KUIML Widget User Experience

Keyboard Focus

If the auto_focus attribute is set to true, the control gains focus when the mouse hovers over it. If set to false, the user must click on the control to grant it focus and enable keyboard interaction.

Keys

All control widgets support the following keys (note: in audio plug-ins, some keys may be intercepted by the host application):

Key	Action
Up Arrow	Small increment of the position (up or right)
Down Arrow	Small decrement of the position (down or left)
Left Arrow	Same as Down Arrow
Right Arrow	Same as Up Arrow
Page Up	Large increment of the position (up or right)
Page Down	Large decrement of the position (down or left)
+	Small increment of the control's value
-	Small decrement of the control's value
d	Set to default value (same as right-click)
e	Open the fine edit popup window
SHIFT	Fine tuning mode for precise control

Button-Specific Key

Key	Action
Enter	Pushes the button

Disabling default keys

Notice that all widgets have "default_keys_enabled" attribute that allows you to enable only selected default keys.

Mouse Interactions

The mouse has an influence over a control only when it is over its active part, defined by its mouse_mask (default is the entire bounding rectangle of the control).

When over the active area of a control, the mouse will do the following:

Mouse Event	Action
Left Click	Acquire focus and start dragging or push (button)
Alt + Click	Set the value to default (the Alt modifier can also be changed to Control) via reset_modifier_key="ctrl" (see Param Controls).
Left Double Click	Acquire focus and launch the fine tuning edit window (except for button)
Right Click	Set the value to default
Mouse Wheel	Increment or decrement the position
Mouse Drag	Change the control position depending on mouse movement (except button)

Comments

Please, authorize to view and post comments.