Page tree
Skip to end of metadata
Go to start of metadata

"Connect object" palette

The palette Connect object is used to create the relations between graphic objects and D2000 system objects. Defining these relations allows, in process D2000 HI, to display and control real values of monitored technology with use of graphic objects.
After selecting the object, its type and internal identifier is displayed in the header. If the object has some reference variable, its name is also displayed.

Connect object palette

The palette Connect object, in dependence on the graphic object type, may comprise the following tabs.

TabMeaning
ViewParameters for connecting the graphic object to view. The selection of D2000 system object, selection of a display palette and, for some of the graphic object, also extended palette. You must define a column and row for objects of Structured variable type.
PalettesSetting the palette or EXT palette and a control object for this graphical element.
ControlParameters for connecting the graphic object to control.
ScriptAssigning a reference variable to the script, opening the script to define the event handler.
RepaintSelection of a method to repaint the graphic object connected to view.
DynamicsConfiguration of the parameters for dynamic objects displaying (for some graphic objects only).
ActiveXSelection and setting an ActiveX object inserted into the picture.
Info text/URLSettings of so-called info object - a text, that will be displayed as a tooltip when you point the mouse cursor on the graphic object in picture D2000 HI.
Setting of URL address.
SelectDefinition of a condition for select and sorting.
ParametersConfiguration of the graphic object (for Displayers).
PropertiesConfiguration of the graphic object (for Windows controls).
LookDefinition of appearance of the graphic object.
OthersConfiguration of other, not often used parameters of Browser displayer.
Multiple changeDefining the same connection parameters for a group of graphic objects, or modification of common parameters.


The palette contains several buttons placed at the right side, which are used to ...

Select D2000 system object to connect.
Use the parameters of the last selected object (template).
Undo the changes.
 
Synchronize connections - if the tab View is displayed, the parameters (selected object, column and index) will be copied into the tab Control and vice versa.
Disconnect (remove) the connection - in selected tab only.
Test the correctness of connection parameters - all parameters in all tabs.
Opens the Object properties palette. This functionality works also vice-versa, i.e. in the Object properties palette opens Connect object palette.

Note:
The following descriptions of the tabs are not comprehensive. Depending on the object type, some of the parameters, displayed in the tabs, could be disabled.
Parameters used especially for specific type of graphic object are described in detailed in the particular chapter.

View


Connect object palette - View tab


1, 2Allow to select an object (1) or a local variable (2), you want to connect to view.
3Selects a dynamic value of a local variable row.
ColumnSelection of a column of the local variable.
RowAllows to choose a row of the local variable.

For more information on connecting the object to view see the topic Connecting objects to view.

Palettes


  • Number of palettes in object: 3; each of the three buttons enable to select the particular palette.
  • Properties: N objects can be connected to one graphic object. A display palette will be added to each attached object.
  • Only first object is used for real display (other objects only select graphic attributes from palettes)
  • Displaying in HI: After modification of any object, application of all palettes is needed (or modify only the attributes redefined by the palette with changed object)
  • Expected usage: Each palette controls the different graphic attribute (forecolor, textcolor, backcolor, visibility, ...) - otherwise there could occur a collision of formulas.

Connect object palette - Palettes tab


1Button to choose a display palette that will define displaying the object in process D2000 HI - optional parameter
2Button to select an extended display palette, which defines some additional options for displaying the object in process D2000 HI (optional parameter; it can be used only for graphic objects of Text, Bitmap and Button type).
3, 4Enables to select an object (3) or a local variable (4), you want to connect.
ColumnSelection of a column of the local variable.
RowAllows to choose a row of the local variable.
5Allows to select a dynamic value of a local variable row.

Control


Object can be controlled by clicking or releasing mouse button over a graphic object. To select the method of controlling, click either Button down tab or Button up tab.
It can have two states:

  • Object is connected  - blue icon
  • Object is not connected - black icon

Connect object palette - Control tab


1, 2Selection of an object (1) or a local variable (2), you want to connect to the control.
3Enables to select a function instead of the connected object:
  • %ACKChange - acknowledges the values of all objects in the picture. The state of the values, whose last change has not been acknowledged by an operator, is NoAcknValue.
  • %CLOSE - closing the picture.
  • %History - history of picture.
  • %History2 - history of picture - it shows the history in the range of one hour from the entered time interval (only the begin time interval can be set in this dialog window (1)).
  • %MovePicture - Change the position of the pictute using the mouse. Only available in left mouse button action (D2000 V12.2N)
  • %ViewTrend - displaying the flow of connected object in a dynamic graph.
  • %ViewTrendAdd - displaying the flow of connected object in a dynamic graph in other window.
  • %ToggleNotesVisible / hide notes in picture (D2000 V12.2N)
  • %NStepBack - calling the navigator function - previous view.
ColumnSelection of a column of the local variable.
RowAllows to choose a row of the local variable.
4Allows to select a dynamic value of local variable row.

Set directly

Quick setting the values of numerical type objects. Clicking the graphic object (in the picture opened in process D2000 HI) opens the control window reduced to one input field. You can directly entre the value of connected object. To acknowledge the value, press the Enter key. If you want to cancel this action, press Esc.

Open window

When clicking the graphic object (in the picture opened in process D2000 HI), it opens the control window of connected object. The type of control window depends on the type of connected object.

In case of graphic information windows (pictures, graphs), this type of control allows to open these windows on the D2000 HI desktop. The button Position appears in the tab. It allows to define the position of the graphic information window in process D2000 HI.

Set value

Sets a value for the object. The value, defined in the input field, will be set for the selected object. The following methods of setting the value are implemented:

  • ON - object value will be set to TRUE
  • OFF - object value will be set to FALSE
  • ONOFF - object value will be set to the opposite value (from TRUE to FALSE and from FALSE to TRUE)
  • KVIT - object value will be set to KVIT (alarm acknowledgement)

Acknowledgement

If the option is checked, then any change of the object attribute will have to be acknowledged by an operator in process D2000 HI.

Autoclose

If it is checked, the change of the object attribute will close the control window in process D2000 HI.


For objects of Picture and Graph types, the palette contains the button Position, that allows to define a position of the information window on the D2000 HI desktop.

Connect object palette - Control tab

Inherit instance

The parameter Inherit instance allows the multiple opening the same object (graph, picture) with the same instance number.

Instance number

The parameter Instance allows multiple object instantiation with different instance number. It can be used only for active picture / graph, because only these objects can detect its current instance number and modify their contents or behaviour according to this number. These objects detect the instance number by calling the function HI_GetSelfInstanceID from the script. Multiple object instantiation is used in connection with structured variables, where the instance number can determine the currently used row of a structure, which describes certain repeated object.

Position...

The button Position allows to define the position of the graphic information window on the D2000 HI desktop. Clicking the button opens the following dialog box:

Position

The red rectangle defines the position of the information window after opening on the D2000 HI desktop and behaviour of the picture, from which the window is opened.

  • Open picture as popup - the parameter is enabled only for objects of Picture type. The picture, connected to view, will be opened after clicking on the object you connect (button) as a dialog picture with no title bar. To close it, click outside the picture area. Warning: The pictures, which are used as popup, should not be used in any other way (e.g. as a part of other pictures, or opened from a script).
  • Open on given position - the window will be opened on defined position on the D2000 HI desktop.
  • Replace on given position - the window will be opened on defined position and the picture will be closed.
  • Open on picture position - the window will cover the picture.
  • Replace on picture position - the window will cover the picture and the picture will be closed.



For more information on connecting the object to control, see the topic Connecting objects to control.

Script


Connect object palette - Script tab

Reference variable

Defines a reference variable for use in the script.

Metadata

The application data (metadata) can be assigned to each graphic object and to column of Browser displayer in the System D2000 application. This metadata are used as storage room for data. The records are stored in a key/value format (the key and value are a text). Value assigned to key can be gained by calling the function %HI_GetMetadata and %HI_GetColumnMetadata. If the object contains some metadata, the name of the first record will be displayed in the button. Multiple records are indicated by ",...".

Event

Selection of a picture event for graphic object from the list. The contents of the list depends on the type of graphic object.

Event Handler

Defines the picture event.

Repaint


Connect object palette - Repaint tab

The tab Repaint defines a repaint method of the graphic object in the picture after changing the value of connected object. It also defines how to repaint it while blinking. The tab contains the following options.

All object area

All the graphic object together with its background will be repainted.

Object

Only the graphic object will be repainted.

Object with background

Object with a rectangle as a background will be repainted. This background rectangle takes a background color.


Note relating to D2000 Thin Client

Parameters are not implemented.
For more rules see the page Drawing rules and object properties for D2000 Thin Client.

Dynamics


Connect object palette - Dynamics tab

Draw dynamic part only

If it is checked, only the part of object that corresponds to the last change of connected object, will be redrawn.

Min. / Max.

When the value of connected object is within the interval, the size of the graphic object will be changed.

Direction

Direction of a dynamic drawing:

  • From centre
  • To centre
  • From centre horizontally
  • From centre vertically
  • Left to right
  • To bottom
  • Right to left
  • Bottom to top

Cancel dynamic drawing

Cancels the defined settings for dynamic drawing of the graphic object.



For more information on connecting the object to dynamic drawing see the topic Connecting the object to dynamic view.


Note relating to D2000 Thin Client

Parameters are not implemented.
For more rules see the page Drawing rules and object properties for D2000 Thin Client.

ActiveX


Connect object palette - ActiveX tab

ActiveX control

Selection of an ActiveX object. The dropdown box contains a list of ActiveX objects, which are available in the operating system.

Design

If the option is checked, the ActiveX object is disabled - in the environment of process D2000 GrEditor, the object does not react to pressing any keys or clicking the mouse buttons (it is necessary to carry out any editing actions for some ActiveX objects - change position, ...). Otherwise, the behaviour of the ActiveX object is the same as in D2000 HI.

Interface

The button opens the dialog box to view the interface of the ActiveX object (methods, variables, events, ...).

Properties

Clicking the button opens the dialog box to edit the properties of the ActiveX object (if it is allowed by the author of the object). Appearance and properties of the dialog box depends on the ActiveX object (they do not have to be implemented by the author of given ActiveX object).



For more information on inserting an ActiveX object into picture see the topic Inserting an ActiveX object.

Info text/URL


Info text

A text to be displayed as a tooltip when user points the mouse cursor to the graphic object in the picture  D2000 HI. It is allowed to use format masks in the text to display information about the connected object. If there are multiple objects connected in the graphic object, then the information from the first one is displayed.
Possibility to use the Dictionary (to open press CTRL+L).

URL

Definition of URL address to open a web page from a picture. The address may be set also in the picture script by the function %HI_SetOBJURL.

Select


The tab Select may be used only for objects of Database table type and allows to define a selection condition and a sorting condition.

Connect object palette - Select tab

Initial query

If checked, the condition specified below is applied to the table immediately after opening a picture and the table is filled with the items matching the criteria. Otherwise, after opening a picture the table remains empty. The desired condition is still available, though. However, to be applied, the function %HI_RefreshData must be called.

Condition

The input edit box to define a selection condition. A result set will include the objects matching the given mask. Condition syntax is identical with the syntax of condition following the clause WHERE in the SQL command SELECT (e.g. NAME= 'Test' or VALUE < 32.5).
Entering the condition #empty# does not read any data into the Browser (it can be used to open a Browser, whose condition is generated automatically on opening the picture from the script).

Sorting

The input edit box to define a sorting condition. Selected rows will be sorted by given condition. Condition syntax is the same as the syntax of a condition following the clause ORDER BY of the SQL command SELECT (e.g. NAME - sorting by the column NAME in ascending order or VALUE DESC - sorting by the column VALUE in ascending order).

Parameters/Parameters 2


The tab enables defining the parameters of particular displayer. For detailed description of the parameters see the chapter Displayers.


 Borders



Windows controls can have a rounded rectangle border around them, for example, text input:

Border parameters are entered in the Connect object window in the Borders tab control:

Use

Parameters and their use are only available after setting this option.

Round

Set the degree of rounding of the corners of a graphic object (0-99). A value of 0 means that the object has no rounded corners. The maximum rounding angle is 99. Option 4 allows to define the rounding of each corner separately.

Distance

Defines the distance of the elements' windows from the borders of the object space.

Properties


The tab allows to define the parameters of particular Windows control. For detailed description of the parameters see the chapter Windows controls.

Look


Connect object palette - Look tab Connect object palette - Look tab

The tab Look allows to define an appearance of the Browser.

ParameterMeaning
First columnColor of the first column.
OddColor of odd lines.
EvenColor of even lines.
InsertedColor of inserted values.
DeletedColor of deleted values.
ModifiedColor of modified values.
GridShow / hide the grid.
FrameFrame type (None, Thin, 3D).
Horiz. scroll barDisplaying the horizontal scroll bar (Never, Automatic, Always).
Vertic. scroll barDisplaying the vertical scroll bar (Never, Automatic, Always).

Others


Connect object palette - Others tab

Columns

The button Columns opens the following dialog box allowing to define parameters for displaying individual columns.

Defining the parameters for columns


ColumnMeaning
Visible orderThe order of structure columns for displaying in Browser window.
Order in the structureThe order of columns in the structure definition (it cannot be changed).
NameName in the structure definition.
CaptionColumn name, that will be displayed in the Browser window.
VisibleShows / hides the column in the Browser window.
EditableEnable / disable editing values of the column.
WidthColumn width.
AlignAlignment of text in the columns.
CheckboxShows / hides the checkbox for values of Boolean type.
Displ. paletteSelection of a display palette (double-clicking the item opens the list of display palettes).
Trans. paletteSelection of a transformation palette (clicking the item opens the dropdown box containing defined transformation palettes)
MetadataAllows to configure metadata in the dialog box.  

The buttons and allow changing the order of columns in the browser window.
The button All visible shows / hides all columns in the browser window.
The button All editable enables / disables editing values of all columns in the browser window.

Master browser

Definition of a model browser, the defined browser will be synchronized with. Synchronization is related to either horizontal shifting (the parameter Horizontal) or vertical shifting (the parameter Vertical) of the browser using scroll bars.

Multiple change


Connect object palette - Multiple change tab

View

If checked, all the parameters defined in the tabs View, Repaint and Dynamics are to be used for the selection of graphic objects (the same as when you check all the parameters placed in the column below the parameter).

Objects

The parameter allows to define the parameter Connected object (the tab View) for all the graphic objects in the selection.

Row

The parameter allows to define the parameter Row (the tab View) for all the graphic objects in the selection.

Column

The parameter allows to define the parameter Column (the tab View) for all the graphic objects in the selection.

Palette

The parameter allows to define the parameter Palette (the tab View) for all the graphic objects in the selection.

Extended palette

The parameter allows to define the parameter Extended palette (the tab View) for all the graphic objects in the selection.

Repaint

The parameter allows to define the repaint parameters (the tab Repaint) for all the graphic objects in the selection.

Dynamics

The parameter allows to define the repaint parameters for dynamic view (the tab Dynamics) for all the graphic objects in the selection.

Control

If the parameter is checked, all the parameters defined in the tabs Control are to be used for the selection of graphic objects (the same as when you check all the parameters placed in the column below the parameter, except the parameters Button down and Button up).

Button down

The parameter allows to set the parameter Action on to the value of Button down (the tab Control) for all the graphic object in the selection.

Button up

The parameter allows to set the parameter Action on to the value of Button up (the tab Control) for all the graphic object in the selection.

Objects

The parameter allows to define the parameter Connected object (the tab Control) for all the graphic object in the selection.

Row

The parameter allows to define the parameter Row (the tab Control) for all the graphic object in the selection.

Column

The parameter allows to define the parameter Column (the tab Control) for all the graphic object in the selection.

Parameters

The parameter allows to define some parameters (the tab Control) for all the graphic object in the selection - e.g. Set directly, Open window, Set value, Position. The parameters Inherit instance and Instance cannot be defined for all the graphic object in the selection.



Note: When you define the connection parameters for a selection of graphic objects, only the applicable parameters for individual graphic objects will be used.

Write a comment…