Defining a Grid Control 

Use

You use this procedure to define the properties and event handlers for a grid control. A grid control presents data in tabular format on a tile.

 

To display product information, create a grid control to list product name, product description, distributor and price.

When you design a grid control, you must observe the following constraints:

·        A grid control is mandatory in a list tile. When you create a list tile, a grid control is inserted automatically.

·        Columns of a grid control can be associated with the properties of a business collection.

·        A grid control cannot be associated with a business object or business query.

Prerequisites

You have:

·        Added a grid control on a list tile

·        Switched to the required change list

Procedure

...

       1.      In the Solution Explorer, locate the tile for which you want to design the grid control, click the tile with the secondary mouse button, and choose View Designer.

The Tile Designer window appears.

       2.      In the Anchors view of the Document Outline window, locate and select the grid control.

The Properties panel displays the values for the grid control’s properties.

       3.      In the Properties panel, enter the appropriate values for the grid control properties.

For more information on each of the properties, see Properties of a Grid Control.

       4.      If you do not need to create an event handler, continue with step 5. If you want to create an event handler, perform the following steps:

Ensure that the value of the IsGridColumn property is True. This incorporates the control as a column in the grid.

                            a.      In the Document Outline window in the Scripts View, click the Event Handlers node with the secondary mouse button and choose New.

The New Event Handler dialog box appears with default values in the fields.

                            b.      In the Event field, select the event you want to use.

The following table provides information about the events.

Event Name	Description
RowLoaded2	You define the content of unbound columns.
RowColChange	You change a row or a column.

The RowLoaded event is not supported in this release. Use RowLoaded2 event.

                            c.      Select Edit this handler code after creation and choose OK.

                            d.      In the TODO section, enter the code you require for the event handler.

                            e.      Save the code.

       5.      Save your entries.

Result

You have defined a grid control by specifying the properties and event handlers.

See also:

 

Adding Controls to a Tile