Grid Object

Here are the object's settings as they appear on the "double-click" Properties dialog.

There are three tabs on the Properties dialog:

Settings

Attributes

Script

Settings Tab

Grid

Rows:

The number of rows initially in the grid object.

Columns:

The number of columns initially in the grid object.

Fixed rows:

The number of fixed rows initially in the grid object.

Fixed columns:

The number of fixed columns initially in the grid object.

Options

Editable

Make the grid object editable by the user.

Selectable

Allow the user to select grid cells with the mouse or keyboard.

Cell drag and drop

Allow cells to be dragged and dropped by the user.

Font...

The font that you want to use for the text. Click the Select Font button to open the Font dialog where you can edit all of the font settings.

Tip: You can set the default font for this object type by configuring its settings on the Objects tab in Edit > Preferences.

Resizable rows

Allow rows to be resized by the user.

Resizable columns

Allow columns to be resized by the user.

Grid lines:

Which grid lines to display in the grid object.

None

Don't show any grid lines.

Horizontal

Show horizontal grid lines.

Vertical

Show vertical grid lines.

Both

Show both horizontal and vertical grid lines.

Colors

Custom colors

Use custom colors for items in the grid object when initially created. If unchecked, the colors will be set to the default colors according to the user's Windows color scheme. This setting only affects its initial creation; all of these values can be changed at runtime using actions.

Tip: Clicking the "More Colors..." button on the color menu allows you to choose either a standard color/custom color, or use the eyedropper to pick a color from somewhere within the AutoPlay application window.

Text background:

The text background color to use in the object. You can click the select button to bring up a color chooser.

Text:

The text color to use in the object. You can click the select button to bring up a color chooser.

Fixed background:

The fixed background color to use in the object. You can click the select button to bring up a color chooser.

Fixed text:

The fixed text color to use in the object. You can click the select button to bring up a color chooser.

Grid background:

The grid background color to use in the object. You can click the select button to bring up a color chooser.

Lines:

The line color to use in the object. You can click the select button to bring up a color chooser.

Tooltip background:

The tooltip background color to use in the object. You can click the select button to bring up a color chooser.

Tooltip text:

The tooltip text color to use in the object. You can click the select button to bring up a color chooser.

CSV File

The Comma Separated Value (csv) file that you want to display in the grid object at runtime. Click the Browse button to select a file.

Use CSV data to specify rows and columns

If selected, the number of rows and columns displayed in the grid object at runtime will be determined by the contents of the CSV file.

Fit CSV data in existing rows and columns

If selected, the number of rows and columns displayed in the grid object at runtime will not be changed by the contents of the CSV file. Whatever is defined in the Grid section of this dialog, or via actions, will control the number of rows and columns.

Attributes Tab

Identification

Object name:

The name that is used to identify this object.

State

Enabled

Enable the object so it responds to user interaction. When an object is disabled, it will not respond to any mouse overs or clicks and will not perform any actions until it is enabled.

Note: You can use the Grid.SetEnabled action to enable this object.

Visible

Set the object's initial visibility (whether it's visible when the page or dialog is displayed).

Note: You can use the Grid.SetVisible action to make the object visible or invisible at run time.

Auto-Resize

Left

If checked, the left side of the object will move when the application is resized. If unchecked, the left side of the object will not move.

Right

If checked, the right side of the object will move when the application is resized. If unchecked, the right side of the object will not move.

Top

If checked, the top of the object will move when the application is resized. If unchecked, the top of the object will not move.

Bottom

If checked, the bottom of the object will move when the application is resized. If unchecked, the bottom of the object will not move.

Position

Left:

The distance in pixels from the left edge of the object to the left edge of the page or dialog.

Tip: You can also change the position of an object by dragging it.

Top:

The distance in pixels from the top edge of the object to the top edge of the page or dialog.

Width:

The width of the object in pixels.

Tip: You can also resize an object by dragging one of the resize handles on its bounding box.

Height:

The height of the object in pixels.

Restore Original

Set's the object's size back to the original values.

Note: This option is not available for grid objects.

Feedback

Tooltip:

A short string of text that will appear after the mouse hovers over this object for a moment.

Tip: You can choose from several tooltip styles for all tooltips in your project, Standard, Balloon and Extended. This setting can be found on the Appearance tab of the Project > Settings.

Tip: If you want a newline in your tooltip text, use "\r\n". For example, for an Extended tooltip, "My First Line\r\nMy Second Line|My Title". Newlines are not supported in the Title text for Balloon or Extended styles.

Tip: If you want a "&" character in the text, you must enter "&&&".

Spelling

Check the spelling of the tooltip text.

Cursor:

Note: This option is not available for grid objects.

Script Tab

You can use the script editor on this tab to edit the script of actions that will be performed on each of this object's events.

This object supports the following events:

On Cell Changed

The actions that will be performed whenever the text of a cell changes for any reason. This may result from the user editing cell text or from text being pasted in or even from the text changing in response to an action such as Grid.SetCellText.

The following event variables are automatically set whenever this event is triggered:

e_Row

(number) The row (0-based) of the cell that changed.

e_Column

(number) The column (0-based) of the cell that changed.

e_OldText

(number) The text that was in the cell before it was changed.

e_NewText

(number) The new text of the cell.

On Selection Changed

The actions that will be performed whenever the selection of cells in the grid changes.

The following event variables are automatically set whenever this event is triggered:

e_Row

(number) The row (0-based) of the cell that now has focus.

e_Column

(number) The column (0-based) of the cell that now has focus.