Skip to main content

Grid3 and Grid4 Equivalents (Alphabetically)

  • 36 minutes to read

This topic provides a conversion guide between ExpressQuantumGrid3 and ExpressQuantumGrid4 members. All members are grouped into four categories: Options, Properties, Methods and Events. Use the links under each category to access the equivalents to ExpressQuantumGrid3 members (provided in alphabetical order).

Options

All option names have the edgo prefix –; so the alphabetical order refers to option names excluding this prefix.

A B C D E F H I K L M N P R S T U V

Properties

A B C D E F G H I K L M N O P R S T U V W

Methods

A B C D E F G H I L M P R S

Events

All event names have the On prefix – so the alphabetical order refers to event names excluding this prefix.

A B C D E F G H I R S V

Grid control

The main difference between versions 3 and 4 of the ExpressQuantumGrid is that the latter is capable of displaying data within multiple Views. ExpressQuantumGrid4 provides different Views (Table, Banded Table and Card Views) for displaying data while ExpressQuantumGrid3 provides just one basic Table View (which can be displayed with or without bands). Most of the TdxDBGrid functionality is now implemented by View objects. Views present data from data fields by means of “items”. An Item represents a column in Table Views and a row in Card Views. Refer to the Views and Items sections for more details.

A data controller represented by the View’s DataController property implements data-aware operations such as loading data, filtering, grouping and calculating summaries. Customizing colors and fonts has been delegated to Style objects and so is implemented now by assigning styles to grid elements.

These changes mean that the multitude of top level properties in the grid have been replaced by a small collection of objects. While these changes provide for a more efficient and extensible product, we recognize that users of ExpressQuantumGrid3 will have initial difficulty in finding the properties required while converting event handlers for ExpressQuantumGrid4 and hence the reason for this topic.

Note

the two technologies are very different so there isn’t always a simple replacement available. While we have tried to cover as many options as possible, the following lists can never be totally complete (you may be using our product in ways we haven’t considered!). If you still have difficulty in replacing your ExpressQuantumGrid3 code because your needs are not covered here, please write to support@devexpress.com and we will help you.

Bands

Unlike the previous version of the grid control, ExpressQuantumGrid4 does not contain bands by default. Instead, it provides Banded Table Views (TcxGridBandedTableView and TcxGridDBBandedTableView). A Banded Table View contains the Bands property providing a collection of TcxGridBand objects.

Columns

Every View provided by ExpressQuantumGrid4 contains a collection of View-specific items (columns in a (Banded) Table View and rows in a Card View) displaying data from particular fields. Unlike the previous version of the grid control, ExpressQuantumGrid4 does not provide different column types. Instead, you should use the item’s properties (RepositoryItem or PropertiesClass) to specify the editor type used to edit the item’s data. You can refer to the Data Editing Using Inplace Editors section for more information.

ExpressQuamtumGrid4 provides different repository items corresponding to the ExpressQuantumGrid3 columns. These repository items can be used to specify the in-place editor type:

ExpressQuantumGrid3 members

ExpressQuantumGrid4 equivalent

ExpressQuantumGrid3 columns

Repository items

TdxDBGridColumn

TcxEditRepositoryTextItem

TdxDBGridBlobColumn

TcxEditRepositoryBlobItem

TdxDBGridButtonColumn

TcxEditRepositoryButtonItem

TdxDBGridCalcColumn

TcxEditRepositoryCalcItem

TdxDBGridCheckColumn

TcxEditRepositoryCheckBoxItem

TdxDBGridCurrencyColumn

TcxEditRepositoryCurrencyItem

TdxDBGridDateColumn

TcxEditRepositoryDateItem

TdxDBGridDropDownColumn

–;

TdxDBGridExtLookupColumn

TcxEditRepositoryExtLookupComboBoxItem

TdxDBGridGraphicColumn

TcxEditRepositoryImageItem

TdxDBGridHyperLinkColumn

TcxEditRepositoryHyperLinkItem

TdxDBGridImageColumn

TcxEditRepositoryImageComboBoxItem

TdxDBGridLookupColumn

TcxEditRepositoryLookupComboBoxItem

TdxDBGridMaskColumn

TcxEditRepositoryMaskItem

TdxDBGridMemoColumn

TcxEditRepositoryMemoItem

TdxDBGridMRUColumn

TcxEditRepositoryMRUItem

TdxDBGridPickColumn

TcxEditRepositoryComboBoxItem

TdxDBGridPopupColumn

TcxEditRepositoryPopupItem

TdxDBGridSpinColumn

TcxEditRepositorySpinItem

TdxDBGridTimeColumn

TcxEditRepositoryTimeItem

TdxDBGridWrapperColumn

–;

Use any repository item listed above and handle the OnGetProperties event to specify the type of editor used to edit values of individual item cells.

Nodes/records

Records provided by an ExpressQuantumGrid4 View can be accessed via the ViewData property (e.g. TcxGridTableView.ViewData). TcxCustomGridRecord is the base class for items available via the ViewData object and these items consist of group rows, master and data rows, the new item row and cards. ViewData contains only those records which are currently visible or potentially visible by scrolling. It does not contain records hidden under collapsed group rows.

Summary items

ExpressQuantumGrid provides summary groups (as in the previous version), thus enabling you to calculate summaries when grouping by particular columns. Default summary groups are now available via the View’s DataController.Summary.DefaultGroupSummaryItems property.

Filter

Filtering data in ExpressQuantumGrid4 is implemented by the TcxDataFilterCriteria class. It allows you to create complex filter conditions, enable/disable filter criteria and customize the filter drop-down list.

Options

Option

Property which contains the option

ExpressQuantumGrid4 equivalent

A

edgoAnsiSort

TCustomdxDBGrid.OptionsBehavior

The dcoAnsiSort option of the View’s DataController.Options property

edgoAutoCalcPreviewLines

TCustomdxDBGrid.OptionsView

The (Banded) Table View’s Preview.AutoHeight property.

edgoAutoCopySelectedToClipboard

TCustomdxDBGrid.OptionsBehavior

–;

edgoAutoHeaderPanelHeight

TCustomdxDBGrid.OptionsView

–;

edgoAutoSearch

TCustomdxDBGrid.OptionsBehavior

The View’s OptionsBehavior.IncSearch and item’s Options.IncSearch properties

edgoAutoSort

TCustomdxDBGrid.OptionsBehavior

The View’s OptionsCustomize.ItemSorting (ColumnSorting in a grid Table View) and item’s Options.Sorting property.

edgoAutoWidth

TCustomdxDBGrid.OptionsView

The (Banded) Table View’s OptionsView.ColumnAutoWidth property.

B

edgoBandButtonClicking

TCustomdxDBGrid.OptionsBehavior

–;

edgoBandHeaderWidth

TCustomdxDBGrid.OptionsView

–;

edgoBandMoving

TCustomdxDBGrid.OptionsCustomize

The Banded Table View’s OptionsCustomize.BandMoving and band’s Options.Moving properties.

edgoBandPanelSizing

TCustomdxDBGrid.OptionsCustomize

–;

edgoBandSizing

TCustomdxDBGrid.OptionsCustomize

The Banded Table View’s OptionsCustomize.BandSizing and the band’s Options.Sizing properties.

C

edgoCanAppend

TCustomdxDBGrid.OptionsDB

The View’s OptionsData.Appending property

edgoCancelOnExit

TCustomdxDBGrid.OptionsDB

The View’s OptionsData.CancelOnExit property

edgoCanDelete

TCustomdxDBGrid.OptionsDB

The View’s OptionsData.Deleting property

edgoCanInsert

TCustomdxDBGrid.OptionsDB

The View’s OptionsData.Inserting property

edgoCanNavigation

TCustomdxDBGrid.OptionsDB

The View’s DataController.DataModeController.SyncMode property.

edgoCaseInsensitive

TCustomdxDBGrid.OptionsBehavior

The dcoCaseInsensitive option of the View’s DataController.Options property

edgoCellMultiSelect

TCustomdxDBGrid.OptionsBehavior

–;

edgoCollapsedReload

TCustomdxDBGrid.OptionsBehavior

–;

edgoColumnMoving

TCustomdxDBGrid.OptionsCustomize

The View’s OptionsCustomize.ItemMoving (OptionsCustomize.ColumnMoving in a grid Table View) and item’s Options.Moving properties.

edgoColumnSizing

TCustomdxDBGrid.OptionsCustomize

The View’s OptionsCustomize.ColumnHorzSizing and column’s Options.HorzSizing properties. See also the OptionsCustomize.ColumnVertSizing and Options.VertSizing properties which are available for Banded Table Views.

edgoConfirmDelete

TCustomdxDBGrid.OptionsView

The View’s OptionsData.DeletingConfirmation property

D

edgoDblClick

TCustomdxDBGrid.OptionsBehavior

–;

edgoDragCollapse

TCustomdxDBGrid.OptionsBehavior

–;

edgoDragExpand

TCustomdxDBGrid.OptionsBehavior

The View’s OptionsBehavior.DragOpening property.

edgoDragScroll

TCustomdxDBGrid.OptionsBehavior

See the View’s OptionsBehavior.DragFocusing and OptionsBehavior.DragScrolling properties.

edgoDrawEndEllipsis

TCustomdxDBGrid.OptionsView

The following properties affect ellipsis displaying when clipping occurs:

OptionsView.BandHeaderEndEllipsis

OptionsView.HeaderEndEllipsis

OptionsView.RowCaptionEndEllipsis

OptionsView.CellEndEllipsis

E

edgoEditing

TCustomdxDBGrid.OptionsBehavior

The View’s OptionsData.Editing and item’s Options.Editing properties

edgoEnterShowEditor

TCustomdxDBGrid.OptionsBehavior

–;

If end-users are allowed to edit cell values, they can initiate editing of the focused cell by pressing the Enter or Space key, or by typing a new cell value directly.

edgoEnterThrough

TCustomdxDBGrid.OptionsBehavior

The View’s OptionsBehavior.GoToNextCellOnEnter property

edgoExtCustomizing

TCustomdxDBGrid.OptionsCustomize

The (Banded) Table View’s OptionsCustomize.ColumnHiding property.

edgoExtMultiSelect

TCustomdxDBGrid.OptionsBehavior

End-users are allowed to select multiple records from different groups provided that the OptionsSelection.MultiSelect property is set to True. Setting this property to True is equivalent to enabling both the edgoMultiSelect and edgoExtMultiSelect options in Grid 3.

F

edgoFullSizing

TCustomdxDBGrid.OptionsCustomize

–;

H

edgoHeaderButtonClicking

TCustomdxDBGrid.OptionsBehavior

–;

edgoHeaderPanelSizing

TCustomdxDBGrid.OptionsCustomize

–;

edgoHideFocusRect

–;

edgoHorzThrough

TCustomdxDBGrid.OptionsBehavior

The View’s OptionsBehavior.FocusCellOnCycle property

edgoHotTrack

TCustomdxDBGrid.OptionsView

–;

I

edgoImmediateEditor

TCustomdxDBGrid.OptionsBehavior

The View’s OptionsBehavior.ImmediateEditor property.

edgoIndicator

TCustomdxDBGrid.OptionsView

The View’s OptionsView.Indicator property

edgoInvertSelect

TCustomdxDBGrid.OptionsView

The View’s OptionsSelection.InvertSelect property

K

edgoKeepColumnWidth

TCustomdxDBGrid.OptionsCustomize

–;

L

edgoLoadAllRecords

TCustomdxDBGrid.OptionsDB

By default, ExpressQuantumGrid4 loads all records into memory. To limit the number of records loaded at a time, see the View’s DataController.DataModeController.GridMode property

M

edgoMouseScroll

TCustomdxDBGrid.OptionsBehavior

–;

edgoMultiSelect

TCustomdxDBGrid.OptionsBehavior

The View’s OptionsSelection.MultiSelect property. Setting this property to True is equivalent to enabling both the edgoMultiSelect and edgoExtMultiSelect options in Grid 3.

edgoMultiSort

TCustomdxDBGrid.OptionsBehavior

–;

End-users are allowed to sort the View data by values of multiple columns if the View’s OptionsCustomize.ColumnSorting property is set to True. Setting this property to True is equivalent to enabling both the edgoMultiSort And edgoAutoSort options in Grid 3).

N

edgoNotHideColumn

TCustomdxDBGrid.OptionsCustomize

See the View’s OptionsCustomize.ColumnHidingOnGrouping property.

P

edgoPartialLoad

TCustomdxDBGrid.OptionsDB

You can use the grid mode to limit the number of records loaded into memory at a time. See the View’s DataController.DataModeController.GridMode property

edgoPreview

TCustomdxDBGrid.OptionsView

The View’s Preview.Visible property

R

edgoResetColumnFocus

TCustomdxDBGrid.OptionsDB

The View’s OptionsBehavior.FocusFirstCellOnNewRecord property

edgoRowAutoHeight

TCustomdxDBGrid.OptionsView

The View’s OptionsView.CellAutoHeight property

edgoRowSelect

TCustomdxDBGrid.OptionsView

The View’s OptionsSelection.CellSelect property

edgoRowSizing

TCustomdxDBGrid.OptionsCustomize

In a Banded Table View, the row height can be adjusted by changing the height of column headers displayed within the bands. To enable this, set the OptionsCustomize.ColumnVertSizing property of a Banded Table View to True.

S

edgoSeekDetail

TCustomdxDBGrid.OptionsBehavior

–;

edgoShowButtonAlways

TCustomdxDBGrid.OptionsView

The View’s OptionsView.ShowEditButtons property

edgoShowHourGlass

TCustomdxDBGrid.OptionsBehavior

–;

edgoSmartRefresh

TCustomdxDBGrid.OptionsDB

The View’s DataController.DataModeController.SmartRefresh property

edgoSmartReload

TCustomdxDBGrid.OptionsDB

–;

edgoStoreToIniFile

TCustomdxDBGrid.OptionsBehavior

–;

See the View’s StoreToIniFile method.

edgoStoreToRegistry

TCustomdxDBGrid.OptionsBehavior

–;

See the View’s StoreToRegistry method.

edgoSyncSelection

TCustomdxDBGrid.OptionsDB

The View’s DataController.DataModeController.SyncMode property

T

edgoTabs

TCustomdxDBGrid.OptionsBehavior

The View’s OptionsBehavior.FocusCellOnTab property

edgoTabThrough

TCustomdxDBGrid.OptionsBehavior

The View’s OptionsBehavior.FocusCellOnCycle and OptionsBehavior.FocusCellOnTab properties

U

edgoUseBitmap

TCustomdxDBGrid.OptionsView

–;

edgoUseBookmarks

TCustomdxDBGrid.OptionsDB

–;

edgoUseLocate

TCustomdxDBGrid.OptionsDB

–;

The Locate method is always used if key field names are specified via the View’s DataController.KeyFieldNames property.

V

edgoVertThrough

TCustomdxDBGrid.OptionsBehavior

–;

Properties

Property

Class

ExpressQuantumGrid4 equivalent

A

AbsoluteIndex

TdxTreeListNode

The TcxCustomGridRecord.Index property.

Active

TdxDBGridFilter

The View’s OptionsCustomize.ColumnFiltering property.

Alignment

TdxTreeListBand

The TcxGridBand.Alignment property.

Alignment

TdxTreeListColumn

The Alignment attribute of the in-place editor properties. To access the column editor properties, use the RepositoryItem.Properties, Properties objects or the GetProperties method.

ArrowsColor

TCustomdxTreeList

–;

AssignedValues

TdxTreeListColumn

–;

ATreeList

TdxDBTreeListColumn

Items belong to a View specified by the GridView property.

AutoDataSetFilter

TdxDBGridFilter

The View’s DataController.Filter.AutoDataSetFilter property.

AutoExpandOnSearch

TCustomdxTreeList

Group rows are always expanded on finding a record during an incremental search.

AutoSearchColor

TCustomdxTreeList

The View’s Styles.IncSearch property.

B

BandButtonPushed

TCustomdxTreeList

–;

BandColor

TCustomdxTreeList

The Styles.BandHeader property (Banded Table Views only) and the band’s Styles.Header property.

BandFont

TCustomdxTreeList

The Styles.BandHeader property (Banded Table Views only) and the band’s Styles.Header property.

BandIndex

TdxTreeListColumn

The banded column’s Position.BandIndex property.

BandMaxRowCount

TCustomdxTreeListControl

–;

BandPanelHeight

TCustomdxTreeList

–;

BandRowCount

TCustomdxTreeListControl

The BandHeaderLineCount property (Banded Table Views only).

Bands

TCustomdxTreeListControl

The Bands property (Banded Table Views only).

BeginSummaryText

TdxDBGridSummaryGroup

The TcxDataGroupSummaryItems.BeginText property.

BorderStyle

TCustomdxTreeList

–;

C

Caption

TdxTreeListBand

The TcxGridBand.Caption property.

Caption

TdxTreeListColumn

The item’s Caption property.

CaseInsensitive

TdxDBGridFilter

The fcoCaseInsensitive option in the View’s DataController.Filter.AutoDataSetFilter property.

CharCase

TdxTreeListColumn

The CharCase attribute of the in-place editor properties. To access the column editor properties, use the RepositoryItem.Properties, Properties objects or the GetProperties method.

ColIndex

TdxTreeListColumn

The banded column’s Position.ColIndex property.

Color

TdxTreeListColumn

The item’s Styles.Content property.

ColumnCount

TCustomdxTreeListControl

The View’s ItemCount property.

ColumnName

TdxDBGridSummaryItem

The ItemLink property of a summary item contained in the TcxDataSummaryGroup.SummaryItems collection.

Table Views and Banded Table Views provide summary items. These declare the Column property (TcxGridTableSummaryItem.Column, for instance) which can be used instead of ItemLink.

Columns

TCustomdxDBTreeListControl

The Items property declared in a base View class.

Specific View classes provide the Columns (in a grid table and Banded Table Views) and Rows properties (in a Card View) as equivalents (the Items collection).

Count

TCustomdxTreeList

–;

See the View’s ViewData.Records property to get the collection of all records currently displayed. To know whether a particular record is at the root nesting level, see its Level property.

Count

TdxTreeListNode

–;

CountValues

TdxTreeListNode

The TcxCustomGridRecord.ValueCount property.

CustomizingBandListBox

TCustomdxTreeList

–;

CustomizingForm

TCustomdxTreeList

The View’s Controller.CustomizationForm property.

CustomizingHeaderListBox

TCustomdxTreeList

–;

CustomizingPos

TCustomdxTreeList

The View’s Controller.CustomizationFormBounds property. You can also use the Left, Top, Width and Height properties of the object obtained via the Controller.CustomizationForm property.

CustomizingRowCount

TCustomdxTreeList

–;

D

Data

TdxTreeListNode

–;

DataLink

TCustomdxDBTreeListControl

–;

DataSetChangedBusy

TCustomdxDBGrid

The View’s DataController.Provider.IsDataSetBusy property.

DataSource

TCustomdxDBTreeListControl

The View’s DataController.DataSource property in data-aware Views and DataController.CustomDataSource in non data-aware Views.

DblClkExpanding

TCustomdxTreeList

Double-clicking group rows always expands/collapse the corresponding group.

The View’s TcxGridTableOptionsBehavior.ExpandMasterRowOnDblClick property allows you to prevent expanding/collapsing of master rows on a double-click event.

DBGrid

TdxDBGridSummaryGroups

The collection of summary groups belongs to a TcxDataSummary object that can be obtained via the TcxDataSummaryGroups.Summary property.

DefaultFields

TCustomdxDBGrid

Fields in ExpressQuantumGrid4 are not automatically retrieved from a data source. You can use the Retrieve Fields button in the Columns panel of the Component Editor or call the View’s DataController.CreateAllItems method.

DefaultGroup

TdxDBGridSummaryGroup

ExpressQuantumGrid4 provides a collection of default summary items supported by the View’s DataController.Summary.DefaultGroupSummaryItems property. Default summary items specify summaries to calculate when data is grouped by any grid column except for those columns associated with summary groups in the DataController.Summary.SummaryGroups property.

DefaultLayout

TCustomdxTreeListControl

–;

DefaultRowHeight

TCustomdxTreeList

The View’s OptionsView.DataRowHeight property.

Deleting

TdxTreeListNode

–;

DescTextHeight

TCustomdxTreeList

–;

Description

TdxDBTreeListControlNode

–;

DisableCaption

TdxTreeListColumn

–;

DisableCustomizing

TdxTreeListBand

The TcxGridBand.VisibleForCustomization property.

DisableCustomizing

TdxTreeListColumn

The column’s VisibleForCustomization property.

DisableDragging

TdxTreeListBand

The band’s Options.Moving property.

DisableDragging

TdxTreeListColumn

The column’s Options.Moving property.

DisableEditor

TdxTreeListColumn

The item’s Options.Editing property.

DisableFilter

TdxTreeListColumn

The item’s Options.Filtering property.

DisableGrouping

TdxDBTreeListColumn

The column’s Options.Grouping property.

DownBandIndex

TCustomdxTreeList

–;

DownBandPushed

TCustomdxTreeList

–;

DownColumnIndex

TCustomdxTreeList

–;

DownColumnPushed

TCustomdxTreeList

–;

DragAbsoluteBandIndex

TCustomdxTreeList

–;

DragAbsoluteHeaderIndex

TCustomdxTreeList

–;

DragNode

TCustomdxTreeList

–;

DropDownCount

TdxDBGridFilter

The View’s Filtering.MaxDropDownCount property.

E

EditingText

TCustomdxTreeList

Use the View’s Controller.EditingItem property to access the item (column in a grid Table View or card in a Card View) being edited. The EditValue property of the item specifies its value.

Alternatively you can use the View’s Controller.FocusedRecord.DisplayTexts property to get the text representation of an individual item’s value within the currently focused record.

EndSummaryText

TdxDBGridSummaryGroup

The TcxDataGroupSummaryItems.EndText property.

Expanded

TdxTreeListNode

The TcxCustomGridRecord.Expanded property.

F

Field

TdxDBTreeListColumn

The item’s DataBinding.Field property.

FieldName

TdxDBTreeListColumn

The item’s DataBinding.FieldName property.

Filter

TCustomdxDBGrid

The View’s DataController.Filter and Filtering properties.

FilterCaption

TdxDBGridFilter

The View’s DataController.Filter.FilterCaption property.

FilterStatus

TdxDBGridFilter

The View’s Filtering.Visible property.

FilterText

TdxDBGridFilter

The View’s DataController.Filter.FilterText property.

Fixed

TdxTreeListBand

The TcxGridBand.FixedKind property.

FixedBandLineColor

TCustomdxTreeList

The View’s OptionsView.FixedBandSeparatorColor property.

FixedBandLineWidth

TCustomdxTreeList

The View’s OptionsView.FixedBandSeparatorWidth property.

Focused

TdxTreeListNode

The TcxCustomGridRecord.Focused property.

FocusedAbsoluteIndex

TCustomdxTreeList

The View’s Controller.FocusedItemIndex property.

FocusedColumn

TCustomdxTreeList

The View’s Controller.FocusedItem property.

FocusedField

TCustomdxDBTreeListControl

You can access a focused item (column in a grid Table View or row in a Card View) using the View’s Controller.FocusedItem property. To access the field linked to the item, see the item’s DataBinding.Field property.

FocusedNode

TCustomdxTreeList

The View’s Controller.FocusedRecord property.

FocusedNumber

TCustomdxTreeList

The View’s Controller.FocusedRecord.Index property.

Font

TdxTreeListColumn

The item’s Styles.Content property.

FooterPanelHeight

TCustomdxTreeList

–;

FooterRowHeight

TCustomdxTreeList

–;

FooterRowNodeHeight

TCustomdxTreeList

–;

G

GrIndicatorWidth

TCustomdxDBTreeListControl

The View’s OptionsView.IndicatorWidth property.

GridLineColor

TCustomdxTreeList

The View’s OptionsView.GridLineColor property.

GroupColumnCount

TCustomdxDBGrid

The View’s GroupedItemCount property

GroupColumns

TCustomdxDBGrid

The View’s GroupedItems property.

GroupId

TdxDBGridNode

The TcxGridGroupRow.Value property.

GroupIndex

TdxDBTreeListColumn

The column’s GroupIndex property.

GroupNodeColor

TCustomdxTreeList

The View’s Styles.Group property.

GroupNodeTextColor

TCustomdxTreeList

The View’s Styles.Group property.

GroupPanelColor

TCustomdxDBGrid

The View’s Styles.GroupByBox property.

GroupPanelFontColor

TCustomdxDBGrid

The View’s Styles.GroupByBox property.

GroupPanelHeight

TCustomdxDBGrid

–;

H

HasChildren

TdxTreeListNode

–;

You can determine whether the current row is a group row by analyzing the row class. A group row contains an object of the TcxGridGroupRow class.

HeaderAlignment

TdxTreeListColumn

The HeaderAlignmentHorz and HeaderAlignmentVert properties of columns;

the CaptionAlignmentHorz and CaptionAlignmentVert properties of Card View rows.

HeaderButtonPushed

TCustomdxTreeList

–;

HeaderColCount

TdxTreeListBand

The Count property of a band row within a Banded Table View. To access a particular band’s row, use code as follows

bandedTableView1.Bands[ABandIndex].Rows[RowIndex]

HeaderColor

TCustomdxTreeList

The View’s Styles.Header and the column’s Styles.Header properties

HeaderColumn

TdxTreeListBand

The Items property of a band row within a Banded Table View. To access a particular band’s row, use code as follows:

bandedTableView1.Bands[ABandIndex].Rows[RowIndex]

HeaderFont

TCustomdxTreeList

The View’s Styles.Header and the column’s Styles.Header properties

HeaderGlyph

TdxTreeListColumn

–;

The View’s BackgroundBitmaps.Header property allows you to specify the bitmap used to render all column headers.

HeaderHeight

TCustomdxTreeList

The View’s HeaderHeight property.

HeaderMaxLineCount

TdxTreeListColumn

The banded column’s Position.LineCount property.

HeaderMinRowCount

TCustomdxTreeListControl

–;

See the View’s HeaderHeight property.

HeaderPanelHeight

TCustomdxTreeList

The View’s HeaderHeight property.

HeaderPanelMaxRowCount

TCustomdxTreeListControl

–;

HeaderPanelRowCount

TCustomdxTreeListControl

To determine the View’s band nesting level, use the View’s Bands.VisibleRowCount property (Banded Table Views only). To create a nested band layout, use a band’s Position.BandIndex property in code or nest bands as necessary, using drag and drop at design or runtime. To collapse nested bands to a single row and prohibit end-users from nesting bands, set the Position.BandIndex property to -1 for all bands, and disable the View’s OptionsCustomize.NestedBands property.

HeaderRowCount

TdxTreeListBand

The band’s Rows.Count property.

HeaderRowHeight

TCustomdxTreeList

–;

HideFocusRect

TCustomdxTreeList

The View’s OptionsSelection.HideFocusRect property.

HideSelection

TCustomdxTreeList

The View’s OptionsSelection.HideSelection property.

HideSelectionColor

TCustomdxTreeList

The View’s Styles.Inactive property.

HideSelectionTextColor

TCustomdxTreeList

The View’s Styles.Inactive property.

HighlightColor

TCustomdxTreeList

The View’s Styles.Selection property.

HighlightTextColor

TCustomdxTreeList

The View’s Styles.Selection property.

I

Id

TdxDBTreeListControlNode

–;

See TcxCustomGridRecord.RecordIndex property.

ImageIndex

TdxTreeListNode

–;

IndentDesc

TCustomdxTreeList

The Preview.LeftIndent and Preview.RightIndent properties provide the two indents.

Index

TdxTreeListColumn

The item’s Index property.

Index

TdxTreeListNode

–;

IniFileName

TCustomdxTreeListControl

–;

IniSectionName

TCustomdxTreeListControl

–;

InplaceColumnIndex

TCustomdxTreeList

The View’s Controller.EditingItem.Index property. Check the Controller.IsEditing property to see whether a cell is currently being edited.

InplaceEditor

TCustomdxTreeList

The View’s Controller.EditingController.Edit property.

The View’s Controller.EditingItem.GetProperties method provides access to the properties of the editor (and these vary depending on the editor’s type).

IsCustomizing

TCustomdxTreeList

The View’s Controller.Customization property.

IsLast

TdxTreeListNode

–;

IsVisible

TdxTreeListNode

The TcxCustomGridRecord.Visible property.

Items

TCustomdxTreeList

The View’s ViewData.Records property.

Items

TdxTreeListBands

The TcxGridBands.Items property.

Items

TdxTreeListNode

–;

TcxGridGroupRow does not maintain a collection of child rows. Instead, you can use the View’s ViewData property to access the list of all records currently displayed within the View.

Items

TdxDBGridSummaryGroups

The TcxDataSummaryGroups.Items property.

Items

TdxDBGridSummaryItems

The Items property of the TcxDataSummaryGroup.SummaryItems object.

You can access a particular summary group via the View’s DataController.Summary.SummaryGroups property.

K

KeyField

TCustomdxDBTreeListControl

The View’s DataController.KeyFieldNames property.

L

LastNode

TCustomdxTreeList

Use the View’s ViewData.Records property to access any record within a View.

LeftCoord

TCustomdxTreeList

The View’s Controller.LeftPos property.

Level

TdxTreeListNode

The TcxCustomGridRecord.Level property.

LockSelection

TCustomdxTreeList

LockRefresh

TCustomdxDBGrid

The View’s DataController.BeginLocate and EndLocate methods allow you to prevent a grid control from excessive reloading of data when navigating through dataset records. If you need to call the TDataSet.Locate method, enclose this part of the code with BeginLocate and EndLocate.

Calling the BeginLocate and EndLocate methods is equivalent to setting the LockRefresh property to True and False respectively.

LookAndFeel

TCustomdxTreeList

The LookAndFeel property.

M

MaxDropDownCount

TdxDBGridFilter

The View’s DataController.Filter.MaxValueListCount property.

MaxLength

TdxTreeListColumn

The MaxLength attribute of the in-place editor properties. To access the column editor properties, use the RepositoryItem.Properties, Properties objects or the GetProperties method.

MaxRowLineCount

TCustomdxTreeList

The View’s OptionsView.CellTextMaxLineCount property.

MinWidth

TdxTreeListBand

To specify the minimum width of a band, set the minimum width (the MinWidth property) of the columns displayed within the band.

MinWidth

TdxTreeListColumn

The column’s MinWidth property.

N

Name

TdxDBGridSummaryGroup

–;

NewItemRowHeight

TCustomdxTreeList

–;

O

OnlyOwnColumns

TdxTreeListBand

–;

Owner

TdxTreeListNode

Use the TcxCustomGridRecord.ViewData property to access the object owning the current record.

P

Parent

TdxTreeListNode

–;

PartialLoad

TCustomdxDBGrid

ExpressQuantumGrid4 does not provide PartialLoad mode.

You can use the grid mode to limit the number of records loaded into memory at a time. See the View’s DataController.DataModeController.GridMode property.

PartialLoadBufferCount

TCustomdxDBGrid

ExpressQuantumGrid4 does not provide PartialLoad mode.

ExpressQuantumGrid4 provides the grid mode for limiting the number of records loaded into memory at a time. Use the DataController.DataModeController.GridModeBufferCount to specify the buffer size.

PasswordChar

TdxTreeListColumn

–;

You can use the EchoMode attribute of the in-place editor properties to specify how characters are displayed.

To access the column editor properties, use the RepositoryItem.Properties, Properties objects or the GetProperties method.

PreviewFieldName

TCustomdxDBTreeListControl

The View’s Preview.Column property.

PreviewFont

TCustomdxTreeList

The View’s Styles.Preview property.

PreviewLines

TCustomdxTreeList

The (Banded) Table View’s Preview.MaxLineCount property.

PreviewMaxLength

TCustomdxDBTreeListControl

–;

R

ReadOnly

TdxTreeListColumn

The ReadOnly attribute of the in-place editor properties. To access the column editor properties, use the RepositoryItem.Properties, Properties objects or the GetProperties method.

RecNo

TdxDBGridNode

The TcxCustomGridRecord.RecordIndex property.

RegistryPath

TCustomdxTreeListControl

–;

RowFooterColor

TCustomdxTreeList

The Styles.Footer property specifies the style for both the footer and group footer panels. You can specify different styles for these panels by handling the Styles.OnGetFooterStyle event.

RowFooterTextColor

TCustomdxTreeList

The Styles.Footer property specifies the style for both footer and group footer panels. You can specify different styles for these panels by handling the Styles.OnGetFooterStyle event.

RowHeight

TCustomdxTreeList

Use the View’s ViewInfo.RecordsViewInfo[ARowIndex].Height property.

ARowIndex specifies the position of the required record among all visible records within a View

RowIndex

TdxTreeListColumn

The banded column’s Position.RowIndex property.

RowSeparatorLineWidth

TCustomdxTreeList

The View’s OptionsView.RowSeparatorWidth property.

S

ScrollBars

TCustomdxTreeList

The View’s OptionsView.ScrollBars property.

Selected

TdxTreeListNode

The TcxCustomGridRecord.Selected property.

SelectedCount

TCustomdxTreeList

The View’s Controller.SelectedRecordCount property.

SelectedIndex

TdxTreeListNode

–;

SelectedNodes

TCustomdxTreeList

The View’s Controller.SelectedRecords property.

SelectedRows

TCustomdxDBTreeListControl

The View’s DataController.GetSelectedBookmark function (in grid mode only).

ShowBands

TCustomdxTreeList

The OptionsView.BandHeaders property of a Banded Table View.

ShowGrid

TCustomdxTreeList

The View’s OptionsView.GridLines property allows you to specify which grid lines to display.

ShowGroupPanel

TCustomdxDBGrid

The View’s OptionsView.GroupByBox property

ShowHeader

TCustomdxTreeList

The View’s OptionsView.Header property.

ShowHiddenInCustomizeBox

TCustomdxTreeList

–;

ShowNewItemRow

TCustomdxTreeList

The View’s OptionsView.NewItemRow property.

ShowPreviewGrid

TCustomdxTreeList

The View’s OptionsView.GridLines property allows you to specify which grid lines to display.

ShowRowFooter

TCustomdxTreeList

The View’s OptionsView.GroupFooters property.

ShowSummaryFooter

TCustomdxDBGrid

The View’s OptionsView.Footer property.

SimpleCustomizeBox

TCustomdxTreeList

–;

Sizing

TdxTreeListBand

The band’s Options.Sizing property.

Sizing

TdxTreeListColumn

The column’s Options.HorzSizing property.

SortBySummary

TdxDBTreeListColumn

–;

Sorted

TdxTreeListColumn

The column’s SortOrder property.

SortedColumn

TCustomdxDBTreeListControl

The first element of the SortedItems collection.

SortedColumnCount

TCustomdxTreeListControl

The View’s SortedItemCount property.

SortedColumns

TCustomdxDBTreeListControl

The (Banded) Table View’s SortedItems property.

State

TCustomdxTreeList

–;

StateIndex

TdxTreeListNode

–;

Strings

TdxTreeListNode

The TcxCustomGridRecord.DisplayTexts property.

For group rows, use the TcxGridGroupRow.DisplayText property.

SummaryField

TdxDBTreeListColumn

–;

The ItemLink (Column in Table Views) and/or FieldName properties of a summary item.

To calculate summaries when data is grouped by the current column,

1.create a summary group via the View’s DataController.Summary.SummaryGroups object,

2.add summary item(s) using the TcxDataSummaryGroup.SummaryItems.Add method and specify their ItemLink or FieldName property. Use the Position property to specify whether the summary values will be displayed in the group footers or in group rows.

3.add a new element to the TcxDataSummaryGroup.Links collection and set its ItemLink (Column in Table Views) property to the current column.

SummaryField

TdxDBGridSummaryItem

The FieldName property of a summary item contained in the TcxDataSummaryGroup.SummaryItems collection.

SummaryFooterField

TdxDBTreeListColumn

–;

The ItemLink and/or FieldName properties of a summary item within the View’s DataController.Summary.FooterSummaryItems collection.

SummaryFooterFormat

TdxDBTreeListColumn

–;

The Format property of a summary item within the View’s DataController.Summary.FooterSummaryItems collection.

SummaryFooterText

TdxDBTreeListColumn

–;

Use the FooterSummaryTexts property of the View’s DataController.Summary object.

SummaryFooterType

TdxDBTreeListColumn

–;

The Kind property of a summary item within the View’s DataController.Summary.FooterSummaryItems collection.

SummaryFooterValue

TdxDBTreeListColumn

–;

To get the footer summary results, use the FooterSummaryValues property of the View’s DataController.Summary object.

SummaryFormat

TdxDBTreeListColumn

–;

The Format property of a summary item.

SummaryFormat

TdxDBGridSummaryItem

The Format property of a summary item contained in the TcxDataSummaryGroup.SummaryItems collection.

SummaryGroup

TdxDBTreeListColumn

–;

SummaryGroup

TdxDBGridSummaryItems

–;

SummaryGroupName

TdxDBTreeListColumn

–;

To calculate a set of summaries when data is grouped by the current column:

1.create a summary group via the View’s DataController.Summary.SummaryGroups object.

2.add summary items (the TcxDataSummaryGroup.SummaryItems.Add method) corresponding to the summaries you want to display.

3.add a new element to the TcxDataSummaryGroup.Links collection and set its ItemLink property to the current column.

SummaryGroups

TCustomdxDBGrid

All summaries are set via the View’s DataController.Summary property. Summary groups are provided by the Summary.SummaryGroups collection. To create default summary groups, use the Summary.DefaultGroupSummaryItems property.

SummaryItems

TdxDBGridSummaryGroup

The TcxDataSummaryGroup.SummaryItems property.

SummarySeparator

TCustomdxDBGrid

The TcxDataGroupSummaryItems.Separator property.

SummaryType

TdxDBTreeListColumn

–;

The Kind property of a summary item.

See the SummaryField entry for details.

SummaryType

TdxDBGridSummaryItem

The Kind property of a summary item contained in the TcxDataSummaryGroup.SummaryItems collection.

SummaryValue

TdxDBGridNode

–;

SummaryValue represents a value of a group summary set via the column’s SummaryType and SummaryField properties. There are no equivalents to these three properties. In ExpressQuantumGrid4, you use summary groups to calculate summaries when grouping by particular column(s).

Summary groups are supported by the View’s DataController.Summary.SummaryGroups property. To get a group summary value for a particular data group, use the DataController.Summary.GroupSummaryValues property.

SummaryValues

TdxDBGridNode

–;

Use the View’s DataController.Summary.GroupSummaryValues property to get a summary value for a particular data group.

T

TabStop

TdxTreeListColumn

–;

TopIndex

TCustomdxTreeList

The View’s Controller.TopRecordIndex property.

TopNode

TCustomdxTreeList

The View’s ViewData.Records[0] value.

TopVisibleNode

TCustomdxTreeList

The View’s ViewData.Records[GridView1.Controller.TopRecordIndex] value.

TreeList

TdxTreeListBands

Bands belong to a View specified by the TcxGridBands.GridView property.

U

UseBookmarks

TCustomdxDBGrid

When in grid mode, bookmarks are stored automatically for the selected records and can be accessed via the View’s DataController.GetSelectedBookmark function.

When not in grid mode, bookmarks are not stored.

V

Values

TdxTreeListNode

The TcxCustomGridRecord.Values property.

VariantData

TdxDBTreeListControlNode

–;

VariantType

TdxDBTreeListColumn

The item’s DataBinding.ValueTypeClass.GetVarType method

VariantValues

TdxDBTreeListControlNode

The View’s DataController.Values property and the TcxCustomGridRecord.Values property.

VertAlignment

TdxTreeListColumn

The Alignment attribute of the in-place editor properties. To access the column editor properties, use the RepositoryItem.Properties, Properties objects or the GetProperties method.

Visible

TdxTreeListBand

The Visible property of a band within a Banded Table View. Individual bands can be accessed via the Banded Table View’s Bands property.

Visible

TdxTreeListColumn

The item’s Visible property.

VisibleColumnCount

TCustomdxTreeListControl

The VisibleItemCount property in a base View class. In a (Banded) Table View and Card View, you can use the VisibleColumnCount and VisibleRowCount properties respectively.

VisibleColumns

TCustomdxDBTreeListControl

The View’s VisibleItems property. Views publish the VisibleColumns (in grid table and grid Banded Table Views) and VisibleRows (in a Card View) properties and these provide access to the same items as VisibleItems.

VisibleCount

TdxTreeListBands

The TcxGridBands.VisibleCount property.

VisibleIndex

TdxTreeListBand

The VisibleIndex property of a band within a Banded Table View. Individual bands can be accessed via the Banded Table View’s Bands property.

VisibleItems

TdxTreeListBands

The TcxGridBands.VisibleItems property.

W

WaitForExpandNodeTime

TCustomdxTreeList

The grid’s DragOpeningWaitTime property.

Width

TdxTreeListBand

The Width property of a band within a Banded Table View. Individual bands can be accessed via the Banded Table View’s Bands property.

Width

TdxTreeListColumn

The item’s Width property.

Methods

Method

Class

ExpressQuantumGrid4 equivalent

A

Add

TCustomdxTreeList

The View’s DataController.AppendRecord method.

Add

TdxTreeListBands

The TcxGridBands.Add method.

Add

TdxDBGridSummaryGroups

The TcxDataSummaryGroups.Add method.

Add

TdxDBGridSummaryItems

The TcxDataSummaryItems.Add method.

Add

TdxDBGridFilter

  1. The item’s DataBinding.AddToFilter method.

  2. The View’s DataController.AddItemToFilter method.

  3. The View’s DataController.Filter.AddItem method.

  4. The View’s DataController.Filter.Root.AddItem method

AddNull

TdxDBGridFilter

When creating a filter condition using the TcxFilterCriteriaItemList.AddItem method, you can specify NULL as a value for the AValue parameter.

AddChild

TdxTreeListNode

–;

AddChildFirst

TdxTreeListNode

–;

AddFirst

TCustomdxTreeList

–;

AddGroupColumn

TCustomdxDBGrid

Set the GroupIndex property of the desired column to a value greater than or equal to the GroupedColumnCount property value.

AddNodesToList

TdxTreeListNode

–;

AdjustColumnsWidth

TCustomdxTreeList

–;

The View’s OptionsView.ColumnAutoWidth property

ApplyBestFit

TCustomdxTreeListControl

The item’s ApplyBestFit method. To adjust the width of all View columns, call the View’s ApplyBestFit method.

Assign

TdxTreeListColumn

The item’s Assign method.

AssignColumns

TCustomdxTreeListControl

The View’s Assign method.

B

BeginGrouping

TCustomdxDBGrid

The View’s BeginUpdate method.

BeginSelection

TCustomdxTreeList

–;

BeginSorting

TCustomdxTreeListControl

The View’s BeginUpdate method.

BeginUpdate

TCustomdxTreeList

The BeginUpdate method declared in the TcxCustomGrid, TcxCustomGridView, TcxCustomDataController, TcxDataSummary and TcxFilterCriteria classes.

C

CalcDrawInfo

TCustomdxTreeList

–;

CanAddGroupColumn

TCustomdxDBGrid

–;

CancelEditor

TCustomdxTreeList

Call the View’s Controller.EditingController.HideEdit method passing False as the Accept parameter.

CellRect

TCustomdxTreeList

Use code like this to access a particular cell region within a record:

(cxGrid1TableView1.ViewInfo.RecordsViewInfo[AIndex] as TcxGridDataRowViewInfo).GetBoundsForItem(AItem);

AIndex specifies the TcxCustomGridRecord.Index property value. AItem is an item (column in a (Banded) Table View and row in a Card View) to which the required cell belongs.

Clear

TdxDBGridFilter

The View’s DataController.Filter.Clear method.

You can temporarily disable filtering via the DataController.Filter.Active property.

ClearColumnsSorted

TCustomdxTreeList

The View’s DataController.ClearSorting method.

ClearGroupColumns

TCustomdxDBTreeListControl

The View’s DataController.Groups.ClearGrouping method.

ClearNodes

TCustomdxTreeList

In unbound mode, set the View’s DataController.RecordCount property to 0.

CloseEditor

TCustomdxTreeList

Call the View’s Controller.EditingController.HideEdit method passing True as the Accept parameter.

Collapse

TdxTreeListNode

The TcxCustomGridRecord.Collapse method.

ColumnByFieldName

TCustomdxDBTreeListControl

In (Banded) Table Views, see the GetColumnByFieldName method. In Card Views, the equivalent is GetRowByFieldName. Note that these methods do not throw an exception if no items found linked to the specified field.

ColumnByName

TCustomdxDBTreeListControl

The View’s FindItemByName method.

ColumnCalcLineCount

TCustomdxTreeList

–;

ColumnsCustomizing

TCustomdxTreeList

The View’s Controller.Customization property.

CopyAllToClipboard

TCustomdxTreeList

Call the View’s CopyToClipboard method passing True as the ACopyAll parameter.

CopySelectedToClipboard

TCustomdxTreeList

Call the View’s CopyToClipboard method passing False as the ACopyAll parameter.

CreateColumn

TCustomdxDBTreeListControl

–;

See the View’s CreateItem method to add a new item. In table and Card Views, you use the CreateColumn and CreateRow methods respectively. These implement the same functionality, but differ from CreateItem by the class of the returned object.

CreateColumnEx

TCustomdxDBTreeListControl

–;

Use the View’s CreateItem (CreateColumn in a grid (Banded) Table View, CreateRow in a Card View) method to add a new column. To specify an editor for the item, see the PropertiesClass and RepositoryItem properties.

D

DefaultAlignment

TdxTreeListColumn

The item’s DefaultValuesProvider.DefaultAlignment method.

DefaultCaption

TdxTreeListColumn

The item’s DataBinding.DefaultCaption method.

DefaultColor

TdxTreeListColumn

–;

DefaultFont

TdxTreeListColumn

–;

DefaultReadOnly

TdxTreeListColumn

The item’s DefaultValuesProvider.DefaultReadOnly method.

DefaultWidth

TdxTreeListColumn

The item’s DataBinding.DefaultWidth method.

Delete

TdxDBTreeListControlNode

–;

In unbound mode, use the View’s DataController.DeleteRecord method passing it the record’s RecordIndex property value as a parameter.

To delete records from Views connected to datasets, use the View’s DataController.DeleteFocused or DeleteSelection methods.

DeleteChildren

TdxTreeListNode

–;

DeleteGroupColumn

TCustomdxDBGrid

–;

Set the column’s GroupIndex property to –;1 for that purpose.

DestroyColumns

TCustomdxTreeListControl

The View’s ClearItems method.

E

EndColumnsCustomizing

TCustomdxTreeList

The View’s Controller.Customization property.

EndGrouping

TCustomdxDBGrid

The View’s EndUpdate method.

EndSearch

TCustomdxTreeList

The View’s Controller.CancelIncSearching method.

EndSelection

TCustomdxTreeList

–;

EndSorting

TCustomdxTreeListControl

The View’s EndUpdate method.

EndUpdate

TCustomdxTreeList

The EndUpdate method declared in the TcxCustomGrid, TcxCustomGridView, TcxCustomDataController, TcxDataSummary and TcxFilterCriteria classes.

Expand

TdxTreeListNode

The TcxCustomGridRecord.Expand method.

F

FindNodeByKeyValue

TCustomdxDBGrid

The View’s DataController.FindRecordIndexByKey function.

FindColumnByFieldName

TCustomdxDBTreeListControl

In (Banded) Table Views, see the GetColumnByFieldName method. In Card Views, the equivalent is GetRowByFieldName.

FreeDrawInfo

TCustomdxTreeList

–;

FullCollapse

TCustomdxTreeList

The View’s ViewData.Collapse method lets you collapse group and master rows within a View.

The View’s DataController.Groups.FullCollapse method collapses group rows.

FullExpand

TCustomdxTreeList

The View’s ViewData.Expand method lets you expand group and master rows within a View.

The View’s DataController.Groups.FullExpand method expands group rows.

FullRefresh

TCustomdxDBTreeListControl

Call the View’s DataController.UpdateItems method with False as a parameter.

G

GetAbsoluteColumnIndex

TCustomdxTreeListControl

The Index property of the desired item. To access an item by its position among the visible items, use the View’s VisibleItems property.

GetAbsoluteIndex

TdxTreeListBands

–;

GetBandAt

TCustomdxTreeListControl

Use the ViewInfo.GetHitTest method. This returns an object with information on the grid element containing the specified coordinates.

The following code gets the band at a specific point provided that it is within the band header panel:

var AHitTest: TcxCustomGridHitTest; ABand: TcxGridBand;//…AHitTest := cxGrid1.ViewInfo.GetHitTest(X, Y);if AHitTest is TcxGridBandHeaderHitTest then ABand := TcxGridBandHeaderHitTest(AHitTest).Band;

GetBestFit

TdxTreeListColumn

–;

GetColumnAt

TCustomdxDBTreeListControl

Use the ViewInfo.GetHitTest method. This returns an object with information on the grid element with the coordinates specified.

For instance, the following code determines the item (column) at point (X,Y) if the point relates to a record or to the column header panel.

var AHitTest: TcxCustomGridHitTest; AItem: TcxCustomGridTableItem;//…AHitTest := cxGrid1.ViewInfo.GetHitTest(X, Y);if AHitTest is TcxGridRecordCellHitTest then AItem := TcxGridRecordCellHitTest(AHitTest).Itemelse if AHitTest is TcxGridColumnHeaderHitTest then AItem := TcxGridColumnHeaderHitTest(AHitTest).Column;

GetColumnAt

TCustomdxTreeListControl

Use the ViewInfo.GetHitTest method. This returns an object with information on the grid element containing the specified coordinates.

For instance, the following code determines the item (column) at point (X,Y) if the point is within a record or the column header panel.

var AHitTest: TcxCustomGridHitTest; AItem: TcxCustomGridTableItem;//…AHitTest := cxGrid1.ViewInfo.GetHitTest(X, Y);if AHitTest is TcxGridRecordCellHitTest then AItem := TcxGridRecordCellHitTest(AHitTest).Itemelse if AHitTest is TcxGridColumnHeaderHitTest then AItem := TcxGridColumnHeaderHitTest(AHitTest).Column;

GetDefaultColumnClass

TCustomdxDBTreeListControl

When the item’s ValueTypeClass property is set, this value determines the default editor assigned to the item. An example of registering a default editor follows:

GetDefaultEditDataRepositoryItems.RegisterItem(TcxBooleanValueType, cxEditRegisteredItemsStandardVersion, GetDefaultEditRepository.CreateItem(TcxEditRepositoryCheckBoxItem));

Here, a check box is registered as the editor for items with the value type of TcxBooleanValueType.

To redefine the default editor for this value type, call the RegisterItem procedure passing it the required repository item instead of TcxEditRepositoryCheckBoxItem. The second parameter of the procedure specifies the priority of the registered editor. To redefine the existing editor, you must set the parameter to a value greater than the cxEditRegisteredItemsStandardVersion.

If an item is assigned to a value type not registered by RegisterItem, its editor is determined by the RegisterDefaultItem method:

GetDefaultEditDataRepositoryItems.RegisterDefaultItem(cxEditRegisteredItemsStandardVersion, GetDefaultEditRepository.CreateItem(TcxEditRepositoryTextItem));

If you need to use a different editor, call RegisterDefaultItem passing it another repository item instead of TcxEditRepositoryTextItem. Like the RegisterItem method, set the first parameter to a value greater than the cxEditRegisteredItemsStandardVersion constant.

GetDefaultFieldColumnClass

TCustomdxDBTreeListControl

In data-aware Views, items (columns in a Table View and cards in a Card View) are assigned default editors based on the field type.

An example of registering a default editor follows:

GetDefaultEditDBRepositoryItems.RegisterItem(ftCurrency, cxEditRegisteredItemsStandardVersion, GetDefaultEditRepository.CreateItem(TcxEditRepositoryCurrencyItem));

Here, a currency editor represented by the TcxEditRepositoryCurrencyItem class is registered as an editor for currency fields.

The first parameter specifies a value of the TFieldType enumerator. The second parameter specifies the priority of the registered editor. To redefine the existing editor, you must set the parameter to a value greater than the cxEditRegisteredItemsStandardVersion.

If an item is assigned to a field not registered by the RegisterItem method, its editor is determined by the RegisterDefaultItem method:

GetDefaultEditDBRepositoryItems.RegisterDefaultItem(cxEditRegisteredItemsStandardVersion, GetDefaultEditRepository.CreateItem(TcxEditRepositoryMaskItem));

If you need to use a different editor, call RegisterDefaultItem passing it another repository item instead of TcxEditRepositoryMaskItem. Like the RegisterItem method, set the first parameter to a value greater than the cxEditRegisteredItemsStandardVersion constant.

GetDefaultGroup

TdxDBGridSummaryGroups

–;

Default groups are provided by the View’s DataController.Summary.DefaultGroupSummaryItems property.

GetDisplayValue

TCustomdxTreeListControl

The TcxCustomGridRecord.DisplayTexts property provides the text representation of a value stored in a particular record field.

GetEditRect

TCustomdxTreeList

Use the code as follows

(cxGrid1TableView1.ViewInfo.RecordsViewInfo[AIndex] as TcxGridDataRowViewInfo).GetCellViewInfoByItem(AItem).ContentBounds;

AIndex specifies the record index defined by the TcxCustomGridRecord.Index property. AItem refers to the item (column in a (Banded) Table View and row in a Card View).

GetFocusedAbsoluteIndex

TCustomdxTreeList

Use the View’s Controller.FocusedItem.Index property.

GetFocusedVisibleIndex

TCustomdxTreeList

Use the View’s Controller.FocusedItemIndex or Controller.FocusedItem.VisibleIndex property.

GetFooterColumnAt

TCustomdxDBTreeListControl

Use the ViewInfo.GetHitTest method. This returns an object with information on the grid element containing the specified coordinates.

The following code determines a particular column within the footer panel.

var AHitTest: TcxCustomGridHitTest; AColumn: TcxGridColumn;//…AHitTest := cxGrid1.ViewInfo.GetHitTest(X, Y);if AHitTest is TcxGridFooterCellHitTest then AColumn := TcxGridFooterCellHitTest(AHitTest).Column;

GetHeaderColumnAt

TCustomdxDBTreeListControl

Use the ViewInfo.GetHitTest method. This returns an object with information on the grid element containing the specified coordinates.

The following code shows how you can determine whether a given point is within a column header. If so, AColumn is assigned to this column:

var AHitTest: TcxCustomGridHitTest; AColumn: TcxGridColumn;//…AHitTest := cxGrid1.ViewInfo.GetHitTest(X, Y);if AHitTest is TcxGridColumnHeaderHitTest then AColumn := TcxGridColumnHeaderHitTest(AHitTest).Column;

GetHitInfo

TCustomdxTreeList

See the View’s ViewInfo.GetHitTest method. This returns an object with information on a grid element (a TcxCustomGridHitTest class descendant) at specific coordinates. You can determine the type of the element via the HitTestCode function of the object obtained.

GetHitTestInfoAt

TCustomdxTreeList

See the View’s ViewInfo.GetHitTest method. This returns an object with information on a grid element (a TcxCustomGridHitTest class descendant) at specific coordinates. You can determine the type of the element via the HitTestCode function of the object returned.

GetGroupColumnAt

TCustomdxDBGrid

Use the ViewInfo.GetHitTest method. This returns an object with information on the grid element containing the specified coordinates.

The following code shows how you can determine whether a given point belongs to the header of a column. If so, AColumn is assigned to this column.

var AHitTest: TcxCustomGridHitTest; AColumn: TcxGridColumn;//…AHitTest := cxGrid1.ViewInfo.GetHitTest(X, Y);if AHitTest is TcxGridColumnHeaderHitTest then AColumn := TcxGridColumnHeaderHitTest(AHitTest).Column;

See the column’s GroupIndex property value to see whether data is grouped by this column.

GetNext

TdxTreeListNode

–;

GetNextNode

TdxTreeListNode

–;

GetNextSibling

TdxTreeListNode

–;

GetNextVisible

TCustomdxTreeList

–;

The View’s ViewData.Records property provides access to all records currently displayed within a View. A record can be obtained from this collection by its Index property as it identifies the visual position of the record within a View. For instance, you can use the code below to access the record following the ACurrentRecord:

ANextRecord := view1.ViewData.Records[ACurrentRecord.Index + 1];

GetNodeAt

TCustomdxTreeList

Use the ViewInfo.GetHitTest method. This returns an object with information on the grid element containing the specified coordinates.

The following code determines the record at the (X,Y) point if it falls within the content area:

var AHitTest: TcxCustomGridHitTest; ARecord: TcxCustomGridRecord;//…AHitTest := cxGrid1.ViewInfo.GetHitTest(X, Y);if AHitTest is TcxGridRecordHitTest then ARecord := TcxGridRecordHitTest(AHitTest).GridRecord;

GetNodeFooterColumnAt

TCustomdxDBGrid

Use the ViewInfo.GetHitTest method. This returns an object with information on the grid element containing the specified coordinates.

The following code determines the column referenced within the group footer.

var AHitTest: TcxCustomGridHitTest; AColumn: TcxGridColumn;//…AHitTest := cxGrid1.ViewInfo.GetHitTest(X, Y);if AHitTest is TcxGridGroupFooterCellHitTest then AColumn := TcxGridGroupFooterCellHitTest(AHitTest).Column;

GetPrev

TdxTreeListNode

–;

GetPrevSibling

TdxTreeListNode

–;

GetPriorNode

TdxTreeListNode

–;

GetPriorParentNode

TdxTreeListNode

–;

GetSummaryGroupByName

TCustomdxDBGrid

–;

GetSummaryGroups

TdxDBGridSummaryGroup

See the TcxDataSummaryGroup.SummaryGroups property.

GetSummaryItemAt

TCustomdxDBGrid

–;

GetSummaryItems

TdxDBGridSummaryItem

–;

See the TcxDataSummaryItem.SummaryItems property.

GetVisibleColumnIndex

TCustomdxTreeListControl

The VisibleIndex property of the desired item. To access an individual item by its absolute index, see the View’s Items property (Columns in a (Banded) Table View or Rows in a Card View).

GetVisibleIndex

TdxTreeListBands

–;

GotoFirst

TCustomdxTreeList

The View’s Controller.GoToFirst method.

GotoLast

TCustomdxTreeList

The View’s Controller.GoToLast method.

GotoNext

TCustomdxTreeList

The View’s Controller.GoToNext method.

GotoPrev

TCustomdxTreeList

The View’s Controller.GoToPrev method.

H

HasAsParent

TdxTreeListNode

–;

HeaderPanelBestFit

TCustomdxTreeList

–;

HideDrawFocusRect

TCustomdxContainer

The View’s OptionsSelection.HideFocusRect property.

HideEditor

TCustomdxTreeList

–;

Call the View’s Controller.EditingController.HideEdit method passing True as the Accept parameter.

I

IndexOf

TCustomdxTreeList

–;

Use the Index property of a TcxCustomGridRecord object to get the position of the record.

IndexOf

TdxTreeListNode

–;

Insert

TCustomdxTreeList

In unbound mode, use the View’s DataController.InsertRecord method to insert a new record above the record specified as the method’s parameter.

In bound mode, you should use the methods of the dataset object to which the View is connected by means of a TDataSource object (for instance, the Insert method of a TDataSet descendant).

InsertChild

TdxTreeListNode

–;

InsertGroupColumn

TCustomdxDBGrid

Set the column’s GroupIndex property to a value between 0 and GroupedColumnCount –; 1.

IsGridMode

TCustomdxDBGrid

The View’s DataController.IsGridMode function.

IsInvertSelect

TCustomdxTreeList

The View’s OptionsSelection.InvertSelect property.

IsNodeVisible

TCustomdxTreeList

The Visible property of a TcxCustomGridRecord object.

IsPartialLoad

TCustomdxDBGrid

ExpressQuantumGrid4 does not provide the PartialLoad mode. Use grid mode to limit the number of records loaded into memory at once.

IsShowButtonAlways

TCustomdxContainer

The View’s OptionsView.ShowEditButtons property.

L

LoadFromIniFile

TCustomdxTreeListControl

The View’s RestoreFromIniFile method.

LoadFromRegistry

TCustomdxTreeListControl

The View’s RestoreFromRegistry method.

M

MakeBandVisible

TCustomdxTreeList

–;

MakeColumnVisible

TCustomdxTreeList

The View’s Controller.MakeItemVisible method.

MakeNodeVisible

TCustomdxTreeList

  1. The View’s Controller.MakeRecordVisible method.

  2. The MakeVisible method of a TcxCustomGridRecord object.

You can also make a master row owning a specific detail View visible via the MakeMasterGridRecordVisible method.

MakeVisible

TdxTreeListNode

The TcxCustomGridRecord.MakeVisible method.

MoveTo

TdxTreeListNode

–;

P

PointInFooterPanel

TCustomdxDBGrid

See the View’s ViewInfo.GetHitTest.HitTestCode function. If the specified point belongs to the footer panel, it returns htFooter.

PointInGroupPanel

TCustomdxDBGrid

See the View’s ViewInfo.GetHitTest.HitTestCode function. If the specified point belongs to the group panel, it returns htGroupByBox.

PointInCustomizingForm

TCustomdxTreeList

See the View’s ViewInfo.GetHitTest.HitTestCode function. If the specified point belongs to the customization form, it returns the htCustomizationForm constant value.

R

RefreshBookmarks

TCustomdxDBTreeListControl

–;

RefreshDefaultColumnsWidths

TCustomdxTreeListControl

–;

The RestoreDefaults method, declared in View and item classes, allows you to restore the default column widths.

RebuildGroupIndexes

TCustomdxDBGrid

–;

RefreshGroupColumns

TCustomdxDBGrid

The View’s DataController.Summary.Calculate method.

RefreshSorting

TCustomdxTreeListControl

–;

Remove

TdxDBGridFilter

The View’s DataController.Filter.RemoveItemByItemLink method. Pass the column object as the AItemLink parameter.

RestoreColumnsDefaults

TCustomdxTreeListControl

–;

The RestoreDefaults method declared in the View and item classes allows you to restore the default column widths and captions.

RestoreDefaults

TdxTreeListBand

–;

RestoreDefaults

TdxTreeListBands

–;

RestoreDefaults

TdxTreeListColumn

The item’s RestoreDefaults method.

RestoreDefaultWidth

TdxTreeListColumn

–;

S

SaveAllToStrings

TCustomdxTreeList

–;

SaveAllToTextFile

TCustomdxTreeList

–;

SaveSelectedToStrings

TCustomdxTreeList

–;

SaveSelectedToTextFile

TCustomdxTreeList

See the ExportGridToText procedure.

SaveToHTML

TdxDBGrid

The global ExportGridToHTML procedure.

SaveToIniFile

TCustomdxTreeListControl

The View’s StoreToIniFile method.

SaveToRegistry

TCustomdxTreeListControl

The View’s StoreToRegistry method.

SaveToText

TdxDBGrid

The global ExportGridToText procedure.

SaveToXLS

TdxDBGrid

The global ExportGridToExcel procedure.

SaveToXML

TdxDBGrid

The global ExportGridToXML procedure.

ShowButtonEditorMouse

TCustomdxTreeList

See the View’s Controller.EditingController.ShowEdit method.

ShowCustomDialog

TdxDBGridFilter

The View’s Filtering.RunCustomizeDialog method.

ShowEditorChar

TCustomdxTreeList

See the View’s Controller.EditingController.ShowEdit method.

ShowEditor

TCustomdxTreeList

See the View’s Controller.EditingController.ShowEdit method.

Alternatively, you can set the View’s Controller.EditingItem property to open the editor for a specific item within the currently focused record.

ShowEditorMouse

TCustomdxTreeList

See the View’s Controller.EditingController.ShowEdit method.

StartSearch

TCustomdxTreeList

To start an incremental search, assign a string to the View’s Controller.IncSearchingText property.

Events

Event

Class

ExpressQuantumGrid4 equivalent

A

OnAddGroupColumn

TCustomdxDBGrid

ExpressQuantumGrid4 does not provide an event to allow you to control column grouping. You can prevent grouping by a particular column though by using the column’s Options.Grouping property.

B

OnBackgroundDrawEvent

TCustomdxDBGrid

See the View’s OnCustomDrawPartBackground event.

OnBandButtonClick

TCustomdxTreeListControl

–;

OnBandClick

TCustomdxTreeListControl

The TcxGridBand.OnHeaderClick event.

OnBeforeCalcSummary

TCustomdxDBTreeListControl

–;

OnBeginDragNode

TCustomdxTreeList

–;

C

OnCalcRowLineHeight

TCustomdxTreeListControl

–;

OnCalcSummary

TCustomdxDBTreeListControl

The View’s DataController.Summary.OnAfterSummary event.

OnCanBandDragging

TCustomdxTreeListControl

ExpressQuantumGrid4 does not provide an event allowing you to control band dragging.

You can prevent a user from a dragging a band by setting the View’s OptionsCustomize.BandMoving or the band’s Options.Moving property to False.

OnCanHeaderDragging

TCustomdxTreeListControl

ExpressQuantumGrid4 does not provide an event allowing you to control column dragging.

The View’s OptionsCustomize.ColumnMoving and the item’s Options.Moving properties can be set to False to prevent the dragging of column(s).

OnCanNodeSelected

TCustomdxTreeList

The View’s OnCanSelectRecord event.

OnChange

TdxTreeListColumn

–;

See the View’s OnEditChanged event.

OnChangeColumn

TCustomdxTreeList

The View’s OnFocusedItemChanged event.

OnChangedColumnsWidth

TCustomdxTreeListControl

The View’s OnColumnSizeChanged event.

OnChangeLeftCoord

TCustomdxTreeList

The View’s OnLeftPosChanged event.

OnChangeName

TdxDBGridSummaryGroup

–;

OnChangeNode

TCustomdxTreeList

The View’s OnFocusedRecordChanged event.

OnChangeNodeEx

TCustomdxDBTreeListControl

–;

The View’s OnFocusedRecordChanged event.

OnChangeTopVisibleNode

TCustomdxTreeList

The View’s OnTopRecordIndexChanged event.

OnClearNodeData

TCustomdxDBGrid

–;

OnCollapsed

TCustomdxTreeList

–;

OnCollapsing

TCustomdxTreeList

–;

OnColumnClick

TCustomdxDBGrid

The column’s OnHeaderClick event.

OnColumnClick

TCustomdxTreeListControl

The column’s OnHeaderClick event.

OnColumnMoved

TCustomdxTreeListControl

The column’s OnColumnPosChanged event.

OnColumnSorting

TCustomdxDBGrid

ExpressQuantumGrid4 does not provide an event to allow you to control column sorting.

The column’s Options.Sorting property can be used to prevent a user from sorting by the column.

OnCompare

TCustomdxTreeList

The View’s DataController.OnCompare event.

OnCustomDraw

TCustomdxDBGrid

The OnCustomDrawCell event provided by View and item objects.

OnCustomDraw

TCustomdxTreeListControl

The OnCustomDrawCell event provided by View and item objects.

OnCustomDraw

TdxDBTreeListColumn

The item’s OnCustomDrawCell event.

OnCustomDrawBand

TCustomdxTreeListControl

The View’s OnCustomDrawBandHeader event.

OnCustomDrawCell

TCustomdxTreeListControl

The OnCustomDrawCell event provided by View and item objects.

OnCustomDrawCell

TdxTreeListColumn

The item’s OnCustomDrawCell event.

OnCustomDrawColumnHeader

TCustomdxTreeListControl

The View’s OnCustomDrawColumnHeader event.

OnCustomDrawColumnHeader

TdxTreeListColumn

The item’s OnCustomDrawHeader event.

OnCustomDrawFooter

TCustomdxTreeListControl

The View’s OnCustomDrawFooterCell event.

OnCustomDrawFooterNode

TCustomdxTreeListControl

The View’s OnCustomDrawFooterCell event.

OnCustomDrawHeader

TdxDBTreeListColumn

The item’s OnCustomDrawHeader event.

OnCustomDrawPreview

TCustomdxTreeListControl

The OnCustomDrawCell event provided by View and item objects.

OnCustomDrawPreviewCell

TCustomdxTreeListControl

The OnCustomDrawCell event provided by View and item objects.

D

OnDeletion

TCustomdxTreeList

–;

OnDragEndBand

TCustomdxTreeListControl

–;

Handle the View’s OnBandPosChanged event for writing code after a band’s position has changed.

OnDragEndHeader

TCustomdxTreeListControl

–;

Handle the View’s OnColumnPosChanged event for writing code after a column’s position has changed

OnDragOverBand

TCustomdxTreeListControl

–;

OnDragOverHeader

TCustomdxTreeListControl

–;

OnDrawSummaryFooter

TdxDBTreeListColumn

The column’s OnCustomDrawFooterCell event.

E

OnEditChange

TCustomdxTreeList

The View’s OnEditChanged event.

OnEdited

TCustomdxTreeList

–;

OnEditing

TCustomdxTreeList

The View’s OnEditing event.

OnEditValidate

TCustomdxTreeList

Handle the OnValidate event of the editor assigned to an item.

OnEndColumnsCustomizing

TCustomdxTreeList

–;

OnEndDragColumn

TCustomdxTreeListControl

–;

OnEndDragGroupColumn

TCustomdxDBGrid

ExpressQuantumGrid4 does not provide an event to allow you to control column grouping.

Use the column’s Options.Grouping property to prevent the grouping by that column.

OnEnumFilterValues

TCustomdxDBGrid

The column’s OnGetFilterValues or View’s DataController.Filter.OnGetValueList event.

OnExpanded

TCustomdxTreeList

–;

OnExpanding

TCustomdxTreeList

–;

F

OnFilterChanged

TCustomdxDBGrid

The View’s DataController.Filter.OnBeforeChange event.

G

OnGetCustomSummaryText

TCustomdxDBGrid

–;

OnGetEditColor

TCustomdxDBTreeListControl

See the Styles.OnGetContentStyle event provided by View and item objects.

OnGetLevelColor

TCustomdxTreeListControl

The View’s Styles.OnGetGroupStyle event.

OnGetNodeDragText

TCustomdxTreeListControl

–;

In v5 or later, the View’s OnGetDragDropText event.

OnGetPreviewText

TCustomdxDBTreeListControl

The OnGetDisplayText event of the column assigned to the (Banded) Table View’s Preview.Column property.

OnGetText

TdxDBTreeListColumn

The item’s OnGetDisplayText event.

H

OnHeaderButtonClick

TCustomdxTreeListControl

–;

OnHeaderMoved

TCustomdxTreeListControl

The View’s OnColumnPosChanged event.

OnHideBand

TCustomdxTreeListControl

–;

The OnBandPosChanged event declared in a Banded Table View.

OnHideColumn

TCustomdxDBGrid

The View’s OnColumnPosChanged event.

OnHideHeader

TCustomdxTreeListControl

–;

The View’s OnColumnPosChanged event.

OnHotTrackNode

TCustomdxTreeList

–;

I

OnIsExistFooterCell

TCustomdxTreeListControl

–;

R

OnReloadGroupList

TCustomdxDBGrid

The View’s DataController.OnGroupingChanged event.

OnRefreshNodeData

TCustomdxDBTreeListControl

–;

S

OnSelectedCountChange

TCustomdxTreeList

The View’s OnSelectionChanged event.

OnShowBand

TCustomdxTreeListControl

–;

The OnBandPosChanged event declared in a Banded Table View.

OnShowColumn

TCustomdxDBGrid

The View’s OnColumnPosChanged event.

OnShowHeader

TCustomdxTreeListControl

–;

The View’s OnColumnPosChanged event.

OnStartBandDragging

TCustomdxTreeListControl

–;

OnStartHeaderDragging

TCustomdxTreeListControl

–;

OnSummary

TdxDBTreeListColumn

The OnSummary event of the View’s DataController.Summary.DefaultGroupSummaryItems and DataController.DataSummary.SummaryGroups[ASummaryGroupIndex].SummaryItems objects.

OnSummary

TdxDBGridSummaryItem

See the TcxDataSummaryItems.OnSummary event.

OnSummaryFooter

TdxDBTreeListColumn

The OnSummary event of the View’s DataController.Summary.FooterSummaryItems object.

OnSummaryNode

TCustomdxDBGrid

The TcxDataSummaryItems.OnSummary event provided by the FooterSummaryItems, DefaultGroupSummaryItems properties and by every summary group in the SummaryGroups collection.

V

OnValidate

TdxTreeListColumn

–;

Specify an editor for an item via the PropertiesClass or RepositoryItem property and handle the Properties.OnValidate or RepositoryItem.Properties.OnValidate event respectively.

See Also