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);

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

С: 2.4

gtk_button_get_focus_on_click ()

gboolean
gtk_button_get_focus_on_click (GtkButton *button);

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

С: 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