Displays Selection and Creation

However Action.NET the main window of the application Display is defined by an object named Layout. One Layout defines the size of the application window and the basic arrangement of preview components (Displays and Display parts) in the application in real time. See "Layout Creation".

A Display can contain multiple visualization and command elements, including controls, data Display areas, static areas, and other objects. These components or Displays can be static, that is, they are always displayed, such as a menu bar, toolbar, or status bar. Components can also be swapped dynamically, depending on what the user clicks or selects.

To select Displays:

1. Go to Edit> Displays> Displays.

2. Select the viewing option Cardview or TableView at the top right of the DataGrid with the List of Displays.

3. See the list of available Displays appear on datagrid.

• Other columns not included in the table above refer to the Display dimensions. In this table these attributes are in read-only mode. Can be changed in the environment Draw described below.

Display Operations

To edit a Display, select it from the DataGrid tab Display and press the DRAW button.

When you are in the DRAW environment, you can also edit Displays by selecting them in the combo-box in the toolbar that appears to perform operations with the Displays.

• The left box shows the name of the Display currently loaded on the desktop. Opening this box (click the arrow) appears the list with all existing Displays in the project. By choosing one from the list, it will load into the Drawing area and become the current Display for editing.

• The floppy icon is used to request saving of changes;

• The icon with the floppy and the figure opening the plug is used to request saving the Display with another name (save as).

• The icon with the + sign should be used to create a new, empty, and close Display, saving it to the Display until then loaded. It also causes a window to appear asking for the name to be given to the new Display.

• The symbol with Video Monitor lets you show a preview of the Display to see what the Display will look like in real time.

• The icon with the image of a data window, when pressed, shows a window with the list of all existing objects on the Display. By clicking on each of the listed objects, select the object on the Display.

• The last icon is used to close the current Display without saving the last changes

Creating a new Display

To create a new Display

1. Go to Draw> Draw .

2. Click the icon whose action is Close the Current Display and Create a new one.

   Image Modified

3. If you don't see this button in the toolbar, make your window wider.

4. The window appears to create a new Display.

5. Image Modified

6. Enter or select the information as needed.

• Click OK, to close the Display creation window.

Setting properties for the common Display

On the left side of the main window appears an area for detailing the attributes of the Display, with two parts: Appearance and DisplaySettings.

The parameters of Appearance define the style of the "brush" used when drawing objects on the Display, including colors.
Clicking on the option Fill (fill) you can set Colors, gradients, or objects to fill a graphic figure.

The parameters in DisplaySettings define, the attributes of the Display. Displays can be configured as PopUps, Dialogs, or Normal Displays. The dimensions of the Display when created follow what is defined in Info>Settings.

Like any graphic object, Displays can have different colors and patterns, borders, titles, and more.
A special feature is that you can specify an animation transition to use when switching from one Display to another in a similar way to what you use in PowerPoint presentations.

If you have selected the Display option for iPad/iPhone iOS, when you created the view, not all DisplaySettings will be available. Also in the case of Dashboards there will be some differences for definition. See the following items.

At the bottom you can choose Enable Theme, for use of this color-swapping functionality of presentation themes.

For setting Display properties:

Enter or select the information as needed for setting displaysettings

• Use the drawing tools on the vertical bars on the left and bottom horizontal to create, and position viewing objects on the Display

• Select one of the buttons on the vertical toolbar. Place the cursor in the display area, then click and hold the left mouse button while dragging the cursor in the area of the newly created Display.

• To see an options menu, right-click on the drawn object. The context menu provides actions that are specific to the selected object.

• To select multiple objects, press Shift + Left-click on each object.

• The horizontal toolbar (at the bottom of the Drawing) contains buttons to group, combine, align, and lock selected objects

• For more information on drawing tools, see "Drawing tools".

• Click Save Display.

Dashboards

Dashboards quickly transmit a large amount of data in a compact and easily accessible format.

• Responsive layouts allow your dashboards to be intelligently resized based on the Display size of the viewing device.

• Drag and drop panels easily to display various chart types, such as trend, pie, bars, plus gauges, and more!

• Add any object from the symbol library - whether it's native to Action˳NET or a user-created one!

• Create groups to control your responsive behavior separately from the general page.

• Create dashboards for .NET and HTML5 clients from the same development environment.

• Support our new Project Themes for quick customization!

Setting properties for Dashboards Displays

For type Displays Dashboard, due to its functionality, few properties should be set. Basically the background color, Display size and whether to use the functionality of color themes.

Only Symbols, (local library or graphic symbol library) WPF components (charts, tables, grids, other controls) and panels can be inserted into dashboard-type Displays.

You can't draw directly at the bottom of the Display. For a drawing, label objects, or numeors displays or text, make a symbol and colloquial these elements on it. After place the symbol on the Display. These symbols or components will always be wrapped by containers that will be responsively resized in real time.

See more details of how to use this Displays in Dashboards.

Display Opening Methods

There are many ways to open a new Display or Popup. For each method, specific characteristics must be considered. Below you will find every method for opening a new Display with some description on their behavior and how to use them.

Display.DisplayName.Open

• Begin Open Display process

• Returns a flag (true or false) indicating success or fail

• Uses the following syntax:

@Display.<DisplayName>.Open();
E.g.:
@Display.MainPage.Open();

Display.DisplayName.OpenModal

• Open Display as Modal

• Not available for Mono and HTML5

• Returns a flag (true or false) indicating success or fail

• Uses the following syntax:

@Display.<DisplayName>.OpenModal();E.g.:@Display.MainPage.OpenModal();

 Display.DisplayName.NewPopup

• Open a new popup. If the Display is already open, a new instance will open

• Always returns an empty string, independent if it succeeds or fails

• Uses the following syntax:

@Display.<DisplayName>.NewPopup(LabelList[label1=tag1;label2=tag2],Left,Top, Width,Height);
E.g.:
@Display.MyPopup.NewPopup("PID=PID1;NAME=’PID  1’");

Client.OpenDisplay

• Open a Display

• Returns a flag (true or false) indicating success or fail

• Uses the following syntax:

@Display.OpenDisplay("DisplayName");@Display.OpenDisplay("About");

Client.OpenDisplayAtIndex

• Open Display at x-order list of displays. Current Display is closed

• Returns a flag (true or false) indicating success or fail

• Uses the following syntax:

Code Block @Client.OpenDisplayAtIndex(string DisplayName,int index);E.g.:@Client.OpenDisplayAtIndex("MainPage",0);

Client.NewPopup

• Open a new popup. If the Display is already open, a new instance will open

• Always returns an empty string, independent if it succeeds or fails

• Uses the following syntax:

Code Block @Client.NewPopup(string DisplayName, LabelList[label1=tag1;label2=tag2],Left, Top,Width,Height);E.g.: @Client.NewPopup("PopupPID","PID=PID1;NAME=’PID 1’");

Display Namespace 

With most systems, you must create custom logic for your projects and create Tags or Variables for all internal properties. Namespaces allow your application to directly access all the objects that you created in your project.

This means that user-created temporary tags are not required to manage the status of PLC network nodes, the total number of alarms in a group, or the number of rows in a dataset. You can now access runtime objects, business objects (representing a network node), or an alarm group or dataset. Then, you can display the required information or take action directly through the object's built-in properties.

When you are building a project's configuration, filling input fields, or creating scripts, the system uses Intellisense auto-completion to guide you to all the existing properties that you are allowed to use according to what you are editing. This feature allows you to easily ‘drill down’ to a specific property.

When accessing a project object in the .NET Script Editor, it is necessary to prefix the namespace with an ‘@’ symbol in order to avoid conflict with the .NET local variables names.

Below you will find a list of the Display namespace's properties and methods and some properties from the Client namespace.

Display Namespace

Properties

Category: ReadOnly property with categories that are configured for the Display Object in Run > Dictionaries > Categories. Used for organization purposes.

Description: Description of the display, configured in Edit > Displays > Displays.

HorizontalScroll: Indicates the horizontal scroll value.

Id Object: Object ID (Internal Use). Can be found at Edit > Displays > Displays.

IsOpened: Indicates if the selected display is opened.

• Returns false if is not opened

  • Returns true if is opened

Level: ReadOnly property with levels configured for the Display Object in Edit > Tags > Assets.

VerticalScroll: Indicates the vertical scroll value.

ZoomLevel: Indicates the zoom level of the page. One is the normal zoom level. See images to see a difference between zoom level 1 and 2. 

Methods

Close()

• Begin close display

• Returns a flag indicating success (true) or fail (false)

Example

Code Block bool sts = @Display.About.Close();

GetCustomPropertiesAsString(string sep)

• Get all custom properties

• Default Separator is ‘, ‘

• Returns a string

Example

Code Block string msg = @Display.About.GetCustomPropertiesAsString(",");

GetCustomPropertyValue(string PropertyName,string defaultValue):

• Get value of custom property name

• propertyName: Property Name

• defaultValue: Default value if property could not be found

• Returns property value

Example

Code Block @Display.MainPage.GetCustomPropertyValue("p1","-1")

NewPopup(object[] items):

• Opens a new popup. If the Display is already open, a new instance will open

• Always returns an empty string, independent if it succeeds or fails

Example

Code Block @Display.MyPopup.NewPopup("Max=MaxValue;Min=MinValue");

Open()

• Begin open display

• Returns a flag indicating success (true) or fail (false)

Example

Code Block bool sts = @Display.About.Open();

OpenModal()

• Open Display as modal

• Disabled for Mono and HTML5

• Returns a boolean indicating success (true) or fail (false)

Example

Code Block bool sts = @Display.MainPage.OpenModal();

PrintDisplay(bool defaultPrinter)

• Begin print display

• Returns a boolean indicating success (true) or fail (false)

• defaultPrinter: flag indicating whether default printer must be used or not

Example

Code Block bool sts = @Display.MainPage.PrintDisplay(true);

• If the default printer is set to false, a popup window will appear.

PrintDisplayDefaultPrinter(int PageOrientation) :

• Begin print display using default printer

• PageOrientation: 0 for Portrait and 1 for Landscape

• Returns a flag indicating success (true) or fail (false)

Example

Code Block bool sts = @Display.MainPage.PrintDisplayDefaultPrinter(0);

RemoveAllCustomProperties():

• Remove all custom properties

• Returns always Not used

Example

Code Block @Display.LogOn.RemoveAllCustomProperties();

SetCustomProperties(string str, string sep)

• Set custom property. If property does not exist, it is created.

• propertyName: Property Name. If the name starts with an ‘@’ and the rest of the string is a valid tag name, the property is a reference to the Tag Value.

• propertyValue: Property value

• Returns always Not used

Example

Code Block @Display.MainPage.SetCustomProperties("p1=10;p2=20",  ";")

SetCustomPropertyValue(string propertyName, object propertyValue)

• Set custom property. If the property does not exist, it is created.

• propertyName: Property Name. If the name starts with an ‘@’ and the rest of the string is a valid tag name, the property is a reference to the Tag Value.

• propertyValue: Property value.

• Returns always Not used.

Example

Code Block @Display.MainPage.SetCustomPropertyValue("p1",  50")

Display runtime objects

The namespace Display lists all Displays with their properties and open and close methods.
The namespace Layout lists all layouts with their properties and open and close methods.
The namespace Client has the properties of the environment on each client computer or mobile device connected.
See http://www.spinengenharia.com.br/help/an-2014/runtime/index.html for the full programming reference on runtime objects.