Grid Object

Here are the object's settings as they appear in the properties pane:

Object

Name

The name that is used to identify this object.

Rows

The number of rows initially in the grid object.

Columns

The number of columns initially in the grid object.

FixedRows

The number of fixed rows initially in the grid object.

FixedColumns

The number of fixed columns initially in the grid object.

CSV File

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.

FitMethod

Whether the rows and columns displayed will be determined by the CSV file. Choose from:

CSV File

Make the number of rows and columns displayed in the grid object at runtime determined by the contents of the CSV file.

Design-time Settings

Don't change the number of rows and columns displayed in the grid object at runtime based on the contents of the CSV file. Whatever is defined in the object's settings at design-time, or via actions, will control the number of rows and columns.

Options

Editable

Whether the grid object is editable by the user. Choose from:

True

Make the grid object editable by the user.

False

Don't allow the user to edit the grid object.

Selectable

Whether the user can select grid cells with the mouse or keyboard. Choose from:

True

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

False

Don't allow the user to select grid cells.

CellDragAndDrop

Whether cells can be dragged and dropped by the user. Choose from:

True

Allow the user to drag and drop cells.

False

Don't allow the user to drag and drop cells.

ResizableRows

Whether rows can be resized by the user. Choose from:

True

Allow the user to resize rows.

False

Don't allow the user to resize rows.

ResizableColumns

Whether columns can be resized by the user. Choose from:

True

Allow the user to resize columns.

False

Don't allow the user to resize columns.

GridLines

Which grid lines to display in the grid object. Choose from:

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.

Font

The font that you want to use for the text. Click the edit 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.

FontFamily

The font family that you want to use.

FontSize

The font size, in points.

FontBold

Make the text bolded.

FontItalic

Make the text appear in italics.

Colors

CustomColors

Whether to use custom colors for items in the grid object when initially created, or to use the default colors according to the user's Windows color scheme.

Note: This setting only affects its initial creation; all of these values can be changed at runtime using actions.

True

Use custom colors for the grid object when initially created.

False

Use the default colors according to the user's Windows color scheme.

TextColor

The text color to use in the object.

Tip: You can click the select button to bring up a color chooser. 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.

TextBkColor

The text background color to use in the object.

Tip: You can click the select button to bring up a color chooser.

FixedTextColor

The fixed text color to use in the object.

Tip: You can click the select button to bring up a color chooser.

FixedBkColor

The fixed background color to use in the object.

Tip: You can click the select button to bring up a color chooser.

GridLineColor

The line color to use in the object.

Tip: You can click the select button to bring up a color chooser.

GridBkColor

The grid background color to use in the object.

Tip: You can click the select button to bring up a color chooser.

ToolTipBackColor

The tooltip background color to use in the object.

Tip: You can click the select button to bring up a color chooser.

Note: The tooltip background and tooltip text colors are used for cell tooltips that are displayed within the grid object itself. They are not used to control the color of the tooltip set on the Object's Attributes tab.

ToolTipTextColor

The tooltip text color to use in the object.

Tip: You can click the select button to bring up a color chooser.

Note: The tooltip background and tooltip text colors are used for cell tooltips that are displayed within the grid object itself. They are not used to control the color of the tooltip set on the Object's Attributes tab.

Attributes

TooltipText

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 "&&&".

Enabled

Enable the object so it responds to user interaction. Choose from:

True

The object will respond to mouse overs and clicks and perform any actions assigned to its events.

False

The object 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. Choose from:

True

The object will be visible when the page or dialog is displayed.

False

The object will be invisible 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.

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.

Auto-Resize

ResizeLeft

Whether the left side of the object will move when resized. Choose from:

True

The left side of the object will move when the application is resized.

False

Don't move the left side of the object when the application is resized.

ResizeRight

Whether the right side of the object will move when resized. Choose from:

True

The right side of the object will move when the application is resized.

False

Don't move the right side of the object when the application is resized.

ResizeTop

Whether the top of the object will move when resized. Choose from:

True

The top of the object will move when the application is resized.

False

Don't move the top of the object when the application is resized.

ResizeBottom

Whether the bottom of the object will move when resized. Choose from:

True

The bottom of the object will move when the application is resized.

False

Don't move the bottom of the object when the application is resized.

Actions

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. Click the edit button to open the script editor.

On Selection Changed

The actions that will be performed whenever the selection of cells in the grid changes. Click the edit button to open the script editor.