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

    AccessibilityLabelLabel used by the macOS accessibility manager for various of disability settings and devices.
    BorderColorSets the border color of the Gauge.
    ClickableIf set to true then the Gauge is clickable like a button.
    DMBorderColorSets the border color of the Gauge when the system is in dark mode.
    DMDownColorSets 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)
    DMGaugeColorSets the color of main body on the Gauge when the system is in dark mode.
    DMHighLimitColorSets the color of the high limit when in dark mode.
    DMLargeTickColorSets the color of the large ticks when in dark mode.
    DMLowLimitColorSets the color of the low limit when in dark mode.
    DMMediumLimitColorSets the color of the medium limit when in dark mode.
    DMNeedleColorSets the color of the needle on the Gauge when in Dark mode..
    DMSmallTickColorSets the color of the small ticks when in dark mode.
    DMTextColorSets the text color of the Gauge when the system is in dark mode.
    DoubleBufferDoubleBuffers the drawing of the control on Windows systems. (MacOS X and Linux systems are always double buffered by the OS it self)
    DownColorSets 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.
    FormatValueProperty used to determine how the value on the Gauge is formatted.
    FormatValueMaskSets format mask for the value part in what is displayed for the Gauge value.
    GaugeColorSets 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.
    HighLimitSets value for where high limit starts.
    HighLimitColorSets the color of the high limit.
    HighValueLabelShort label to display at the Gauge max value.
    IconSets 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.
    LargeIf set to true then Gauge will be slightly larger version.
    LargeTickColorSets the color of the large ticks.
    LargeTickCountSets the number of large ticks.
    Left (Inherited) The left side of the control in local coordinates (relative to the window)
    LowLimitSets value for where low limit ends.
    LowLimitColorSets the color of the low limit.
    LowValueLabelShort label to display at the Gauge min value.
    MaxValueSets or gets the maximum value of the gauge.
    MediumLimitColorSets the color of the medium limit.
    MinValueSets or gets the minimum value of the gauge.
    NeedleColorSets the color of the needle on the Gauge.
    ShowLargeTicksToggles large ticks on and off.
    ShowLimitBarToggles visibility of the limit bar.
    ShowSmallTicksToggles small ticks on and off.
    SmallTickColorSets the color of the small ticks.
    SmallTickCountSets the number of small ticks.
    TextColorSets the text color for the Gauge.
    Top (Inherited) The top of the control in local coordinates (relative to the window).
    ValueSets 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.
    GetOptimalWidthReturns optimal width of the control for the text and settings that have been assigned to it.
    ReloadEventsReloads 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.
    FocusLostInherited from parent class but Gauge control is not focusable control.
    FocusReceivedInherited 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.
    MouseDownThis event is fired when Mouse is pressed down on the control.
    MouseDragFires when mouse is dragged within the control.
    MouseEnterThis event is fired when the mouse enters the control.
    MouseExitThis event is fired when the mouse exits the control.
    MouseMoveThis event is fired when the mouse moves within the control.
    MouseUpFires when mouse button goes up within the control.
    MouseWheel (Inherited) The mouse wheel has been moved.
    PressedThis 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