Группы ускорителей

gtk_accel_group_new ()

GtkAccelGroup *
gtk_accel_group_new (void);

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

gtk_accel_group_connect ()

void
gtk_accel_group_connect (GtkAccelGroup *accel_group,
                         guint accel_key,
                         GdkModifierType accel_mods,
                         GtkAccelFlags accel_flags,
                         GClosure *closure);

Устанавливает акселератор в этой группе. При активации accel_group в ответ на вызов gtk_accel_groups_activate(), будет вызвано closure, если accel_key и accel_mods из gtk_accel_groups_activate() совпадают с соответствующими значениями этой связи.

Подпись используемая для closure, соответствует GtkAccelGroupActivate.

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

gtk_accel_group_connect_by_path ()

void
gtk_accel_group_connect_by_path (GtkAccelGroup *accel_group,
                                 const gchar *accel_path,
                                 GClosure *closure);

Устанавливает акселератор в этой группе, используя путь акселератора для поиска соответствующего ключа и модификаторов (см. gtk_accel_map_add_entry()). При активации accel_group в ответ на вызов gtk_accel_groups_activate(), будет вызвано closure, если accel_key и accel_mods из gtk_accel_groups_activate() совпадают с ключом и модификаторами для пути.

Подпись используемая для closure, соответствует GtkAccelGroupActivate.

Обратите внимание, что строка accel_path будет храниться в GQuark. Поэтому, если вы передаёте статическую строку, можно немного сэкономить память, предварительно интернировав её с помощью g_intern_static_string().

GtkAccelGroupActivate ()

gboolean
(*GtkAccelGroupActivate) (GtkAccelGroup *accel_group,
                          GObject *acceleratable,
                          guint keyval,
                          GdkModifierType modifier);

GtkAccelGroupFindFunc ()

gboolean
(*GtkAccelGroupFindFunc) (GtkAccelKey *key,
                          GClosure *closure,
                          gpointer data);

С: 2.2

gtk_accel_group_disconnect ()

gboolean
gtk_accel_group_disconnect (GtkAccelGroup *accel_group,
                            GClosure *closure);

Удаляет акселератор, ранее установленный с помощью gtk_accel_group_connect().

С версии 2.20 closure может быть NULL.

gtk_accel_group_disconnect_key ()

gboolean
gtk_accel_group_disconnect_key (GtkAccelGroup *accel_group,
                                guint accel_key,
                                GdkModifierType accel_mods);

Удаляет акселератор, ранее установленный с помощью gtk_accel_group_connect().

gtk_accel_group_activate ()

gboolean
gtk_accel_group_activate (GtkAccelGroup *accel_group,
                          GQuark accel_quark,
                          GObject *acceleratable,
                          guint accel_key,
                          GdkModifierType accel_mods);

Находит первый акселератор в accel_group, который соответствует accel_key и accel_mods, и активирует его.

gtk_accel_group_lock ()

void
gtk_accel_group_lock (GtkAccelGroup *accel_group);

Блокирует заданную группу акселераторов.

Блокировка группы акселераторов предотвращает изменение акселераторов, содержащихся в ней, во время выполнения. Обратитесь к gtk_accel_map_change_entry() для получения информации о изменениях акселераторов во время выполнения.

Если вызов осуществляется более одного раза, accel_group остаётся заблокированной до тех пор, пока gtk_accel_group_unlock() не будет вызван эквивалентное количество раз.

gtk_accel_group_unlock ()

void
gtk_accel_group_unlock (GtkAccelGroup *accel_group);

Отменяет последний вызов gtk_accel_group_lock() для этой accel_group .

gtk_accel_group_get_is_locked ()

gboolean
gtk_accel_group_get_is_locked (GtkAccelGroup *accel_group);

Блокировки добавляются и удаляются с помощью gtk_accel_group_lock() и gtk_accel_group_unlock().

С: 2.14

gtk_accel_group_from_accel_closure ()

GtkAccelGroup *
gtk_accel_group_from_accel_closure (GClosure *closure);

Находит GtkAccelGroup, к которому подключена closure; см. gtk_accel_group_connect().

gtk_accel_group_get_modifier_mask ()

GdkModifierType
gtk_accel_group_get_modifier_mask (GtkAccelGroup *accel_group);

Получает GdkModifierType, представляющий маску для этой accel_group . Например, GDK_CONTROL_MASK, GDK_SHIFT_MASK и т.д.

С: 2.14

gtk_accel_groups_activate ()

gboolean
gtk_accel_groups_activate (GObject *object,
                           guint accel_key,
                           GdkModifierType accel_mods);

Ищет первый акселератор в любой GtkAccelGroup, присоединённой к object, который соответствует accel_key и accel_mods, и активирует этот акселератор.

gtk_accel_groups_from_object ()

GSList *
gtk_accel_groups_from_object (GObject *object);

Получает список всех групп акселераторов, присоединённых к object .

gtk_accel_group_find ()

GtkAccelKey *
gtk_accel_group_find (GtkAccelGroup *accel_group,
                      GtkAccelGroupFindFunc find_func,
                      gpointer data);

Находит первую запись в группе акселераторов, для которой find_func возвращает TRUE, и возвращает её GtkAccelKey.

gtk_accelerator_valid ()

gboolean
gtk_accelerator_valid (guint keyval,
                       GdkModifierType modifiers);

Определяет, является ли заданное значение клавиши и маска модификаторов допустимым акселератором клавиатуры. Например, значение клавиши GDK_KEY_a плюс GDK_CONTROL_MASK является допустимым — это акселератор «Ctrl+a». Но, например, вы не можете использовать значение клавиши GDK_KEY_Control_L в качестве акселератора.

gtk_accelerator_parse ()

void
gtk_accelerator_parse (const gchar *accelerator,
                       guint *accelerator_key,
                       GdkModifierType *accelerator_mods);

Разбирает строку, представляющую ускоритель. Формат похож на «<Control>a» или «<Shift><Alt>F1» или «<Release>z» (последнее — для отпускания клавиши).

Парсер довольно либерален и допускает строчные и прописные буквы, а также сокращения, такие как «<Ctl>» и «<Ctrl>». Имена клавиш разбираются с помощью gdk_keyval_from_name(). Для символьных клавиш имя не является символом, а строчным именем, например, следует использовать «<Ctrl>minus» вместо «<Ctrl>-».

Если разбор завершается неудачей, accelerator_key и accelerator_mods будут установлены в 0 (ноль).

gtk_accelerator_name ()

gchar *
gtk_accelerator_name (guint accelerator_key,
                      GdkModifierType accelerator_mods);

Преобразует значение клавиши ускорителя и маску модификаторов в строку, разбираемую функцией gtk_accelerator_parse(). Например, если передать GDK_KEY_q и GDK_CONTROL_MASK, эта функция вернёт «<Control>q».

Если вам нужно отобразить ускорители в пользовательском интерфейсе, см. gtk_accelerator_get_label().

gtk_accelerator_get_label ()

gchar *
gtk_accelerator_get_label (guint accelerator_key,
                           GdkModifierType accelerator_mods);

Преобразует значение клавиши ускорителя и маску модификаторов в строку, которую можно использовать для представления ускорителя пользователю.

С: 2.6

gtk_accelerator_parse_with_keycode ()

void
gtk_accelerator_parse_with_keycode (const gchar *accelerator,
                                    guint *accelerator_key,
                                    guint **accelerator_codes,
                                    GdkModifierType *accelerator_mods);

Разбирает строку, представляющую ускоритель, аналогично gtk_accelerator_parse(), но также обрабатывает коды клавиш. Это полезно только для компонентов системного уровня, приложения должны использовать gtk_accelerator_parse().

Если accelerator_codes указан, и результат в нём отличен от NULL, результат необходимо освободить с помощью g_free().

Если в ускорителе присутствует код клавиши и accelerator_codes не задан, разбор завершится неудачей.

Если разбор завершается неудачей, accelerator_key , accelerator_mods и accelerator_codes будут установлены в 0 (ноль).

С: 3.4

gtk_accelerator_name_with_keycode ()

gchar *
gtk_accelerator_name_with_keycode (GdkDisplay *display,
                                   guint accelerator_key,
                                   guint keycode,
                                   GdkModifierType accelerator_mods);

Преобразует значение клавиши ускорителя и маску модификаторов в строку, разбираемую функцией gtk_accelerator_parse_with_keycode(), аналогично gtk_accelerator_name(), но обрабатывает коды клавиш. Это полезно только для компонентов системного уровня, приложения должны использовать gtk_accelerator_parse().

С: 3.4

gtk_accelerator_get_label_with_keycode ()

gchar *
gtk_accelerator_get_label_with_keycode
                               (GdkDisplay *display,
                                guint accelerator_key,
                                guint keycode,
                                GdkModifierType accelerator_mods);

Преобразует значение клавиши и маску модификаторов акселератора в (возможно переведённую) строку, которая может быть отображена пользователю, аналогично gtk_accelerator_get_label(), но обрабатывает коды клавиш.

Это полезно только для компонентов системного уровня, приложения должны использовать gtk_accelerator_parse() вместо этого.

С версии: 3.4

gtk_accelerator_set_default_mod_mask ()

void
gtk_accelerator_set_default_mod_mask (GdkModifierType default_mod_mask);

Устанавливает модификаторы, которые будут считаться значимыми для клавиатурных акселераторов. Маска модификаторов по умолчанию зависит от используемого бэкенда GDK, но обычно включает GDK_CONTROL_MASK | GDK_SHIFT_MASK | GDK_MOD1_MASK | GDK_SUPER_MASK | GDK_HYPER_MASK | GDK_META_MASK. Другими словами, Control, Shift, Alt, Super, Hyper и Meta. Другие модификаторы по умолчанию игнорируются GtkAccelGroup.

Вы должны включить как минимум три модификатора Control, Shift и Alt в любое значение, которое вы передаёте в эту функцию.

Маску модификаторов по умолчанию необходимо изменить при запуске приложения, до использования каких-либо групп акселераторов.

gtk_accelerator_get_default_mod_mask ()

GdkModifierType
gtk_accelerator_get_default_mod_mask (void);

Возвращает маску модификаторов.

Маска модификаторов определяет, какие модификаторы считаются значимыми для клавиатурных акселераторов. См. gtk_accelerator_set_default_mod_mask().