The Movicon Drawings and Controls can be grouped together to form composed Symbols. Composed symbols can be inserted in the Movicon "Symbols Library" for later use in other projects.
Movicon Help on Line - Rel. 11.7.1301
The Movicon "ToolBox" has a great variety of drawings and controls to choose from and inserted in the Screens and Embedded Reports resources. The drawings and controls have been grouped into different categories within the ToolBox according to their function type.
The "ToolBox" can be activated with the "ToolBox" command from the "View" menu.
The Drawings and Controls are vectorial object types and have different and similar ways of functioning especially concerning their Animation properties. These objects also have properties which are common to them all.
|
The Movicon Drawings and Controls can be grouped together to form composed Symbols. Composed symbols can be inserted in the Movicon "Symbols Library" for later use in other projects.
|
The Movicon "ToolBox" automatically updates every time a Screen or Embedded Report resource is selected within the workspace. Depending on the case, the categories and objects supported by the Screens or Embedded Report resources will be made available accordingly.
ToolBox components for Screens
When a Screen resource is opened within the workspace of a Movicon project, the "ToolBox" will automatically open showing all the supported components that can be inserted on screen. These components are grouped into different categories in the "ToolBox" according to how they function. The "ToolBox" can be activated with the "ToolBox" command from the "View" menu.
The three "ToolBox" object categories provided for Screens are as follows:
Basic Shapes
In this category you will find a series of drawings, or simple geometric shapes, which are mainly dedicated to creating the screen's graphical design. These components do not have specific properties for Command executions but they support all the animation properties common to all the other Movicon vectorial components.
|
Despite not having specific properties for executing commands, they can, however, execute Commands by being edited with Script codes internally. |
Basic Controls, Emergency Buttons, Lights-Led, Round Buttons, Square Buttons, Rectangular Buttons
In this category you will find a series of "Button" type controls which are dedicated to executing the Commands defined in the "Command List" or simple variable settings. This category includes a list of various types of objects, such as Coloured Lights or Leds and Coloured Buttons of different shapes, which all derive from the same Button component modified in the Style Properties.
Switches, Selectors Two-States, Selectors Three-States
In this category you will find a series of "Switch and selector" control types which are designed to execute Commands defined by means of using the "Command list" or by simply setting variables. This category lists various switch and selector objects which derive from the same Button component but have been modified differently in their style properties. These objects can be set with tri-state mechanics to assume three different positions.
Sliders-Gauges-Meters-Displays
In this category you will find a series of "Gauge" type controls in all sorts of graphical shapes. There is a list of different objects which all derive from the same Gauge component modified in the Style properties. In addition to this, you will also find an "Editbox - Display" object.
Trend-Charts-Data Analysis
In this category you will find a set of "Trend" controls and a Chart object. These controls are designed to display variable behaviour graphically.
In this category you will find various controls each with different functions. These control types include Displays, Alarm Viewers, Historical Log and Data Logger Viewers, Charts and others.
This category contains a series of "clock" symbols that display the time and date. These symbols differ graphically and use system variables for retrieving times and dates. Therefore, it is indispensable that the "_SysVar_" be inserted in the project's Real Time DB.
|
The symbols which display days and months in letters also use script code and, therefore, it is not advised to use them in Windows CE. |
|
In certain cases, the "Clock" objects use local screen variables. If these objects are used within a screen displayed as an embedded Embedded Screen, it will be necessary to redefine the local variables in the project's RealTimeDB so that the clocks work correctly. |
Custom ToolBox Objects
The ToolBox can be extended with new categories containing custom symbols created by the programmer. These symbols can also be inserted in the Movicon "Symbols Library" to create new library categories. In order to do this, you will first need to create a Movicon Installation subfolder in the name of "ToolBox" , if not already done so.
Then simply create a category containing the symbols of interest in the "Symbols Libraries" and copy the created symbol libraries ".msxz" file within the "ToolBox" folder. The new symbols will then be displayed within the ToolBox as a new category with the same name of the ".msxz" file containing them.
This will allow you to extend the "ToolBox" contents with customized symbols thus rendering them available for immediate use without retrieving them from the "Symbol Libriaries".
When a Report or an Embedded Report is openend within the Movicon project's workspace, the ToolBox will automatically display showing a list of objects that can be inserted within Embedded Reports. These objects are grouped into different categories in the "ToolBox" according to how they function. The "ToolBox" objects can also be activated using the "Objects" command from the "View" menu.
A major part of the objects that can be inserted into the Movicon Embedded Reports are also the same ones that can be inserted on screen. The main difference between the two categories are:
objects that can be inserted in Reports only manage some of the graphical animations, such as visibility and transparency. These animations are only considered while generating the report and once the report has been displayed or printed, they can no longer be changed.
objects that cannot be used in Reports cannot be edited and, therefore, those properties used for entering data or command executions will not be available.
Most of the objects that are used by the Movicon Reports are a subset of those objects that can be inserted in Screens and have their own subset of properties.
|
The "ToolBox" Drawings and Controls that can be used in Reports can also be grouped together to form composed Symbols and added to the Symbol Library for later use in other projects. |
There are three "ToolBox" object categories that can be used in Reports and they are:
This category contains a series of drawings or simple geometric shapes that can be used to create the Report's graphical design.
This category contains a series of controls with the purpose to display data. Data that can be displayed by these controls include the project's RealTimeDB variables, table fields or recordsets associated to the Report or special fields that show information from the system or the Report itself. These values can be selected using the "Tag Browser" window or typed directly in the field.
The objects available in this category are:
Checkbox: this is a "Check Box Button" object type that displays boolean values graphically. This object has two "Close Bit String" and "Open Bit String" properties which are used to specify the boolean value to be displayed according to the string recorded in the database. This object can be associated with a Movicon RealTimeDB variable, a table field or recordsets associated to the Report.
Radio Button: this is a "Check Box Button" type object that displays values graphically. In cases where the object must display a boolean value, the two "Close Bit String" and "Open Bit String" properties can be used to specify the boolean value to be displayed according to the string recorded in the database. This object can be associated with a Movicon RealTimeDB variable, a table field or recordsets associated to the Report.
Standard Display: this is a read only "Display" type object. This object can be associated with a Movicon RealTimeDB variable, a table field or recordsets associated to the Report.
Date Time: this is a read only "Display" type object. This object exclusively displays the "[SP:time]" parameter which shows the date and time of when the report was generated. This format can be customized by using the object's "Value Format" property (i.e. "%d:%m:%Y: %H:%M:%S").
Current User: this is a read only "Display" type object. This object exclusively displays the "[SP:user]" parameter which shows the name of the user who was logged in the project when the report was generated. This format can be customized by using the object's "Value Format" property (i.e.: "User: %s").
Page-Pages: this is a read only "Display" type object. This object exclusively displays the "[SP:pages]" parameter which shows the current report page number and total report page number. This format can be customized by using the object's "Value Form" property (i.e.: "Page %d of %d").
Query: this is a read only "Display" type object. This object exclusively displays the "[SP:filterQuery]" parameter which shows the query used for extracting data from the database.
Selected Period: this is a read only "Display" type object. This object exclusively displays the "[SP:filterPeriod]" parameter which shows the period selected in the "Period" parameter set in the report's generation command. (i.e.: Today, Yesterday and Today, Current Week, etc.).
Duration Threshold: this is a read only "Display" type object. This object exclusively displays the "[SP:filterDuration]" parameter which shows the duration defined in the "Duration" parameter set in the report generation command for Alarm Statistics. The display format can be customized by using the object's "Value Format" property (ie: "Duration Threshold: %H:%M:%S").
Start Date-Time: this is a read only "Display" type object. This object exclusively displays the "[SP:filterFrom]" parameter which shows the start date set for extracting data from the database. The display format can be customized by using the object's "Value Format" property (ie: %H:%M:%S"). This field will be populated only when the "Period" parameter has been specified in the Report's open command. If this parameter had been set to "None", the "Start Date-Time" field will remain empty.
End Date-Time: this is a read only "Display" type object. This object exclusively displays the "[SP:filterTo]" parameter which shows the end date set for extracting data from the database. The display format can be customized by using the object's "Value Format" property (ie: %H:%M:%S").This field will be populated only when the "Period" parameter has been specified in the Report's open command. If this parameter had been set to "None", the"End Date-Time" field will remain empty.
|
The "Radio Button", "Checkbox" and "Standard Display" objects can display RealTimeDB and Database field variables. When these objects are set to display database fields, they can only be inserted in the "Details" section, otherwise no values will display when the report is generated and an error message will be generated in the Output and Historical Log windows. |
|
When two or more objects of the same type that display special fields are inserted in the Report, such as "Date Time", "Start Date"etc, the format of these objects should be the same. Otherwise, Movicon will apply the same format applied to the object with the lowest tab number to the objects of the same type. For instance, when inserting two "Date Time" objects with two different formats, these objects will display the same format as the one defined in the object with a lower tab number. |
This category includes a series of control types, such as the "Trend" and "Chart" objects, which have been made available for use within reports. These controls have been designed to graphically display data extracted from the database using queries. Data extraction queries can be set at different levels by means of using the Trend's "Default Query" property, the Report Generator command's "Report - Query" parameter and the Report's"Query Report" property. The query execution priority order is determined by a number of factors, for example if a query has been set in the Trend's "Default Query" property, it will have priority of use over the others. If a query has not been defined in this property but in the Report generation command's parameter instead, this will obtain priority of use. If no queries have been defined in either the Trend's "Default Query" or the Reports generation command's "Report - Query" but one has been defined in the Report's "Query Report" property, this will have priority of use. If no customized query has been defined in all three mentioned properties, the report's default query will be applied for extracting all data (query default = "SELECT * FROM TableName ORDER BY TimeCol DESC").
The objects available in this category are:
Horizontal and Vertical Trend: this is a "Trend" type object that displays data obtained by means of applying a query in the Horizontal or Vertical Trend in standard mode.
Trend XY: this is a "Trend" type object that displays data obtained by applying a query to the the XY Trend in standard mode.
Basic Chart: this is a "Trend" type object that displays data obtained by applying a query. The difference between this object and a normal Trend object is that it can display an X axis based on time or any set of discrete values. This object must be specified with which resulting query recordset column is to be used as the X axis in its "Label Data Source" property. In cases where no column has been specified in this property, the object will use the table's time column called the LocalCol by also adding milliseconds. This object also provides an additional three properties for customising the X axis: "Show Item Side by Side", "Show Labels" and "Show Labels every".
Advanced Chart: this is a "Chart Object" type object that displays data obtained from report queries. Compared to the "Basic Chart" object, the "Advanced Chart" object allows more advanced and configurable charts to be displayed. This object, like the "Basic Object", can display times or any subset of discrete values on its X axis. It is necessary that this object be specified with which resulting query recordset column is to be used as the X axis in its "Label Data Source" property. In cases where no column has been specified in this property, the object will use the table's time column, which is called the LocalCol, by also adding milliseconds. The name of one or more database fields can be inserted in the Advanced Chart's 'Curve Variable' properties for displaying data extracted by report queries, or a project array type variable can be associated for displaying values.
|
Caution! The "Advanced Chart" object uses libraries that are NOT supported in Windows CE and, therefore, cannot be used in projects running on Windows CE platforms. |
|
"#samples" properties can be set in the "Trend", "Basic Chart" and "Advanced Chart" objects. The value set in this property represents the maximum number of points that the object will be allowed to display. In cases where the number of record sets extracted by the report's query exceeds the value set in the "Num.Samples" property, the Trend or Chart object will only display a number of records equal to the one set in this property. |
