Appearance Category Properties
- Last UpdatedJul 13, 2023
- 11 minute read
The following table contains a list of properties in the Appearance property category used by the:
-
Elements.
-
Canvas.
-
Element groups.
-
Embedded graphics.
It shows their purpose, where they are used and where to find more information on how to use them.
Asterisk (*) marks properties that are specific to only one type of element or the canvas, a group or an embedded graphic.
|
Property |
Purpose, category, usage and further information |
|
AbsoluteAnchor* |
Purpose: Defines the absolute anchor point of the source graphic. By default, this is the center point of all elements on the canvas but can be changed. |
|
Category: Appearance |
|
|
Used by: Canvas |
|
|
Can be read by script at run time: No |
|
|
AnchorFixedTo |
Purpose: Determines if the anchor point is fixed to the canvas when you resize, delete, or add elements (Absolute), or if the anchor point is recalculated relative to the element sizes and positions (Relative). |
|
Category: Appearance |
|
|
Used by: Embedded Symbol, Canvas |
|
|
Can be read by script at run time: No |
|
|
AbsoluteOrigin |
Purpose: Defines an X, Y location relative to the top, left (0, 0) origin of the graphic or window. |
|
Category: Appearance |
|
|
Used by: Rectangle, Rounded Rectangle, Ellipse, Polygon, Closed Curve, 2 Point Pie, 3 Point Pie, 2 Point Chord, 3 Point Chord, Line, H/V Line, Polyline, Curve, 2 Point Arc, 3 Point Arc, Button, Text, Text Box, Image, Status, Embedded Symbol, Group, Path, Radio Button Group, Check Box, Edit Box, Combo Box, Calendar, DateTime Picker, List Box. |
|
|
Can be read by script at run time: No |
|
|
AnchorPoint* |
Purpose: Defines the anchor X, Y location of the embedded graphic. |
|
Category: Appearance |
|
|
Used by: Embedded Symbol |
|
|
Can be read by script at run time: No |
|
|
Angle |
Purpose: Defines the current angle of rotation of the element. 0 is always the top of the element relative to the canvas. Angle is always determined relative to the top of the element and rotates in a clockwise direction. |
|
Category: Appearance |
|
|
Used by: Rectangle, Rounded Rectangle, Ellipse, Polygon, Closed Curve, 2 Point Pie, 3 Point Pie, 2 Point Chord, 3 Point Chord, Line, H/V Line, Polyline, Curve, 2 Point Arc, 3 Point Arc, Button, Text, Text Box, Image, Status, Group, Embedded Symbol |
|
|
Can be read by script at run time: Yes |
|
|
AutoScale |
Purpose: If this property is set to True then the text is stretched horizontally and vertically (larger or smaller) to fit the bounding rectangle. |
|
Category: Appearance |
|
|
Used by: Button, Text Box |
|
|
Can be read by script at run time: Yes |
|
|
ButtonStyle* |
Purpose: Determines if the button appears as a standard button or as an image. |
|
Category: Appearance |
|
|
Used by: Button |
|
|
Can be read by script at run time: No |
|
|
CalendarColumns* |
Purpose: Defines the number of columns the calendar object has. |
|
Category: Appearance |
|
|
Used by: Calendar |
|
|
Can be read by script at run time: No |
|
|
CalendarRows* |
Purpose: Defines the number of rows the calendar object has. |
|
Category: Appearance |
|
|
Used by: Calendar |
|
|
Can be read by script at run time: No |
|
|
Checked* |
Purpose: Sets or gets the value of check box. This is the initial value of the check box when the control is not connected to a reference and is overridden at run time with value of reference. |
|
Category: Appearance |
|
|
Used by: Check Box |
|
|
Can be read by script at run time: Yes |
|
|
ControlStyle |
Purpose: Defines the control style as Flat or 3D. |
|
Category: Appearance |
|
|
Used by: Radio Button Group, Check Box |
|
|
Can be read by script at run time: No |
|
|
Info:Setting the Layout of the Radio Button Group Options and Setting the 3D appearance of a Check Box Control |
|
|
CustomFormat* |
Purpose: Defines the format to be used in the DateTime Picker control for input of a date or time. |
|
Category: Appearance |
|
|
Used by: DateTime Picker |
|
|
Can be read by script at run time: No |
|
|
DefaultValue |
Purpose: The default time value to use for the control. |
|
Category: Appearance |
|
|
Used by: Calendar, DateTime Picker |
|
|
Can be read by script at run time: No |
|
|
Info: Setting the Default Value of the Calendar Control and Configuring DateTime Picker Controls |
|
|
DownImage* |
Purpose: Defines the image that is rendered in the button element when it is clicked or held down. |
|
Category: Appearance |
|
|
Used by: Button |
|
|
Can be read by script at run time: No |
|
|
DropDownType* |
Purpose: Defines the type of combo box: simple, drop-down or drop-down list. |
|
Category: Appearance |
|
|
Used by: Combo Box |
|
|
Can be read by script at run time: No |
|
|
DropDownWidth* |
Purpose: Defines the width of the drop-down list. |
|
Category: Appearance |
|
|
Used by: Combo Box |
|
|
Can be read by script at run time: No |
|
|
DynamicSizeChange* |
Purpose: Determines if the embedded graphic propagates the size changes from the source graphic. |
|
Category: Appearance |
|
|
Used by: Embedded Symbol |
|
|
Can be read by script at run time: No |
|
|
Info: Enabling or Disabling Dynamic Size Change of Embedded Graphics |
|
|
End |
Purpose: Defines the end of a line or H/V line as X, Y location. |
|
Category: Appearance |
|
|
Used by: Line, H/V Line |
|
|
Can be read by script at run time: No |
|
|
FirstDayOfWeek* |
Purpose: Defines the first day of the week used for the display of the columns in the calendar. |
|
Category: Appearance |
|
|
Used by: Calendar |
|
|
Can be read by script at run time: No |
|
|
Format* |
Purpose: Defines the format of the reference values. This is only available for array mode. |
|
Category: Appearance |
|
|
Used by: DateTime Picker |
|
|
Can be read by script at run time: No |
|
|
HasTransparentColor* |
Purpose: Indicates whether or not the image applies a transparent color. If True the image is rendered transparent wherever a color in the image matches the TransparentColor property. |
|
Category: Appearance |
|
|
Used by: Image |
|
|
Can be read by script at run time: Yes |
|
|
Height |
Purpose: Defines the height of the element. |
|
Category: Appearance |
|
|
Used by: Rectangle, Rounded Rectangle, Ellipse, Polygon, Closed Curve, 2 Point Pie, 3 Point Pie, 2 Point Chord, 3 Point Chord, Line, H/V Line, Polyline, Curve, 2 Point Arc, 3 Point Arc, Button, Text, Text Box, Image, Status, Radio Button Group, Check Box, Edit Box, Combo Box, Calendar, DateTime Picker, List Box, Group, Path, Embedded Symbol |
|
|
Can be read by script at run time: Yes |
|
|
HorizontalScrollbar |
Purpose: Determines if a horizontal scroll bar appears on a list box control to allow the user to scroll the list box items horizontally. |
|
Category: Appearance |
|
|
Used by: List Box |
|
|
Can be read by script at run time: No |
|
|
Image* |
Purpose: Defines the image that is rendered in the element. Any image format supported by the application can be used. |
|
Category: Appearance |
|
|
Used by: Image |
|
|
Can be read by script at run time: No |
|
|
ImageAlignment* |
Purpose: Controls the location of the image relative to the bounding rectangle of the graphic. This property is only applicable when the ImageStyle is set to Normal. |
|
Category: Appearance |
|
|
Used by: Image |
|
|
Can be read by script at run time: No |
|
|
ImageStyle |
Purpose: Defines how the image is rendered relative to its bounding rectangle. |
|
Category: Appearance |
|
|
Used by: Button, Image |
|
|
Can be read by script at run time: No |
|
|
IntegralHeight |
Purpose: Determines if the List Box size is an integral multiple of the Font Size so that a finite number of items fit in it without being clipped. |
|
Category: Appearance |
|
|
Used by: Combo Box, List Box |
|
|
Can be read by script at run time: No |
|
|
Info: Avoiding Clipping of Items in the Simple Combo Box Control |
|
|
Layout* |
Purpose: Defines the way the radio buttons are arranged in the group (Horizontal or Vertical). |
|
Category: Appearance |
|
|
Used by: Radio Button Group |
|
|
Can be read by script at run time: No |
|
|
Locked |
Purpose: Locks or unlocks the element’s size, position, orientation and origin. Other properties that can have an affect on element size, position, orientation and origin are also locked. These are element-specific. |
|
Category: Appearance |
|
|
Used by: Rectangle, Rounded Rectangle, Ellipse, Polygon, Closed Curve, 2 Point Pie, 3 Point Pie, 2 Point Chord, 3 Point Chord, Line, H/V Line, Polyline, Curve, 2 Point Arc, 3 Point Arc, Button, Text, Text Box, Image, Status, Radio Button Group, Check Box, Edit Box, Combo Box, Calendar, DateTime Picker, List Box, Group, Path, Embedded Symbol |
|
|
Can be read by script at run time: Yes |
|
|
MaxDropDownItems* |
Purpose: Defines the maximum number of items the drop-down list shows. |
|
Category: Appearance |
|
|
Used by: Combo Box |
|
|
Can be read by script at run time: No |
|
|
Info: Setting the Maximum Number of Items to Appear in the Combo Box Drop-Down List |
|
|
Multiline* |
Purpose: Determines if the control shows several lines of text that automatically wrap up when reaching the right border of the control. |
|
Category: Appearance |
|
|
Used by: Edit Box |
|
|
Can be read by script at run time: No |
|
|
Radius* |
Purpose: Defines the radius of the corners of the Rounded Rectangle. |
|
Category: Appearance |
|
|
Used by: Rounded Rectangle |
|
|
Can be read by script at run time: Yes |
|
|
ReadOnly* |
Purpose: Determines if the user can type data into the edit box. |
|
Category: Appearance |
|
|
Used by: Edit Box |
|
|
Can be read by script at run time: No |
|
|
Info: Configuring the Text to be Read-Only in an Edit Box Control |
|
|
RelativeAnchor* |
Purpose: Relative anchor point of the source graphic. By default, this is 0,0. |
|
Category: Appearance |
|
|
Used by: Canvas |
|
|
Can be read by script at run time: No |
|
|
RelativeOrigin |
Purpose: Defines the relative origin as X, Y location. The location is relative to the center point of the element (0, 0). |
|
Category: Appearance |
|
|
Used by: Rectangle, Rounded Rectangle, Ellipse, Polygon, Closed Curve, 2 Point Pie, 3 Point Pie, 2 Point Chord, 3 Point Chord, Line, H/V Line, Polyline, Curve, 2 Point Arc, 3 Point Arc, Button, Text, Text Box, Image, Status, Group, Path, Embedded Symbol |
|
|
Can be read by script at run time: No |
|
|
ShowToday* |
Purpose: Determines if today's date is shown on the calendar control. |
|
Category: Appearance |
|
|
Used by: Calendar |
|
|
Can be read by script at run time: No |
|
|
Smoothing* |
Purpose: When False the graphics are rendered normally, when True graphics are rendered with anti-aliasing which produces a smoother appearing graphic. |
|
Category: Appearance |
|
|
Used by: Canvas |
|
|
Can be read by script at run time: No |
|
|
Start |
Purpose: Defines the start of a line or H/V line as X, Y location. |
|
Category: Appearance |
|
|
Used by: Line, H/V Line |
|
|
Can be read by script at run time: No |
|
|
StartAngle |
Purpose: Defines the starting angle of an Arc, Pie or Chord. 0 is always the top of the graphic relative to its orientation. A positive number is clockwise from 0 and a negative number is counter clockwise from 0. If a negative number is used to set the property it is automatically converted to a positive value. |
|
Category: Appearance |
|
|
Used by: 2 Point Pie, 3 Point Pie, 2 Point Chord, 3 Point Chord, 2 Point Arc, 3 Point Arc |
|
|
Can be read by script at run time: Yes |
|
|
SweepAngle |
Purpose: Defines the ending angle of the Arc, Pie or Chord. This angle is always measured from the start angle. |
|
Category: Appearance |
|
|
Used by: 2 Point Pie, 3 Point Pie, 2 Point Chord, 3 Point Chord, 2 Point Arc, 3 Point Arc |
|
|
Can be read by script at run time: Yes |
|
|
Tension |
Purpose: Specifies how tightly the curve bends through the control points of the curve. |
|
Category: Appearance |
|
|
Used by: Closed Curve, Curve |
|
|
Can be read by script at run time: Yes |
|
|
Text |
Purpose: Defines the unicode text that is shown by the element. |
|
Category: Appearance |
|
|
Used by: Button, Text, Text Box, Edit Box |
|
|
Can be read by script at run time: Yes |
|
|
TextFormat |
Purpose: Defines the formatting string that is applied to the text when it is shown. |
|
Category: Appearance |
|
|
Used by: Button, Text, Text Box |
|
|
Can be read by script at run time: Yes |
|
|
Transparency |
Purpose: Defines the transparency. A value of 0 means fully opaque and a value of 100 means fully transparent. |
|
Category: Appearance |
|
|
Used by: Rectangle, Rounded Rectangle, Ellipse, Polygon, Closed Curve, 2 Point Pie, 3 Point Pie, 2 Point Chord, 3 Point Chord, Line, H/V Line, Polyline, Curve, 2 Point Arc, 3 Point Arc, Button, Text, Text Box, Image, Group, Path, Embedded Symbol |
|
|
Can be read by script at run time: Yes |
|
|
TransparentColor* |
Purpose: Defines the RGB color value that is used as the transparent color. |
|
Category: Appearance |
|
|
Used by: Image |
|
|
Can be read by script at run time: No |
|
|
Info:Setting the Image Color Transparency |
|
|
UpImage* |
Purpose: Defines the image that is used in the button element when it is un-clicked or released. |
|
Category: Appearance |
|
|
Used by: Button |
|
|
Can be read by script at run time: No |
|
|
Width |
Purpose: Defines the width of the element. |
|
Category: Appearance |
|
|
Used by: Rectangle, Rounded Rectangle, Ellipse, Polygon, Closed Curve, 2 Point Pie, 3 Point Pie, 2 Point Chord, 3 Point Chord, Line, H/V Line, Polyline, Curve, 2 Point Arc, 3 Point Arc, Button, Text, Text Box, Image, Status, Radio Button Group, Check Box, Edit Box, Combo Box, Calendar, DateTime Picker, List Box, Group, Path, Embedded Symbol |
|
|
Can be read by script at run time: Yes |
|
|
WordWrap |
Purpose: When set to True, the text in the button or text box is formatted to fit as much text on a single line within the horizontal bounding area of the element and then continued to the next line. This continues as long as there is vertical space. |
|
Category: Appearance |
|
|
Used by: Button, Text Box |
|
|
Can be read by script at run time: Yes |
|
|
Info: Wrapping Text in Buttons |
|
|
X |
Purpose: Defines the left position of the element. |
|
Category: Appearance |
|
|
Used by: Rectangle, Rounded Rectangle, Ellipse, Polygon, Closed Curve, 2 Point Pie, 3 Point Pie, 2 Point Chord, 3 Point Chord, Line, H/V Line, Polyline, Curve, 2 Point Arc, 3 Point Arc, Button, Text, Text Box, Image, Status, Radio Button Group, Check Box, Edit Box, Combo Box, Calendar, DateTime Picker, List Box, Group, Path, Embedded Symbol |
|
|
Can be read by script at run time: Yes |
|
|
Info: Moving Elements |
|
|
Y |
Purpose: Defines the top position of the element. |
|
Category: Appearance |
|
|
Used by: Rectangle, Rounded Rectangle, Ellipse, Polygon, Closed Curve, 2 Point Pie, 3 Point Pie, 2 Point Chord, 3 Point Chord, Line, H/V Line, Polyline, Curve, 2 Point Arc, 3 Point Arc, Button, Text, Text Box, Image, Status, Radio Button Group, Check Box, Edit Box, Combo Box, Calendar, DateTime Picker, List Box, Group, Path, Embedded Symbol |
|
|
Can be read by script at run time: Yes |
|
|
Info: Moving Elements |