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, содержащий изображение и текст из элемента запаса.

Некоторые идентификаторы запаса имеют макросы препроцессора, такие как GTK_STOCK_OK и GTK_STOCK_APPLY.

Если 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);

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

gtk_button_set_focus_on_click ()

void
gtk_button_set_focus_on_click (GtkButton *button,
                               gboolean focus_on_click);

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

C версии: 2.4

gtk_button_get_focus_on_click ()

gboolean
gtk_button_get_focus_on_click (GtkButton *button);

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

C версии: 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 или если свойство “always-show-image” равно 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