Карты ускорителей

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