GaugeControl Xojo Plugin |

# DesktopGaugeControl Control

A control to display gauges in your desktop applications.
GaugeControl supports:
- Extensive dark and light mode theme styling
- Min max settings.
- 3 levels of optional limit bars.
- Fine grade control over tick marks
- Can be clickable like button.
- Extensive support for Apple accessibility features for visually impaired and people with other some disabilities.
- Two sizes, normal and large.
- Optional icon.
- Custom formatting of value label.

DesktopUIControl
DesktopGaugeControl

control DesktopGaugeControl

#### Properties

AccessibilityLabel | Label used by the macOS accessibility manager for various of disability settings and devices.
BorderColor | Sets the border color of the Gauge.
Clickable | If set to true then the Gauge is clickable like a button.
DMBorderColor | Sets the border color of the Gauge when the system is in dark mode.
DMDownColor | Sets the dark mode color for the body of the Gauge when mouse is pressed down on it. (Applies only if the gauge has been set to be clickable)
DMGaugeColor | Sets the color of main body on the Gauge when the system is in dark mode.
DMHighLimitColor | Sets the color of the high limit when in dark mode.
DMLargeTickColor | Sets the color of the large ticks when in dark mode.
DMLowLimitColor | Sets the color of the low limit when in dark mode.
DMMediumLimitColor | Sets the color of the medium limit when in dark mode.
DMNeedleColor | Sets the color of the needle on the Gauge when in Dark mode..
DMSmallTickColor | Sets the color of the small ticks when in dark mode.
DMTextColor | Sets the text color of the Gauge when the system is in dark mode.
DoubleBuffer | DoubleBuffers the drawing of the control on Windows systems. (MacOS X and Linux systems are always double buffered by the OS it self)
DownColor | Sets the color for the body of the Gauge when mouse is pressed down on it. (Applies only if the gauge has been set to be clickable)
Enabled (Inherited) | Determines if the control should be enabled when the owning window is opened.
FormatValue | Property used to determine how the value on the Gauge is formatted.
FormatValueMask | Sets format mask for the value part in what is displayed for the Gauge value.
GaugeColor | Sets the color of main body on the Gauge.
Handle (Inherited) | Returns a handle to the control.
Height (Inherited) | The height (in points) of the control.
HighLimit | Sets value for where high limit starts.
HighLimitColor | Sets the color of the high limit.
HighValueLabel | Short label to display at the Gauge max value.
Icon | Sets or gets icon for the control.
Index (Inherited) | If the control is used in a control set, this specifies the control's index in the set.
Large | If set to true then Gauge will be slightly larger version.
LargeTickColor | Sets the color of the large ticks.
LargeTickCount | Sets the number of large ticks.
Left (Inherited) | The left side of the control in local coordinates (relative to the window)
LowLimit | Sets value for where low limit ends.
LowLimitColor | Sets the color of the low limit.
LowValueLabel | Short label to display at the Gauge min value.
MaxValue | Sets or gets the maximum value of the gauge.
MediumLimitColor | Sets the color of the medium limit.
MinValue | Sets or gets the minimum value of the gauge.
NeedleColor | Sets the color of the needle on the Gauge.
ShowLargeTicks | Toggles large ticks on and off.
ShowLimitBar | Toggles visibility of the limit bar.
ShowSmallTicks | Toggles small ticks on and off.
SmallTickColor | Sets the color of the small ticks.
SmallTickCount | Sets the number of small ticks.
TextColor | Sets the text color for the Gauge.
Top (Inherited) | The top of the control in local coordinates (relative to the window).
Value | Sets or gets the value of the gauge.
Visible (Inherited) | Determines whether the control is visible when its owning window is opened. The default is True: the control is visible.
Width (Inherited) | The width (in points) of the control.
Window (Inherited) | The control's parent window.

#### Methods

Close (Inherited) | Closes a control.
GetOptimalWidth | Returns optimal width of the control for the text and settings that have been assigned to it.
ReloadEvents | Reloads events if having used AddHandler to subscribe events.
SetFocus (Inherited) | If applicable, sets the focus to the DesktopUIControl. KeyDown events are directed to the control.

#### Events

Closing (Inherited) | The control is about to close.
ConstructContextualMenu (Inherited) | This event is called when it is appropriate to display a contextual menu for the control.
ContextualMenuItemSelected (Inherited) | Fires when a contextual menuitem selectedItem was selected but the MenuItemSelected event and the MenuHandler for the DesktopMenuItem did not handle the menu selection.
DragEnter (Inherited) | Fires when the passed DragItem enters the DesktopUIControl.
DragExit (Inherited) | Fires when the passed DragItem exits the DesktopUIControl.
DragOver (Inherited) | Fires when the DragItem is over the DesktopUIControl.
DropObject (Inherited) | The item represented by Obj has been dropped on the control.
FocusLost | Inherited from parent class but Gauge control is not focusable control.
FocusReceived | Inherited from parent class but Gauge control is not focusable control.
KeyDown (Inherited) | The user has pressed the Key passed while the control has the focus.
KeyUp (Inherited) | Fires when the passed Key is released in the control that has the focus.
MouseDown | This event is fired when Mouse is pressed down on the control.
MouseDrag | Fires when mouse is dragged within the control.
MouseEnter | This event is fired when the mouse enters the control.
MouseExit | This event is fired when the mouse exits the control.
MouseMove | This event is fired when the mouse moves within the control.
MouseUp | Fires when mouse button goes up within the control.
MouseWheel (Inherited) | The mouse wheel has been moved.
Pressed | This event is fired when the Gauge has been clicked when the Gauge is in clickable mode or if macOS accessibility manager calls for click when Gauge is in clickable mode.

#### Constants

Version = 1.0 |

#### Supported Platforms:

- macOS Intel 64 bit
- macOS Apple Silicon
- Windows 32 bit
- Windows 64 bit
- Windows ARM 64 bit
- Linux 32 bit
- Linux 64 bit
- Linux ARM 32 bit
- Linux ARM 64 bit

#### Unsupported Platforms:

- macOS Intel 32 bit