Skip to main content

PropertyGridControl Events

The control that allows you to display and edit properties of any object or set of objects.
Name Description
ActiveViewTypeChanged Fires when the PropertyGridControl.ActiveViewType property value changes.
AutoSizeChanged This event is not relevant for this class. Inherited from Control.
BackColorChanged Occurs when the value of the BackColor property changes. Inherited from Control.
BackgroundImageChanged Occurs when the value of the BackgroundImage property changes. Inherited from Control.
BackgroundImageLayoutChanged Occurs when the BackgroundImageLayout property changes. Inherited from Control.
BeforeLoadLayout Occurs before a layout is restored from storage (a stream, xml file or the system registry). Inherited from VGridControlBase.
BindingContextChanged Occurs when the value of the BindingContext property changes. Inherited from Control.
CausesValidationChanged Occurs when the value of the CausesValidation property changes. Inherited from Control.
CellValueChanged Fires immediately after a cell’s value has been changed. Inherited from VGridControlBase.
CellValueChanging Fires in response to changing the edit value. Inherited from VGridControlBase.
ChangeUICues Occurs when the focus or keyboard user interface (UI) cues change. Inherited from Control.
Click Occurs when the control is clicked. Inherited from Control.
ClientSizeChanged Occurs when the value of the ClientSize property changes. Inherited from Control.
ContextMenuChanged Occurs when the value of the ContextMenu property changes. Inherited from Control.
ContextMenuStripChanged Occurs when the value of the ContextMenuStrip property changes. Inherited from Control.
ControlAdded Occurs when a new control is added to the Control.ControlCollection. Inherited from Control.
ControlRemoved Occurs when a control is removed from the Control.ControlCollection. Inherited from Control.
CursorChanged Occurs when the value of the Cursor property changes. Inherited from Control.
CustomDrawCaption Allows you to paint the control’s caption. Inherited from VGridControlBase.
CustomDrawRowBrick Allows you to customize brick buttons that invoke a context menu (the Office view only).
CustomDrawRowHeaderCell Enables row header cells to be painted manually. Inherited from VGridControlBase.
CustomDrawRowHeaderIndent Enables row header indents to be painted manually. Inherited from VGridControlBase.
CustomDrawRowValueCell Enables data cells to be painted manually. Inherited from VGridControlBase.
CustomDrawSeparator Enables cell separators to be painted manually. Inherited from VGridControlBase.
CustomDrawTreeButton Enables expand buttons to be painted manually. Inherited from VGridControlBase.
CustomizationFormCreatingCategory Fires when a new category is about to be created in Customization Form. Inherited from VGridControlBase.
CustomizationFormDeletingCategory Fires when a category is about to be deleted in Customization Form. Inherited from VGridControlBase.
CustomizationFormSearch Allows you to filter search results when a user searches in the Customization Form. Inherited from VGridControlBase.
CustomPropertyDescriptors Allows you to specify properties that should be displayed in the control. You can use this event to filter or sort properties, display rows that are not bound to the selected object’s properties, or display multiple objects’ properties.
CustomRecordCellEdit Allows you to associate an editor with an individual cell. To avoid performance issues and increased memory consumption, assign repository items that already exist in the VGridControl.RepositoryItems collection. Do not create new repository items in this handler. Inherited from VGridControlBase.
CustomRecordCellEditForEditing Allows you to assign a custom editor to a cell for in-place editing, and so override the default row editor, which is by default, used both in display and edit modes. To avoid performance issues and increased memory consumption, assign repository items that already exist in the VGridControl.RepositoryItems collection. Do not create new repository items in this handler. Inherited from VGridControlBase.
CustomRowCreated Allows you to customize PropertyGridControl rows when this PropertyGridControl has the Office View applied.
DataSourceChanged Fires after the grid’s data source has been changed. Inherited from VGridControlBase.
Disposed Occurs when the component is disposed by a call to the Dispose() method. Inherited from Component.
DockChanged Occurs when the value of the Dock property changes. Inherited from Control.
DoubleClick Occurs when the control is double-clicked. Inherited from Control.
DragDrop Occurs when a drag-and-drop operation is completed. Inherited from Control.
DragEnter Occurs when an object is dragged into the control’s bounds. Inherited from Control.
DragLeave Occurs when an object is dragged out of the control’s bounds. Inherited from Control.
DragOver Occurs when an object is dragged over the control’s bounds. Inherited from Control.
EditorKeyDown Occurs when a key is pressed within an in-place editor that belongs to the container control. Inherited from EditorContainer.
EditorKeyPress Occurs when a character key is pressed within an in-place editor that belongs to the container control. Inherited from EditorContainer.
EditorKeyUp Occurs when a pressed key is released within an in-place editor that belongs to the container control. Inherited from EditorContainer.
EnabledChanged Occurs when the Enabled property value has changed. Inherited from Control.
EndDragRow Fires after a row drag and drop operation has been completed. Inherited from VGridControlBase.
Enter Occurs when the control is entered. Inherited from Control.
FocusedRecordCellChanged Fires in response to cell focus changing from one cell to another in a record if the previously and currently focused cells have different indexes. Inherited from VGridControlBase.
FocusedRecordChanged Fires in response to record focus changing. Inherited from VGridControlBase.
FocusedRowChanged Fires in response to row focus moving. Inherited from VGridControlBase.
FontChanged Occurs when the Font property value changes. Inherited from Control.
ForeColorChanged Occurs when the ForeColor property value changes. Inherited from Control.
GiveFeedback Occurs during a drag operation. Inherited from Control.
GotFocus Occurs when the control receives focus. Inherited from Control.
GridLayout Fires after the grid’s layout has been changed. Inherited from VGridControlBase.
HandleCreated Occurs when a handle is created for the control. Inherited from Control.
HandleDestroyed Occurs when the control’s handle is in the process of being destroyed. Inherited from Control.
HelpRequested Occurs when the user requests help for a control. Inherited from Control.
HiddenEditor Fires after an inplace editor has been closed. Inherited from VGridControlBase.
HideCustomizationForm Fires before the Customization Form is closed. Inherited from VGridControlBase.
HyperlinkClick Fires when a hyperlink in a row header or record header is activated. Inherited from VGridControlBase.
ImeModeChanged Occurs when the ImeMode property has changed. Inherited from Control.
InitCustomRowBrick
InitNewRecord Enables added records to be initialized. Inherited from VGridControlBase.
Invalidated Occurs when a control’s display requires redrawing. Inherited from Control.
InvalidRecordException Fires when a record fails validation or when it cannot be saved to the data source. Inherited from VGridControlBase.
InvalidValueException Enables a proper response to entering an invalid cell value to be provided. Inherited from VGridControlBase.
KeyDown Occurs when a key is pressed while the control has focus. Inherited from Control.
KeyPress Occurs when a character. space or backspace key is pressed while the control has focus. Inherited from Control.
KeyUp Occurs when a key is released while the control has focus. Inherited from Control.
Layout Occurs when a control should reposition its child controls. Inherited from Control.
LayoutUpgrade Occurs after a layout whose version doesn’t match the current layout version has been loaded from storage (a stream, xml file or system registry). Inherited from VGridControlBase.
Leave Occurs when the input focus leaves the control. Inherited from Control.
LeftVisibleRecordChanged Fires when the VGridControlBase.LeftVisibleRecord property’s value is changed. Inherited from VGridControlBase.
LocationChanged Occurs when the Location property value has changed. Inherited from Control.
LostFocus Occurs when the control loses focus. Inherited from Control.
MarginChanged Occurs when the control’s margin changes. Inherited from Control.
MouseCaptureChanged Occurs when the control loses mouse capture. Inherited from Control.
MouseClick Occurs when the control is clicked by the mouse. Inherited from Control.
MouseDoubleClick Occurs when the control is double clicked by the mouse. Inherited from Control.
MouseDown Occurs when the mouse pointer is over the control and a mouse button is pressed. Inherited from Control.
MouseEnter Occurs when the mouse pointer enters the control. Inherited from Control.
MouseHover Occurs when the mouse pointer rests on the control. Inherited from Control.
MouseLeave Occurs when the mouse pointer leaves the control. Inherited from Control.
MouseMove Occurs when the mouse pointer is moved over the control. Inherited from Control.
MouseUp Occurs when the mouse pointer is over the control and a mouse button is released. Inherited from Control.
MouseWheel Occurs when the mouse wheel moves while the control has focus. Inherited from Control.
Move Occurs when the control is moved. Inherited from Control.
PaddingChanged Occurs when the control’s padding changes. Inherited from Control.
Paint Occurs when the control is redrawn. Inherited from Control.
PaintEx Occurs when the control is redrawn. Inherited from VGridControlBase.
ParentChanged Occurs when the Parent property value changes. Inherited from Control.
ParseFindPanelText Fires after the query in the find panel changes. Allows you to create a filter condition based on the query and specify how to highlight results in the control. Inherited from VGridControlBase.
PopupMenuShowing Allows you to populate a context menu invoked with a right-click on a property. Inherited from VGridControlBase.
PreviewKeyDown Occurs before the KeyDown event when a key is pressed while focus is on this control. Inherited from Control.
ProcessDragRow Fires when a user drags a row. Inherited from VGridControlBase.
PropertyDeserializing Allows you to restore certain settings previously saved in the layout. Inherited from VGridControlBase.
PropertySerializing Allows you to include certain settings in the layout when you save it. Inherited from VGridControlBase.
QueryAccessibilityHelp Occurs when AccessibleObject is providing help to accessibility applications. Inherited from Control.
QueryContinueDrag Occurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled. Inherited from Control.
RecordCellStyle Enables the appearance settings of individual cells to be changed. Inherited from VGridControlBase.
RecordWidthChanged Fires after a record’s width has been changed. Inherited from VGridControlBase.
Refreshed
RegionChanged Occurs when the value of the Region property changes. Inherited from Control.
Resize Occurs when the control is resized. Inherited from Control.
RightToLeftChanged Occurs when the RightToLeft property value changes. Inherited from Control.
RowBrickMenuShowing Allows you to populate a context menu invoked with a click on a brick button (the Office view only).
RowChanged Fires after a row’s property has been changed. Inherited from VGridControlBase.
RowChanging Fires when changing a row’s property. Inherited from VGridControlBase.
RowCollapsed Fires after a row is collapsed. Inherited from VGridControlBase.
RowCollapsing Fires before a row is collapsed and allows you to cancel the action. Inherited from VGridControlBase.
RowExpanded Fires after a row is expanded. Inherited from VGridControlBase.
RowExpanding Fires before a row is expanded and allows you to cancel the action. Inherited from VGridControlBase.
RowHeaderWidthChanged Fires after the width of row headers has been changed. Inherited from VGridControlBase.
SelectedChanged Allows you to respond to changes in the current selection. Inherited from VGridControlBase.
SelectedTabChanged Occurs when the PropertyGridControl.SelectedTab property value changes.
ShowCustomizationForm Fires after the Customization Form has been invoked. Inherited from VGridControlBase.
ShowingEditor Allows the editor’s activation to be canceled. Inherited from VGridControlBase.
ShowMenu Obsolete. Allows context menus for rows to be customized.
ShownEditor Fires after a cell editor has been invoked. Inherited from VGridControlBase.
SizeChanged Occurs when the Size property value changes. Inherited from Control.
StartDragRow Fires before a row is dragged by an end-user. Inherited from VGridControlBase.
StateChanged Fires after the vertical grid’s state has been changed. Inherited from VGridControlBase.
StyleChanged Occurs when the control style changes. Inherited from Control.
SystemColorsChanged Occurs when the system colors change. Inherited from Control.
TabIndexChanged Occurs when the TabIndex property value changes. Inherited from Control.
TabPanelCustomize Fires before the control is loaded. Allows you to create tabs with properties and categories in the Office View.
TabStopChanged Occurs when the TabStop property value changes. Inherited from Control.
TextChanged Occurs when the Text property value changes. Inherited from Control.
TopVisibleRowIndexChanged Fires when the VGridControlBase.TopVisibleRowIndex property’s value is changed. Inherited from VGridControlBase.
Validated Occurs when the control is finished validating. Inherited from Control.
ValidateRecord Enables you to specify whether record data is valid and whether the record can lose focus. Inherited from VGridControlBase.
Validating Occurs when the control is validating. Inherited from Control.
ValidatingEditor Enables you to perform manual validation of cell values. Inherited from VGridControlBase.
VisibleChanged Occurs when the Visible property value changes. Inherited from Control.
See Also