Differences

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

--- mistudio:design_editor:basic_layout:text_fields:doubletextfield [2026/09/18 13:35] – removed - external edit (Unknown date) 127.0.0.1
+++ mistudio:design_editor:basic_layout:text_fields:doubletextfield [2026/09/18 15:16] (current) – tputman
@@ Line 1: / Line 1: @@
+===== DoubleTextField =====
+com.ergotech.vib.graphics.swing.DoubleTextField
+==== Image Examples ====
+| {{:mistudio:graphics:basic_layout:text_fields:pasted:20260622-170517.png?40|DoubleTextField in the graphics palette}} | {{:mistudio:graphics:basic_layout:text_fields:pasted:20260622-171710.png?100|DoubleTextField graphic example}} |
+| //DoubleTextField in the graphics palette.// | //DoubleTextField graphic example.// |
+==== Overview ====
+The DoubleTextField graphic is a Basic Layout text field graphic used to display or enter decimal numeric values.
+DoubleTextField is a formatted text field for float or decimal-style numbers. Only values between the configured **Minimum Value** and **Maximum Value** may be entered, and the number of decimal places is controlled by the **Decimal Places** property.
+DoubleTextField shares common properties with other Basic Layout text field graphics. See [[mistudio:design_editor:basic_layout:text_fields:text_field_common_properties|Text Field Common Properties]] for shared font, color, editable, enabled, background, visibility, and data source behavior.
+==== Common Uses ====
+  * Displaying decimal numeric values
+  * Entering decimal values
+  * Setting numeric values with decimal places
+  * Showing values from a numeric data source
+  * Sending numeric values into application logic
+==== Input Behavior ====
+The DoubleTextField display can be updated from an input connection.
+This can be useful when the DoubleTextField needs to show a numeric value from a data source, calculation, or another logic component.
+==== Output Behavior ====
+DoubleTextField sends the entered number as a **Double Value Object**.
+This allows the entered or displayed decimal value to be used by other logic components.
+==== DoubleTextField-Specific Behavior ====
+DoubleTextField is designed for decimal-style numeric values.
+DoubleTextField-specific settings may include:
+  * **Decimal Places** Sets how many decimal places are used.
+  * **Minimum Value** Sets the lowest value allowed.
+  * **Maximum Value** Sets the highest value allowed.
+  * **Horizontal Alignment** Controls how the value is aligned inside the field.
+  * **Cursor Color** Sets the cursor color.
+  * **Selected Text Color** Sets the selected text color.
+  * **Selection Color** Sets the background color used for selected text.
+==== Logic Ports ====
+In the Logic Editor, DoubleTextField may include ports such as:
+  * **PrimaryOutPort**
+  * **updateDisplayedValue**
+The exact available ports may depend on the current MIStudio version and configuration.
+==== Notes ====
+Use DoubleTextField when decimal values are needed.
+For whole-number values, see [[mistudio:design_editor:basic_layout:text_fields:integertextfield|IntegerTextField]].
+For shared text field settings, see [[mistudio:design_editor:basic_layout:text_fields:text_field_common_properties|Text Field Common Properties]].
+For general graphic behavior, see [[mistudio:design_editor:active_graphic|Active Graphic]].
+==== Related Pages ====
+  * [[mistudio:design_editor:start|MIStudio Design Editor]]
+  * [[mistudio:design_editor:basic_layout:start|Basic Layout]]
+  * [[mistudio:design_editor:basic_layout:text_fields:start|Text Fields]]
+  * [[mistudio:design_editor:basic_layout:text_fields:text_field_common_properties|Text Field Common Properties]]
+  * [[mistudio:design_editor:basic_layout:text_fields:textarea|TextArea]]
+  * [[mistudio:design_editor:basic_layout:text_fields:textfield|TextField]]
+  * [[mistudio:design_editor:basic_layout:text_fields:integertextfield|IntegerTextField]]
+  * [[mistudio:design_editor:active_graphic|Active Graphic]]