This page details all possible properties for graphic objects. Refer to the list of available objects for further information about which property is used for which object.

Identifier

You can freely attach a text identifier to each graphic object inserted in a document. Identifiers are useful for arranging overlapped objects as they appear in the Z-order list.

Variable symbol

This is the full name of the application variable connected to the graphic object. In case of a local variable, its symbol must be prefixed with the parent program name, separated with "/". Example: "MyProg/MyVar".

Spying delay [ms]

This is the minimum period for actuating the value of the connected variable, expressed as a number of milliseconds. If the delay is not specified or equal to 0, refresh is done as fast as possible.

Writing delay [ms]

This property allows to define a time span in milliseconds for the sending of the variable value when draging the slider position with a click on the mouse.

• If the set value is lower than 200 ms, no variable value will be sent to the target until the mouse button is released.
• If the set value range is between 200 – 2000 ms, the variable value is sent to the target using a timer with the specified delay. The value is sent to the target while the slider is dragged.

Hint: The set value cannot be greater than 2000 ms. The property is available for Sliders and Rotating buttons.

Border size

This property indicates the width of the border drawn around the object, as a number of pixels. If this property is 0, then no border is drawn.

Border color

This property indicates the color of the border drawn around the object.

Border style

This property indicates the possible 3D effect used for drawing the border around the object.

Possible values are:

FLAT = no 3D effect
3DUP = depressed 3D effect
3DDOWN = pressed 3D effect
3D = default 3D effect

Text color

This property indicates the color used for drawing texts in the graphic object.

Text mode

This property indicates the font effect used for drawing texts in the graphic object.

Possible values are:

HIDE = text is not displayed
NORMAL = normal font
BOLD = bold text
ITALIC = italic text
UNDERLINE = underlined text

Font name

This property indicates the name of the character font used for drawing texts in the graphic object.

Font size

This property indicates the size of the character font used for drawing texts in the graphic object. The size is expressed as a percentage of the actual height of the object. Maximum possible value is 100. This ensures that the ratio is kept when the object is resized.

Background color

This property indicates the color used for filling the background of the object. In case of a bitmap, it specifies the color that should not be drawn if the TRANS (trasparent) background mode is specified.

Background mode

This property indicates whether the background of the object must be filled or not. If this property is OPAQUE, then the background is filled with teh specified background color. If this property is TRANS (trasparent) then background is not filled. Transparent drawing mode may be useful in case of overlapping objects.

Data format

If defined, this property indicates that the value of the connected variable must be displayed on the graphic object. You must specify for this property a format string that indicates how the data must be formatted.

Format string has the same format as the famous "printf" function of "C" language. It may include static characters together with one of the following possible pragmas that specify the value:

%s = default formatting according to IEC syntax
%d = integer (decimal)
%X = hexadecimal
%g = floating point
%.nf = decimal real (n is the number of displayed decimal digits)

Text

If defined, this property indicates the text to be displayed on the graphic object.

Bitmap display mode

For bitmap based objects, this property indicates whether the attached bitmap must keep its original aspect or be stretched to the actual size of the object.

Possible values are:

• ORIGINAL = Keep the original aspect of the bitmap (cut if too large).
• STRETCH = Stretch or shrink the bitmap for fitting the actual size of the graphic object.

Multi-state bitmap

Allows to associate several values to several bitmap paths.

Example: A traffic light has 3 different bitmaps, one for each color (red, orange, green) plus a default bitmap. So when the associated value equals 1, the bitmap for the green light is displayed, when the value equals 2, the orange light is displayed and so on. In the edit mode or if the value is unknown (e.g. value = 4), the default bitmap is set. The default bitmap is mandatory for this objec. Available only for INT and STRING variables.

Minimum value

For analog animated objects (meters, bargraphs, trends...) this property indicates the minimum possible value that can be displayed. For static scales, it indicates the value of the lowest mark.

Maximum value

For analog animated objects (meters, bargraphs, trends...) this property indicates the maximum possible value that can be displayed. For static scales, it indicates the value of the highest mark.

Data color

This property indicates the color used to represent the value of connected variable within the object (for example the filled part of a bargraph).

Nb divisions (main)

For objects including a graphic scale, this property indicates the number of main division marks to be drawn in the scale.

Nb divisions (small)

For objects including a graphic scale, this property indicates the number of small division marks to be drawn in the scale, between each main division mark.

Scale color

For objects including a graphic scale, this property indicates the color used for drawing the axis, the division marks and corresponding values of the scale.

Bitmap pathname

For bitmaps, this property specifies the pathname of the bitmap to be displayed. BMP, GIF and JPG formats are supported. If no directory is specified, the specified file name is searched:

• In the project folder.
• In the "\BITMAP" folder of the Workbench Studio.

Bitmap for "TRUE" state

For 2-state objects having the CUSTOM aspect, this property specifies the pathname of the bitmap to be displayed when the value of the attached variable is TRUE (or not zero for analogs). BMP, GIF and JPG formats are supported. If no directory is specified, the specified file name is searched:

• In the project folder.
• In the "\BITMAP" folder of the Workbench Studio.

Bitmap for "FALSE" state

For 2-state objects having the CUSTOM aspect, this property specifies the pathname of the bitmap to be displayed when the value of the attached variable is FALSE (or zero for analogs). BMP, GIF and JPG formats are supported. If no directory is specified, the specified file name is searched:

• In the project folder.
• In the "\BITMAP" folder of the Workbench Studio.

Color when not connected

For shapes, this property indicates the color used for filling shapes when no variable is attached to the graphic object.

TRUE color

For shapes, this property indicates the color used for filling shapes when the attached variable has the TRUE state, or non zero for analogs.

FALSE color

For shapes, this property indicates the color used for filling shapes when the attached variable has the FALSE state, or zero for analogs.

Direction (basic shapes)

For oriented shapes such as triangles, half ellipses or cylender, this property indicates the direction of the drawing; to the left, to the right, to the top or to the bottom.

Direction (scale)

For scales, this property indicates the direction of the axis. If LEFT, the minimum value is on the left side. If RIGHT, the minimum value is on the right side.

Placement (scale)

For scales, this property indicates the location of the scale within the object rectangle: on the left, on the right, on the top or at the bottom.

Action (text)

Indicates the possible mouse action for text boxes. Following values are possible:

STATIC = No mouse action.
EDIT = Double-click opens an edit box for entering the variable value.

Action (switch)

Indicates the possible mouse action for switches. Following values are possible:

STATIC = No mouse action.
PUSHBUTTON = The variable is forced to TRUE when pressed and to FALSE when depressed.
SWITCH = The status os the variable is inverted when the button is pressed.
ONESHOTBUTTON = Same as switch, but the display remains depressed when the mouse is released.

Direction (bargraph)

For bargraphs, this property indicates the growing direction: to the left, to the right, to the top or to the bottom.

Nb of points (trends)

For trend charts, this property indicates the maximum number of stored points. If the width of the object (in pixels) is less than this number, then oldest points are not visible.

Direction (slider)

For slider, this property indicates whether the slider is horizontal (RIGHT) or vertical (TOP).

Link

This property indicates the name of the target .GRA animated document for shortcuts. If no directory is specified in the link, then the file is searched in the project folder.

Aspect (shapes)

This property indicates the type of basic shape to be drawn.

Possible aspects are:

Cylinder = A 3D like cylinder.

Ellipse = An ellipse.

Gate = A simple vector drawing for a valve.

Half Ellipse = One half of an ellipse.

Line Bottom = Horizontal line at the bottom of the view.

Line Down = Line from the upper left to the lower right corner.

Line Left = Vertical line on the left side.

Line Right = Vertical line on the right side.

Line Top = Horizontal line at the upper part of the view.

Line Up = Line from the lower left to the upper right corner.

Lozenge = Square, standing on the top.

Polygon1 = Polygon with eight edges.

Polygon2 = Polygon with six edges.

Rectangle = A rectangle.

Round Rectangle = Rectangle with rounded corners.

Round Corner = Quarter of a circle.

Trapez = A trapez.

Triangle = A triangle.

Drawing path (lines)

This property indicates the path for the corresponding line type. Possible aspects are:

LINE_BOTTOM = Line is drawn at the bottom.

LINE_DOWN = Line is drawn from the upper left to the lower right corner.

LINE_LEFT = Vertical line is drawn on the left side.

LINE_RIGHT = Vertical line is drawn on the right side.

LINE_TOP = Horizontal line is drawn at the upper part of the view.

LINE_UP = Line is drawn from the lower left to the upper right corner.

The Drawing path can contain a complex path to draw complex polygons too and is using the svg language syntax.

Hint: Only absolute commands are supported.

Example:

• Command “M 0 100” will move the current point to the bottom left point in the rectangle.
• Command "L25 0" will draw line a from the current position to 25% width of the rectangle on the top of rectangle (0%).
• Command "L75 0" will draw a line from the current position to 75% width of the rectangle on the top of rectangle (0%).
• Command "L100 100" will draw a line from the current point to bottom right of rectangle (100% 100%).

Drawing path: M0 100 L25 0 L 75 0 L 100 100Z

Fill method (lines/polygones)

This property indicates the fill methode for polygons which are drawn of lines. Possible aspects are:

STROKEPATH = Only the lines of the polygon are colored.

STROKEANDFILLPATH = The polygon will be filled with the data color.

Aspect (switches)

This property indicates the type of switch to be drawn. Possible aspects are:

DEFAULT = A standard Windows-like push button.
CUSTOM = A button with TRUE and FALSE drawings defined with bitmaps.

Aspect (trend charts)

This property indicates the type of drawing for a trend chart. Possible aspects are:

POINT = Only relevant dots are drawn.
LINE = Lines are drawn from point to point.
HISTO = Histogram style.

Aspect (digits)

This property indicates the type of drawing for a digital meter. Possible aspects are:

DEFAULT = Plain drawing.
BEZEL = All segments have a 3D effect.

Created with the Personal Edition of HelpNDoc: Free Qt Help documentation generator