Blitz3D+ Command Reference

HotKeyFieldModifiers ( hotkey )

Parameters

hotkey - hotkey field gadget

Description

Returns the modifier bits captured by a hotkey field: Shift 1, Control 2, Alt 4.

Requires Extended language mode.

Reads the modifier half of the combination in a hotkey field, as added-together bits - Ctrl+Shift gives 3, a bare key gives 0. It is the same contract HotKeyEvent and SetHotKeyField use, so the value passes straight through:

key=HotKeyFieldKey(field)
If key<>0 Then HotKeyEvent key,HotKeyFieldModifiers(field),EV_DO_THING

Check individual keys with And - If HotKeyFieldModifiers(field) And 2 tests for Control.

The query is silent; it posts no events. When the user changes the field, the field posts a critical $401 carrying these same modifier bits in EventX, with the raw key in EventData.

See it working in the native input controls sample.

See also: HotKeyFieldKey, CreateHotKeyField, SetHotKeyField, HotKeyEvent.

Index