Skip to content

Grid Objects

The Visual Designer provides special support for designing grids and prompt lists that are based on the CodeJock report control.

For more information about grids and prompt lists, refer to Using Grids.

Creating a Grid Object

Grid and prompt list objects are created by dragging and dropping the appropriate class from the Class Palette onto the Visual Designer. If your grid will show data using a data dictionary object structure, then you should use a data-aware grid class such as cDbCJGrid or cDbCJGridPromptList.

Once a grid object has been created, you can begin creating grid columns. Grid columns can be created by dragging and dropping a column from the class palette onto your grid object. If the column will display data using a data dictionary object, then you should use the data-aware column class: cDbCJGridColumn.

A better way to create data-aware grid columns is to use the DDO Explorer. Drag the desired table columns from the DDO Explorer onto your grid object. One grid column will be created for each table column. These grid columns will be "bound" to the desired table column, and various column properties will be read from the data dictionary and applied, e.g., the column caption and width.

Changing the Column Order

The left-to-right order of columns is determined by the relative positions of the grid's column objects. You can move a column object using any of the following methods:

  • Dragging the column header in the Visual Designer and dropping it to its new location.

While moving a column in this way, the column header "sticks" to the mouse, and double red arrows indicate the position that the column will be located when it is dropped.

  • Moving the column object in Code Explorer.
  • Moving the column object in the Code Editor.

Resizing Columns

Columns can be resized by dragging the header column splitter on the right-hand edge of the column.

Removing Columns

To remove (delete) a column object, drag the column header to a position outside the grid object and drop it. Notice that the column header "sticks" to the mouse as it is dragged, and that a large "X" is superimposed when the column is dragged outside the grid boundaries.

Note that a column can be "hidden" (without deleting the object) by setting the column's [pbVisible](../VdfClassRef/Windows/cCJGridColumn-Property-pbVisible.md) property to False.

You can also remove a column by right-clicking the column header in the Designer and selecting “Delete Grid Column” from the context menu.

Using Column Subclasses

When dragging and dropping column objects onto your grid from the DDO Explorer, the column object's class is determined by the grid class's "CompositeClass" meta-tag. See CompositeClass for more information.

See Also