Связывания

Установка ключевого связывания

Связывание в файле CSS состоит из определения «связывающего набора» и оператора сопоставления для применения набора связей к определенным типам виджетов. Подробности о механизме сопоставления описаны в разделе «Селекторы» в документации GtkCssProvider. Внутри определения набора связей сочетания клавиш связываются с одним или несколькими определенными сигналами об отправке на целевом виджете. Сочетания клавиш — это строки, состоящие из необязательного имени GdkModifierType и имен клавиш, таких как те, что определены в gdk/gdkkeysyms.h или возвращаемые из gdk_keyval_name(), они должны быть распарсируемыми для gtk_accelerator_parse(). Спецификации сигналов об отправке состоят из строки, идентифицирующей имя сигнала, и списка аргументов специфичных для сигнала в скобках.

Например, для связывания клавиш Ctrl и левой или правой клавиши курсора виджета GtkEntry с сигналом “move-cursor” (чтобы перемещение происходило шагами в 3 символа), можно использовать следующее связывание:

Отключение существующих ключевых связей

GTK+ уже определяет ряд полезных связей для предоставляемых им виджетов. Поскольку пользовательские связывания, настроенные в файлах CSS, имеют приоритет над стандартными связываниями, поставляемыми с GTK+, переопределение существующих связей, как показано в примере установки связывания, работает как ожидается. Однако тот же механизм не может использоваться для «отключения» существующих связей.

Приведенный выше пример не приведет к желаемому эффекту игнорирования GTK+ нажатий клавиш «<Ctrl>Вправо» и «<Ctrl>Влево». Вместо этого он просто приводит к удалению любых существующих связей из набора связей «MoveCursor3», поэтому при нажатии «<Ctrl>Вправо» или «<Ctrl>Влево» в наборе связей «MoveCursor3» не найдено ни одного связывания. Таким образом, GTK+ продолжит поиск соответствующих ключевых связей и в конечном итоге найдет стандартные связывания GTK+ для полей, которые реализуют перемещение слов. Чтобы не активировать стандартные связывания GTK+, можно использовать ключевое слово «отключить» следующим образом:

Теперь GTK+ найдет соответствие при поиске нажатий клавиш «<Ctrl>Вправо» и «<Ctrl>Влево» до того, как он обратится к стандартным связываниям GTK+, и совпадение указывает ему прервать («отключить») поиск, поэтому нажатия клавиш не будут потребляться этим виджетом. Как обычно, дальнейшая обработка нажатий клавиш, например, виджетом-родителем поля, теперь возможна.

struct GtkBindingSet

struct GtkBindingSet {
  gchar           *set_name;
  gint             priority;
  GSList          *widget_path_pspecs;
  GSList          *widget_class_pspecs;
  GSList          *class_branch_pspecs;
  GtkBindingEntry *entries;
  GtkBindingEntry *current;
  guint            parsed : 1;
};

Набор привязок сохраняет список активируемых сочетаний клавиш. Один набор привязок может соответствовать нескольким типам виджетов. Подобно контекстам стилей, он может сопоставляться с любой информацией, содержащейся в GtkWidgetPath виджета. Когда привязка в наборе сопоставляется при активации, на целевой виджет отправляется сигнал действия, чтобы выполнить фактическую активацию.

struct GtkBindingEntry

struct GtkBindingEntry {
  /* key portion */
  guint             keyval;
  GdkModifierType   modifiers;

  GtkBindingSet    *binding_set;
  guint             destroyed     : 1;
  guint             in_emission   : 1;
  guint             marks_unbound : 1;
  GtkBindingEntry  *set_next;
  GtkBindingEntry  *hash_next;
  GtkBindingSignal *signals;
};

Каждый элемент сочетания клавиш списка привязок набора привязок представлен GtkBindingEntry.

struct GtkBindingSignal

struct GtkBindingSignal {
  GtkBindingSignal *next;
  gchar            *signal_name;
  guint             n_args;
  GtkBindingArg    *args;
};

GtkBindingSignal хранит необходимую информацию для активации виджета в ответ на нажатие клавиши с помощью отправки сигнала.

struct GtkBindingArg

struct GtkBindingArg {
  GType      arg_type;
  union {
    glong    long_data;
    gdouble  double_data;
    gchar   *string_data;
  } d;
};

A GtkBindingArg хранит данные, связанные с аргументом для отправки сигнала сочетания клавиш, как хранится в GtkBindingSignal.