|Navigation: Templates > Guide to all Templates > Control Templates >====== BrowseGrid ======|
The BrowseGrid template provides a group control that is used to define an area (within a BrowseBox) to display controls in a matrix format. The size of the BrowseGrid control and BrowseBox can be manipulated to give the end result of a matrix with one column or many. When this template is added, the BrowseBox control does not display at runtime.
This feature is particularly useful for Web applications, but can also extend the capabilities of desktop applications.
This template requires a BrowseBox control template. The BrowseGrid GROUP box must be placed entirely within the BrowseBox. If the application is to be a Web application, the WebGridExtension must be added to the procedures extension set.
Populating the Control Template
Open the Window Designer for any procedure containing a BrowseBox control.
Highlight BrowseGrid and press the Select button.
Click on the window at the position where you want the Browse Grid.
If you have a multi-tab Browse, you do not want to populate the control template inside the TAB structure. Populating it outside of the structure will enable it to display for all tabs.
Resize the BrowseGrid Group box, as desired. The size of the LIST and the size of the GROUP determine how many columns will appear at runtime. The smaller the GROUP width, the more columns will be displayed at runtime.
This layout will produce a list with two columns and multiple rows (GROUP box ½ the size of the LIST box):
This next layout will produce a grid with one column and multiple rows:
Populate other controls you want to display for each record. Keep in mind that these are for display only unless you write the code to update records.
Typically, you will populate STRING controls in a BrowseGrid GROUP. You may also want to populate a DynamicImage control.
The BrowseGrid template provides the following prompts:
Expression for Group Title
Specifies a string, variable, or runtime expression using EVALUATE to use as the title for the group box that outlines each entry in the grid. To specify a variable here, precede the entry with an exclamation point (!). To specify a runtime expression, precede the entry with an equal sign (.
Press the “E” button to call the Expression Editor. This dialog is used to help you construct syntactically correct expressions to use in the Expression for Group Title prompt.
Color of Selected Group
Specifies the color of the currently selected group in the BrowseGrid. Type in a valid color equate, hex color code, or choose from the color dialog by pressing the ellipsis button.
If a color is specified in a Web application, the specific color used at runtime is taken from the web skeleton set.
Update on control event
Check this box to allow the Update Control use variable to update when the Update Control Event occurs.
Specifies the control that will initiate the update.
Update Control Event
Specifies the event that triggers the update action.
Make Group Selectable
Check this box to indicate the group defined by the BrowseGrid can be selected and generate events.
Forward Other Control Clicks
Check this box to force an EVENT:Accepted action to the Forward Click To control when a cell in the matrix is selected. A DOUBLE-CLICK activates the action in a Windows application.
Forward Other Control Clicks (To)
Specifies the control to process when a cell in the BrowseGrid matrix is selected.