Differences

This shows you the differences between two versions of the page.

--- mistudio:design_editor:more_layout:status_motion:spinner [2026/09/18 13:37] – removed - external edit (Unknown date) 127.0.0.1
+++ mistudio:design_editor:more_layout:status_motion:spinner [2026/09/18 15:41] (current) – tputman
@@ Line 1: / Line 1: @@
+===== Spinner =====
+com.ergotech.vib.graphics.swing.SwingSpinner
+==== Image Examples ====
+| {{:mistudio:graphics:more_layout:status_motion:pasted:20260701-093339.png?30|Spinner in the graphics palette}} | {{:mistudio:graphics:more_layout:status_motion:pasted:20260701-093432.png?40|Spinner graphic example}} |
+| //Spinner in the graphics palette.// | //Spinner graphic example.// |
+==== Overview ====
+The Spinner graphic is a More Layout input control used to select or enter an integer value.
+A user can change the value by clicking the spinner controls or by entering a value in the display area.
+Spinner limits the selected value between the configured **Low Value** and **High Value**.
+==== Common Uses ====
+  * Entering an integer value
+  * Incrementing or decrementing a value
+  * Setting a numeric value within a range
+  * Sending user input into application logic
+  * Creating operator input controls
+  * Updating another display or logic component
+==== Input Behavior ====
+Spinner accepts input through **updateDisplayedValue**.
+The input can come from a data source, Constant, or another logic component.
+The input updates the displayed Spinner value.
+If the input value is higher than **High Value**, the Spinner displays the high value. If the input value is lower than **Low Value**, the Spinner displays the low value.
+==== Output Behavior ====
+Spinner sends its current value through **PrimaryOutPort**.
+The **PrimaryOutPort** can be connected to another logic component.
+This allows the Spinner value to be used as user input for another part of the application.
+A new output value is generated when the user changes the Spinner value.
+==== Spinner-Specific Behavior ====
+Spinner is designed for integer value input.
+Spinner-specific settings include:
+  * **Name** Sets the name of the Spinner graphic.
+  * **Enabled** Controls whether the user can interact with the Spinner.
+  * **Font** Controls the font used by the Spinner.
+  * **High Value** Sets the maximum allowed value.
+  * **Low Value** Sets the minimum allowed value.
+  * **Text Color** Sets the display text color.
+  * **Background Color** Sets the Spinner background color.
+  * **Visible** Controls whether the Spinner is shown.
+==== Logic Ports ====
+In the Logic Editor, Spinner includes these default ports:
+  * **PrimaryOutPort**
+  * **updateDisplayedValue**
+The **PrimaryOutPort** sends the current Spinner value.
+The **updateDisplayedValue** port updates the displayed Spinner value from a data source, Constant, or another logic component.
+==== Range Behavior ====
+Spinner uses **Low Value** and **High Value** to limit the value that can be displayed or output.
+For example, with **Low Value** set to `0.0` and **High Value** set to `100.0`, the Spinner value is limited to that range.
+If a decimal value is entered, Spinner uses the integer value.
+==== Notes ====
+Use Spinner when a user needs to enter or adjust an integer value.
+Use [[mistudio:design_editor:more_layout:buttons_inputs:slider|Slider]] when the user should select a value by moving a slider.
+Use [[mistudio:design_editor:more_layout:status_motion:progressbar|ProgressBar]] when a value should be shown as progress instead of edited by the user.
+For general graphic behavior, see [[mistudio:design_editor:active_graphic|Active Graphic]].
+==== Related Pages ====
+  * [[mistudio:design_editor:start|MIStudio Design Editor]]
+  * [[mistudio:design_editor:more_layout:start|More Layout]]
+  * [[mistudio:design_editor:more_layout:status_motion:start|Status, Motion, and Process Graphics]]
+  * [[mistudio:design_editor:more_layout:buttons_inputs:slider|Slider]]
+  * [[mistudio:design_editor:more_layout:status_motion:progressbar|ProgressBar]]
+  * [[mistudio:design_editor:active_graphic|Active Graphic]]