Связывания

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

Связывание в файле 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» в наборе связей «MoveCursor3» не будет найдено ни одного связывания. GTK+ продолжит поиск сопоставления по ключевым связываниям и в конечном итоге найдёт стандартные связывания GTK+ для полей, реализующих перемещение по словам. Чтобы предотвратить активацию GTK+ его стандартных связываний, можно использовать ключевое слово «unbind», как показано ниже:

Теперь GTK+ найдёт соответствие при поиске нажатий клавиш «<Control>Right» и «<Control>Left» до того, как прибегнет к стандартным связываниям, и соответствие указывает ему прервать («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.