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

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

Определяет, являются ли заданные keyval и modifier mask действительным клавиатурным ускорителем. Например, keyval GDK_KEY_a плюс GDK_CONTROL_MASK — это действительный ускоритель «Ctrl+a». Но, например, вы не можете использовать keyval 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 (ноль).

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