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

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