1. In design mode, create a new Canvas screen or object.
2. Configure the Style property.

1. Style —

   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.

   Tip: You can also change a control's Style on the Controls view of the Screen pane.

3. Configure the Screen properties. See To configure screen properties below.
4. Configure the Chart Date Range properties. See To configure chart date ranges below.
5. Configure the CygNet connection properties. See To configure the CygNet connection below.
6. Configure the Chart properties.

1. Default chart file —

   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.

2. Default chart file source —

   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.

7. Configure the Facility Navigation property.

1. Facility navigation mode — See Navigation by Facility for more information about using this property.

   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.

8. Configure the Grid properties. See To configure layout grid properties below.
9. Configure the General properties.

1. Height —

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

   Tip: You can also change the height of a control using the Settings pane (click on the (Settings) to the right of the control in design mode) or on the Controls view of the Screen pane.

2. Width —

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

   Tip: You can also change the width of a control using the Settings pane (click on the (Settings) to the right of the control in design mode) or on the Controls view of the Screen pane.

10. Configure the Global Settings properties.

1. Path —

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
2. Source —

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.

11. Configure the Alarm Notifier property.

1. Show alarm notifier —

   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.

   Note: Alarm sounds will still play in the screen, even if Show alarm notifier property is disabled (Off).

12. Add and configure other controls as required.
13. Save the screen.
14. Run the screen to test your configuration.

1. Find the Screen properties and configure for the screen:

1. Background color — The Background color property specifies the background color of the screen, object, or control. Click to select a color using the color picker.
2. Color palette — 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.
3. Is pan/zoom control visible — 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.
4. Is pan/zoom enabled —

   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.

   Note: Enabling this will negatively impact screen load performance and disable the ability to dynamically add controls via script.

   Note:  The new run mode implemented in Canvas v9.4 does not support panning and zooming. Thus, Canvas has retained the old method of running screens for backwards compatibility. If you need to pan and zoom on a specific screen (configured via the IsPanZoomEnabled property on a screen), you will not be able to take advantage of the performance improvements the new run mode supports. The legacy run mode is accessible from the Run icon on the Canvas toolbar: Run > Run current screen (Legacy).

5. Title — The Title property specifies the title of this screen.
6. Unique name — 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.

2. Add and configure other controls as required.
3. Save the screen.
4. Run the screen to test your configuration.

1. Find the Chart Date Range properties and configure for the screen:

1. Begin date — 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.
2. Begin relative date — 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.
3. End date — 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.
4. End relative date — 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.
5. Override chart dates — The Override chart dates check box indicates whether to use the screen's dates, when displaying charts for this screen.
6. Use relative date —

   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.

2. Add and configure other controls as required.
3. Save the screen.
4. Run the screen to test your configuration.

The source of your CygNet data can be explicitly configured on the screen and passed to controls.

1. Find the CygNet property groups and configure the following properties:

1. Broadcast facilities — 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>.
2. Broadcast SiteService — 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>.
3. CygNet connection — 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.

1. Selection mode —

   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%.

2. SiteService — The SiteService property is where you specify the source of the SiteService for the control (or screen) to use. The source for the SiteService can be explicitly configured for this control or it can be inherited from another control on the same screen, or from the screen, or from another screen. Click to reveal the SiteService selector. Options include:
• Source — Options include <Self> or Screen (default):
  • <Self> — Select <Self> to explicitly configure the SiteService for this control. A SiteService selector is displayed:
    • SiteService — 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.
• Screen — Select Screen to inherit the SiteService from the screen for this control. By default, the sender is the Screen control if no other senders have been configured.

3. Facility — The Facility tag or Facility property is where you specify the source of the facility for the control (or screen) to use. The source for the facility can be explicitly configured for this control or it can be inherited from another control on the same screen, or from the screen, or from another screen. Click to reveal the Facility tag or Facility selector. Options include: Click to reveal the Facility selector. 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. A Facility tag or Facility selector is displayed, depending on the Selection mode:
  • Facility — 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.
  • Facility Tag — 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.
• 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.
• Resolve to a relative facility — 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.
  • Relative link — 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.
  • Order in type — 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.

2. Configure other control properties as necessary.
3. Save the screen.
4. Run the screen to test your configuration.

1. Find the Grid properties and configure for the screen:

1. Grid color — The Grid color property specifies the color of the lines in the layout grid. Click to select a color using the color picker.
2. Grid height — The Grid height property specifies the height of the layout grid. The default is 10 pixels high.
3. Grid width — The Grid width property specifies the width of the layout grid. The default is 10 pixels wide.
4. Show grid — 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.
5. Snap to grid — The Snap to grid property indicates whether controls should snap to the grid. The default value is true.
6. Snap to items — The Snap to items property indicates whether controls should snap to other controls. The default value is true.

2. Add and configure other controls as required.
3. Save the screen.
4. Run the screen to test your configuration.