Связывания

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

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

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

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

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

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

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

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;
};

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