This enum is used with the function
gdk-keymap-modifier-mask 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.
(define-g-enum "GdkModifierIntent" gdk-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))
- :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. AltGr on X11/Windows and Option/Alt on OS X.
- :default-mod-mask
- The set of modifier masks accepted as modifiers
in accelerators. Needed because Command is mapped to MOD2 on OSX, which
is widely used, but on X11 MOD2 is NumLock and using that for a mod key is problematic at best.