GtkButton

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

			GTK+ Reference Manual
Top \| Description \| Object Hierarchy \| Properties \| Style Properties \| Signals

GtkButton

GtkButton Виджет создающий сигнал когда на него нажимают

Краткое описание

#include <gtk/gtk.h>


#include <gtk/gtk.h>


            GtkButton;
GtkWidget*  gtk_button_new                  (void);
GtkWidget*  gtk_button_new_with_label       (const gchar *label);
GtkWidget*  gtk_button_new_with_mnemonic    (const gchar *label);
GtkWidget*  gtk_button_new_from_stock       (const gchar *stock_id);
void        gtk_button_pressed              (GtkButton *button);
void        gtk_button_released             (GtkButton *button);
void        gtk_button_clicked              (GtkButton *button);
void        gtk_button_enter                (GtkButton *button);
void        gtk_button_leave                (GtkButton *button);
void        gtk_button_set_relief           (GtkButton *button,
                                             GtkReliefStyle newstyle);
GtkReliefStyle gtk_button_get_relief        (GtkButton *button);
const gchar* gtk_button_get_label           (GtkButton *button);
void        gtk_button_set_label            (GtkButton *button,
                                             const gchar *label);
gboolean    gtk_button_get_use_stock        (GtkButton *button);
void        gtk_button_set_use_stock        (GtkButton *button,
                                             gboolean use_stock);
gboolean    gtk_button_get_use_underline    (GtkButton *button);
void        gtk_button_set_use_underline    (GtkButton *button,
                                             gboolean use_underline);
void        gtk_button_set_focus_on_click   (GtkButton *button,
                                             gboolean focus_on_click);
gboolean    gtk_button_get_focus_on_click   (GtkButton *button);
void        gtk_button_set_alignment        (GtkButton *button,
                                             gfloat xalign,
                                             gfloat yalign);
void        gtk_button_get_alignment        (GtkButton *button,
                                             gfloat *xalign,
                                             gfloat *yalign);
void        gtk_button_set_image            (GtkButton *button,
                                             GtkWidget *image);
GtkWidget*  gtk_button_get_image            (GtkButton *button);
void        gtk_button_set_image_position   (GtkButton *button,
                                             GtkPositionType position);
GtkPositionType gtk_button_get_image_position
                                            (GtkButton *button);

Иерархия объектов

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkButton
                                       +----GtkToggleButton
                                       +----GtkColorButton
                                       +----GtkFontButton
                                       +----GtkOptionMenu

Осуществляемые интерфейсы

GtkButton осуществляет AtkImplementorIface.

Свойства

  "focus-on-click"       gboolean              : Read / Write
  "image"                GtkWidget             : Read / Write
  "label"                gchararray            : Read / Write / Construct
  "relief"               GtkReliefStyle        : Read / Write
  "use-stock"            gboolean              : Read / Write / Construct
  "use-underline"        gboolean              : Read / Write / Construct
  "xalign"               gfloat                : Read / Write
  "yalign"               gfloat                : Read / Write

Свойства стиля

  "child-displacement-x" gint                  : Read
  "child-displacement-y" gint                  : Read
  "default-border"       GtkBorder             : Read
  "default-outside-border" GtkBorder             : Read
  "displace-focus"       gboolean              : Read

Сигналы

"activate"  void        user_function      (GtkButton *widget,
                                            gpointer   user_data)      : Run first / Action
"clicked"   void        user_function      (GtkButton *button,
                                            gpointer   user_data)      : Run first / Action
"enter"     void        user_function      (GtkButton *button,
                                            gpointer   user_data)      : Run first
"leave"     void        user_function      (GtkButton *button,
                                            gpointer   user_data)      : Run first
"pressed"   void        user_function      (GtkButton *button,
                                            gpointer   user_data)      : Run first
"released"  void        user_function      (GtkButton *button,
                                            gpointer   user_data)      : Run first

Описание

Виджет GtkButton в основном используется для прикрепления к нему функций которые вызываются когда он нажат. Различные сигналы и то как ими пользоваться описано ниже.

Виджет GtkButton может содержать любой стандартный дочерний виджет GtkWidget. В основном в качестве дочернего виджета используется GtkLabel.

Детали

GtkButton

typedef struct _GtkButton GtkButton;

К этой структуре нет непосредственного доступа. Используйте для этого функции приведённые ниже.

gtk_button_new ()

GtkWidget*  gtk_button_new                  (void);

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

Возвращает :

Вновь созданный GtkButton виджет.

gtk_button_new_with_label ()

GtkWidget*  gtk_button_new_with_label       (const gchar *label);

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

`label` :	Текст который должен содержать виджет GtkLabel.
Возвращает :	Вновь созданный GtkButton виджет.

gtk_button_new_with_mnemonic ()

GtkWidget*  gtk_button_new_with_mnemonic    (const gchar *label);

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

`label` :	Текст кнопки с подчеркиванием спереди означающий мнемонический ускоритель
Возвращает :	новый GtkButton

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()).

`stock_id` :	Имя готового элемента
Возвращает :	новый GtkButton