GtkAccelLabel

Создание простого пункта меню с клавишей-акселератором.

CSS-узлы

GtkWidget *save_item;
GtkAccelGroup *accel_group;

// Create a GtkAccelGroup and add it to the window.
accel_group = gtk_accel_group_new ();
gtk_window_add_accel_group (GTK_WINDOW (window), accel_group);

// Create the menu item using the convenience function.
save_item = gtk_menu_item_new_with_label ("Save");
gtk_widget_show (save_item);
gtk_container_add (GTK_CONTAINER (menu), save_item);

// Now add the accelerator to the GtkMenuItem. Note that since we
// called gtk_menu_item_new_with_label() to create the GtkMenuItem
// the GtkAccelLabel is automatically set up to display the
// GtkMenuItem accelerators. We just need to make sure we use
// GTK_ACCEL_VISIBLE here.
gtk_widget_add_accelerator (save_item, "activate", accel_group,
                            GDK_KEY_s, GDK_CONTROL_MASK, GTK_ACCEL_VISIBLE);

Как и GtkLabel, GtkAccelLabel имеет основной CSS-узел с именем label. Он добавляет дочерний узел с именем accelerator.

gtk_accel_label_new ()

GtkWidget *
gtk_accel_label_new (const gchar *string);

Создаёт новый GtkAccelLabel.

gtk_accel_label_set_accel_closure ()

void
gtk_accel_label_set_accel_closure (GtkAccelLabel *accel_label,
                                   GClosure *accel_closure);

Устанавливает обработчик, который будет отслеживаться этой меткой акселератора. Обработчик должен быть подключён к группе акселераторов; см. gtk_accel_group_connect().

gtk_accel_label_get_accel_widget ()

GtkWidget *
gtk_accel_label_get_accel_widget (GtkAccelLabel *accel_label);

Возвращает виджет, отслеживаемый этой меткой акселератора. См. gtk_accel_label_set_accel_widget().

gtk_accel_label_set_accel_widget ()

void
gtk_accel_label_set_accel_widget (GtkAccelLabel *accel_label,
                                  GtkWidget *accel_widget);

Устанавливает виджет, который будет отслеживаться этой меткой акселератора.

gtk_accel_label_get_accel_width ()

guint
gtk_accel_label_get_accel_width (GtkAccelLabel *accel_label);

Возвращает ширину, необходимую для отображения клавиши(ей) акселератора. Это используется меню для выравнивания всех виджетов GtkMenuItem, и не должно требоваться приложениям.

gtk_accel_label_set_accel ()

void
gtk_accel_label_set_accel (GtkAccelLabel *accel_label,
                           guint accelerator_key,
                           GdkModifierType accelerator_mods);

Вручную устанавливает keyval и маску модификаторов в качестве акселератора, отображаемого accel_label.

Если keyval и модификатор явно заданы, эти значения используются независимо от любого связанного accel closure или виджета.

Указание accelerator_key равным 0 удаляет ручную установку.

С: 3.6

gtk_accel_label_get_accel ()

void
gtk_accel_label_get_accel (GtkAccelLabel *accel_label,
                           guint *accelerator_key,
                           GdkModifierType *accelerator_mods);

Получает keyval и маску модификаторов, установленные с помощью gtk_accel_label_set_accel().

С: 3.12

gtk_accel_label_refetch ()

gboolean
gtk_accel_label_refetch (GtkAccelLabel *accel_label);

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

struct GtkAccelLabel

struct GtkAccelLabel;

Структура GtkAccelLabel содержит только внутренние данные и должна быть обработана с помощью перечисленных ниже функций.

Свойство “accel-closure”

  “accel-closure”            GClosure *

Обработчик, который будет отслеживаться для изменений акселератора.

Флаги: Чтение / Запись

Свойство “accel-widget”

  “accel-widget”             GtkWidget *

Виджет, который будет отслеживаться для изменений акселератора.

Флаги: Чтение / Запись