Skip to content

GridControl Control Members

See Also

GridControl Overview

See Also

Grid Control ActiveX Control v24.0

GridControl Control Members

Public Methods

Method Description
Public MethodAboutBox Displays a dialog box that indicates the current version of the control.
Public MethodAddRecord Adds a record to the grid.
Public MethodAddRecordEx Adds record to records collection and associates a row with it.
Public MethodAddRecordEx2 Adds record to records collection and associates a row with it.
Public MethodAddRecordEx3 Adds record to records collection and associates a row with it.
Public MethodClearContent Clears all memory from the grid.
Public MethodCollapseAll Collapses all rows.
Public MethodCopy Copies the data (in the Binary and Text data formats) from all currently selected records to the clipboard. Selected records will remain.
Public MethodCreateIconViewAndRowNumberColumn Creates an icon column to be used in the grid.
Public MethodCreatePrintView If the CommandBars control is used, CreatePrintView allows the CommandBars Control's PrintPreview control to be used to display the Grid.
Public MethodCreateRecords Creates an empty records collection.
Public MethodCreateRecordsFromDropArray Creates a GridRecords collection object from a ByteArray.
Public MethodCreateRowNumberColumn Creates a row number column.
Public MethodCut Copies the data (in the Binary and Text data formats) from all currently selected records to the clipboard. Selected records will be removed.
Public MethodDoPropExchange Exchanges layout and state information to/from a PropExchange object.
Public MethodDragRecords Prepares records to be dropped into the Grid Control.
Public MethodEditItem The EditItem method is used to set focus to a specific row and column so that it can be edited.
Public MethodEnableDragDrop Enables drag and drop functionality.
Public MethodEnableToolTips The EnableToolTips method enables or disables the use of tool tips in the GridControl.
Public MethodExpandAll Expands all rows that are collapsed.
Public MethodGetElementRect Retrieves a grid element rectangle.
Public MethodHitTest Returns hit test information for a given X and Y pixel on the screen.
Public MethodIconViewRowNumberSetup Sets up the IconView and row number methods.
Public MethodIconViewSetup Specifies the icon used for all items in IconView.
Public MethodInsertRecord Inserts a record into the grid.
Public MethodIsShowIconWhenEditing Determines if icons are displayed for an item while it is being edited.
Public MethodLoadSettings Loads the GridColumn settings of the GridControl from a string.
Public MethodPaste Reads records from the clipboard and adds them to the records collection.
Public MethodPopulate Populates the GridControl's with GridRow collection with the data contained in the GridRecords.
Public MethodPopulateFooterRows Performs control's footer rows population, creating view from the data.
Public MethodPopulateHeaderRows Performs control's header rows population, creating view from the data.
Public MethodPrintGrid Prints the current Grid view.
Public MethodPrintGrid2 Prints the current Grid view with the option to print immediately without showing any dialogs or needing any HDC handle.
Public MethodPrintPreview Displays a print preview window.
Public MethodPrintPreviewExt Runs print preview in non-maximized mode with given screen position and size.
Public MethodReCalc Updates the results of a given Formula for an item.
Public MethodRedraw Redraws the GridControl.
Public MethodRemoveRecordEx Removes a Row in the grid by specifying the attached GridRecord.
Public MethodRemoveRowEx Removes a Row in the grid.
Public MethodSaveSettings Saves the GridColumn settings of the GridControl.
Public MethodSetCustomDraw Specifies which of the three custom draw events should be executed when the rows and items are drawn.
Public MethodSetFieldChooserHandle Associates a FieldChooser control with the GridControl.
Public MethodSetIconViewToDefaults Resets all IconView parameters to their defaults.
Public MethodSetImageList Associates an ImageList with the GridControl.
Public MethodSetScrollBars Sets custom ScrollBars from the SuitePackage to be used by the GridControl.
Public MethodSetVirtualMode Enables virtual mode of the Grid Control.
Public MethodSetWatermarkBitmap Sets a watermark bitmap to be shown in the Grid control background from a resource.
Public MethodSetWatermarkBitmapFromFile Sets a watermark bitmap to be shown in the Grid control background using a bmp file.
Public MethodShowIconWhenEditing Specifies whether icons displayed for an item will be visible while the item is getting edited.
Public MethodShowPrintPageSetup Displays a custom "Page Setup" print dialog for the Grid.
Public MethodShowRowNumber Shows a column that displays the row numbers.
Public MethodUpdateRecord Updates a record that has been modified to the current grouping and sorting.

Public Properties

Property Description
Public PropertyAllowColumnRemove Specifies whether GridColumns can be removed from the GridControl.
Public PropertyAllowColumnReorder Specifies whether GridColumns can be reordered in the GridControl.
Public PropertyAllowColumnResize Specifies whether GridColumns can be resized.
Public PropertyAllowColumnSort Specifies whether GridColumns can be sorted.
Public PropertyAllowEdit Allows the text in all GridRecordItems to be edited.
Public PropertyAllowEditPreview Allows the preview rows to be edited by the user.
Public PropertyAllowGroup Specifies whether to allow grouping.
Public PropertyAllowSelectionCheck Specifies whether to allow a check box to be checked using the right mouse button.
Public PropertyAllowSort Specifies whether to allow sorting.
Public PropertyAutoColumnSizing Specifies if AutoColumnSizing should be used.
Public PropertyAutoVScrollTimerResolution Gets or sets the vertical scrolling timer resolution.
Public PropertyBehavior Specifies the behavior of the Grid control when a mouse button or keystroke is performed on a row/group row in the grid.
Public PropertyBorderStyle The type of border style that is placed around the GridControl.
Public PropertyCanCopy Specifies whether the Copy operation can be performed.
Public PropertyCanCut Specifies whether the Cut operation can be performed.
Public PropertyCanPaste Specifies whether the Paste operation can be performed.
Public PropertyColumns The GridControl's collection of GridColumn objects.
Public PropertyCustomTitle Used for unique title - e.g. for PrintJob name.
Public PropertyDataManager Gets or sets the grid data manager.
Public PropertyDefaultRowFreeHeight Specifies the default height for free rows.
Public PropertyDesktopTrackerMode Specifies whether to use Vista Tracker Mode (On or Off). This fixes desktop flicker.
Public PropertyDisableReorderColumnsCount Gets or sets the count of the columns at the left side where reordering is disabled.
Public PropertyDragSensitivityX Horizontal sensitivity of Drag'n'Drop operation in pixels. Default value is 3.
Public PropertyDragSensitivityY Vertical sensitivity of Drag'n'Drop operation in pixels. Default value is 3.
Public PropertyEditMode Indicates whether the in-place edit control is currently active (visible and focused).
Public PropertyEditOnClick Determines whether a GridRecordItem can be edited by single-clicking on the item.
Public PropertyEditOnDelayClick Enables or disables the delay click edit feature for GridRecordItems (like editing a file name in Windows explorer).
Public PropertyEditOnDoubleClick Specifies whether a GridRecordItem can be edited by double-clicking on the item.
Public PropertyEnabled Gets or sets a value indicating whether the GridControl can respond to user interaction.
Public PropertyEnableMarkup Enables the use of XAML to display text in the Grid control.
Public PropertyEnsureFocusedRowVisible Gets or sets whether focused rows will be forced visible.
Public PropertyFastDeselectMode Specifies whether all selected rows can quickly be de-selected with the click of a mouse.
Public PropertyFieldChooser Associates a FieldChooser control with the GridControl.
Public PropertyFilterHiddenColumns Specifies whether to search filter text in hidden columns.
Public PropertyFilterSeparatorStrict Specifies whether text filtering will be strict.
Public PropertyFilterText The FilterText property is used to filter the rows in the Grid Control by one or more text strings.
Public PropertyFocusedColumn The FocusedColumn property returns a reference to the Column that contains the GridRecordItem (SubItem) that currently has focus in the GridControl.
Public PropertyFocusedRow Returns a reference to the row that currently has focus in the GridControl.
Public PropertyFocusSubItems Specifies whether sub-items should receive focus.
Public PropertyFooterRecords Returns the collection of footer records.
Public PropertyFooterRows Returns the collection of the grid footer rows.
Public PropertyFooterRowsAllowAccess Specifies whether to allow user to move selection to footer rows.
Public PropertyFooterRowsAllowEdit Allows the text in all Footer Row GridRecordItems to be edited.
Public PropertyFooterRowsAllowGroup Specifies whether to allow grouping in footer rows.
Public PropertyFooterRowsAllowSort Specifies whether to allow sorting in footer rows.
Public PropertyFooterRowsEnableSelection Enables or disables selection in footer rows.
Public PropertyForcePagination Specifies whether to force the grid to be split up into "pages" while in print preview mode.
Public PropertyFreeHeightMode Allows row height to be changed using the mouse to drag to a new height.
Public PropertyFreezeColumnsAbs Gets or sets whether the freeze column is absolute or relative.
Public PropertyFreezeColumnsCount Gets/Sets the number of columns that are frozen when the grid is scrolled horizontally.
Public PropertyFullColumnScrolling Specifies whether full column scrolling will be used.
Public PropertyGroupsOrder Used to determine how the GridControl is grouped.
Public PropertyHeaderRecords Returns the collection of header records.
Public PropertyHeaderRows Returns the collection of the grid header rows.
Public PropertyHeaderRowsAllowAccess Specifies whether to allow user to move selection to header rows.
Public PropertyHeaderRowsAllowEdit Allows the text in all Header Row GridRecordItems to be edited.
Public PropertyHeaderRowsAllowGroup Specifies whether to allow grouping in header rows.
Public PropertyHeaderRowsAllowSort Specifies whether to allow sorting in header rows.
Public PropertyHeaderRowsEnableSelection Enables or disables selection in header rows.
Public PropertyHideColumnAfterGroupBoxDrop Specifies whether to hide the column after it is dropped into the group box.
Public PropertyHScrollStep Gets or sets the amount of pixels the grid is scrolled when the horizontal scroll bar buttons are clicked.
Public PropertyhWnd The hWnd property returns the handle to the Grid Control.
Public PropertyIcons A collection of icons that can be used in GridRecordItem and GridColumn objects.
Public PropertyIconView Displays or hides Icon View, a view similar to the Icon View in Windows Explorer.
Public PropertyInitialSelectionEnable Specifies whether the first row in the grid will become selected when initially populated.
Public PropertyInplaceEditHwnd Returns the handle to the currently used In-place Edit control.
Public PropertyLeftOffset Gets or sets the horizontal scroll position.
Public PropertyLockExpand Specifies whether collapsing/expanding rows is locked.
Public PropertyMarkupContext Object used to connect XML Markup with methods, functions, and events.
Public PropertyMaxColumnWidth Get or set the maximum column width for all columns.
Public PropertyMovePivot Specifies whether multiple selections are allowed.
Public PropertyMultipleSelection Enables/disables the multiple selection mode for the control.
Public PropertyNavigator Object used to handle navigation activities in the Grid Control.
Public PropertyOLEDropAbove Specifies whether the drop marker is above or below the current row when using OLEDragDrop.
Public PropertyOLEDropMode Specifies the drop mode used by the task panel for dropping external items.
Public PropertyOverrideThemeMetrics Specifies whether to allow themes to override control metrics.
Public PropertyPaintManager A GridPaintManager object used for drawing the GridControl.
Public PropertyPinFooterRows Specifies whether to pin footer records to the last body row.
Public PropertyPinFooterRowsPrinted Specifies whether to pin footer records to the last body row when printed.
Public PropertyPopulatedRecordsCount The current number of records displayed in the grid.
Public PropertyPreviewMode Specifies whether PreviewMode is enabled.
Public PropertyPrintGroupRowIcon Specifies whether the group row expand/collapse icons should be displayed.
Public PropertyPrintOptions Options that specify how the Grid should look when sent to a print device.
Public PropertyPrintPreviewOptions Object that contains options for the print preview window.
Public PropertyRecords The GridControl's collection of GridRecord objects.
Public PropertyRecordsTreeFilterMode Gets or sets the filtering mode for the Record tree.
Public PropertyReCreateReparented Specifies whether to re-create reparented records.
Public PropertyReleaseOnDestroy Before destroying, check until WM_DESTROY handling is complete.
Public PropertyRightToLeft Gets or sets a value indicating whether the CommandBars elements are aligned to support locales using right-to-left fonts.
Public PropertyRightToLeftReading Allows Right-To-Left (RTL) reading order without changing the entire layout of the control.
Public PropertyRows The GridControl's collection of GridRow objects.
Public PropertyScrollMode Gets or sets the scroll mode for the Grid control.
Public PropertyScrollModeH Gets or sets the scroll mode for horizontal scrolling in the Grid control.
Public PropertyScrollModeV Gets or sets the scroll mode for vertical scrolling in the Grid control.
Public PropertySections Collection of grid sections (header, footer, or body).
Public PropertySelectedRows The collection of currently selected rows in the GridControl.
Public PropertySelectionEnable Gets or sets whether rows will become selected when clicked or navigated with the arrow keys.
Public PropertySelectionExcludeGroupRows Specifies whether group rows will be included in the selection when the collapse (+/-) button is pressed while selecting multiple rows.
Public PropertySendContextMenuForWholeHeaderArea The ColumnClick event will be called when the right mouse button is clicked anywhere over the grid header or column headers.
Public PropertyShowFooter Shows or hides the grid column footer.
Public PropertyShowFooterRows Hides or shows the footer rows.
Public PropertyShowGroupBox Specifies whether the Group By box is shown at the top of the GridControl.
Public PropertyShowHeader The ShowHeader property is used to hide or display the Column Headers in the Grid Control.
Public PropertyShowHeaderRows Hides or shows the header rows.
Public PropertyShowItemsInGroups GridRecordItems will be automatically shown in groups when a column is sorted.
Public PropertyShowRowFocus Specifies whether to draw a focus rectangle around the focused row.
Public PropertySkipGroupsFocus Specifies whether groups are skipped when navigating the GridControl with the Up and Down keys.
Public PropertySortLocale Specifies how text, dates, times, and currencies are sorted based on locale.
Public PropertySortOrder Used to determine how the GridControl is sorted.
Public PropertySortRecordChildren Specifies the sort order to record children.
Public PropertyStrictBestFit BestFitMode will only be used in non-autosize mode (when AutoSize is False).
Public PropertyToolTipContext ToolTipContext object represents the tool tip window that is used to display tool tips.
Public PropertyTopRowIndex The TopRowIndex property will either return the index of the topmost row or it will scroll a row until it is the topmost row in the Grid control view.
Public PropertyTrapTabKey Traps the TAB key when an item begins to be edited by the user.
Public PropertyUnrestrictedDragDrop Specifies whether child rows can be dropped to any position, not just among sibling child records.
Public PropertyVisualTheme Gets or sets the theme for the grid.
Public PropertyWatermarkAlignment Gets or sets the alignment of the watermark.

Events

Event Description
Public EventBeforeCopyToText Occurs before all text data from a record is copied to the clipboard.
Public EventBeforeDrawRow Occurs before a GridRecordItem is drawn in each GridRow.
Public EventBeforePaste Occurs before a record that contains ONLY text data is inserted/pasted into the grid.
Public EventBeforePasteFromText Occurs after creating new record using binary data read from the clipboard, but before the record is added to the grid.
Public EventBeginDrag Occurs when records start to be dragged from/within the Grid Control.
Public EventBeginEdit Occurs when the user begins to edit an item.
Public EventColumnClick Occurs when a GridColumn header or Grid Header Area is right-clicked in the GridControl.
Public EventColumnOrderChangedEx Occurs when the order of the columns change.
Public EventColumnWidthChanged Occurs when the width of a column has changed.
Public EventConstraintSelecting Occurs when a constraints list is navigated with the keyboard arrow keys.
Public EventDragDropCompleted Occurs when the drag and drop operation has completed.
Public EventDragOverRecords Occurs when the user is dragging records over other records.
Public EventDrawItem Occurs before a GridRecordItem is drawn.
Public EventDrawPreviewItem Occurs before a preview item is drawn.
Public EventDropRecordsEx Occurs when records are dropped into a Grid Control but before they are actually added to the grid.
Public EventEditCanceled Occurs when in-place editing is canceled and value is not changed.
Public EventFocusChanging Occurs before a user selects a row or a column.
Public EventGetToolTipInfo Occurs before a tooltip is displayed in the grid.
Public EventGiveFeedback Called during drag operations, provides visual feedback during drag-and-drop operations.
Public EventGroupOrderChangedEx Occurs when the user changes the columns group order of Grid control.
Public EventHScroll Occurs when the grid has been horizontally scrolled.
Public EventHyperlinkClick Occurs when a hyperlink in an item is clicked.
Public EventInplaceButtonDown Occurs when an in-place button is used to edit an item's value.
Public EventInplaceEditChanging Occurs when an item/cell enters edit mode.
Public EventItemButtonClick Occurs when a GridItemControl button is clicked.
Public EventItemCheck Occurs when a GridRecordItem is clicked.
Public EventKeyDown Occurs when a key is pressed on the keyboard and the GridControl has focus.
Public EventKeyUp Occurs when a key on the keyboard has been released (after being pressed) and the GridControl has focus.
Public EventMeasurePreviewItem Occurs before a Preview Item is drawn.
Public EventMeasureRow Occurs before a row is drawn.
Public EventMouseDown Occurs when a button on the mouse is pressed anywhere on the GridControl.
Public EventMouseMove Occurs when the mouse pointer is moved anywhere over the GridControl.
Public EventMouseUp Occurs when a button on the mouse has been released anywhere on the GridControl.
Public EventOLEDragDrop Occurs when a source component is dropped onto a target component when the source component determines that a drop can occur.
Public EventOLEDragOver Occurs when one component is dragged over another.
Public EventPlusMinusClick Occurs when a plus/minus button is clicked.
Public EventPreviewKeyDown Occurs when a key is pressed on the keyboard during the Preview KeyDown event.
Public EventRecordsDropped Occurs immediately after records have been dropped onto the grid and the records have actually been added to the grid and the grid has been updated.
Public EventReCreated Occurs when a record is recreated.
Public EventRequestEdit Occurs when a request to edit an item is made.
Public EventRowDblClick Occurs when a GridRecordItem in a GridRow is double-clicked.
Public EventRowExpanded Occurs when a GridRow is expanded.
Public EventRowHeightChanged Occurs when the height of a row has changed.
Public EventRowRClick Occurs when a GridRecordItem in a GridRow is right-clicked.
Public EventSelectionChanged Occurs when the selection changes in the GridControl.
Public EventSelectionChanging Occurs when the selection is in the process of changing in the GridControl.
Public EventSortOrderChanged Occurs when the column sort order is changed.
Public EventValueChanged Occurs when the value of a GridRecordItem has changed.
Public EventValueChanging Occurs before the value of an item is changed by the user.
Public EventVScroll Occurs when the grid has been vertically scrolled.

See Also

GridControl Overview


Copyright (c) 1998-2024 Codejock Technologies. All rights reserved.