The Alarm attribute property specifies the alarm attribute that will be displayed in the column. Click to reveal a drop-down menu of available CygNet alarm attributes supported by the alarm grid:

• Alarm Condition
• Set / Reset State
• Alarm Hidden
• Alarm Suppression State
• Point State
• Reported Time
• Alarm Priority Highest
• Alarm Priority Highest Since Ack
• Alarm Priority Highest Category
• Alarm Priority Highest Category Desc.
• Alarm Priority Highest Since Ack Cat.
• Alarm Priority Highest Since Ack Cat. Desc.
• Facility Tag (CAS)
• Alarm Priority
• Primary Value
• Secondary Value
• Alarm Acknowledgment Status

An alarm column presents data for a point by an alarm attribute. The property sheet displays Common and Alarm properties.

The Alarm filter property is used to limit the data that is presented in the alarm grid by configuring alarm filtering rules. Click to open the Alarm Filter dialog box, where you can create a custom alarm filter rule. The filter rule is displayed in the property label; you do need to open the Alarm Filter dialog box to edit the rule.

The Alarm icon column property is used to indicate whether a column and icon will be displayed as the first column of the alarm grid. A customizable icon can be configured to change color based on point state and change image based on alarm priority. Icons will display only when there is an unacknowledged alarm. Click to configure the column, the icon color source, the associated priority ranges, and the icon image used for each priority in the Alarm Priority Icon Ranges dialog box.

The Alarm icon configuration property is used to configure the alarm icon that can optionally be included in the upper right corner of the detail control. If enabled in the Show alarm icon property, a customizable icon can be configured to change color based on point state and change image based on alarm priority. Icons will display only when there is an unacknowledged alarm.

Click to configure the icon color source, the associated priority ranges, and the icon image used for each priority in the Configure Alarm Icons dialog box.

The Animate Marker check box indicates whether to animate the marker movement. When enabled the Value Indicator's marker will move smoothly from one value to the next value.

The Appearance property group contains properties that configure the appearance of points on the chart series, such as enabling points, color, point size, enabling labels, and label colors.

The Arrow size property specifies the size of the arrowheads at the end of the line shapes. Select a number using the spin control. The default value is 20. The Shape type must be one of the arrow shapes to take effect.

The Auto range x-axis check box indicates whether the sparkline's x-axis is constrained to the range of values for the associated point or fixed to the configured time range (default). Configure the date and time range in the Range properties below.

The Auto range y-axis check box indicates whether the sparkline's y-axis is constrained to the range of values for the associated points (default) or fixed to the configured minimum and maximum values. Configure the y-axis scale in the Maximum Y value and Minimum Y value below.

The Background color property specifies the background color of the screen, object, or control. Click to select a color using the color picker.

Combo Box —

The Background color property specifies background color of the combo box header. Click to select a color using the color picker.

The Background color property specifies the color used for the background of the grid cell. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated alarm.

• Source — Click to reveal four options:
  • <Self> — Select <Self> to explicitly configure the color. When <Self> is selected a Color field is automatically displayed beneath the Source field and must be configured.
  • SingleColor — Select SingleColor to specify that the source of the icon's color corresponds to the alarm's point state single color (%pointstatesinglecolor%)
  • ForegroundColor — Select ForegroundColor to specify that the source of the icon's color corresponds to the alarm's point state foreground color (%pointstateforecolor%)
  • BackgroundColor — Select BackgroundColor to specify that the source of the icon's color corresponds to the alarm's point state background color (%pointstatebackcolor%)
• Color — Only displays if the Source is <Self>. Click to explicitly specify a color using the color picker.

The Background color property specifies the color used for the background of the grid cell. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated point (by selecting Point State).

For a Generic and Facility column, select the color using the following option:

• Color — Click to explicitly specify a color using the color picker.

For a Point column, select the color using the following options:

• Source — Click to reveal two options:
  • <Self> — Select <Self> to explicitly configure the color. When <Self> is selected a Color field and picker is automatically displayed beneath the Source field and must be configured.
  • Point State — Select Point State to specify that the source of the color corresponds to the point state color defined for the point represented in the element. The default point state colors for a CygNet system are defined by the system’s point scheme. When Point State is selected the Color property disappears.
• Color — Only displays if the Source is <Self>. Click to explicitly specify a color using the color picker.

The Background color property specifies the color used for the background of the control. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated point (by selecting Point State).

Options include:

• Source — Click to reveal two options:
  • <Self> — Select <Self> to explicitly configure the color. When <Self> is selected a Color field and picker is automatically displayed beneath the Source field and must be configured.
  • Point State — Select Point State to specify that the source of the color corresponds to the point state color defined for the point represented in the element. The default point state colors for a CygNet system are defined by the system’s point scheme. When Point State is selected the Color property disappears.
• Color — Only displays if the Source is <Self>. Click to explicitly specify a color using the color picker.

The Bar color property specifies the color used for the bar that represents the point value in the linear gauge control. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated point (by selecting Point State).

The Base node property specifies the group node to use as the base (or bottom) of the hierarchy. Click to select the desired node from the Select Group Hierarchy Node dialog box. Note that you must set up a group hierarchical structure with levels of nodes in your CygNet system prior to selecting a base node in the tag chooser.

The Begin date (or Start or Start date) property specifies the start date and time for a control (or screen or chart or column) for an absolute date and time view window. The format is MM/DD/YYYY hh:mm:ss AM/PM. The default value is the system date and time at which the control was first added to the screen. Click to change the date using the date picker.

The Begin relative date (or Relative start date or Start) property specifies a wildcard string defining the amount of time by which to adjust the start date and time. The space-separated elements in this string must be of the form: "x-#", "x+#", or "x=#" where # is an integer and x is one of the following unit specifiers: y — Year, m — Month, d — Day, H — Hour, M — Minute, S — Second, and # is an integer. T wildcard is also supported and must be in the form: T, T+#, T-#, where T represent today at midnight, T-1 is yesterday at midnight, and T+1 is tomorrow at midnight, etc. Any integer can be used. For example, H-8 represents data from the 8 hours before the current hour, d+3 represents data 3 days after the current day, and d+2 H+1 M+30 represents data 2 days, 1 hour and 30 minutes after the current date and time. d-4 H=6 sets the relative start date and time to four days ago (d-4) at 6:00 a.m. (H=6). See Date and Time Wildcards for more information about adjusting relative time.

See Display alarm acknowledgment

The Border color property specifies the color used for the border of the grid cell. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated alarm.

• Source — Click to reveal four options:
  • <Self> — Select <Self> to explicitly configure the color. When <Self> is selected a Color field is automatically displayed beneath the Source field and must be configured.
  • SingleColor — Select SingleColor to specify that the source of the icon's color corresponds to the alarm's point state single color (%pointstatesinglecolor%)
  • ForegroundColor — Select ForegroundColor to specify that the source of the icon's color corresponds to the alarm's point state foreground color (%pointstateforecolor%)
  • BackgroundColor — Select BackgroundColor to specify that the source of the icon's color corresponds to the alarm's point state background color (%pointstatebackcolor%)
• Color — Only displays if the Source is <Self>. Click to explicitly specify a color using the color picker.

The Border color property specifies the color used for the border of the grid cell. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated point (by selecting Point State).

For a Generic and Facility column, select the color using the following option:

• Color — Click to explicitly specify a color using the color picker.

For a Point column, select the color using the following options:

• Source — Click to reveal two options:
  • <Self> — Select <Self> to explicitly configure the color. When <Self> is selected a Color field and picker is automatically displayed beneath the Source field and must be configured.
  • Point State — Select Point State to specify that the source of the color corresponds to the point state color defined for the point represented in the element. The default point state colors for a CygNet system are defined by the system’s point scheme. When Point State is selected the Color property disappears.
• Color — Only displays if the Source is <Self>. Click to explicitly specify a color using the color picker.

The Border color property specifies the color used for the border of the control. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated point (by selecting Point State).

Options include:

• Source — Click to reveal two options:
  • <Self> — Select <Self> to explicitly configure the color. When <Self> is selected a Color field and picker is automatically displayed beneath the Source field and must be configured.
  • Point State — Select Point State to specify that the source of the color corresponds to the point state color defined for the point represented in the element. The default point state colors for a CygNet system are defined by the system’s point scheme. When Point State is selected the Color property disappears.
• Color — Only displays if the Source is <Self>. Click to explicitly specify a color using the color picker.

The Bottom information text property specifies the text that will appear on the bottom information area on the control, which can be a static label, or dynamic text based on point or facility attributes. Dynamic text is built using tokens, which can represent real-time CVS point properties, point configuration properties, and facility properties. Click to configure text and property strings using the CygNet Property String dialog box. The default value is the %Units% token.

The Broadcast facilities check box indicates whether to notify other screens when this screen's facility selection changes. When enabled, and when a screen's facility selection changes, Canvas will broadcast the list of facilities out to all other screens open in the application that are configured to source their facility from <Broadcast>.

The Broadcast SiteService check box indicates whether to notify other screens when this screen's SiteService selection changes. When enabled, and when a screen's SiteService selection changes, Canvas will broadcast the SiteService out to all other screens open in the application that are configured to source their SiteService from <Broadcast>.

The Cell padding property specifies the size of the padding around each heat map cell in pixels.

The Chart drop mode property specifies how the chart should handle the facility from a dropped point. Two options are available:

• Use dropped facility — Create a series using the full point tag, including the facility tag from the point dropped on the chart (default).
• Use control facility — Create a series using the UDC from the dropped point but drive the facility tag at the control level.

The default value is Use dropped facility.

The Checked property indicates whether the check box initially displays as checked.

The Color property specifies the color of the point in the chart series. The default value is the series color. Click to select a color using the color picker. The Show points property must be enabled to change the point color.

The Sparkline color (or Color) property specifies the color of the sparkline. Click to select a color using the color picker.

The Color property specifies the color of the chart series. Click to select a color using the color picker.

The Color configuration box contains all the options required to specify the color properties of the control. Click to reveal a set of color options where you can specify the source of the color to be used for the elements of the control. The Color configuration box consists of the following options.

See each control for more information about configuring color properties.

The Color palette property specifies the color palette to use for the CygNet-aware controls on this screen. Select the desired palette from the drop-down menu. Select None to use the default CygNet point state colors. This is the default value.

See Configuring Color Palettes for more information.

Alarm Grid —

The Grid Column Configuration dialog box contains all properties required to configure columns in your grid. There are five types of columns that can be configured in an alarm grid: an Alarm icon column (configured separately), an Alarm column, a Facility column, a Generic column, and a Point column. The number of defined columns is listed on the property label once defined.

You can create your own columns or select from 11 default columns: four Alarm columns (Alarm Priority, Alarm Acknowledge, Primary Value, Timestamp), and seven Point columns (Alarm Condition, SiteService, Long Point ID, Primary Units, Description, Facility ID, Uniform Data Code).

CygNet Grid —

The Grid Column Configuration dialog box contains all the properties required to configure each column in your grid. There are four types of columns that can be configured in a CygNet grid: a Facility column, a Generic column, a History column, and a Point column. The number of defined columns is listed on the property label once defined.

The Configuration drop-down box contains the properties required to configure the tag chooser using a Facility hierarchy: a Facility service, an optional Facility filter, and the facility attribute hierarchy levels.

The Configuration drop-down box contains the properties required to configure the tag chooser using Group service node hierarchy: a Group service, Base node, and the Facility type filter.

The Control margin property specifies the size of the whitespace between displayed objects in pixels.

The Custom line style property specifies a special abbreviated syntax that defines the line's pattern. If you want to manually modify these values, set the Line style type to Custom. For example, 1 3 1 renders a dot-dash-dot effect.

The CygNet connection property is used to configure the facility and SiteService associated with this control or screen. Two selection modes are available: a) by Facility tag or b) by SiteService / Facility. This split configuration allows for the inheritance of these properties from other controls, or the specific configuration of the SiteService or the facility, while dynamically changing the other. This use case may be rare; therefore, the Facility tag option is the default.

Click to reveal a drop-down area where you can configure the Selection mode, source SiteService, and source Facility. Each option is described below.

See each control for more information about configuring the CygNetconnection.

The Date and time format property specifies the format for a point's timestamp using any of the valid .NET standard or custom numeric format strings. The date and time format applies to a point's Timestamp, Last Verified Change Timestamp, and Last Questionable Change Timestamp properties. Use this property to override the default format, which is configured on the Settings page of the Backstage view. The default format is YYYY/MM/DD HH:MM:SS.fff, which corresponds to 2019/01/01 10:20:30.0001. All timestamps are local client time.

The Date range configuration property is used to configure the range of dates to be trended in the chart or sparkline, whether to enable live data updates, the live update rate, the starting time for a trend, whether to use relative or absolute dates, and the actual date range. Click to open the Configure Time Range dialog box, where you can configure these properties.

You can change the date and time range settings for any chart in run mode via an icon on the chart toolbar.

The Data source property specifies the source of the data used in a selected series. The options are as follows:

• CygNet — The series will display native CygNet data. This is the default value.
• Script — The series will display non-CygNet data from a custom script. For example, you might display data with a generic SQL query from an external database. See the examples provided below.

Scripting a Chart Series

The following example guides you though creating a scripted chart series, adding delegates to show random data and auto update the series, and some important notes.

1. Configure a chart, add a series, and for the Data source property select Script as the source.
2. Switch to the Script View and enable scripting for this screen.
3. In the script for the screen, add a GetCustomSeriesData method below the //add custom methods here comment in the public class ScreenClass class. See the following example. This example also includes a GetCustomSeriesAutoUpdateData method to handle an auto updating series. Also see the comments showing the ability to handle multiple scripted series.

4. The above method has a parameter with a data type of 'Series', which is included in the Canvas.Shared.Models namespace. So, at the top of the script you need to add a statement to indicate this:

5. Next you need to add the delegates, which are used, for example, to reference the custom scripted data or instruct the series to auto update.
6. Go to the Events tab and enable the Initialize event on the screen. This is where you hook the delegates:

Other Script Notes

• The AddData method on a series object is used to add a value at the supplied time. AddData has three parameters:

• DateTime — Type of "DateTime"
• Value — Type of "Double"
• Color — Type of "String". This is an optional parameter. See the next note about bar charts and color.

Here is an example of adding a point to the chart.

• When adding a Bar Series type, you must set the color at the point level. This allows for points to be colored differently from each other. Color is an optional parameter on the AddData method; but it must be supplied for a bar chart.

• When adding a scripted data source, set the Delay loading property to True to give the script time to set the delegates before data retrieval begins. The chart needs to be refreshed after the delegates are connected. See example above.

The Default chart file property specifies the path to the chart file associated with this screen.

• Click to access the Open dialog box and select either the BSS or Local.
• Click BSS to access a CygNet APPS or BSS folder.
  • Browse to the folder and file you want to open.
• Click Local to access a local or network Windows file-system folder.
  • Browse to the folder and file you want to open.
• Click OK to save the file path.
• Or click Cancel to abort and close the Open dialog box.

See Default Chart for more information.

This property specifies the source to the file, image, object file, or screen. Options include:

• BSS — Indicates that the file is stored in a CygNet APPS or BSS folder
• Local — Indicates that the file is stored in a local or network Windows file-system folder

The default file source is Local.

This property specifies the source to the file, image, object file, or screen. Options include:

• BSS — Indicates that the file is stored in a CygNet APPS or BSS folder
• Local — Indicates that the file is stored in a local or network Windows file-system folder

The default file source is Local.

This property specifies the path to the file, image file, object file, or screen file. Depending on the selection in the source property the type of path is different. Click to access either the:

• Select File dialog box — To access a CygNet APPS or BSS folder
• Open File dialog box — To access a local or network Windows file-system folder

The Default to first item check box indicates whether the first item configured will be the default selected item when starting a screen, instead of showing the Watermark.

Chart —

The Delay loading property indicates whether to delay data loading for the chart. Use this to stop unwanted messaging to the service, for example, if you don't want the chart to load when the screen first opens. This is necessary when using scripted data sources for a series, to give the script time to set the delegates before data retrieval begins.

Tag Chooser —

The Delay loading property indicates whether to delay data loading for the control. Use this to stop unwanted messaging to the service, for example, if you don't want the control to load when the screen first opens. You can turn off the DelayLoading flag via script, then use RefreshTagChooser to trigger data loading after the delay.

Alarm Grid, CygNet Grid, Text Tool —

The Display alarm acknowledgment property enables the cell or text tool's background, text, and border to blink when the associated point is in alarm. Check each box to configure the:

• Background — The background of the cell or text tool will blink when the associated point is in alarm
• Text — The text in the cell or text tool will blink when the associated point is in alarm
• Border — The border of the cell or text tool will blink when the associated point is in alarm

If none of these options are selected, no visual indication of a point in alarm will be presented. However, if the point is in alarm, an Acknowledge alarm option will be available from the context menu in run mode.

Button —

The Display alarm acknowledgment property enables the button's text and border to blink when the associated point is in alarm. Check each box to configure the:

• Text — The text on the button will blink when the associated point is in alarm
• Border — The border of the button will blink when the associated point is in alarm

If none of these options are selected, no visual indication of a point in alarm will be presented. However, if the point is in alarm, an Acknowledge alarm option will be available from the context menu in run mode.

The Display alarm ranges check box indicates whether to display alarm ranges for the setpoints for the associated point on the donut. The colors depicted for the ranges are randomly chosen from a predefined set of colors.

The Display mode property specifies how to display the navigation menu when the screen is in run mode. By default, the navigation menu and the control's contents will adapt depending on the amount of available space. Options include:

• Minimal — The navigation menu shows and hides as you click the navigator icon () and all menu items are hidden when clicked
• Compact — Only the top-level menu icons display and sub-menu items are hidden when clicked
• Expanded — The top-level menu items always on display and sub-menu items are hidden when clicked

The default value is Compact.

The Display mode property specifies the method for displaying the data elements in the tile view. Options include:

• Single UDC — Data for a single UDC is displayed and a tile will be created for each child of a parent facility
• Each UDC for facility — Facilities are queried for their associated UDCs and a tile will be created for each one

The default value is Single UDC.

The Display mode property specifies the method for displaying the data elements in the tree map. Options include:

• Best fit — Elements are sized based on value and arranged in rectangles to best fit within the control's space. Best fit is the default value.
• Stacked — Elements are sized based on value and stacked vertically to fit within the control's space.

The default value is Best fit.

The Drag mode property determines the drag action for the chart in run mode. Setting it to Pan will start panning, instead of zooming when you drag the mouse over the plot area. To forbid any drag actions you can set the Drag mode to None. Options include:

• None — Turn off all dragging actions. Neither panning nor zooming is enabled.
• Pan — Enable panning only, zooming is disabled.
• Zoom — Enable zooming only, panning is disabled.

The default value is None.

The Earliest (span) property specifies the starting date for a trend; that is, the amount of time in the past from when to start the trend. Enter a number in the text box and select a time period from the drop-down menu. For example, 8 Hours ago or 2 Days ago.

The Earliest (unit) property specifies the unit of time in the past from when to start the trend. After entering a number in the text box, select a time period from the drop-down menu. The options include: Seconds, Minutes, Hours, Days, and Years. For example, 60 Seconds ago or 2 Hours ago. The default value is Hours.

The Enable live updates check box indicates whether this chart or sparkline will request new data at a specified interval allowing the chart to trend data at a real-time pace. When live updates are enabled and the next poll occurs, the series line will update to reflect the slope change, if any. The interval at which the trend moves forward is defined in the Update rate. If disabled, a trend is populated once with data from the Value History Service (VHS). You can disable/enable live updates for any chart in run mode via an icon on the chart toolbar.

The Empty bar color property specifies the color used for the empty or inner background bar in the linear gauge control. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated point (by selecting Point State).

The Empty ring color property specifies the color used for the empty or unused ring in the donut. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated point (by selecting Point State).

The Enabled check box indicates whether the control is enabled. The default value is True.

The End date (or End) property specifies the end date and time for a control (or screen or chart or column) for an absolute date and time view window. The format is MM/DD/YYYY hh:mm:ss AM/PM. The default value is the system date and time at which the control was first added to the screen. Click to change the date using the date picker.

The End relative date (or Relative end date or End) property specifies a wildcard string defining the amount of time by which to adjust end date and time. The space-separated elements in this string must be of the form: "x-#", "x+#", or "x=#" where # is an integer and x is one of the following unit specifiers: y — Year, m — Month, d — Day, H — Hour, M — Minute, S — Second, and # is an integer. T wildcard is also supported and must be in the form: T, T+#, T-#, where T represent today at midnight, T-1 is yesterday at midnight, and T+1 is tomorrow at midnight, etc. Any integer can be used. For example, H-8 represents data from the 8 hours before the current hour, d+3 represents data 3 days after the current day, and d+2 H+1 M+30 represents data 2 days, 1 hour and 30 minutes after the current date and time. d-4 H=6 sets the relative end date and time to four days ago (d-4) at 6:00 a.m. (H=6). See Date and Time Wildcards for more information about adjusting relative time.

The Facility property specifies the facility for which the control (or screen) is to display data. Click to select a facility using the Select Facility dialog box.

The Facility property specifies the source facility for the CygNet grid's rows. Options include:

• Source — Options include <Self>, Screen (default), or a list of Sender controls.
  • <Self> — Select <Self> to explicitly configure the facility for this control, which can be further filtered,.
  • Screen — Select Screen to inherit the facility from the screen for this control. By default, the sender is the Screen control if no other senders have been configured. Once Screen is selected Inherited from Screen will display for the Facility property.
  • Sender — A list of sender controls that have been configured with a facility will be displayed. Select the name of the control that will send its facility to this control. By default, the sender is the Screen control if no other senders have been configured. Once a sender control has been specified its name will display in the Source field.
• Filter — Only visible is the Source is <Self>.

  Use the Facility filter property to limit the data presented in the control to any CygNet filter attribute set up for your CygNet installation. Click to open the Facility Filter dialog box where you can create a custom filter rule. The filter rule is displayed in the property label; you do need to open the Facility Filter dialog box to edit the rule.

The Facility attribute property specifies the facility attribute that will displayed in the column. Click to reveal a drop-down menu of all available CygNet facility attributes categorized by type:

• Facility: General Attributes (The default value is Facility Description.)
• Facility: Text Attributes
• Facility: Table-driven Attributes
• Facility: Yes/No Attributes

Click to expand each category and select the desired facility attribute.

Alarm Grid —

A facility column presents data for a point by a facility attribute. You can choose to resolve the facility to a relative facility if desired. The property sheet displays Common and Facility properties.

CygNet Grid —

A facility column presents data for a point by a facility attribute. You can choose to resolve the facility to a relative facility if desired. The property sheet displays Common, Facility, and Color properties.

Object Container, Tag Chooser —

Use the Facility filter property to limit the data presented in the control to any CygNet filter attribute set up for your CygNet installation. Click to open the Facility Filter dialog box where you can create a custom filter rule. The filter rule is displayed in the property label; you do need to open the Facility Filter dialog box to edit the rule.

Search Box —

Use the Facility filter property to limit the data presented in the control to any CygNet filter attribute set up for your CygNet installation. A search will be executed against the facilities that are described by this filter. Click to open the Facility Filter dialog box where you can create a custom filter rule. The filter rule is displayed in the property label; you do need to open the Facility Filter dialog box to edit the rule.

The Facility mode property specifies how to handle facilities provided to the object container. Options include:

• Facility list — The object container will use the facilities provided and make an object for each one.
• Resolve children — The object container will use the Facility filter to resolve the children of the provided facility and create an object for each one.

The default value is Resolve children.

The Facility navigation mode (FacilityNavigationMode) property is included on the screen object to determine how a screen will handle a request to navigate to another screen via a facility. This property is used with the NavigateByFacility or OpenedViaHyperlink events to link to a facility's associated screen or replace a current screen in a Navigator control with a facility's associated screen. Click to reveal a drop-down menu of options:

• Script event —

  Fires a NavigateByFacility script event on the screen that provides the associated screen path, as well as any optional facility record properties, to send when this navigation is triggered. The EventArgs type for this event is:

  Canvas.Shared.Events.NavigateByFacilityEventArgs

  The associated screen path for the facility is configured in the facility record in CygNet Explorer. The screen path facility attribute, and any optional facility record properties to be included when this navigation is triggered, is configured in the Backstage view.

• Hyperlink - Open — Opens the facility's associated screen in a new window.
• Hyperlink - Replace — Replaces the current screen with the facility's associated screen.
• Hyperlink - Replace with navigation — Replaces the current screen with the facility's associated screen and adds a navigation toolbar.
• Navigator - Replace — Notifies any Navigator controls on the current screen to replace the active screen with the facility's associated screen.
• Navigator - Replace with navigation — Notifies any Navigator controls on the current screen to replace the active screen with the facility's associated screen and add a navigation toolbar.

The default value is Hyperlink - Open.

See Navigation by Facility for more information about using this property.

A list of sender controls that have been configured with a facility will be displayed. Select the name of the control that will send its facility to this control. By default, the sender is the Screen control if no other senders have been configured. Once a sender control has been specified its name will display in the Source field.

The Facility sender mode property determines which mouse-click actions will send facilities to other controls. Options include:

• None — No facilities are sent.
• Single click — A single click will send facilities to another control.
• Double click — A double click will send facilities to another control.
• All facilities — All facilities in the grid will be sent to another control.

The default value is None.

Sending and receiving facility tags

Some controls on the same screen allow for the sending of facility tag information from one control to another.

1. On the sending control configure the Facility sender mode property to send facility tag information to another control on the same screen.
2. On the receiving control configure the Selection mode property (in either CygNet connection or Point configuration section) to Facility tag and select the Facility Source to the sending control.
3. On the receiving control configure a display tag that associates to a facility property, e.g. %FacilityTag%.

The Facility service property specifies the service to use for this tag chooser. Click to select a Facility service using the Select Service dialog box.

The Facility tag property specifies the full facility tag identifier for which the control (or screen) is to display data. Click to select a facility using the Select Facility Tag dialog box.

The Facility type filter property specifies the facility type on which to filter the hierarchy, in all UPPERCASE letters. The nodes in the hierarchy will correspond to the Facility Type column in the Facility service. This must be a valid facility type in your system. The types are stored in the SYSFCTYP table in the Table Reference Service (TRS). You can also see a list of types by displaying the properties for a facility and clicking the Type browse button. For example, common facility types include REMDEV, MTRRUN, WELL, PLNGR, TANKS, PUMP, etc. Leave this blank to include all facility types.

This property specifies the path to the file, image file, object file, or screen file. Depending on the selection in the source property the type of path is different. Click to access either the:

• Select File dialog box — To access a CygNet APPS or BSS folder
• Open File dialog box — To access a local or network Windows file-system folder

This property specifies the source to the file, image, object file, or screen. Options include:

• BSS — Indicates that the file is stored in a CygNet APPS or BSS folder
• Local — Indicates that the file is stored in a local or network Windows file-system folder

The default file source is Local.

The Fill color property specifies the color used for the internal body of the control. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated point (by selecting Point State).

The Filter Type property allows you to limit the number of facilities displayed in the tree map. By configuring a value in the Items to filter property, and selecting Top or Bottom in this property, only the top or bottom number of facilities will be displayed, no matter how many facilities are sent to the tree map from the sending control. Options include:

• None — No filtering occurs.
• Top — Only show the top number of items in the tree map.
• Bottom — Only show the bottom number of items in the tree map.

The default value is None.

The Flip enabled property indicates whether to enable flipping of the detail control when clicked.

The Font size property specifies the font size of the text on the control.

The Font size (bottom) property specifies the font size of the bottom text on the control. Only applies if Font size mode is set to Fixed.

The Font size (main) property specifies the font size of the main text on the control. Only applies if Font size mode is set to Fixed.

The Font size (top) property specifies the font size of the top text on the control. Only applies if Font size mode is set to Fixed.

The Font size mode property specifies the method used to size the text on the control. Options include:

• Auto — Automatically size the text relative to the size of control.
• Fixed — Size the text using the values specified in the Font size property.

The default value is Auto. The default value for the text tool is Fixed.

Alarm Grid —

A generic column can display any kind of scripted data of your choosing using C# or VB.NET at run-time. First configure the column in Canvas and then reference the column by name to pull in CygNet or other values. A generic column can be used to discover data defined in a supporting script. If the column is defined, but no data is defined, then the column is hidden by default.

The cells in a generic column can be configured to be editable in run mode, so that, for example, users could make quick data changes to facilities in a grid format. Changed values are not saved anywhere but in the grid, but they can be saved or otherwise manipulated via script.

The property sheet displays only Common properties.

CygNet Grid —

A generic column can display any kind of scripted data of your choosing using C# or VB.NET at run-time. First configure the column in Canvas and then reference the column by name to pull in CygNet or other values. A generic column can be used to discover data defined in a supporting script. If the column is defined, but no data is defined, then the column is hidden by default.

The cells in a generic column can be configured to be editable in run mode, so that, for example, users could make quick data changes to facilities in a grid format. Changed values are not saved anywhere but in the grid, but they can be saved or otherwise manipulated via script. Note that when a generic column is set to editable the Color properties are not configurable.

The property sheet displays only Common and Color properties.

The Grid color property specifies the color of the lines in the layout grid. Click to select a color using the color picker.

The Grid height property specifies the height of the layout grid. The default is 10 pixels high.

The Grid width property specifies the width of the layout grid. The default is 10 pixels wide.

The Group name property specifies the name of the group that indicates which radio buttons are mutually exclusive.

The Group service property specifies the service to use for this tag chooser. Click to select a Group service using the Select Service dialog box.

The Height property specifies the height of the control (or screen).

The Hide invalid tag check box indicates whether to hide the control if it resolves to an invalid or unknown tag.

The Hierarchy type property is used to select the service type by which the tag chooser's facilities will be organized: by Facility service or by Group service.

The High range color property specifies the color to be used at the high end of the value range. Click to select a color using the color picker.

The Horizontal alignment property specifies the horizontal position of the text within the boundary of the control. Click to select from the following options: Left, Right, Center, or Justify. The default value is Center.

The Horizontal resize mode property specifies whether and how the control dynamically moves or resizes horizontally when the screen is resized in run mode. Options include:

• None — No resizing occurs.
• Shift — The object will shift horizontally.
• Expand — The object will expand or shrink horizontally the same number of pixels as the screen.
• Proportional — The object expands or shrinks proportionally to the screen.

The default value is None.

The Hover mode property specifies the mode when hovering over a series in the chart. Two options are available:

• None — No change to the other series in the chart.
• Fade other series — When hovering over a series, all other series in the chart are faded.

The default value is None.

The Icon path property specifies the icon to display to the left of a top-level menu item. Click to select an image file from the Open Files dialog box, where you can access a CygNet APPS or BSS folder or a local or network Windows file-system folder. This option is not available for sub-menu items.

The Icon preview property displays a preview of the selected icon. This option is not available for sub-menu items.

The Icon size property is used to set the dimensions of the menu icon. The range is 8 to 40 pixels. The default is 16 by 16 pixels.

The Image size property indicates the size of the image on the button.

The ImageSizeMode property specifies the method used to size the image on the button. Options include:

• Auto — Automatically size the image relative to the size of control.
• Fixed — Size the image using the values specified in the Image size property.

The default value is Auto.

The Image property indicates the file path and file name of the image that will be substituted when the point state changes to the selected point state. Click to open the Open dialog box, where you can access a CygNet APPS or BSS folder or a local or network Windows file-system folder. Browse and select the desired image file.

The Image resolution mode property determines how a point's status should be used to select images to display. The control will display an image based on the point state or the alarm condition of the associated point. The point state of the associated point is evaluated to determine which image to display. This new behavior mirrors the CygNet Studio Image tool. Options include:

• Point state — all possible point states are included
• Alarm condition — only point states marked explicitly as an alarm condition in the CVSMetadata are included (point states with the alarm condition attribute set to "true")

The default option is Point state.

The Image Selection dialog box is where you configure the image that will be displayed in the control. The image can be explicitly configured to a default image or it can be dynamically changed based on the point state of the associated point.

Click to open the Image Selection dialog box.

The Include in script check box indicates that the control will appear in the objects collection of the screen (if scripting is enabled). To optimize performance, best practice dictates that you only include the controls you need to manipulate via script. Other controls should be excluded. When you add an event to a control, it will be automatically added to script and the Include in script property (and the In Script check box on the Controls view) will be set to True.

The Is logarithmic property indicates whether the gauge scale is linear or logarithmic.

The Is pan zoom control visible check box indicates whether to display the pan zoom control on the screen in run mode. Pan and zoom are always enabled in design mode; the control is optional in run mode.

The Is pan/zoom enabled check box indicates whether the user can pan around or zoom in and out of the screen. Pan and zoom are always enabled in design mode; the control is optional in run mode.

The Combo Box Items dialog box displays all the item labels that will appear in the combo box and their corresponding values.

Click to open Combo Box Items dialog box.

The Items to filter property specifies the number of items to filter if the Filter type is set to Top or Bottom.

Check Box —

The Label property specifies the text label to display next to the check box. By default, the label appears to the right of the check box.

Combo Box —

The Label property specifies the label for an item in the combo box drop-down menu.

Radio Button —

The Label property specifies the text label to display next to the radio button.

The Label background color property specifies the background color of the label associated with the point in the chart series. Click to select a color using the color picker. The Show labels property must be enabled to change the background color of the label.

The Label connector color property specifies the color of the label border and the connector line linking the label to the point in the chart series. Click to select a color using the color picker. The Show labels property must be enabled to change the color of the label connector.

The Label on Left check box indicates if the label should be shown on the left side of the check box.

The Label text color property specifies the color of the text on the label associated with the point in the chart series. The text color is sometimes known as the foreground color. Click to select a color using the color picker. The Show labels property must be enabled to change the text color on the label.

The Layer property specifies the layer for this control. Layers are used to show, hide, and edit multiple controls on one layer without affecting controls on another layer.

• Type the name of the layer into the Layer field.
• All layers are listed on the Layers pane, where you can show and hide layers for the screen in design mode and run mode.

The Legend date format property specifies the format for the dates used in the chart legend.

The Legend format property specifies the format for the text used in the chart legend. Build a dynamic text string, based on real-time CVS point properties, point configuration properties, and facility properties, using text tokens to represent a CygNet point attribute. Click to configure text and property strings using the CygNet Property String dialog box. The default format is %SiteService%:%PointIdLong%. For example, CYGDEMO.UIS: <FACILITY_UDC>.

If you leave this property empty, the chart will use the series Name value in the legend.

The Legend location property specifies where the chart legend should appear, if it is shown. Options include: Left, Top, Right, or Bottom. The default value is Bottom.

The Legend value format property specifies the format for the legend's point value using any of the valid .NET standard or custom numeric format strings. The value format applies to a point's value, primary value, and alternate value properties.

The Line color property specifies the color used for the border line of the control. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated point (by selecting Point State).

The Line style property specifies the style of the shape's border line. Click to select from the following options: Custom, Solid, Dashed, and Dotted. The default value is Solid. Select Custom to define your own line style and enter the values in the Custom line style property.

The Line width property specifies the width of the shape's border line.

The Long point ID property specifies the long point ID of the CygNet point for which the control is to display data. Type the tag into the field.

The Low range color property specifies the color to be used at the low end of the value range. Click to select a color using the color picker.

The Lower value bound property specifies the lower value to use when filling the control.

The value bound can be explicitly configured (by selecting <Self>) or the value can be sourced from an application-specific attribute of the associated point (by selecting Point Attribute). Point application attributes are configured on the Application page of the CygNet PNT Editor. The following fields are available to store an attribute that can be used to indicate the value bound.

• Indexed attributes — A property that is included in a defined PNT index. This can be free-form text up to 15 characters. Three fields are available.
• General data attributes — A property that can be free-form text up to 20 characters. Three fields are available.

Options include:

• Source — Click to reveal two options:
  • <Self> — Select <Self> to explicitly configure the value bound in the Value field.
  • Point Attribute — Select Point Attribute to specify that the source of the value bound corresponds to a point attribute of the associated point represented in the control.
• Value — Configuration depends on the source:
  • If the Source is <Self>, select a number using the spin control. The default value is 0.
  • If the Source is Point Attribute, click to select from the following point attribute options: Indexed 1, Indexed 2, Indexed 3, General 1, General 2, or General 3.

The Main screen path property specifies the path to the Canvas file that will be displayed when you click the Maximize button on the tile view in run mode. Click to open the Open Files dialog box, where you can access a CygNet APPS or BSS folder or a local or network Windows file-system folder.

The Marker border color property specifies the color used for the border of the triangular marker in the value indicator. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated point (by selecting Point State).

The Marker color property specifies the color used for the value marker on the donut. The color can be sourced from one of two options:

1. explicitly configured (using <Self>)
2. sourced from the point state of the associated point (by selecting Point State)

The default value is <Self>.

The Marker fill color property specifies the color used for the interior of the triangular marker in the value indicator. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated point (by selecting Point State).

The Marker height property specifies the height of the triangular marker for the point value on the donut.

The Marker width property specifies the width of the triangular marker for the point value on the donut.

The Maximum Y value property specifies the maximum value to use on the sparkline's y-axis when the Auto range - y-axis property is set to fixed (disabled).

The Navigator Menu Configuration dialog box displays all the menu items that will appear in the navigator's menu, and each menu item's properties: label, screen path, whether this screen is the start screen, icon path, and an icon preview.

Click to open the Navigator Menu Configuration dialog box.

The Menu item label property specifies the label for an item in the navigator menu.

The Menu width property specifies the width of the main navigator menu in expanded mode. The default value is 150 pixels. The minimum width is 40 pixels.

The Minimum Y value property specifies the minimum value to use on the sparkline's y-axis when the Auto range - y-axis property is set to fixed (disabled).

The Mouse cursor property determines which mouse cursor will appear when the mouse hovers over this control. Select an option from the drop-down menu: Arrow (), Hand (), Wait (), or Help (). The default cursor is the Arrow ().

The Name property specifies the unique identifier for this control. Valid characters are A-Z, 0-9, and underscore (_). Spaces are not allowed. Names cannot start with a number. The default value is the object name and the numeric instance. The control's Name is also displayed on the Controls view of the Screen pane.

The Name specifies the name that appears in the column header.

The Name property specifies the label for the selected chart series, which is displayed in the upper right corner of the chart.

This property specifies the path to the file, image file, object file, or screen file. Depending on the selection in the source property the type of path is different. Click to access either the:

• Select File dialog box — To access a CygNet APPS or BSS folder
• Open File dialog box — To access a local or network Windows file-system folder

This property specifies the source to the file, image, object file, or screen. Options include:

• BSS — Indicates that the file is stored in a CygNet APPS or BSS folder
• Local — Indicates that the file is stored in a local or network Windows file-system folder

The default file source is Local.

The Object limit property specifies the maximum number of objects to be added to the container. Use this value to limit the number of objects and avoid poor performance when loading an unexpectedly large number of objects.

The Override chart dates check box indicates whether to use the screen's dates, when displaying charts for this screen.

Select the Override chart's facility check box to specify a different facility for this chart series. Once checked a facility field is revealed where you can override the facility configured for the chart. The chart's facility is specified in the CygNet Connection property group.

If Override chart's facility is selected the Resolve to a relative facility option is removed.

Select the Override chart's SiteService check box to specify a different SiteService for this chart series. Once checked a SiteService field is revealed where you can override the SiteService configured for the chart. The chart's SiteService is specified in the CygNet Connection property group.

The Order in type property specifies the attribute value used to represent the order in type (facility ordinal) if the relative facility definition is configured for one. It is possible to have multiple relative facility definition sets with the same definition name. In this case, if the specified Relative link is configured for ordinalization, then you need to configure the attribute value in the box.

The Pan mode property allows users to pan in the chart plot area when there is a dense area of data points that cannot be seen clearly at the normal chart scale. With Pan enabled you can reduce the area you want to examine using the scroll bars, and then drag the chart within the pan region horizontally, vertically, or in both directions. Options include:

• None — Panning with the mouse is disabled.
• Horizontal — Panning with the mouse is enabled only on the horizontal axis.
• Vertical — Panning with the mouse is enabled only on the vertical axis.
• Both — Panning with the mouse is enabled both on the horizontal and vertical axes. You can use this value to remove any restrictions, thus the chart can be panned on both the horizontal and vertical axes.

The default value is None.

The Path property specifies the path to the global settings file. Depending on the selection in the source property the type of path is different. Click to access either the:

• Select File dialog box — To access a CygNet APPS or BSS folder
• Open File dialog box — To access a local or network Windows file-system folder

The Rollup period property works in conjunction with the Rollup unit to define the interval by which a specified Rollup type takes place. For example, if you selected Minutes from the Rollup unit drop-down menu, then typed 3 in the Rollup period field, rollups for the control would occur every three minutes. Enter only whole numbers.

The Point property is used to determine how the CygNet point will be configured. Click the appropriate radio button to reveal the desired field.

• UDC — The UDC property specifies the UDC for which the control is to display data. Click to select a UDC using the Select UDC dialog box.
• Long point ID — The Long point ID property specifies the long point ID of the CygNet point for which the control is to display data. Type the tag into the field.

The Point attribute property specifies the point attribute that will be displayed in the column. Click to reveal a drop-down menu of all available CygNet point attributes categorized by type:

• Current Values (The default value is Value.)
• Point: General
• Point: Alarm
• Point: Point Reference
• Point: Application
• Point: Scaling
• Point: Hyperpoint
• Point: Alarm (Scheme 0)
• Point: History
• Current Value Status Bits

Click to expand each category and select the desired point attribute.

Alarm Grid —

A point column presents data for a point by UDC and point attribute. You can choose to resolve the point to a relative facility if desired. The property sheet displays Common and Point properties.

CygNet Grid —

A point column presents data for a point by UDC and point attribute. You can choose to resolve the point to a relative facility if desired. The property sheet displays Common, Point, and Color properties.

The Point configuration property is used to configure the CygNet point associated with the control. Click to reveal a drop-down area where you can configure the Selection mode, source Facility tag, source SiteService, source Facility, and the UDC or Long Point ID for the point. Each option is described below.

See each control for more information about configuring points.

The point scheme defines the point types, point alarms, point statuses, and default colors for a CygNet domain.

Point state is the highest precedented state for a point record as defined for each point scheme. The point state for a point record is based on 48 System, Configuration, and User status bits, which are associated with the four point types (Analog, Digital, String, Enumeration). A point record may contain up to 48 status bits, which are used to provide point status information about the point record in a CVS and the ELSALM. A point can be in multiple states at the same time, for example, in High Warning and High Alarm; however, the state defined to be the most severe is the one that is used for the point state (i.e., High Alarm, in this case).

The point types configured for the selected point scheme for your CygNet system. The default CygNet Standard Point Scheme has eight point types: Analog Input & Analog Output, Digital Input & Digital Output, Enumeration Input & Enumeration Output, and String Input & String Output.

Use the Properties to Search property to select the facility properties that will be searched in the search box.

1. Click to open the Properties to Search dialog box.
2. Select the facility properties and attributes to use.
3. Click OK.

Searching many properties and searching non-indexed properties may negatively impact performance.

The default properties are Facility Description and Facility ID.

The Read only property indicates whether the cells in a Generic column are editable.

The End relative date (or Relative end date or End) property specifies a wildcard string defining the amount of time by which to adjust end date and time. The space-separated elements in this string must be of the form: "x-#", "x+#", or "x=#" where # is an integer and x is one of the following unit specifiers: y — Year, m — Month, d — Day, H — Hour, M — Minute, S — Second, and # is an integer. T wildcard is also supported and must be in the form: T, T+#, T-#, where T represent today at midnight, T-1 is yesterday at midnight, and T+1 is tomorrow at midnight, etc. Any integer can be used. For example, H-8 represents data from the 8 hours before the current hour, d+3 represents data 3 days after the current day, and d+2 H+1 M+30 represents data 2 days, 1 hour and 30 minutes after the current date and time. d-4 H=6 sets the relative end date and time to four days ago (d-4) at 6:00 a.m. (H=6). See Date and Time Wildcards for more information about adjusting relative time.

The Relative link property specifies a list of all available relative facility paths. Click to reveal a drop-down menu of all available relative facility definitions (relative links). Select a link from the list. If an order-in-type attribute is specified for the selected link, the Order in type field will display.

The Begin relative date (or Relative start date or Start) property specifies a wildcard string defining the amount of time by which to adjust the start date and time. The space-separated elements in this string must be of the form: "x-#", "x+#", or "x=#" where # is an integer and x is one of the following unit specifiers: y — Year, m — Month, d — Day, H — Hour, M — Minute, S — Second, and # is an integer. T wildcard is also supported and must be in the form: T, T+#, T-#, where T represent today at midnight, T-1 is yesterday at midnight, and T+1 is tomorrow at midnight, etc. Any integer can be used. For example, H-8 represents data from the 8 hours before the current hour, d+3 represents data 3 days after the current day, and d+2 H+1 M+30 represents data 2 days, 1 hour and 30 minutes after the current date and time. d-4 H=6 sets the relative start date and time to four days ago (d-4) at 6:00 a.m. (H=6). See Date and Time Wildcards for more information about adjusting relative time.

The Resolve filter if no facility property indicates whether to use the facility filter to resolve against all facilities if no facility is provided. If a facility is set for the object container, then it will search the child facilities of that facility using the provided facility filter. By enabling Resolve filter if no facility, the object container will use the provided facility filter against all facilities for the specified SiteService.

The Resolve to a relative facility check box redirects the source of the facility to a relative facility, overriding the configured source facility. Once selected a list of configured Relative links is displayed.

See Using Relative Facilities in Canvas for more information about configuring and scripting relative facility links.

The Ring color property specifies the color used for the outer ring that represents the point value in the donut. The color can be sourced from one of two options:

1. explicitly configured (using <Self>)
2. sourced from the point state of the associated point (by selecting Point State)

The default value is <Self>.

The Rollup property group contains properties that determine how data is rolled up in the chart series, such as type, units, period, and offset.

The Rollup period property works in conjunction with the Rollup unit to define the interval by which a specified Rollup type takes place. For example, if you selected Minutes from the Rollup unit drop-down menu, then typed 3 in the Rollup period field, rollups for the control would occur every three minutes. Enter only whole numbers.

Chart —

By default, a rollup derives its values from raw data stored in the Value History Service (VHS). The Rollup type drop-down menu enables you to rollup data for the selected point. Using the Rollup type option might be preferable to using the data thinning option because rollup calculations performed by the VHS can provide improved performance and reduced network traffic relative to data thinning. Rollup type options are as follows:

• None (default)
• Calculated weighted average
• Calculated mean
• Calculated minimum
• Calculated maximum
• Calculated delta
• Calculated last
• Thin median
• Thin minimum / maximum
• Thin last

Heap Map —

By default, a rollup derives its values from raw data stored in the Value History Service (VHS). The Rollup type drop-down menu enables you to rollup data for the selected point. Using the Rollup type option might be preferable to using the data thinning option because rollup calculations performed by the VHS can provide improved performance and reduced network traffic relative to data thinning. Rollup type options are as follows:

• None
• Calculated weighted average
• Calculated mean (default)
• Calculated minimum
• Calculated maximum
• Calculated delta
• Calculated last
• Thin median
• Thin minimum / maximum
• Thin last

Tree Map —

By default, a rollup derives its values from raw data stored in the Value History Service (VHS). The Rollup type drop-down menu enables you to rollup data for the selected point. Using the Rollup type option might be preferable to using the data thinning option because rollup calculations performed by the VHS can provide improved performance and reduced network traffic relative to data thinning. Rollup type options are as follows:

• Calculated weighted average
• Calculated mean (default)
• Calculated maximum
• Calculated minimum
• Calculated last
• Calculated delta

Chart —

The Rollup unit property options define the time units by which a specified Rollup type takes place. The Rollup Unit options are as follows:

• None (default)
• Minutes
• Hours
• Days
• Seconds

For instance, if you select Minutes, rollups occur on a minute basis. The interval is further defined by the Rollup Period setting, which defines how many (in this case) minutes long a rollup period is.

Heat Map —

The Rollup unit property options define the time units by which a specified Rollup type takes place. The Rollup Unit options are as follows:

• None
• Minutes
• Hours
• Days (default)
• Seconds

For instance, if you select Minutes, rollups occur on a minute basis. The interval is further defined by the Rollup Period setting, which defines how many (in this case) minutes long a rollup period is.

Tree Map —

The Rollup unit property options define the time units by which a specified Rollup type takes place. Rollup unit options are as follows:

• Days (default)
• Hours
• Minutes

For instance, if you select Minutes, rollups occur on a minute basis. The interval is further defined by the Rollup period setting, which defines how many (in this case) minutes long a rollup period is.

The Row configuration property is where you specify the source of the facility (and maybe the SiteService) for the row of the CygNet grid to use. The source for the facility can be explicitly configured for this row or it can be inherited from the screen or another control. If Row configuration is set to <Self> then you also need to provide a SiteService. This could be manually configured or inherited.

The Row header font size property specifies the font size for the text that lies to the left of each row in the heat map.

The Row height property specifies the height of each heat map row. Only applicable if the Row sizing mode is set to Fixed.

The Row sizing mode specifies the method used to size the heat map row height. Options include:

• Auto — Automatically size the rows based on the height of the heat map.
• Fixed — Size the rows using the value specified in the row height property. If this requires more vertical space than is available, a scroll bar will be added.

The default value is Auto.

This property specifies the source to the file, image, object file, or screen. Options include:

• BSS — Indicates that the file is stored in a CygNet APPS or BSS folder
• Local — Indicates that the file is stored in a local or network Windows file-system folder

The default file source is Local.

This property specifies the path to the file, image file, object file, or screen file. Depending on the selection in the source property the type of path is different. Click to access either the:

• Select File dialog box — To access a CygNet APPS or BSS folder
• Open File dialog box — To access a local or network Windows file-system folder

Linking between Canvas screens, objects, and nested views is quite flexible. You don't need to specify the service or folder information in the path to find related screens, objects, or nested views, although you can if desired. When specifying a path to another file, the following notes apply:

If the screen or object file is in the APPS or BSS, you can specify the:

• full path of the file
• folder\filename.can of the file (Canvas uses the source file's service)
• filename.can of the file (Canvas uses source file's service and folder)

If the screen or object file is in the local file system, you can specify the:

• full path of the file
• filename.can of the file (Canvas uses source file's path)

Navigator —

The Screen path property specifies the screen that will open in the body of the navigator. Click to select a screen from the Open Files dialog box, where you can access a CygNet APPS or BSS folder or a local or network Windows file-system folder. The option is not available for top-level menu items with sub-menu items.

Tab Control —

The Screen path property specifies the screen that will open in the body of the tab control. Click to select a screen from the Open Files dialog box, where you can access a CygNet APPS or BSS folder or a local or network Windows file-system folder. If no screen is specified, the nested view does not display in run mode.

The Search custom check box indicates whether a custom search will be performed.

This property invokes the CustomSearch script property, a delegate that references a custom search method, when a user searches for a string.

Example

See Scripting Custom Searches for more information about this property.

The Search facilities check box indicates whether to search for facilities based on facility attributes, filter settings, and SiteService. The default value is True. This property works in conjunction with the Facility filter, Properties to search, and SiteService properties.

The Selected check box indicates whether the radio button initially displays as selected.

The Selected index property specifies a zero-based index for the selected tab. -1 indicates no tab is selected and no nested view will display in run mode. 0 indicates the first tab is selected; 1 indicates the second tab is selected; 2 indicates the third tab is selected; and so on.

The Selected action property specifies the action to take when a search result is selected. Options include:

• FacilitySender — The search box acts as a facility sender and sends the selected facility to any controls configured to receive it. This only works if the selected result includes a facility.
• Navigate — The search box will navigate to the selected facility's associated screen or the selected screen. The navigation mode is determined by the Facility navigation mode property setting on the screen displaying the search box. Also see Navigation by Facility for more information.
• Script — Executes a script event when selecting a facility or custom item from the search results. If you are setting up a facility search, and want to script the selection action, you also need to enable the Search facilities check box. If you are setting up a custom search to query some other object, for example, a SQL database, a .csv file, even a web site, you also need to enable the Search custom check box. See Scripting Custom Searches for more information.

The default value is FacilitySender.

The grid controls offer three selection modes, which determine how many grid units may be selected in run mode. The grid units are determined by the Selection unit property. Options include:

• Single — Only one item can be selected at a time.
• Multiple — Items are added to the selection when they get clicked and get removed when they get clicked again.
• Extended — Items are added to the selection only by combining mouse clicks with the Ctrl key or Shift key.

The default value is Single.

In script, use SelectionMode with the SelectAll method and SelectedRows property (read-only) to aid in multi-row selection:

• SelectAll method — If the SelectionMode property is Multiple or Extended, SelectAll will select all rows in a grid and SelectedRows will return the matching DataRow objects. SelectAll will not obviously change the selection if SelectionMode is Single.
• SelectedRows property (read-only) — SelectedRows will be restricted to a single row if SelectionMode is Single. Otherwise SelectedRows can contain multiple rows to be retrieved via script.

The Selection mode property is used to determine how the control will receive CygNet information from other controls. Two options are available; click the desired radio button:

• Facility tag — The Facility tag selector consists of a Source chooser and Resolve to a relative facility check box. If the Source is <Self> a Facility tag selector and relative facility options are also displayed. Facility tag is the default option.
• SiteService / Facility — The SiteService / Facility selector consists of Source and SiteService and facility choosers.

Sending and receiving facility tags

Some controls on the same screen allow for the sending of facility tag information from one control to another.

1. On the sending control configure the Facility sender mode property to send facility tag information to another control on the same screen.
2. On the receiving control configure the Selection mode property (in either CygNet connection or Point configuration section) to Facility tag and select the Facility Source to the sending control.
3. On the receiving control configure a display tag that associates to a facility property, e.g. %FacilityTag%.

The CygNet grid control offers three selection units. The Selection unit property determines the grid units that may be selected in run mode. Options included:

• Cell — Only the clicked cell is selected. Depending on the value of the Selection mode property you can have more than one selected cell
• Full row — Clicking within any cell will select the entire row.
• Mixed — Select any cell and you can also select a full row if you click on a row, but not on a cell from it.

The default value is Full row.

The Series configuration box contains all the properties required to configure a series on your chart. The number of defined series is listed on the property label. Although some properties of a series are inherited from the screen or from another object on the current screen, you can define properties specific to a certain series, in some cases overriding the inherited properties.

• Click to reveal the Series configuration box, which is organized into four property groups: Series, Appearance, Rollup, and Data source.
• Click Add series to add a new, blank series to a y-axis. Each new series is assigned a dynamically generated color, which can be changed later if desired. Complete the new series configuration to suit your needs using the properties described below. Alternately, you can locate the desired point or facility in the Tag Chooser pane and drag and drop it to your chart.

• Click to expand each property group. Click to collapse each property group.

• Click (Delete series) to remove a series from your chart.

The Series property group contains properties that configure the primary attributes of the chart series, such as name, UDC, color, SiteService override, facility override, and relative facility resolution.

The Series type property specifies the style to use for the chart series. Click to select an option from the drop-down menu. Options include:

• Bar — A bar chart visualizes data as a set of rectangular bars, with the length of each bar representing the value of each data point. Each bar is the color assigned to the series.
  • When adding a series showing custom non-CygNet data in a Bar chart type via script, you must set the color at the point level. This allows for points to be colored differently from each other.
• Line — A line chart shows information as a series of data points connected by straight lines. This is the default series type for the chart.
• LineArea — An line area chart is based on the line chart and shows information as a series of data points connected by straight lines, with the area between the X-axis and the line filled with the line color.
• Spline — A spline chart is a line chart where data points are connected by a smooth curve.
• SplineArea — A spline area chart is based on the spline chart where data points are connected by a smooth curve, with the area between the X-axis and the line filled with the line color.
• Step — A step chart is a line chart in which data points are connected by horizontal and vertical lines, looking like a series of steps.
• StepArea — A step area chart is based on the step chart where data points are connected by horizontal and vertical lines, looking like a series of steps, with the area between the X-axis and the steps filled with the line color.

Click here to see an example of each type of series.

The Shape geometry property specifies a special abbreviated syntax that defines the shape's geometry. If you want to manually modify these values, set the Shape type to Custom.

The Shape type property specifies the type of shape to draw. Click to select from the following options:

• Circle
• Custom shape
• Diamond
• Double-ended horizontal arrow
• Double-ended vertical arrow
• Down arrow
• Left arrow
• Line (horizontal)
• Line (vertical)
• Right arrow
• Square
• Triangle
• Up arrow
• Valve (horizontal)
• Valve (vertical)

The default value is Custom shape.

Select Custom shape to define your own shape and enter the values in the Shape geometry property.

The Show alarm icon indicates whether to show or hide the alarm icon in the detail control.

The Show alarm notifier property indicates whether the alarm notifier is visible on this screen when opened in Canvas View and Canvas View Lite. This property is set to true (On) by default and the alarm banner will always appear at the top of a screen in run mode, unless you turn it off in design mode.

The Show cell labels check box indicates whether to display the value in each cell. Note that displaying a value may have an impact on performance.

The Show configuration check box indicates whether to display the configuration field in run mode.

The Show context menu check box indicates whether a right-click context menu will be available or suppressed in run mode. The default context menu will allow alarm acknowledgment, access to point history and alarm history, point configuration, and facility configuration.

The Show grid property indicates whether to show the grid lines in design mode. By default the layout grid will be displayed. The grid will always be hidden in run mode.

The Show image property indicates whether to display an image along with any button text.

The Show labels check box indicates whether to display a label corresponding to each data point in the chart series when in run mode. The labels will dynamically reorient their position when you resize or reshape a screen.

The Show legend check box indicates whether to display the legend on the chart.

The Show value marker check box indicates whether to show a triangular marker for the point value on the donut. The marker's color is configurable:

The Marker color property specifies the color used for the value marker on the donut. The color can be sourced from one of two options:

1. explicitly configured (using <Self>)
2. sourced from the point state of the associated point (by selecting Point State)

The default value is <Self>.

See Color configuration: Marker color for more information.

Chart (Series) —

The Show points check box indicates whether to display the points on the chart series. Once enabled, several other properties (color, size, and label attributes) become configurable.

Tag Chooser —

The Show points check box indicates whether to display the points in the tag chooser. Points are designated with a blue circle () in the tag chooser hierarchy.

The Show primary scale property indicates whether to show the primary scale on the linear gauge. The primary scale shows the lower to upper bound values and includes major and minor tick marks.

The Show scale check box indicates whether to display the color scale beneath the heat map.

The Show secondary scale property indicates whether to show the secondary scale on the linear gauge. The secondary scale shows the lower to upper bound values.

The Show sparkline indicates whether to show or hide a sparkline in the detail control.

The Show time slice check box indicates whether to display a vertical time slice that will snap to the nearest data point and call out the point value and timestamp for all series in the chart in run mode.

The Show Tooltips check box indicates whether to display tooltips when hovering over a data point or cell. When you hover over a data point or cell in run mode the tooltip displays the point value and timestamp. Only available when a control is showing points.

The Show top labels check box indicates whether to display the date and time labels along the top of the heat map.

The Show x-axis label check box indicates whether to display the label text on the x-axis, which is typically the unit of time being displayed in the chart.

The Show y-axis label check box indicates whether to display the label text on the y-axis, which is typically the range of units being displayed on the chart.

The SiteService property specifies the SiteService for which the control (or screen) is to display data. Click to select a service using the Select Service dialog box.

The SiteServices property specifies the service(s) for which the search box is to display data. Click to select a service(s) using the Select Services dialog box.

The Size property specifies the size of the point displayed on the chart series. The default value is 5. The Show points property must be enabled to change the point size.

The Snap to grid property indicates whether controls should snap to the grid. The default value is true.

The Snap to items property indicates whether controls should snap to other controls. The default value is true.

The Sort numerically property specifies whether this column can be sorted numerically. In run mode, clicking a column header moves between the three states: sort ascending, sort descending, and unsorted. A small arrow indicates the sort order.

The Source property specifies the source of the global settings file. Select from the following options:

• BSS — Indicates that the file is stored in a CygNet APPS or BSS folder
• Local — Indicates that the file is stored in a local or network Windows file-system folder

The default value is BSS.

The Sparkline color (or Color) property specifies the color of the sparkline. Click to select a color using the color picker.

The Begin date (or Start or Start date) property specifies the start date and time for a control (or screen or chart or column) for an absolute date and time view window. The format is MM/DD/YYYY hh:mm:ss AM/PM. The default value is the system date and time at which the control was first added to the screen. Click to change the date using the date picker.

The Begin relative date (or Relative start date or Start) property specifies a wildcard string defining the amount of time by which to adjust the start date and time. The space-separated elements in this string must be of the form: "x-#", "x+#", or "x=#" where # is an integer and x is one of the following unit specifiers: y — Year, m — Month, d — Day, H — Hour, M — Minute, S — Second, and # is an integer. T wildcard is also supported and must be in the form: T, T+#, T-#, where T represent today at midnight, T-1 is yesterday at midnight, and T+1 is tomorrow at midnight, etc. Any integer can be used. For example, H-8 represents data from the 8 hours before the current hour, d+3 represents data 3 days after the current day, and d+2 H+1 M+30 represents data 2 days, 1 hour and 30 minutes after the current date and time. d-4 H=6 sets the relative start date and time to four days ago (d-4) at 6:00 a.m. (H=6). See Date and Time Wildcards for more information about adjusting relative time.

The Start date property specifies the start date and time to use when rolling up historical data. Data between the Start relative date and the Start date will be rolled up and displayed in the tree map. The format is MM/DD/YYYY hh:mm:ss AM/PM. The default value is the system date and time at which the control was first added to a screen. Click to change the date using the date picker.

The Start relative date property specifies a wildcard string defining the amount of time by which to adjust the start date and time. The space-separated elements in this string must be of the form: "x-#", "x+#", or "x=#" where # is an integer and x is one of the following unit specifiers: y — Year, m — Month, d — Day, H — Hour, M — Minute, S — Second, and # is an integer. T wildcard is also supported and must be in the form: T, T+#, T-#, where T represent today at midnight, T-1 is yesterday at midnight, and T+1 is tomorrow at midnight, etc. Any integer can be used. For example, H-8 represents data from the 8 hours before the current hour, d+3 represents data 3 days after the current day, and d+2 H+1 M+30 represents data 2 days, 1 hour and 30 minutes after the current date and time. d-4 H=6 sets the relative start date and time to four days ago (d-4) at 6:00 a.m. (H=6). See Date and Time Wildcards for more information about adjusting relative time.

The Start screen check box indicates that this screen will be displayed in the Navigator when first opened. The option is not available for top-level menu items with sub-menu items.

The String property specifies a generic string property that can be used when scripting this control. Type a string and reference it in your script as necessary.

The Style property defines the style sheet applied to an object on a screen. A style sheet consists of a predetermined list of properties and property values configured for a particular control type.

• Click to reveal a drop-down menu of predetermined styles configured for the selected control.
• Select a desired style and its properties will be applied to the control.
• Alternately, you can create a new style based on other property values configured for the control.
• Or you can select <None> to remove subscription to any style.

Styles are created in two ways:

• In the control's Properties pane. Click (Add a new style based on this control) next to the Style property, after you have configured property values in the Properties pane. See Add a new style based on a control for more information.
• In the Canvas Settings in the Backstage view. The default style for any control is configured in the Backstage view. See Manage style sheets in the Backstage view for more information.

The Sub-menu width property specifies the width of the expanded menu when a parent item is selected. The default value is 150 pixels. The minimum width is 40 pixels.

The Suppress data retrieval check box indicates whether all CygNet data retrieval is suppressed for this control. Use this if you want to store point information in the control but don't want the control to automatically query services for data. Tokens will not be replaced and point state colors will be ignored.

You can configure the control with a valid point configuration but the control will not retrieve any CygNet data. This allows you to display static text for a control, while still allowing CygNet data context available from script.

If a control has a point configured, but Suppress data retrieval is enabled, Canvas won’t do much point processing. The one exception is for point validity. If the control is configured to Hide invalid tag, then Canvas will check if the current tag is valid, even if Suppress data retrieval is enabled. This will allow you to configure some static text that will dynamically hide in the case of a templated screen for a facility that doesn’t have that particular point.

The Tab name property specifies the label for the tab in the tab control.

The Tab Configuration dialog box displays the tabs that will appear at the top of the tab control, and each tab's properties: the tab name and the path to the screen that will show in the optional nested view.

Click to open Tab Configuration dialog box.

If the number of tabs exceeds the width of the tab control container, arrows are added at the left and right side to allow you to navigate to the tabs you can't see.

The Text property specifies the text that will appear on the face of the control, which can be a static label, or dynamic text based on point or facility attributes. Dynamic text is built using tokens, which can represent real-time CVS point properties, point configuration properties, and facility properties. Click to configure text and property strings using the CygNet Property String dialog box. For most controls there is no default. For the detail, donut, and tile view controls the default value is the %Value% token.

Edit Box —

The Text property specifies the text that will be displayed in the edit box.

The Text alignment property specifies the text alignment for the column. The options are Left, Right, Center, and Justify. The default value is Left.

The Text color property specifies the color used for the text of the grid cell. The text color is sometimes known as the foreground color. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated alarm.

• Source — Click to reveal four options:
  • <Self> — Select <Self> to explicitly configure the color. When <Self> is selected a Color field is automatically displayed beneath the Source field and must be configured.
  • SingleColor — Select SingleColor to specify that the source of the icon's color corresponds to the alarm's point state single color (%pointstatesinglecolor%)
  • ForegroundColor — Select ForegroundColor to specify that the source of the icon's color corresponds to the alarm's point state foreground color (%pointstateforecolor%)
  • BackgroundColor — Select BackgroundColor to specify that the source of the icon's color corresponds to the alarm's point state background color (%pointstatebackcolor%)
• Color — Only displays if the Source is <Self>. Click to explicitly specify a color using the color picker.

The Text color property specifies the color used for the text of the grid cell. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated point (by selecting Point State).

For a Generic and Facility column, select the color using the following option:

• Color — Click to explicitly specify a color using the color picker.

For a Point column option, select the color using the following options:

• Source — Click to reveal two options:
  • <Self> — Select <Self> to explicitly configure the color. When <Self> is selected a Color field and picker is automatically displayed beneath the Source field and must be configured.
  • Point State — Select Point State to specify that the source of the color corresponds to the point state color defined for the point represented in the element. The default point state colors for a CygNet system are defined by the system’s point scheme. When Point State is selected the Color property disappears.
• Color — Only displays if the Source is <Self>. Click to explicitly specify a color using the color picker.

The Text color property specifies the color used for the text of the control. The color can be explicitly configured (using <Self>) or it can be sourced from the point state of the associated point (by selecting Point State).

Options include:

• Source — Click to reveal two options:
  • <Self> — Select <Self> to explicitly configure the color. When <Self> is selected a Color field and picker is automatically displayed beneath the Source field and must be configured.
  • Point State — Select Point State to specify that the source of the color corresponds to the point state color defined for the point represented in the element. The default point state colors for a CygNet system are defined by the system’s point scheme. When Point State is selected the Color property disappears.
• Color — Only displays if the Source is <Self>. Click to explicitly specify a color using the color picker.

The Text color property specifies color of the text in the combo box list. Click to select a color using the color picker.

The Text style property specifies the style to use for the text that appears on the control. Options include: Normal, Italic, or Oblique. The default value is Normal.

The Text trimming property determines the text trimming behavior to use when content overflows the content area. Options include:

• None — The text is not trimmed.
• Character ellipsis — The text is trimmed at a character boundary. An ellipsis (...) is added in place of the remaining text.
• Word ellipsis —The text is trimmed at a word boundary. An ellipsis (...) is added in place of the remaining text.

The default value is Character ellipsis.

The Text weight property specifies the weight to use for the text that appears on the control. Options are: Normal or Bold. The default value is Normal.

The Text wrapping property determines whether the text wraps when it reaches the edge of the content area. Options include:

• No wrap — The text is not wrapped.
• Wrap — The text is wrapped. Very long words will be broken over multiple lines.
• Wrap with overflow — The text is wrapped. Very long words will be pushed to next line and truncated.

The default value is No wrap.

The Tile height property specifies the height of each tiled Detail control.

The Tile width property specifies the width of each tiled Detail control.

The Title property specifies the title of this screen.

The Toolbar location property specifies the location of the toolbar. Options include Top or Bottom. The default location is above the chart (Top).

The Toolbar visible check box indicates whether the toolbar is visible on the chart. The default value is hidden.

The Tooltip property specifies the text that will appear on the control's tooltip, which can be a static label, or dynamic text based on point or facility attributes. Dynamic text is built using tokens, which can represent real-time CVS point properties, point configuration properties, and facility properties. Click to configure text and property strings using the CygNet Property String dialog box.

The Tooltip enabled property indicates whether to display a tooltip when the mouse hovers over the control.

The Tooltip mode property specifies how the tool will be displayed. Options include:

• Text — The tooltip displays as plain and/or tokenized text defined in the Tooltip property, using resolved point and facility properties.
• Object — The tooltip displays as a Canvas object, passing in the facility tag of the control.
• Script — A TooltipOpening event is fired to allow script to create a custom tooltip.

The default value is Text.

The Tooltip object path property specifies the path used for the tooltip when Object mode is selected. Click to open the Open dialog box, where you can access a CygNet APPS or BSS folder or a local or network Windows file-system folder.

The Top information text property specifies the text that will appear on the top information area on the control, which can be a static label, or dynamic text based on point or facility attributes. Dynamic text is built using tokens, which can represent real-time CVS point properties, point configuration properties, and facility properties. Click to configure text and property strings using the CygNet Property String dialog box. The default value is the %Description% token.

The Rollup top of subunit property enables you to specify the time offset by which a rollup is evaluated with greater precision. Subunit refers to the next smaller unit of time from the time unit defined in the Rollup unit property. So, if Rollup unit is set to hours, the implied rollup subunit would be set to minutes. The numeric value is the number of subunits added to starting time of each cell or series.

Using the example of hours and minutes, if the starting time of an item would otherwise have been 09:00 AM, if subunits is set to 15, the starting time of that item would be 09:15 AM.

The read-only Type property displays the type for the control: Chart, Grid, Heat Map, Object Container, Tag Chooser, View, etc. … The control's Type is also displayed on the Controls view of the Screen pane.

The Type property is a read-only text box that shows the column Type: Generic, Facility, Point, or History.

By default, a rollup derives its values from raw data stored in the Value History Service (VHS). The Rollup type drop-down menu enables you to rollup data for the selected point. Using the Rollup type option might be preferable to using the data thinning option because rollup calculations performed by the VHS can provide improved performance and reduced network traffic relative to data thinning. Rollup type options are as follows:

• None (default)
• Calculated weighted average
• Calculated mean
• Calculated minimum
• Calculated maximum
• Calculated delta
• Calculated last
• Thin median
• Thin minimum / maximum
• Thin last

The UDC property specifies the UDC for which the control is to display data. Click to select a UDC using the Select UDC dialog box.

The Unique name property specifies a unique name for the screen which is used when creating an assembly for the screen's script. When a screen is saved, any script assemblies are compiled into a uniquely named .dll file and added to the .can file, so the script does not have to be recompiled every time the screen is run. When a screen is loaded in Canvas preview or Canvas View, the precompiled .dll is extracted to a temp directory and the script assembly is loaded from disk resulting in faster load times by removing the need to recompile script. This property specifies that unique name. Under most circumstances, this will not need to be changed and can be ignored.

The Rollup unit property options define the time units by which a specified Rollup type takes place. The Rollup Unit options are as follows:

• None (default)
• Minutes
• Hours
• Days
• Seconds

For instance, if you select Minutes, rollups occur on a minute basis. The interval is further defined by the Rollup Period setting, which defines how many (in this case) minutes long a rollup period is.

The Update rate property specifies the number of milliseconds to wait before an auto-updated trend refreshes. The default rate is 200 milliseconds.

The Upper value bound property specifies the upper value to use when filling the control.

The value bound can be explicitly configured (by selecting <Self>) or the value can be sourced from an application-specific attribute of the associated point (by selecting Point Attribute). Point application attributes are configured on the Application page of the CygNet PNT Editor. The following fields are available to store an attribute that can be used to indicate the value bound.

• Indexed attributes — A property that is included in a defined PNT index. This can be free-form text up to 15 characters. Three fields are available.
• General data attributes — A property that can be free-form text up to 20 characters. Three fields are available.

Options include:

• Source — Click to reveal two options:
  • <Self> — Select <Self> to explicitly configure the value bound in the Value field.
  • Point Attribute — Select Point Attribute to specify that the source of the value bound corresponds to a point attribute of the associated point represented in the control.
• Value — Configuration depends on the source:
  • If the Source is <Self>, select a number using the spin control. The default value is 0.
  • If the Source is Point Attribute, click to select from the following point attribute options: Indexed 1, Indexed 2, Indexed 3, General 1, General 2, or General 3.

The Use point state color? check box indicates whether to use the point state color for the alarm limit range. The default point state colors for a CygNet system are defined by the system’s point scheme.

The Use relative date check box indicates whether to use relative dates and time for the chart. Use the Begin/Start and End properties to specify the relative date ranges to use in the chart.

If Use relative date is unchecked all dates and time will be absolute. Use the Begin/Start and End properties to specify the absolute date ranges to use in the chart.

The Use relative date check box indicates whether to use relative dates and time for the chart. Use the Begin/Start and End properties to specify the relative date ranges to use in the chart.

If Use relative date is unchecked all dates and time will be absolute. Use the Begin/Start and End properties to specify the absolute date ranges to use in the chart.

The Value property specifies the value for the item in the combo box drop-down menu.

The Value bounds configuration box contains all the options required to specify the lower and upper bound of the control. The source of the bounds can be either hard-coded to an explicit value (<Self>), or dynamically determined for each facility by sourcing the value from an application-specific attribute of the associated point (Point Attribute and then selecting an Indexed field or a General data field). A control on a templated screen supports different bounds for each source facility. By using a point attribute to store the bounds (for example, Indexed 1 for the lower value bound and Indexed 2 for the upper value bound), you can have a templated screen without having to script the control.

Click to reveal a set of options where you can specify the source and value of the lower and upper bound. The Value bounds configuration box consists of the following options.

See each control for more information about configuring value bounds.

The Value format property specifies the format for the point's value using any of the valid .NET standard or custom numeric format strings. The value format applies to a point's Value, Primary Value, and Alternate Value properties. The default value format is #,##0.00, which corresponds to 123,456,789.12. Formats use # and 0, with a period (.) as the decimal separator and comma (,) as the thousands separator. Add additional zeros to show more decimal places.

The Value type property specifies the type of data to use when populating the tree map. Options include Real-time or Historical. The default value is Real-time.

The Vertical alignment property specifies the vertical position of the text within the boundary of the control. Click to select from the following options: Top, Center, Bottom, or Stretch. The default value is Center.

The Vertical resize mode property specifies whether and how the control dynamically moves or resizes vertically when the screen is resized in run mode. Options include:

• None — No resizing occurs.
• Shift — The object will shift vertically.
• Expand — The object will expand or shrink vertically the same number of pixels as the screen.
• Proportional — The object expands or shrinks proportionally to the screen.

The default value is None.

The Visible check box indicates whether the control is visible in run mode.

The Visible check box indicates whether to display the column in run mode.

The Watermark property can be used to specify explanatory text that appears in the combo box when no option has been selected. This allows you to give guidance to your screen users on what should be selected. The watermark text appears in light grey and in italic.

The Watermark property can be used to specify explanatory text that appears in the edit box when no other text has been configured. This allows you to give guidance to your screen users on what should be entered in the text input field. The watermark content is displayed when the control is empty and not focused. The text appears in light grey and in italic.

The Width property specifies the width of the control (or screen).

The Width property specifies the width of the column in pixels. Set the value to 0 to auto size the width.

The X property specifies the location of the control along the horizontal axis. Use the up, down, left, and right arrow keys to nudge a control by 1 pixel. Arrow moves a control by 1 pixel. Ctrl+Arrow moves a control by 10 pixels. Ctrl+Shift+Arrow moves a control by 100 pixels.

The X-axis label color property specifies the color of the x-axis label text. Click to select a color using the color picker.

The X-axis label position property specifies the location of the label text on the x-axis. Options include: Top or Bottom. The default value is Bottom.

The X-axis tick color property specifies the color of the tick lines for the x-axis. Click to select a color using the color picker.

The X-axis title property specifies the text for the x-axis title. The x-axis typically shows the time frame being displayed on the chart. The default value is Time.

The Y property specifies the location of the control along the vertical axis. Use the up, down, left, and right arrow keys to nudge a control by 1 pixel. Arrow moves a control by 1 pixel. Ctrl+Arrow moves a control by 10 pixels. Ctrl+Shift+Arrow moves a control by 100 pixels.

The Y-axis label color property specifies the color of the y-axis label text. Click to select a color using the color picker.

The Y-axis label position property specifies the location of the label text on the y-axis. Options include: Left or Right. The default value is Left.

The Y-axis tick color property specifies the color of the tick lines for the y-axis. Click to select a color using the color picker.

The Y-axis title property specifies the text for the y-axis title. The y-axis typically displays increments of data according to the data's relevant unit type. The unit type derives from the associated data type's point record in the Point Service (PNT). The default value is Values.

The Yes/No property specifies a generic Boolean yes/no property that can be used when scripting this control. Click the check box to enable the property and reference it in your script as necessary.

The Z index property is used to determine the order in which controls are layered on top of each other. Controls with higher values will draw on top of those with lower values. The newest control added to a screen will always have the highest value and will be the top layer. Two or more controls can be on the same index (layer).