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

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

Since: 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 и т. д.

Since: 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 и маска модификаторов допустимым ускорителем клавиатуры. Например, keyval 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);

Преобразует комбинацию клавиш (keyval) и модификаторов (modifier mask) в строку, парсируемую функцией 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);

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

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

Преобразует комбинацию клавиш (keyval) и модификаторы (modifier mask) в строку, парсируемую 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);

Преобразует комбинацию клавиш (keyval) и модификаторы (modifier mask) в (возможно, переведённую) строку, которая может быть отображена пользователю, аналогично 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().