class Fox::FXDial

The Dial widget is a valuator widget which is able to provide a cyclic value range when the DIAL_CYCLIC is passed, or a simple linear value range. While being turned, the dial sends a SEL_CHANGED message to its target; at the end of the interaction, a SEL_COMMAND message is sent. The message data represents the current value (an integer). The options DIAL_VERTICAL and DIAL_HORIZONTAL control the orientation of the dial. An optional notch can be used to indicate the zero-position of the dial; display of the notch is controlled by the DIAL_HAS_NOTCH option.

Events

The following messages are sent by FXDial to its target:

SEL_KEYPRESS

sent when a key goes down; the message data is an FXEvent instance.

SEL_KEYRELEASE

sent when a key goes up; the message data is an FXEvent instance.

SEL_LEFTBUTTONPRESS

sent when the left mouse button goes down; the message data is an FXEvent instance.

SEL_LEFTBUTTONRELEASE

sent when the left mouse button goes up; the message data is an FXEvent instance.

SEL_CHANGED

sent when the dial’s value changes; the message data is the new value (an integer).

SEL_COMMAND

sent when the user stops changing the dial’s value and releases the mouse button; the message data is the new value (an integer).

Dial style options

DIAL_VERTICAL

Vertically oriented

DIAL_HORIZONTAL

Horizontal oriented

DIAL_CYCLIC

Value wraps around

DIAL_HAS_NOTCH

Dial has a Center Notch

DIAL_NORMAL

same a DIAL_VERTICAL