Text Object

Note: For Canvas Series see Text Label for Canvas

See also: User Interface

See also: Graphic Object Toolbox

 

Topic Menu

Overview of the Text Object

Used to display text anywhere on-screen. Text [Static Text] can be accessed through the Home > Project Toolbox > Fixed Objects > Text Label. User must be on a Screen and not in the Main work area in order to see the Objects Project Toolbox items.

 

Text Object Configuration

Selecting Text graphic object, displays the following Static Text Properties window:

Text -This field is used to configure the actual text to be displayed on screen. Object will auto-wrap wide lines to fit object. If vertical or horizontal space is insufficient, excess legend text is truncated or in case of enhanced graphics, text displays “…” at the end indicating there is text that is not displayed.

Justification - Specifies the location of the caption in the bounding rectangle.

Vertical Text - If vertical Text is selected, text is placed in a vertical row. (Return is placed after each character). Text too long to fix within the object (that does not contain returns) is automatically ’wrapped’ to produce multiple lines. If vertical or horizontal space is insufficient, excess legend text is truncated or in case of enhanced graphics, text displays “…” at the end indicating there is text that is not displayed.

3D Snken /3D Raised - Gives the bounding rectangle border the 3D appearance of being sunken or raised on the screen.

Insert Special Char >>> - Selecting this option displays the following window wherein user can select different fonts/special characters available to be added.

 

Display Properties for Text

Attributes >>>

Static

Visible

  • Non-touch units* - all objects are always visible, so as a result both the static and dynamic override fields will be grayed out.

  • Touch units** - the visibility attribute may be set as static or dynamic.

  • *Non-touch units include X2, XLE, and XLEe.

    **Touch Units include all XL series, Prime Series, and Micro OCS series controllers.

  • When the attribute is statically set to ON, the object is always visible and always responds to touch signals.

  • When the attribute is statically set invisible (unchecked) the object is not drawn but if the object is the front most object it responds to touch signals. For example, placing a statically invisible screen jump object in front of a bitmap allows the bitmap to be drawn but touching the location of the invisible screen jump causes the screen jump action to be performed.

  • When this attribute is dynamically enabled the visibility of the object is controlled by the associated bit in the override register. When the bit is ON the object is drawn and operates normally. When the bit is OFF the object is not drawn and does respond to any touch signals.

Flash – When statically set, an object will ’Flash’ the data display continuously or the animation ICON when the associated control register is in the ON state. When dynamically overridden, a three-state display can be created: OFF, ON solid and ON flash, depending both on the state of the control register and the Override Register.

Border – This attribute, available only statically, provides a decorative border (rectangle) drawn around the inside of the objects bounding rectangle. This border is typically removed to allow either a more elaborate border to be drawn with the drawing primitives or no border at all.

Enable Input – This attribute, optionally available only as dynamically overridden, allows the object or the object editor to ignore keystrokes directed to that object. This allows run-time determination on whether to restrict input access to that object. This allows the user to create operator privilege or in-motion lockout of object modification. If this box is NOT checked, the associated object always accepts input.

Color – This attribute allows some objects to dynamically change colors. Up to four additional colors can be selected for an object. If none of the color attribute override bits are set the object defaults to the color chosen in the main object properties.

 

Dynamic

Color – This attribute allows some objects to dynamically change colors. Up to four additional colors can be selected for an object. If none of the color attribute override bits are set the object defaults to the color chosen in the main object properties.

 

Text Color >>>

Selecting Color>>> option displays the Color Picker dialog for user to select the color and this will be applied to the text.

 

Color Picker

Selecting More >>> displays the following window allowing user to select color apart from default colors available in the above displayed color picker window.

 

Background>>>

Selecting Background>>> option displays the Color Picker dialog for user to select the color and this will be applied to the text background.

Return to the Top: Text Object