Карты акселераторов

GtkAccelMapForeach ()

void
(*GtkAccelMapForeach) (gpointer data,
                       const gchar *accel_path,
                       guint accel_key,
                       GdkModifierType accel_mods,
                       gboolean changed);

gtk_accel_map_add_entry ()

void
gtk_accel_map_add_entry (const gchar *accel_path,
                         guint accel_key,
                         GdkModifierType accel_mods);

Регистрирует новый акселератор в глобальной карте акселераторов. Эту функцию следует вызывать только один раз на accel_path с каноническим accel_key и accel_mods для данного пути. Чтобы изменить акселератор во время выполнения программно, используйте gtk_accel_map_change_entry().

Установите accel_key и accel_mods в 0, чтобы запросить удаление акселератора.

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

gtk_accel_map_lookup_entry ()

gboolean
gtk_accel_map_lookup_entry (const gchar *accel_path,
                            GtkAccelKey *key);

Ищет запись акселератора для accel_path и заполняет key .

gtk_accel_map_change_entry ()

gboolean
gtk_accel_map_change_entry (const gchar *accel_path,
                            guint accel_key,
                            GdkModifierType accel_mods,
                            gboolean replace);

Изменяет accel_key и accel_mods, в настоящее время связанные с accel_path. Из-за конфликтов с другими акселераторами изменение может быть не всегда возможным, replace указывает, могут ли быть удалены другие акселераторы для разрешения таких конфликтов. Изменение произойдёт только в том случае, если все конфликты могут быть разрешены (что может не произойти, если конфликтующие акселераторы заблокированы). Успешные изменения обозначаются возвращаемым значением TRUE.

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

gtk_accel_map_load ()

void
gtk_accel_map_load (const gchar *file_name);

Парсит файл, ранее сохранённый с помощью gtk_accel_map_save() для спецификаций акселераторов и распространяет их соответствующим образом.

gtk_accel_map_save ()

void
gtk_accel_map_save (const gchar *file_name);

Сохраняет текущие спецификации акселераторов (путь, ключ и модификаторы) в file_name. Файл записывается в формате, который можно прочитать обратно с помощью gtk_accel_map_load().

gtk_accel_map_foreach ()

void
gtk_accel_map_foreach (gpointer data,
                       GtkAccelMapForeach foreach_func);

Перебирает записи в карте акселераторов, путь к которым не соответствует ни одному из фильтров, добавленных с помощью gtk_accel_map_add_filter(), и выполняет foreach_func на каждой. Подпись foreach_func такая же, как у GtkAccelMapForeach, параметр changed указывает, был ли этот акселератор изменён во время выполнения (следовательно, его необходимо будет сохранить при экспорте карты акселераторов).

gtk_accel_map_load_fd ()

void
gtk_accel_map_load_fd (gint fd);

Вариант с дескриптором файла для gtk_accel_map_load().

Обратите внимание, что дескриптор файла не будет закрыт этой функцией.

gtk_accel_map_save_fd ()

void
gtk_accel_map_save_fd (gint fd);

Вариант с дескриптором файла для gtk_accel_map_save().

Обратите внимание, что дескриптор файла не будет закрыт этой функцией.

gtk_accel_map_load_scanner ()

void
gtk_accel_map_load_scanner (GScanner *scanner);

Вариант GScanner для gtk_accel_map_load().

gtk_accel_map_add_filter ()

void
gtk_accel_map_add_filter (const gchar *filter_pattern);

Добавляет фильтр к глобальному списку фильтров пути акселератора.

Элементы карты акселераторов, путь акселератора которых соответствует одному из фильтров, пропускаются функцией gtk_accel_map_foreach().

Эта функция предназначена для модулей GTK+, которые создают собственные меню, но не хотят, чтобы они сохранялись в дамп карты акселераторов приложения.

gtk_accel_map_foreach_unfiltered ()

void
gtk_accel_map_foreach_unfiltered (gpointer data,
                                  GtkAccelMapForeach foreach_func);

Проходит по всем записям в карте акселераторов и выполняет foreach_func для каждой. Подпись foreach_func соответствует GtkAccelMapForeach, параметр changed указывает, был ли данный акселератор изменён во время выполнения (следовательно, потребуется сохранение во время дампа карты акселераторов).

gtk_accel_map_get ()

GtkAccelMap *
gtk_accel_map_get (void);

Возвращает одиночный глобальный объект GtkAccelMap. Этот объект полезен только для оповещения о изменениях в карте акселераторов через сигнал ::changed; он не является параметром других функций работы с картой акселераторов.

С: 2.4

gtk_accel_map_lock_path ()

void
gtk_accel_map_lock_path (const gchar *accel_path);

Блокирует указанный путь акселератора. Если карта акселераторов ещё не содержит запись для accel_path, создаётся новая.

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

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

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

С: 2.4

gtk_accel_map_unlock_path ()

void
gtk_accel_map_unlock_path (const gchar *accel_path);

Отменяет последний вызов gtk_accel_map_lock_path() для этого accel_path. См. gtk_accel_map_lock_path() для информации о блокировке путей акселератора.

С: 2.4