Клавишные ускорители

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

gboolean
gtk_accelerator_parse (const char *accelerator,
                       guint *accelerator_key,
                       GdkModifierType *accelerator_mods);

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

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

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

gtk_accelerator_name ()

char *
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 ()

char *
gtk_accelerator_get_label (guint accelerator_key,
                           GdkModifierType accelerator_mods);

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

gtk_accelerator_parse_with_keycode ()

gboolean
gtk_accelerator_parse_with_keycode (const char *accelerator,
                                    GdkDisplay *display,
                                    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_name_with_keycode ()

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

gtk_accelerator_get_label_with_keycode ()

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

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

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

gtk_accelerator_get_default_mod_mask ()

GdkModifierType
gtk_accelerator_get_default_mod_mask (void);

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

Маска модификаторов определяет, какие модификаторы считаются значимыми для комбинаций клавиш. Это включает все модификаторы клавиатуры, кроме GDK_LOCK_MASK.