GtkButton

gtk_button_new ()

GtkWidget *
gtk_button_new (void);

Создаёт новый виджет GtkButton. Для добавления дочернего виджета к кнопке используйте gtk_container_add().

gtk_button_new_with_label ()

GtkWidget *
gtk_button_new_with_label (const gchar *label);

Создаёт виджет GtkButton с дочерним виджетом GtkLabel, содержащим заданный текст.

gtk_button_new_with_mnemonic ()

GtkWidget *
gtk_button_new_with_mnemonic (const gchar *label);

Создаёт новый виджет GtkButton содержащий метку. Если символы в label предваряются нижним подчёркиванием, они подчеркиваются. Если вам нужен буквенный символ нижнего подчёркивания в метке, используйте «__» (два нижних подчёркивания). Первый подчеркнутый символ представляет собой сочетание клавиш, называемое мнемоникой. Нажатие Alt и этой клавиши активирует кнопку.

gtk_button_new_from_icon_name ()

GtkWidget *
gtk_button_new_from_icon_name (const gchar *icon_name,
                               GtkIconSize size);

Создаёт новую кнопку, содержащую значок из текущей темы значков.

Если имя значка неизвестно, вместо этого будет отображён значок «разбитого изображения». Если текущая тема значков изменена, значок будет соответствующим образом обновлён.

Эта функция представляет собой удобную обёртку вокруг gtk_button_new() и gtk_button_set_image().

С: 3.10

gtk_button_new_from_stock ()

GtkWidget *
gtk_button_new_from_stock (const gchar *stock_id);

Создаёт новый GtkButton содержащий изображение и текст из элемента запаса.

Если stock_id неизвестно, оно будет обработано как метка мнемоники (как для gtk_button_new_with_mnemonic()).

gtk_button_pressed ()

void
gtk_button_pressed (GtkButton *button);

Отправляет сигнал “pressed” для данной GtkButton.

gtk_button_released ()

void
gtk_button_released (GtkButton *button);

Отправляет сигнал “released” для данной GtkButton.

gtk_button_clicked ()

void
gtk_button_clicked (GtkButton *button);

Отправляет сигнал “clicked” для данной GtkButton.

gtk_button_enter ()

void
gtk_button_enter (GtkButton *button);

Отправляет сигнал “enter” для данной GtkButton.

gtk_button_leave ()

void
gtk_button_leave (GtkButton *button);

Отправляет сигнал “leave” для данной GtkButton.

gtk_button_set_relief ()

void
gtk_button_set_relief (GtkButton *button,
                       GtkReliefStyle relief);

Устанавливает стиль рельефа краёв указанного виджета GtkButton. Существуют два стиля: GTK_RELIEF_NORMAL и GTK_RELIEF_NONE. По умолчанию используется стиль GTK_RELIEF_NORMAL. Устаревшее значение GTK_RELIEF_HALF эквивалентно GTK_RELIEF_NORMAL.

gtk_button_get_relief ()

GtkReliefStyle
gtk_button_get_relief (GtkButton *button);

Возвращает текущий стиль рельефа указанного виджета GtkButton.

gtk_button_get_label ()

const gchar *
gtk_button_get_label (GtkButton *button);

Возвращает текст из метки кнопки, установленной с помощью gtk_button_set_label(). Если текст метки не установлен, возвращается NULL. Это произойдёт, если вы создали пустую кнопку с помощью gtk_button_new() для использования в качестве контейнера.

gtk_button_set_label ()

void
gtk_button_set_label (GtkButton *button,
                      const gchar *label);

Устанавливает текст метки кнопки на str . Этот текст также используется для выбора значка, если используется gtk_button_set_use_stock().

Это также очистит все ранее установленные метки.

gtk_button_get_use_stock ()

gboolean
gtk_button_get_use_stock (GtkButton *button);

Возвращает, является ли метка кнопки значком.

gtk_button_set_use_stock ()

void
gtk_button_set_use_stock (GtkButton *button,
                          gboolean use_stock);

Если TRUE, то метка, установленная на кнопке, используется как идентификатор значка для выбора значка для кнопки.

gtk_button_get_use_underline ()

gboolean
gtk_button_get_use_underline (GtkButton *button);

Возвращает, указывает ли встроенное подчеркивание в метке кнопки на мнемонику. См. gtk_button_set_use_underline().

gtk_button_set_use_underline ()

void
gtk_button_set_use_underline (GtkButton *button,
                              gboolean use_underline);

Если значение истинно, подчеркивание в тексте метки кнопки указывает, что следующий символ должен использоваться в качестве мнемонической клавиши.

gtk_button_set_focus_on_click ()

void
gtk_button_set_focus_on_click (GtkButton *button,
                               gboolean focus_on_click);

Устанавливает, получит ли кнопка фокус при нажатии мышью. Необходимость отказаться от захвата фокуса при нажатии мышью полезна в таких местах, как панели инструментов, где вы не хотите, чтобы фокус клавиатуры удалялся из основной области приложения.

Since: 2.4

gtk_button_get_focus_on_click ()

gboolean
gtk_button_get_focus_on_click (GtkButton *button);

Возвращает, получит ли кнопка фокус при нажатии мышью. См. gtk_button_set_focus_on_click().

Since: 2.4

gtk_button_set_alignment ()

void
gtk_button_set_alignment (GtkButton *button,
                          gfloat xalign,
                          gfloat yalign);

Устанавливает выравнивание дочернего виджета. Данный параметр не оказывает влияния, если дочерний виджет не является GtkMisc или GtkAlignment.

С версии: 2.4

gtk_button_get_alignment ()

void
gtk_button_get_alignment (GtkButton *button,
                          gfloat *xalign,
                          gfloat *yalign);

Получает выравнивание дочернего виджета в кнопке.

С версии: 2.4

gtk_button_set_image ()

void
gtk_button_set_image (GtkButton *button,
                      GtkWidget *image);

Устанавливает изображение для button в заданном виджете. Изображение будет отображаться, если текст метки — NULL, или если “всегда показывать изображение” имеет значение TRUE. Вы не должны вызывать gtk_widget_show() для image самостоятельно.

С версии: 2.6

gtk_button_get_image ()

GtkWidget *
gtk_button_get_image (GtkButton *button);

Получает виджет, который в данный момент установлен в качестве изображения для button. Это может быть явно установлено с помощью gtk_button_set_image() или создано с помощью gtk_button_new_from_stock().

С версии: 2.6

gtk_button_set_image_position ()

void
gtk_button_set_image_position (GtkButton *button,
                               GtkPositionType position);

Устанавливает положение изображения относительно текста внутри кнопки.

С версии: 2.10

gtk_button_get_image_position ()

GtkPositionType
gtk_button_get_image_position (GtkButton *button);

Получает положение изображения относительно текста внутри кнопки.

С версии: 2.10

gtk_button_set_always_show_image ()

void
gtk_button_set_always_show_image (GtkButton *button,
                                  gboolean always_show);

Если TRUE, кнопка будет игнорировать настройку “gtk-button-images” и всегда отображать изображение, если оно доступно.

Используйте этот параметр, если кнопка бесполезна или неудобна без изображения.

С версии: 3.6

gtk_button_get_always_show_image ()

gboolean
gtk_button_get_always_show_image (GtkButton *button);

Возвращает, будет ли кнопка игнорировать настройку “gtk-button-images” и всегда показывать изображение, если оно доступно.

С версии: 3.6

gtk_button_get_event_window ()

GdkWindow *
gtk_button_get_event_window (GtkButton *button);

Возвращает окно событий кнопки, если оно реализовано, иначе NULL. Эта функция редко необходима.

С версии: 2.22