/* * Copyright © 2018 Benjamin Otte * * SPDX-License-Identifier: LGPL-2.1-or-later * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library. If not, see . * * Authors: Benjamin Otte */ /** * GtkShortcutTrigger: * * `GtkShortcutTrigger` tracks how a `GtkShortcut` should be activated. * * To find out if a `GtkShortcutTrigger` triggers, you can call * [method@Gtk.ShortcutTrigger.trigger] on a `GdkEvent`. * * `GtkShortcutTriggers` contain functions that allow easy presentation * to end users as well as being printed for debugging. * * All `GtkShortcutTriggers` are immutable, you can only specify their * properties during construction. If you want to change a trigger, you * have to replace it with a new one. */ #include "config.h" #include "gtkshortcuttrigger.h" #include "gtkaccelgroupprivate.h" #include "gtkprivate.h" #include "gtkintl.h" #define GTK_SHORTCUT_TRIGGER_HASH_NEVER 0u #define GTK_SHORTCUT_TRIGGER_HASH_KEYVAL 1u #define GTK_SHORTCUT_TRIGGER_HASH_MNEMONIC 2u #define GTK_SHORTCUT_TRIGGER_HASH_ALTERNATIVE 3u struct _GtkShortcutTrigger { GObject parent_instance; }; struct _GtkShortcutTriggerClass { GObjectClass parent_class; GdkKeyMatch (* trigger) (GtkShortcutTrigger *trigger, GdkEvent *event, gboolean enable_mnemonics); guint (* hash) (GtkShortcutTrigger *trigger); int (* compare) (GtkShortcutTrigger *trigger1, GtkShortcutTrigger *trigger2); void (* print) (GtkShortcutTrigger *trigger, GString *string); gboolean (* print_label) (GtkShortcutTrigger *trigger, GdkDisplay *display, GString *string); }; G_DEFINE_ABSTRACT_TYPE (GtkShortcutTrigger, gtk_shortcut_trigger, G_TYPE_OBJECT) static void gtk_shortcut_trigger_class_init (GtkShortcutTriggerClass *klass) { } static void gtk_shortcut_trigger_init (GtkShortcutTrigger *self) { } /** * gtk_shortcut_trigger_trigger: * @self: a `GtkShortcutTrigger` * @event: the event to check * @enable_mnemonics: %TRUE if mnemonics should trigger. Usually the * value of this property is determined by checking that the passed * in @event is a Key event and has the right modifiers set. * * Checks if the given @event triggers @self. * * Returns: Whether the event triggered the shortcut */ GdkKeyMatch gtk_shortcut_trigger_trigger (GtkShortcutTrigger *self, GdkEvent *event, gboolean enable_mnemonics) { g_return_val_if_fail (GTK_IS_SHORTCUT_TRIGGER (self), GDK_KEY_MATCH_NONE); return GTK_SHORTCUT_TRIGGER_GET_CLASS (self)->trigger (self, event, enable_mnemonics); } /** * gtk_shortcut_trigger_parse_string: (constructor) * @string: the string to parse * * Tries to parse the given string into a trigger. * * On success, the parsed trigger is returned. * When parsing failed, %NULL is returned. * * The accepted strings are: * * - `never`, for `GtkNeverTrigger` * - a string parsed by gtk_accelerator_parse(), for a `GtkKeyvalTrigger`, e.g. `C` * - underscore, followed by a single character, for `GtkMnemonicTrigger`, e.g. `_l` * - two valid trigger strings, separated by a `|` character, for a * `GtkAlternativeTrigger`: `q|w` * * Note that you will have to escape the `<` and `>` characters when specifying * triggers in XML files, such as GtkBuilder ui files. Use `<` instead of * `<` and `>` instead of `>`. * * Returns: (nullable) (transfer full): a new `GtkShortcutTrigger` */ GtkShortcutTrigger * gtk_shortcut_trigger_parse_string (const char *string) { GdkModifierType modifiers; guint keyval; const char *sep; g_return_val_if_fail (string != NULL, NULL); if ((sep = strchr (string, '|')) != NULL) { char *frag_a = g_strndup (string, sep - string); const char *frag_b = sep + 1; GtkShortcutTrigger *t1, *t2; /* empty first slot */ if (*frag_a == '\0') { g_free (frag_a); return NULL; } /* empty second slot */ if (*frag_b == '\0') { g_free (frag_a); return NULL; } t1 = gtk_shortcut_trigger_parse_string (frag_a); if (t1 == NULL) { g_free (frag_a); return NULL; } t2 = gtk_shortcut_trigger_parse_string (frag_b); if (t2 == NULL) { g_object_unref (t1); g_free (frag_a); return NULL; } g_free (frag_a); return gtk_alternative_trigger_new (t1, t2); } if (g_str_equal (string, "never")) return g_object_ref (gtk_never_trigger_get ()); if (string[0] == '_') { keyval = gdk_keyval_from_name (string + 1); if (keyval != GDK_KEY_VoidSymbol) return gtk_mnemonic_trigger_new (gdk_keyval_to_lower (keyval)); } if (gtk_accelerator_parse (string, &keyval, &modifiers)) return gtk_keyval_trigger_new (keyval, modifiers); return NULL; } /** * gtk_shortcut_trigger_to_string: * @self: a `GtkShortcutTrigger` * * Prints the given trigger into a human-readable string. * * This is a small wrapper around [method@Gtk.ShortcutTrigger.print] * to help when debugging. * * Returns: (transfer full): a new string */ char * gtk_shortcut_trigger_to_string (GtkShortcutTrigger *self) { GString *string; g_return_val_if_fail (self != NULL, NULL); string = g_string_new (NULL); gtk_shortcut_trigger_print (self, string); return g_string_free (string, FALSE); } /** * gtk_shortcut_trigger_print: * @self: a `GtkShortcutTrigger` * @string: a `GString` to print into * * Prints the given trigger into a string for the developer. * This is meant for debugging and logging. * * The form of the representation may change at any time * and is not guaranteed to stay identical. */ void gtk_shortcut_trigger_print (GtkShortcutTrigger *self, GString *string) { g_return_if_fail (GTK_IS_SHORTCUT_TRIGGER (self)); g_return_if_fail (string != NULL); GTK_SHORTCUT_TRIGGER_GET_CLASS (self)->print (self, string); } /** * gtk_shortcut_trigger_to_label: * @self: a `GtkShortcutTrigger` * @display: `GdkDisplay` to print for * * Gets textual representation for the given trigger. * * This function is returning a translated string for * presentation to end users for example in menu items * or in help texts. * * The @display in use may influence the resulting string in * various forms, such as resolving hardware keycodes or by * causing display-specific modifier names. * * The form of the representation may change at any time and is * not guaranteed to stay identical. * * Returns: (transfer full): a new string */ char * gtk_shortcut_trigger_to_label (GtkShortcutTrigger *self, GdkDisplay *display) { GString *string; g_return_val_if_fail (self != NULL, NULL); string = g_string_new (NULL); gtk_shortcut_trigger_print_label (self, display, string); return g_string_free (string, FALSE); } /** * gtk_shortcut_trigger_print_label: * @self: a `GtkShortcutTrigger` * @display: `GdkDisplay` to print for * @string: a `GString` to print into * * Prints the given trigger into a string. * * This function is returning a translated string for presentation * to end users for example in menu items or in help texts. * * The @display in use may influence the resulting string in * various forms, such as resolving hardware keycodes or by * causing display-specific modifier names. * * The form of the representation may change at any time and is * not guaranteed to stay identical. * * Returns: %TRUE if something was printed or %FALSE if the * trigger did not have a textual representation suitable * for end users. **/ gboolean gtk_shortcut_trigger_print_label (GtkShortcutTrigger *self, GdkDisplay *display, GString *string) { g_return_val_if_fail (GTK_IS_SHORTCUT_TRIGGER (self), FALSE); g_return_val_if_fail (GDK_IS_DISPLAY (display), FALSE); g_return_val_if_fail (string != NULL, FALSE); return GTK_SHORTCUT_TRIGGER_GET_CLASS (self)->print_label (self, display, string); } /** * gtk_shortcut_trigger_hash: * @trigger: (type GtkShortcutTrigger): a `GtkShortcutTrigger` * * Generates a hash value for a `GtkShortcutTrigger`. * * The output of this function is guaranteed to be the same for a given * value only per-process. It may change between different processor * architectures or even different versions of GTK. Do not use this * function as a basis for building protocols or file formats. * * The types of @trigger is `gconstpointer` only to allow use of this * function with `GHashTable`. They must each be a `GtkShortcutTrigger`. * * Returns: a hash value corresponding to @trigger */ guint gtk_shortcut_trigger_hash (gconstpointer trigger) { GtkShortcutTrigger *t = (GtkShortcutTrigger *) trigger; g_return_val_if_fail (GTK_IS_SHORTCUT_TRIGGER (t), 0); return GTK_SHORTCUT_TRIGGER_GET_CLASS (t)->hash (t); } /** * gtk_shortcut_trigger_equal: * @trigger1: (type GtkShortcutTrigger): a `GtkShortcutTrigger` * @trigger2: (type GtkShortcutTrigger): a `GtkShortcutTrigger` * * Checks if @trigger1 and @trigger2 trigger under the same conditions. * * The types of @one and @two are `gconstpointer` only to allow use of this * function with `GHashTable`. They must each be a `GtkShortcutTrigger`. * * Returns: %TRUE if @trigger1 and @trigger2 are equal */ gboolean gtk_shortcut_trigger_equal (gconstpointer trigger1, gconstpointer trigger2) { return gtk_shortcut_trigger_compare (trigger1, trigger2) == 0; } /** * gtk_shortcut_trigger_compare: * @trigger1: (type GtkShortcutTrigger): a `GtkShortcutTrigger` * @trigger2: (type GtkShortcutTrigger): a `GtkShortcutTrigger` * * The types of @trigger1 and @trigger2 are `gconstpointer` only to allow * use of this function as a `GCompareFunc`. * * They must each be a `GtkShortcutTrigger`. * * Returns: An integer less than, equal to, or greater than zero if * @trigger1 is found, respectively, to be less than, to match, * or be greater than @trigger2. */ int gtk_shortcut_trigger_compare (gconstpointer trigger1, gconstpointer trigger2) { GtkShortcutTrigger *t1 = (GtkShortcutTrigger *) trigger1; GtkShortcutTrigger *t2 = (GtkShortcutTrigger *) trigger2; GType type1, type2; g_return_val_if_fail (GTK_IS_SHORTCUT_TRIGGER (t1), -1); g_return_val_if_fail (GTK_IS_SHORTCUT_TRIGGER (t2), 1); type1 = G_OBJECT_TYPE (t1); type2 = G_OBJECT_TYPE (t2); if (type1 == type2) { return GTK_SHORTCUT_TRIGGER_GET_CLASS (t1)->compare (t1, t2); } else { /* never < keyval < mnemonic < alternative */ if (type1 == GTK_TYPE_NEVER_TRIGGER || type2 == GTK_TYPE_ALTERNATIVE_TRIGGER) return -1; if (type2 == GTK_TYPE_NEVER_TRIGGER || type1 == GTK_TYPE_ALTERNATIVE_TRIGGER) return 1; if (type1 == GTK_TYPE_KEYVAL_TRIGGER) return -1; else return 1; } } struct _GtkNeverTrigger { GtkShortcutTrigger parent_instance; }; struct _GtkNeverTriggerClass { GtkShortcutTriggerClass parent_class; }; G_DEFINE_TYPE (GtkNeverTrigger, gtk_never_trigger, GTK_TYPE_SHORTCUT_TRIGGER) static void G_GNUC_NORETURN gtk_never_trigger_finalize (GObject *gobject) { g_assert_not_reached (); G_OBJECT_CLASS (gtk_never_trigger_parent_class)->finalize (gobject); } static GdkKeyMatch gtk_never_trigger_trigger (GtkShortcutTrigger *trigger, GdkEvent *event, gboolean enable_mnemonics) { return GDK_KEY_MATCH_NONE; } static guint gtk_never_trigger_hash (GtkShortcutTrigger *trigger) { return GTK_SHORTCUT_TRIGGER_HASH_NEVER; } static int gtk_never_trigger_compare (GtkShortcutTrigger *trigger1, GtkShortcutTrigger *trigger2) { return 0; } static void gtk_never_trigger_print (GtkShortcutTrigger *trigger, GString *string) { g_string_append (string, "never"); } static gboolean gtk_never_trigger_print_label (GtkShortcutTrigger *trigger, GdkDisplay *display, GString *string) { return FALSE; } static void gtk_never_trigger_class_init (GtkNeverTriggerClass *klass) { GtkShortcutTriggerClass *trigger_class = GTK_SHORTCUT_TRIGGER_CLASS (klass); GObjectClass *gobject_class = G_OBJECT_CLASS (klass); gobject_class->finalize = gtk_never_trigger_finalize; trigger_class->trigger = gtk_never_trigger_trigger; trigger_class->hash = gtk_never_trigger_hash; trigger_class->compare = gtk_never_trigger_compare; trigger_class->print = gtk_never_trigger_print; trigger_class->print_label = gtk_never_trigger_print_label; } static void gtk_never_trigger_init (GtkNeverTrigger *self) { } /** * gtk_never_trigger_get: * * Gets the never trigger. * * This is a singleton for a trigger that never triggers. * Use this trigger instead of %NULL because it implements * all virtual functions. * * Returns: (type GtkNeverTrigger) (transfer none): The never trigger */ GtkShortcutTrigger * gtk_never_trigger_get (void) { static GtkShortcutTrigger *never = NULL; if (G_UNLIKELY (never == NULL)) never = g_object_new (GTK_TYPE_NEVER_TRIGGER, NULL); return never; } struct _GtkKeyvalTrigger { GtkShortcutTrigger parent_instance; guint keyval; GdkModifierType modifiers; }; struct _GtkKeyvalTriggerClass { GtkShortcutTriggerClass parent_class; }; G_DEFINE_TYPE (GtkKeyvalTrigger, gtk_keyval_trigger, GTK_TYPE_SHORTCUT_TRIGGER) enum { KEYVAL_PROP_KEYVAL = 1, KEYVAL_PROP_MODIFIERS, KEYVAL_N_PROPS }; static GParamSpec *keyval_props[KEYVAL_N_PROPS]; static GdkKeyMatch gtk_keyval_trigger_trigger (GtkShortcutTrigger *trigger, GdkEvent *event, gboolean enable_mnemonics) { GtkKeyvalTrigger *self = GTK_KEYVAL_TRIGGER (trigger); if (gdk_event_get_event_type (event) != GDK_KEY_PRESS) return GDK_KEY_MATCH_NONE; return gdk_key_event_matches (event, self->keyval, self->modifiers); } static guint gtk_keyval_trigger_hash (GtkShortcutTrigger *trigger) { GtkKeyvalTrigger *self = GTK_KEYVAL_TRIGGER (trigger); return (self->modifiers << 24) | (self->modifiers >> 8) | (self->keyval << 16) | GTK_SHORTCUT_TRIGGER_HASH_KEYVAL; } static int gtk_keyval_trigger_compare (GtkShortcutTrigger *trigger1, GtkShortcutTrigger *trigger2) { GtkKeyvalTrigger *self1 = GTK_KEYVAL_TRIGGER (trigger1); GtkKeyvalTrigger *self2 = GTK_KEYVAL_TRIGGER (trigger2); if (self1->modifiers != self2->modifiers) return self2->modifiers - self1->modifiers; return self1->keyval - self2->keyval; } static void gtk_keyval_trigger_print (GtkShortcutTrigger *trigger, GString *string) { GtkKeyvalTrigger *self = GTK_KEYVAL_TRIGGER (trigger); char *accelerator_name; accelerator_name = gtk_accelerator_name (self->keyval, self->modifiers); g_string_append (string, accelerator_name); g_free (accelerator_name); } static gboolean gtk_keyval_trigger_print_label (GtkShortcutTrigger *trigger, GdkDisplay *display, GString *string) { GtkKeyvalTrigger *self = GTK_KEYVAL_TRIGGER (trigger); gtk_accelerator_print_label (string, self->keyval, self->modifiers); return TRUE; } static void gtk_keyval_trigger_set_property (GObject *gobject, guint prop_id, const GValue *value, GParamSpec *pspec) { GtkKeyvalTrigger *self = GTK_KEYVAL_TRIGGER (gobject); switch (prop_id) { case KEYVAL_PROP_KEYVAL: { guint keyval = g_value_get_uint (value); /* We store keyvals as lower key */ if (keyval == GDK_KEY_ISO_Left_Tab) self->keyval = GDK_KEY_Tab; else self->keyval = gdk_keyval_to_lower (keyval); } break; case KEYVAL_PROP_MODIFIERS: self->modifiers = g_value_get_flags (value); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec); } } static void gtk_keyval_trigger_get_property (GObject *gobject, guint prop_id, GValue *value, GParamSpec *pspec) { GtkKeyvalTrigger *self = GTK_KEYVAL_TRIGGER (gobject); switch (prop_id) { case KEYVAL_PROP_KEYVAL: g_value_set_uint (value, self->keyval); break; case KEYVAL_PROP_MODIFIERS: g_value_set_flags (value, self->modifiers); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec); } } static void gtk_keyval_trigger_class_init (GtkKeyvalTriggerClass *klass) { GtkShortcutTriggerClass *trigger_class = GTK_SHORTCUT_TRIGGER_CLASS (klass); GObjectClass *gobject_class = G_OBJECT_CLASS (klass); gobject_class->set_property = gtk_keyval_trigger_set_property; gobject_class->get_property = gtk_keyval_trigger_get_property; trigger_class->trigger = gtk_keyval_trigger_trigger; trigger_class->hash = gtk_keyval_trigger_hash; trigger_class->compare = gtk_keyval_trigger_compare; trigger_class->print = gtk_keyval_trigger_print; trigger_class->print_label = gtk_keyval_trigger_print_label; /** * GtkKeyvalTrigger:keyval: (attributes org.gtk.Property.get=gtk_keyval_trigger_get_keyval) * * The key value for the trigger. */ keyval_props[KEYVAL_PROP_KEYVAL] = g_param_spec_uint (I_("keyval"), NULL, NULL, 0, G_MAXINT, 0, G_PARAM_STATIC_STRINGS | G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE); /** * GtkKeyvalTrigger:modifiers: (attributes org.gtk.Property.get=gtk_keyval_trigger_get_modifiers) * * The key modifiers for the trigger. */ keyval_props[KEYVAL_PROP_MODIFIERS] = g_param_spec_flags (I_("modifiers"), NULL, NULL, GDK_TYPE_MODIFIER_TYPE, 0, G_PARAM_STATIC_STRINGS | G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE); g_object_class_install_properties (gobject_class, KEYVAL_N_PROPS, keyval_props); } static void gtk_keyval_trigger_init (GtkKeyvalTrigger *self) { } /** * gtk_keyval_trigger_new: * @keyval: The keyval to trigger for * @modifiers: the modifiers that need to be present * * Creates a `GtkShortcutTrigger` that will trigger whenever * the key with the given @keyval and @modifiers is pressed. * * Returns: A new `GtkShortcutTrigger` */ GtkShortcutTrigger * gtk_keyval_trigger_new (guint keyval, GdkModifierType modifiers) { return g_object_new (GTK_TYPE_KEYVAL_TRIGGER, "keyval", keyval, "modifiers", modifiers, NULL); } /** * gtk_keyval_trigger_get_modifiers: (attributes org.gtk.Method.get_property=modifiers) * @self: a keyval `GtkShortcutTrigger` * * Gets the modifiers that must be present to succeed * triggering @self. * * Returns: the modifiers */ GdkModifierType gtk_keyval_trigger_get_modifiers (GtkKeyvalTrigger *self) { g_return_val_if_fail (GTK_IS_KEYVAL_TRIGGER (self), 0); return self->modifiers; } /** * gtk_keyval_trigger_get_keyval: (attributes org.gtk.Method.get_property=keyval) * @self: a keyval `GtkShortcutTrigger` * * Gets the keyval that must be pressed to succeed * triggering @self. * * Returns: the keyval */ guint gtk_keyval_trigger_get_keyval (GtkKeyvalTrigger *self) { g_return_val_if_fail (GTK_IS_KEYVAL_TRIGGER (self), 0); return self->keyval; } /*** GTK_MNEMONIC_TRIGGER ***/ struct _GtkMnemonicTrigger { GtkShortcutTrigger parent_instance; guint keyval; }; struct _GtkMnemonicTriggerClass { GtkShortcutTriggerClass parent_class; }; G_DEFINE_TYPE (GtkMnemonicTrigger, gtk_mnemonic_trigger, GTK_TYPE_SHORTCUT_TRIGGER) enum { MNEMONIC_PROP_KEYVAL = 1, MNEMONIC_N_PROPS }; static GParamSpec *mnemonic_props[MNEMONIC_N_PROPS]; static GdkKeyMatch gtk_mnemonic_trigger_trigger (GtkShortcutTrigger *trigger, GdkEvent *event, gboolean enable_mnemonics) { GtkMnemonicTrigger *self = GTK_MNEMONIC_TRIGGER (trigger); guint keyval; if (!enable_mnemonics) return GDK_KEY_MATCH_NONE; if (gdk_event_get_event_type (event) != GDK_KEY_PRESS) return GDK_KEY_MATCH_NONE; /* XXX: This needs to deal with groups */ keyval = gdk_key_event_get_keyval (event); if (keyval == GDK_KEY_ISO_Left_Tab) keyval = GDK_KEY_Tab; else keyval = gdk_keyval_to_lower (keyval); if (keyval != self->keyval) return GDK_KEY_MATCH_NONE; return GDK_KEY_MATCH_EXACT; } static guint gtk_mnemonic_trigger_hash (GtkShortcutTrigger *trigger) { GtkMnemonicTrigger *self = GTK_MNEMONIC_TRIGGER (trigger); return (self->keyval << 8) | GTK_SHORTCUT_TRIGGER_HASH_MNEMONIC; } static int gtk_mnemonic_trigger_compare (GtkShortcutTrigger *trigger1, GtkShortcutTrigger *trigger2) { GtkMnemonicTrigger *self1 = GTK_MNEMONIC_TRIGGER (trigger1); GtkMnemonicTrigger *self2 = GTK_MNEMONIC_TRIGGER (trigger2); return self1->keyval - self2->keyval; } static void gtk_mnemonic_trigger_print (GtkShortcutTrigger *trigger, GString *string) { GtkMnemonicTrigger *self = GTK_MNEMONIC_TRIGGER (trigger); const char *keyval_str; keyval_str = gdk_keyval_name (self->keyval); if (keyval_str == NULL) keyval_str = "???"; g_string_append (string, ""); g_string_append (string, keyval_str); } static gboolean gtk_mnemonic_trigger_print_label (GtkShortcutTrigger *trigger, GdkDisplay *display, GString *string) { GtkMnemonicTrigger *self = GTK_MNEMONIC_TRIGGER (trigger); const char *keyval_str; keyval_str = gdk_keyval_name (self->keyval); if (keyval_str == NULL) return FALSE; g_string_append (string, keyval_str); return TRUE; } static void gtk_mnemonic_trigger_set_property (GObject *gobject, guint prop_id, const GValue *value, GParamSpec *pspec) { GtkMnemonicTrigger *self = GTK_MNEMONIC_TRIGGER (gobject); switch (prop_id) { case MNEMONIC_PROP_KEYVAL: { guint keyval = g_value_get_uint (value); /* We store keyvals as lower key */ if (keyval == GDK_KEY_ISO_Left_Tab) self->keyval = GDK_KEY_Tab; else self->keyval = gdk_keyval_to_lower (keyval); } break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec); } } static void gtk_mnemonic_trigger_get_property (GObject *gobject, guint prop_id, GValue *value, GParamSpec *pspec) { GtkMnemonicTrigger *self = GTK_MNEMONIC_TRIGGER (gobject); switch (prop_id) { case MNEMONIC_PROP_KEYVAL: g_value_set_uint (value, self->keyval); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec); } } static void gtk_mnemonic_trigger_class_init (GtkMnemonicTriggerClass *klass) { GtkShortcutTriggerClass *trigger_class = GTK_SHORTCUT_TRIGGER_CLASS (klass); GObjectClass *gobject_class = G_OBJECT_CLASS (klass); gobject_class->set_property = gtk_mnemonic_trigger_set_property; gobject_class->get_property = gtk_mnemonic_trigger_get_property; trigger_class->trigger = gtk_mnemonic_trigger_trigger; trigger_class->hash = gtk_mnemonic_trigger_hash; trigger_class->compare = gtk_mnemonic_trigger_compare; trigger_class->print = gtk_mnemonic_trigger_print; trigger_class->print_label = gtk_mnemonic_trigger_print_label; /** * GtkMnemonicTrigger:keyval: (attributes org.gtk.Property.get=gtk_mnemonic_trigger_get_keyval) * * The key value for the trigger. */ mnemonic_props[KEYVAL_PROP_KEYVAL] = g_param_spec_uint (I_("keyval"), NULL, NULL, 0, G_MAXINT, 0, G_PARAM_STATIC_STRINGS | G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE); g_object_class_install_properties (gobject_class, MNEMONIC_N_PROPS, mnemonic_props); } static void gtk_mnemonic_trigger_init (GtkMnemonicTrigger *self) { } /** * gtk_mnemonic_trigger_new: * @keyval: The keyval to trigger for * * Creates a `GtkShortcutTrigger` that will trigger whenever the key with * the given @keyval is pressed and mnemonics have been activated. * * Mnemonics are activated by calling code when a key event with the right * modifiers is detected. * * Returns: (transfer full) (type GtkMnemonicTrigger): A new `GtkShortcutTrigger` */ GtkShortcutTrigger * gtk_mnemonic_trigger_new (guint keyval) { return g_object_new (GTK_TYPE_MNEMONIC_TRIGGER, "keyval", keyval, NULL); } /** * gtk_mnemonic_trigger_get_keyval: (attributes org.gtk.Method.get_property=keyval) * @self: a mnemonic `GtkShortcutTrigger` * * Gets the keyval that must be pressed to succeed triggering @self. * * Returns: the keyval */ guint gtk_mnemonic_trigger_get_keyval (GtkMnemonicTrigger *self) { g_return_val_if_fail (GTK_IS_MNEMONIC_TRIGGER (self), 0); return self->keyval; } /*** GTK_ALTERNATIVE_TRIGGER ***/ struct _GtkAlternativeTrigger { GtkShortcutTrigger parent_instance; GtkShortcutTrigger *first; GtkShortcutTrigger *second; }; struct _GtkAlternativeTriggerClass { GtkShortcutTriggerClass parent_class; }; G_DEFINE_TYPE (GtkAlternativeTrigger, gtk_alternative_trigger, GTK_TYPE_SHORTCUT_TRIGGER) enum { ALTERNATIVE_PROP_FIRST = 1, ALTERNATIVE_PROP_SECOND, ALTERNATIVE_N_PROPS }; static GParamSpec *alternative_props[ALTERNATIVE_N_PROPS]; static void gtk_alternative_trigger_dispose (GObject *gobject) { GtkAlternativeTrigger *self = GTK_ALTERNATIVE_TRIGGER (gobject); g_clear_object (&self->first); g_clear_object (&self->second); G_OBJECT_CLASS (gtk_alternative_trigger_parent_class)->dispose (gobject); } static GdkKeyMatch gtk_alternative_trigger_trigger (GtkShortcutTrigger *trigger, GdkEvent *event, gboolean enable_mnemonics) { GtkAlternativeTrigger *self = GTK_ALTERNATIVE_TRIGGER (trigger); return MAX (gtk_shortcut_trigger_trigger (self->first, event, enable_mnemonics), gtk_shortcut_trigger_trigger (self->second, event, enable_mnemonics)); } static guint gtk_alternative_trigger_hash (GtkShortcutTrigger *trigger) { GtkAlternativeTrigger *self = GTK_ALTERNATIVE_TRIGGER (trigger); guint result; result = gtk_shortcut_trigger_hash (self->first); result <<= 5; result |= gtk_shortcut_trigger_hash (self->second); result <<= 5; return result | GTK_SHORTCUT_TRIGGER_HASH_ALTERNATIVE; } static int gtk_alternative_trigger_compare (GtkShortcutTrigger *trigger1, GtkShortcutTrigger *trigger2) { GtkAlternativeTrigger *self1 = GTK_ALTERNATIVE_TRIGGER (trigger1); GtkAlternativeTrigger *self2 = GTK_ALTERNATIVE_TRIGGER (trigger2); int cmp; cmp = gtk_shortcut_trigger_compare (self1->first, self2->first); if (cmp != 0) return cmp; return gtk_shortcut_trigger_compare (self1->second, self2->second); } static void gtk_alternative_trigger_print (GtkShortcutTrigger *trigger, GString *string) { GtkAlternativeTrigger *self = GTK_ALTERNATIVE_TRIGGER (trigger); gtk_shortcut_trigger_print (self->first, string); g_string_append (string, "|"); gtk_shortcut_trigger_print (self->second, string); } static gboolean gtk_alternative_trigger_print_label (GtkShortcutTrigger *trigger, GdkDisplay *display, GString *string) { GtkAlternativeTrigger *self = GTK_ALTERNATIVE_TRIGGER (trigger); if (gtk_shortcut_trigger_print_label (self->first, display, string)) { g_string_append (string, ", "); if (!gtk_shortcut_trigger_print_label (self->second, display, string)) g_string_truncate (string, string->len - 2); return TRUE; } else { return gtk_shortcut_trigger_print_label (self->second, display, string); } } static void gtk_alternative_trigger_set_property (GObject *gobject, guint prop_id, const GValue *value, GParamSpec *pspec) { GtkAlternativeTrigger *self = GTK_ALTERNATIVE_TRIGGER (gobject); switch (prop_id) { case ALTERNATIVE_PROP_FIRST: self->first = g_value_dup_object (value); break; case ALTERNATIVE_PROP_SECOND: self->second = g_value_dup_object (value); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec); } } static void gtk_alternative_trigger_get_property (GObject *gobject, guint prop_id, GValue *value, GParamSpec *pspec) { GtkAlternativeTrigger *self = GTK_ALTERNATIVE_TRIGGER (gobject); switch (prop_id) { case ALTERNATIVE_PROP_FIRST: g_value_set_object (value, self->first); break; case ALTERNATIVE_PROP_SECOND: g_value_set_object (value, self->second); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec); } } static void gtk_alternative_trigger_constructed (GObject *gobject) { GtkAlternativeTrigger *self = GTK_ALTERNATIVE_TRIGGER (gobject); if (self->first == NULL || self->second == NULL) { g_critical ("Invalid alternative trigger, disabling"); self->first = g_object_ref (gtk_never_trigger_get ()); self->second = g_object_ref (gtk_never_trigger_get ()); } G_OBJECT_CLASS (gtk_alternative_trigger_parent_class)->constructed (gobject); } static void gtk_alternative_trigger_class_init (GtkAlternativeTriggerClass *klass) { GtkShortcutTriggerClass *trigger_class = GTK_SHORTCUT_TRIGGER_CLASS (klass); GObjectClass *gobject_class = G_OBJECT_CLASS (klass); gobject_class->constructed = gtk_alternative_trigger_constructed; gobject_class->set_property = gtk_alternative_trigger_set_property; gobject_class->get_property = gtk_alternative_trigger_get_property; gobject_class->dispose = gtk_alternative_trigger_dispose; trigger_class->trigger = gtk_alternative_trigger_trigger; trigger_class->hash = gtk_alternative_trigger_hash; trigger_class->compare = gtk_alternative_trigger_compare; trigger_class->print = gtk_alternative_trigger_print; trigger_class->print_label = gtk_alternative_trigger_print_label; /** * GtkAlternativeTrigger:first: (attributes org.gtk.Property.get=gtk_alternative_trigger_get_first) * * The first `GtkShortcutTrigger` to check. */ alternative_props[ALTERNATIVE_PROP_FIRST] = g_param_spec_object (I_("first"), NULL, NULL, GTK_TYPE_SHORTCUT_TRIGGER, G_PARAM_STATIC_STRINGS | G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE); /** * GtkAlternativeTrigger:second: (attributes org.gtk.Property.get=gtk_alternative_trigger_get_second) * * The second `GtkShortcutTrigger` to check. */ alternative_props[ALTERNATIVE_PROP_SECOND] = g_param_spec_object (I_("second"), NULL, NULL, GTK_TYPE_SHORTCUT_TRIGGER, G_PARAM_STATIC_STRINGS | G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE); g_object_class_install_properties (gobject_class, ALTERNATIVE_N_PROPS, alternative_props); } static void gtk_alternative_trigger_init (GtkAlternativeTrigger *self) { } /** * gtk_alternative_trigger_new: * @first: (transfer full): The first trigger that may trigger * @second: (transfer full): The second trigger that may trigger * * Creates a `GtkShortcutTrigger` that will trigger whenever * either of the two given triggers gets triggered. * * Note that nesting is allowed, so if you want more than two * alternative, create a new alternative trigger for each option. * * Returns: a new `GtkShortcutTrigger` */ GtkShortcutTrigger * gtk_alternative_trigger_new (GtkShortcutTrigger *first, GtkShortcutTrigger *second) { GtkShortcutTrigger *res; g_return_val_if_fail (GTK_IS_SHORTCUT_TRIGGER (first), NULL); g_return_val_if_fail (GTK_IS_SHORTCUT_TRIGGER (second), NULL); res = g_object_new (GTK_TYPE_ALTERNATIVE_TRIGGER, "first", first, "second", second, NULL); g_object_unref (first); g_object_unref (second); return res; } /** * gtk_alternative_trigger_get_first: (attributes org.gtk.Method.get_property=first) * @self: an alternative `GtkShortcutTrigger` * * Gets the first of the two alternative triggers that may * trigger @self. * * [method@Gtk.AlternativeTrigger.get_second] will return * the other one. * * Returns: (transfer none): the first alternative trigger */ GtkShortcutTrigger * gtk_alternative_trigger_get_first (GtkAlternativeTrigger *self) { g_return_val_if_fail (GTK_IS_ALTERNATIVE_TRIGGER (self), NULL); return self->first; } /** * gtk_alternative_trigger_get_second: (attributes org.gtk.Method.get_property=second) * @self: an alternative `GtkShortcutTrigger` * * Gets the second of the two alternative triggers that may * trigger @self. * * [method@Gtk.AlternativeTrigger.get_first] will return * the other one. * * Returns: (transfer none): the second alternative trigger */ GtkShortcutTrigger * gtk_alternative_trigger_get_second (GtkAlternativeTrigger *self) { g_return_val_if_fail (GTK_IS_ALTERNATIVE_TRIGGER (self), NULL); return self->second; }