Table of Contents
Active Graphic (ActiveGraphic)
com.ergotech.vib.graphics.ActiveGraphic
Overview
ActiveGraphic is the basis of most VIB graphics in the MIStudio Design Editor.
Many graphics inherit common properties and behavior from ActiveGraphic. The exact properties available depend on the selected graphic.
Properties
The following properties may be available on graphics based on ActiveGraphic.
Basic
Name A default name is generated when the graphic is added in the Design Editor. The name can be changed to any unique String that starts with an alphabetic character. Some characters are prohibited from being used in the name.
Servers, Quality, and Color Actions
Device Name Select a defined Device that has been added to the Device Node of MIStudio.
Tag Name or Register Select a Tag Name or enter a Register to access a data point from the Device selected with Device Name. Depending on the type of Device, the Tag Names or Registers may be presented as a list from which to select.
Color Action The graphic may have this property available if the input Value Object can change the color of some part of the graphic. This property provides a choice of which part of the graphic will be affected by the server color. See Colors.
Use Color ? Similar to Color Action, but with only a True/False choice when there is only one part of the graphic affected by the server color. See Colors.
Bad Qual. Indicator At Determines the level of data quality that will be displayed as “Bad” on the graphic. Setting this to “Worst Quality” removes the indication of bad data quality. See Quality.
Warning Qual. Indicator At Determines the warning level of data quality that will be displayed as “Warning” on the graphic. Setting this to “Worst Quality” removes the warning indication. See Quality.
Text, Labels, and Fonts
These properties apply to components that support text or labels.
Font Choose the font to use for the text or label.
Number Format and Formatter String Set how numbers are displayed. See Number Formatting.
Label Horizontal Alignment Sets the horizontal alignment of the text: left, centered, or right.
Label Vertical Alignment Sets the vertical alignment of the text: top, centered, or bottom.
Show Label ? Toggles whether the label is displayed on text-based display components.
Use Label Color Controls whether the configured Label Color is used.
Label Color Sets the alternate color for the label when Use Label Color is set to True.
Scaling and Limits
Maximum Value (Hi), High Limit, or High Value Some components display a limited range of data. These properties set the maximum value for that range. The exact property name depends on the graphic.
Minimum Value (Lo), Low Limit, or Low Value Some components display a limited range of data. These properties set the minimum value for that range. The exact property name depends on the graphic.
Bezel
See Bezels for more information.
Bezel Many graphics can use Bezels to add a border around the graphic. There is a choice of six Bezels, as well as None, which removes the Bezel.
Bezel Inside Color Some Bezels can have an inside and outside color for shading or outlines. This property sets the color of the Bezel nearest the graphic.
Bezel Color Sets the main Bezel color, or the outside color when the Bezel uses a blended color.
Bezel Percentage Adjusts the Bezel width to make it thicker or thinner around the graphic.
Click Control
The click properties can be used to switch web pages or application pages.
Click Action Defines the action performed when the graphic is clicked. See Click Action Panel for configuration.
Click Count Sets the number of mouse clicks required to invoke the configured click action.
Notes
ActiveGraphic defines shared behavior used by many graphics in the MIStudio Design Editor. Individual graphic pages document properties and behavior specific to those graphics.
For interactive controls such as Button, PushButton, and URLButton, see Active Controls and Active Control Common Properties.
