Grid Style Properties

The Grid Style properties are used to configure the object's graphical aspects.

To edit the Style properties, select the object with the mouse and use the Movicon "Properties Window" that opens upon doing so.

 

 

Border

The  "Border" property is described in the section on "Style Proprieties common to Drawings and Controls".

 

Prompt Pad

This property allows the Movicon Alphanumeric Pad to display each time a Movicon Grid cell is selected for editing its alphanumeric value.

For further information, please refer to the object's  "Prompt  Pad" property found in the "Style Properties" group.

 

Events:

The Movicon Grid offers advanced features that can be accessed and configured through its GridWndCmdTarget interface which provides Basic Script functions, Properties and Events for programming it. The 'OnTextChanging' and 'OnTextChanged' events can be used to intercept the previously edited instance or the one immediately after according to the following modes:

 

a) With the "Prompt Pad" disabled, the 'OnTextChanging' event is notified before the cell enters into edit mode.  When set to false, the bRet parameter will prevent this from happening by changing the cell's value. However, the 'OnTextChanged' event will only be notified when the entered value has been confirmed with 'Enter', and the 'ChangedText' reports the new value entered in the cell. The editing operations and relative events can be aborted with the 'Escape' button.

b) With the "Prompt Pad" enabled, the 'OnTextChanging' event is notified before the Alphanumeric Pad appears, and by setting bRet = False will impede any following edits in the cell, therefore, preventing the appearance of the Alphanumeric Pad. However, the 'OnTextChanged' event will only be notified when existing with 'OK' or 'Enter' from the Alphnumeric Pad, and the  'ChangedText' event reports the new value entered. Editing is aborted by using the Pad's 'Cancel' button or 'Escape' key from the Keyboard.

 

For further information on the Movicon Grid's VBA interface, please refer to the section on 'API Interface Basic' from the topic on 'VBA Language".

 

System Registry:

A "General" registry key value called 'ShowPad' is available set at zero for default and can be used Windows CE as well.  You will be able to obtain the following combinations by using this value together with the "Prompt Pad" properties:

 

a) 'ShowPad=0' and 'Prompt Pad=false': Alphanumeric pad will not open.

b) 'ShowPad=0' and ''Prompt Pad=true': Opens the alphanumeric pad.

c) 'ShowPad=1' and 'Prompt Pad=false': Opens the alphanumeric pad.

c) 'ShowPad=1' and ''Prompt Pad=true': Opens the alphanumeric pad.

 

Read Only

The Grid object translates ID-Strings in the special "$(ID-String)" format, which are present in the Alarm Log (Alarms) and System Log (SysMsgs) tables, into different languages at runtime.  This functionality is activated when the Grid object is set to "Read Only" in its Style properties.

ID-Strings  in the special  "$(ID-String)" format are saved automatically in the Alarm Log table when the Project's General "Multilanguage Alarm Log" option has been enabled.   

 

ID-Strings are automatically saved in the special "$(ID-String)" format in the Alarm table's  "EvDescCol" column.

However, when using the System Log, you will need to save the ID-Strings in special "$(ID-String)" format directly in the  "EvDescCol" column manually.

 

For example: if "String01" is a ID-String set in an Alarm text translated as "Allarme Motore 01" in Italian and "Motor 01 Alarm" in English, and the Project is set in the Italian language, the text in the Grid object set to read the Alarm table will show as  "Allarme Motore 01".  If the project language is changed to English, the text in the Grid object will show the "Motor 01 Alarm" English translation.

 

In order to display the ID-Strings in multi-language mode in the Alarm Log you will need to:

 

  1. Enable the 'Multi-language Alarm Log" option in the project's General  properties window in order to automatically save the ID-Strings existing in the Alarm texts in the special $(ID-String) format

  2. Set the  ID-Strings in the String Table

  3. Create Alarm objects and thresholds set with ID-Strings in the "Threshold Name" or "Alarm Text" properties (NB: the Name of the Variable can also be inserted as a ID-String in the String Table when using Alarms as Templates)

  4. Set the Grid object to view Alarm Log (e.g. by using the Wizard)

  5. When starting the project up in Runtime, the Grid object will show the ID-String translated according to the language currently set in the project.

 

To display the ID-Strings in multi-language mode in the System Log you will need to:

 

  1. Set ID-Strings in the String Table

  2. Set the Grid object to display the System Log (e.g. by using the Wizard)

  3. By using a VB Script and the Debug.Print() function for example, save the ID-strings in the special "$(ID-String)" format in the System Log at Runtime.

  4. When the Grid object is displayed, the ID-Strings will be translated into the language currently set in the project.

 

The Grid object always uses the multi-language function to translate ID-Strings with the special "$(ID-String)" format that exist in the text to be displayed.

 

 

Clickable

The "Clickable" is described in the paragraph on "Style Proprieties common to Drawings and Controls".

 

Show Control Wnd

The "Show Control Wnd" is described in the paragraph on "Style Proprieties common to Drawings and Controls".

 

Auto Layout

The "Auto Layout" is described in the paragraph on "Style Proprieties common to Drawings and Controls".

 

Refresh Button

This property enables or disables the displaying of the Refresh button.

 

Update Button

This property enables or disables the displaying of the Update button.

 

Save Button

This property enables or disables the displaying of the Save button.

 

Select All Button

This property enables or disables the displaying of the Select All button.

 

Copy Button

This property enables or disables the displaying of the Copy button.

 

Insert Button

This property enables or disables the displaying of the Insert button.

 

Delete Button

This property enables or disables the displaying of the Delete button.

 

Widths of Grid Columns

This property is used for specifying the widths of each Grid column in pixels.  This property is a string where each value indicating each column size is separated by the pipe char. (|).  Each value will be associated to each column in order of succession.  For instance, If there are three columns in the grid, Col1, Col2 and Col3, and the values  "10|20|30" are inserted in this property, the columns will be sized as follows: Col1=10, Col2=20 e Col3=30.

When specifying the column's size with a '0' or negative number, the column will adapt according to the width of its contents.  Furthermore, it is not necessary to insert all the columns' widths.  Those that are not specified with a value will also automatically adapt according to the width of their contents.

 

Button Size

The "Button Size"  property is described in the paragraph on "Style Proprieties common to Drawings and Controls".

 

Align Buttons

The "Align Buttons" property is described in the paragraph on "Style Proprieties common to Drawings and Controls".

 

Refresh Button Text

This edit box allows you to insert the text to be associated to the Refresh button. When this field is left empty the default text will be used instead.

 

Update Button Text

This edit box allows you to insert the text to be associated to the Update button. When this field is left empty the default text will be used instead.

 

Save Button Text

This edit box allows you to insert the text to be associated to the Save Button. When this field is left empty the default text will be used instead.

 

Select All Button Text

This edit box allows you to insert the text to be associated to the Select All Button. When this field is left empty the default text will be used instead.

 

Copy Button Text

This edit box allows you to insert the text to be associated to the Copy Button. When this field is left empty the default text will be used instead.

 

Insert Button Text

This edit box allows you to insert the text to be associated to the Insert Button. When this field is left empty the default text will be used instead.

 

Delete Button Text

This edit box allows you to insert the text to be associated to the Delete Button. When this field is left empty the default text will be used instead.

 

Update Variable

This property allows you to enable the possibility to update the variables which have the same names as the Table columns with the record values of the selected grid. Updating is done on  the Update button's command.

 

 

See Also