Options

• Mar 20, 2024
• 4 minutes to read

The ExpressQuantumGrid has many features making it a very powerful and flexible data-aware control. Most of these features can be accessed by sets of options. These options control the functionality and appearance of almost all the grid elements:

• Views;

• grid levels;

• items;

• other View elements.

Sometimes the ExpressQuantumGrid options affect other option sets, even if connections between them are not obvious.

The ExpressQuantumGrid uses Views to represent data to a user, so the View options play the main role in the customization of the ExpressQuantumGrid. There are several option sets available for grid Views. These options include:

• OptionsBehavior – options defining the grid View’s response to the user’s actions, i.e. via the mouse and keyboard

• OptionsCustomize – options determining the runtime functionality of View items. These options determine whether the end-user can move, group, sort, resize and View columns. The Banded Table View also provides options controlling band moving and resizing. These option settings can be overridden via code, e.g. suppress column grouping by setting the OptionsCustomize.ColumnGrouping property value to False. Columns can still be grouped though by setting the Column.GroupIndex property as appropriate.

• OptionsData – options controlling data manipulation within the View. These options control editing, inserting, deleting records, etc.

• OptionsSelection – options managing selections within a View. Options from this set determine whether the selection bar is visible, whether the selection bar bounding rectangle is visible, whether multiple rows can be selected, whether individual cells can be focused instead of rows, etc. The OptionsSelecton.CellSelect property affects the editing capability of a View. If this property value is False, editing can be implemented only programmatically.

• OptionsView – options controlling the appearance of a View. This option set defines the visibility, color, width and other appearance settings of View elements. These options are specific to the View type. They often affect the View functionality. For instance, making the group panel invisible by setting the OptionsView.GroupByBox property value to False restricts runtime grouping for a specific View.

• FilterBox – options which affect a View’s filter panel (also called a filter box). These options control various appearance settings and behavior of a filter box. For more information about filtering in the ExpressQuantumGrid, refer to the Filtering and Runtime Filtering topics.

• Filtering – options affecting a View’s filter dropdowns and filter dropdowns for the filter panel. These options specify the filter panel visibility, filter dropdown width and the number of data field values displayed within the filter dropdown. For more information about filtering in the ExpressQuantumGrid, see the Filtering and Runtime Filtering topics.

• FilterRow – options which control various appearance aspects and behavior of a filter row. For more information about filtering in the ExpressQuantumGrid, refer to the Filtering and Runtime Filtering topics.

• Navigator – options which control the behavior of the data navigator and various appearance aspects of its buttons. For additional information on the data navigator, refer to the Record Navigation topic.

• NewItemRow – options which control various appearance aspects of a new item row.

• Preview – options managing the preview section of a View. These options specify the preview section visibility, the View column whose values are displayed within the preview section, the preview text position, etc. For more information on the ExpressQuantumGrid preview feature, see the Preview Section topic.

View elements (columns, bands, diagrams, categories and series) have their own option sets. These option sets are similar to the OptionsCustomize View options and are used to override the View settings for certain View elements. For instance, you can allow all View columns to be moved via an appropriate option from the OptionsCustomize set and prevent a particular column from moving via the column’s Option.Moving property.