Package: gdk

GEnum gdk:modifier-intent

Declaration

(gobject:define-genum "GdkModifierIntent" modifier-intent
  (:export t
   :type-initializer "gdk_modifier_intent_get_type")
  (:primary-accelerator 0)
  (:context-menu 1)
  (:extend-selection 2)
  (:modify-selection 3)
  (:no-text-input 4)
  (:shift-group 5)
  (:default-mod-mask 6))

Values

:primary-accelerator
The primary modifier used to invoke menu accelerators.
:context-menu
The modifier used to invoke context menus. Note that mouse button 3 always triggers context menus. When this modifier is not 0, it additionally triggers context menus when used with mouse button 1.
:extend-selextion
The modifier used to extend selections using <modifier>-click or <modifier>-cursor-key.
:modify-selection
The modifier used to modify selections, which in most cases means toggling the clicked item into or out of the selection.
:no-text-input
When any of these modifiers is pressed, the key event cannot produce a symbol directly. This is meant to be used for input methods, and for use cases like typeahead search.
:shift-group
The modifier that switches between keyboard groups, the AltGr key on X11/Windows and the Option/Alt key on OS X.
:default-mod-mask
The set of modifier masks accepted as modifiers in accelerators. Needed because the Command key is mapped to MOD2 on OSX, which is widely used, but on X11 MOD2 is the NumLock key and using that for a mod key is problematic at best.

Details

This enumeration is used with the gdk:keymap-modifier-mask function in order to determine what modifiers the currently used windowing system backend uses for particular purposes. For example, on X11/Windows, the Control key is used for invoking menu shortcuts (accelerators), whereas on Apple computers it is the Command key, which correspond to the :control-mask and :mod2-mask values of the gdk:modifier-type flags, respectively.
 

See also

gdk:modifier-type
gdk:keymap-modifier-mask
2025-08-23