Click or drag to resize
RadPropertyGrid Class
Displays the properties of an object in a grid with two columns with a property name in the first column and value in the second.
Inheritance Hierarchy
SystemObject
  SystemMarshalByRefObject
    System.ComponentModelComponent
      System.Windows.FormsControl
        System.Windows.FormsScrollableControl
          Telerik.WinControlsRadControl
            Telerik.WinControls.UIRadPropertyGrid

Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI (in Telerik.WinControls.UI.dll) Version: 2017.3.1017.40 (2017.3.1017.40)
Syntax
[TelerikToolboxCategoryAttribute("Editors")]
[DefaultPropertyAttribute("SelectedObject")]
[DefaultEventAttribute("SelectedItemChanged")]
public class RadPropertyGrid : RadControl

The RadPropertyGrid type exposes the following members.

Constructors
  NameDescription
Public methodRadPropertyGrid
Initializes a new instance of the RadPropertyGrid class
Top
Properties
  NameDescription
Public propertyAccessibilityRequested
Gets or sets a value indicating whether the CodedUI Tests functionality is requested from external program such a Narrator.
(Inherited from RadControl.)
Public propertyActiveEditor
Gets the active editor.
Public propertyAllowDefaultContextMenu
Gets or sets a value indicating whether the default context menu is enabled.
Public propertyAllowShowFocusCues
Indicates focus cues display, when available, based on the corresponding control type and the current UI state.
(Inherited from RadControl.)
Public propertyAnalyticsName
Gets or sets the Analytics Name associated with this control. By default the Control Name property is logged. If you want to customize the information which will be logged for this control set this property to a preferred value.
(Inherited from RadControl.)
Public propertyAutoExpandGroups
Gets or sets a value indicating whether the groups will be expanded or collapsed upon creation.
Public propertyAutoSize
Gets or sets whether the edit control is auto-sized
(Overrides RadControlAutoSize.)
Public propertyBackColor
RadPropertyGrid consists of multiple visual elements and separate settings are provided to customize their appearance. Current BackColor property might be ignored.
(Overrides RadControlBackColor.)
Public propertyBeginEditMode
Gets or sets a value indicating how user begins editing a cell.
Public propertyBehavior
Gets the input behavior for the control.
(Inherited from RadControl.)
Public propertyCausesValidation
Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus.
(Inherited from RadControl.)
Public propertyCommandBindings (Inherited from RadControl.)
Protected propertyDefaultSize (Overrides ControlDefaultSize.)
Public propertyElementTree (Inherited from RadControl.)
Public propertyEnableAnalytics
Gets or sets a value indicating whether the Analytics functionality is enabled or disabled for this control.
(Inherited from RadControl.)
Public propertyEnableCodedUITests
Gets or sets a value indicating whether the CodedUI Tests functionality is enabled.
(Inherited from RadControl.)
Public propertyEnableCustomGrouping
Gets or sets a value indicating whether the data can be grouped programmatically.
Public propertyEnableFiltering
Gets or sets a value indicating whether filtering is enabled.
Public propertyEnableGestures
Gets or sets a value indicating whether the Gestures functionality is enabled.
(Inherited from RadControl.)
Public propertyEnableGrouping
Gets or sets a value indicating whether grouping is enabled.
Public propertyEnableKeyMap
Gets or sets whether Key Map (Office 2007 like accelerator keys map) is used for this specific control. Currently this option is implemented for the RadRibbonBar control only.
(Inherited from RadControl.)
Public propertyEnableKineticScrolling
Gets or sets a value indicating whether the kinetic scrolling function is enabled.
Public propertyEnableRadAccessibilityObjects
Gets or sets a value indicating whether the RadControls Accessible custom object is enabled.
(Inherited from RadControl.)
Public propertyEnableSorting
Gets or sets a value indicating whether sorting is enabled.
Public propertyEnableTheming
Gets or sets value indicating whether the control is styled through theme
(Inherited from RadControl.)
Public propertyFilterDescriptors
Gets the filter descriptors.
Public propertyFindStringComparer
Gets or sets the string comparer used by the keyboard navigation functionality.
Public propertyFocusable (Inherited from RadControl.)
Public propertyFocusedElement (Inherited from RadControl.)
Public propertyFont
Gets or sets the Font of the control. This is actually the Font property of the root element.
(Inherited from RadControl.)
Public propertyForeColor
RadPropertyGrid consists of multiple visual elements and separate settings are provided to customize their appearance. Current ForeColor property might be ignored.
(Overrides RadControlForeColor.)
Public propertyGroupDescriptors
Gets the group descriptors.
Public propertyGroups
Gets the Groups collection.
Public propertyHelpBarHeight
Gets or sets the height of the PropertyGridHelpElement.
Public propertyHelpVisible
Gets or sets a value indicating whether the PropertyGridHelpElement is visible.
Public propertyImageList
Gets or sets the ImageList that contains the images displayed by this control.
(Inherited from RadControl.)
Public propertyImageScalingSize
Gets or sets the image scaling size.
(Inherited from RadControl.)
Public propertyIsDesignMode (Inherited from RadControl.)
Public propertyIsDisplayed
Determines whether the control is currently displayed on the screen.
(Inherited from RadControl.)
Public propertyIsEditing
Gets a value indicating whether there are currently open editors.
Public propertyIsInitializing (Inherited from RadControl.)
Public propertyIsLoaded
Determines whether the control is properly loaded.
(Inherited from RadControl.)
Public propertyItemHeight
Gets or sets the height of the items.
Public propertyItemIndent
Gets or sets the width of the indentation of subitems.
Public propertyItems
Gets the Items collection.
Public propertyItemSpacing
Gets or sets the distance between items of the RadPropertyGridElement.
Public propertyKeyboardSearchEnabled
Gets or sets a value that determines whether the user can navigate to an item by typing when RadPropertyGrid is focused.
Public propertyKeyboardSearchResetInterval
Gets or sets a value that specifies how long the user must wait before searching with the keyboard is reset.
Public propertyLayoutManager (Inherited from RadControl.)
Public propertyMaximumSize
Gets or sets the size that is the upper limit that GetPreferredSize can specify.
(Inherited from RadControl.)
Public propertyMinimumSize
Gets or sets the size that is the lower limit that GetPreferredSize can specify
(Inherited from RadControl.)
Public propertyPadding
Gets or sets padding within the control.
(Inherited from RadControl.)
Public propertyPropertyGridElement
Gets the PropertyGridTableElement of this control.
Public propertyPropertySort
Gets or sets the mode in which the properties will be displayed in the RadPropertyGrid.
Public propertyRadContextMenu
Gets or sets the shortcut menu associated with the control.
Public propertyReadOnly
Gets or sets a value indicating whether the user is allowed to edit the values of the properties.
Public propertyRootElement
Gets the RootElement of the control.
(Inherited from RadControl.)
Public propertySelectedGridItem
Gets or sets the PropertyGridTableElement selected item.
Public propertySelectedObject
Gets or sets the object which properties the RadPropertyGrid is displaying.
Public propertySelectedObjects
Gets or sets the objects which properties the RadPropertyGrid is displaying.
Public propertyShowItemToolTips
Gets or sets a value indicating whether ToolTips are shown for the RadItem objects contained in the RadControl.
(Inherited from RadControl.)
Public propertySite (Inherited from RadControl.)
Public propertySmallImageList
Gets or sets the SmallImageList that contains the small images which are displayed when there's not enough space.
(Inherited from RadControl.)
Public propertySmallImageScalingSize
Gets or sets the small image scaling size.
(Inherited from RadControl.)
Public propertySortDescriptors
Gets the sort descriptors.
Public propertySortOrder
Gets or sets the sort order of items.
Public propertyText (Inherited from RadControl.)
Public propertyThemeClassName
Gets or sets the class name string that ThemeResolutionService will use to find the themes registered for the control.
(Inherited from RadControl.)
Public propertyThemeName
Gets or sets control's preferred theme name. Themes are stored and retrieved using APIs of ThemeResolutionService.
(Inherited from RadControl.)
Public propertyToolbarVisible
Gets or sets a value indicating whether the search box of the RadPropertyGrid should be visible
Public propertyUseCompatibleTextRendering
Determines whether to use compatible text rendering engine (GDI+) or not (GDI).
(Inherited from RadControl.)
Protected propertyValidationCancel (Inherited from RadControl.)
Top
Methods
  NameDescription
Public methodBeginEdit
Puts the current item in edit mode.
Public methodBeginInit
Suspends layout during initialization.
(Inherited from RadControl.)
Public methodBestFit
Uses a mechanism to maximize the visible strings in both columns of RadPropertyGrid.
Public methodBestFit(PropertyGridBestFitMode)
Best fits the column(s) of RadPropertyGrid using the given mode.
Public methodCallAccessibilityNotifyClients
This method is used internally!
(Inherited from RadControl.)
Public methodCallBaseOnGotFocus
This method is used internally!
(Inherited from RadControl.)
Public methodCallBaseOnKeyDown
This method is used internally!
(Inherited from RadControl.)
Public methodCallBaseOnKeyPress
This method is used internally!
(Inherited from RadControl.)
Public methodCallBaseOnKeyUp
This method is used internally!
(Inherited from RadControl.)
Public methodCallBaseOnLostFocus
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnClick
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnDoubleClick
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnKeyDown
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnKeyPress
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnKeyUp
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseCaptureChanged
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseDown
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseEnter
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseHover
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseLeave
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseMove
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseUp
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnMouseWheel
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnPreviewKeyDown
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnScreenTipNeeded
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnThemeNameChanged
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnToolTipTextNeeded
This method is used internally!
(Inherited from RadControl.)
Public methodCallOnVisibleChanged
This method is used internally!
(Inherited from RadControl.)
Public methodCancelEdit
Close the currently active editor and discard changes.
Protected methodCanEditElementAtDesignTime
Determines whether an element may be edited via the EditUIElements dialog at design-time.
(Inherited from RadControl.)
Public methodCanEditUIElement
Determines whether an element from this element tree may be displayed in the EditUIElements dialog.
(Inherited from RadControl.)
Public methodCollapseAllGridItems
Collapses all the categories in the RadPropertyGrid.
Protected methodConstruct (Inherited from RadControl.)
Public methodControlDefinesThemeForElement
Checks whether the element's theme is defined by the control.
(Inherited from RadControl.)
Protected methodCreateAccessibilityInstance (Overrides ControlCreateAccessibilityInstance.)
Protected methodCreateBehavior
Creates the input behavior instance. Allows inheritors to provide custom input implementations.
(Inherited from RadControl.)
Protected methodCreateChildItems (Overrides RadControlCreateChildItems(RadElement).)
Protected methodCreatePropertyGridElement
Protected methodCreateRootElement (Inherited from RadControl.)
Public methodDisableGesture
Disable firing gesture events of the specified type.
(Inherited from RadControl.)
Protected methodDispose
Releases the unmanaged resources used by the RadPropertyGrid and optionally releases the managed resources
(Overrides RadControlDispose(Boolean).)
Public methodEnableGesture
Enable firing gesture events of the specified type.
(Inherited from RadControl.)
Public methodEndEdit
Commits any changes and ends the edit operation on the current item.
Public methodEndInit
Resumes layout.
(Inherited from RadControl.)
Public methodExpandAllGridItems
Expands all the categories in the RadPropertyGrid.
Protected methodFindPropertyInChildren (Inherited from RadControl.)
Public methodGetChildAt
Method used by control Code Dom serializer to access element in the collection of RootElement.
(Inherited from RadControl.)
Public methodGetControlDefaultSize
This method is used internally!
(Inherited from RadControl.)
Protected methodGetInputElement (Inherited from RadControl.)
Public methodGetPlainText
Strips all html tags of the text set to the control and returns only the plain text.
(Inherited from RadControl.)
Public methodGetPreferredSize (Inherited from RadControl.)
Protected methodGetRootElementDesiredSize (Inherited from RadControl.)
Protected methodInitializeRootElement (Inherited from RadControl.)
Public methodInvokeLayoutCallback (Inherited from RadControl.)
Protected methodIsInputKey (Overrides RadControlIsInputKey(Keys).)
Public methodLoadElementTree
Loads the element tree. While not loaded, no layout operations are allowed upon the tree. By default, the tree will be loaded when the control is displayed for the first time.
(Inherited from RadControl.)
Public methodLoadElementTree(Size)
Loads the element tree using the specified desired size.
(Inherited from RadControl.)
Protected methodOnAutoSizeChanged (Inherited from RadControl.)
Protected methodOnBackColorChanged (Inherited from RadControl.)
Protected methodOnBindingContextChanged (Inherited from RadControl.)
Protected methodOnCaptureLosing (Inherited from RadControl.)
Protected methodOnClick (Inherited from RadControl.)
Protected methodOnCreateControl (Inherited from RadControl.)
Protected methodOnDoubleClick (Inherited from RadControl.)
Protected methodOnEnabledChanged (Inherited from RadControl.)
Protected methodOnFontChanged (Inherited from RadControl.)
Protected methodOnForeColorChanged (Inherited from RadControl.)
Protected methodOnGesture (Inherited from RadControl.)
Protected methodOnGotFocus (Inherited from RadControl.)
Protected methodOnHandleDestroyed (Inherited from RadControl.)
Protected methodOnInvalidated (Inherited from RadControl.)
Protected methodOnKeyDown (Overrides RadControlOnKeyDown(KeyEventArgs).)
Protected methodOnKeyPress (Overrides RadControlOnKeyPress(KeyPressEventArgs).)
Protected methodOnKeyUp (Inherited from RadControl.)
Protected methodOnLayout (Inherited from RadControl.)
Protected methodOnLoad (Overrides RadControlOnLoad(Size).)
Protected methodOnLocationChanged (Inherited from RadControl.)
Protected methodOnLostFocus (Inherited from RadControl.)
Protected methodOnMouseCaptureChanged (Inherited from RadControl.)
Protected methodOnMouseClick (Overrides ControlOnMouseClick(MouseEventArgs).)
Protected methodOnMouseDoubleClick (Overrides ControlOnMouseDoubleClick(MouseEventArgs).)
Protected methodOnMouseDown (Overrides RadControlOnMouseDown(MouseEventArgs).)
Protected methodOnMouseEnter (Overrides RadControlOnMouseEnter(EventArgs).)
Protected methodOnMouseHover (Inherited from RadControl.)
Protected methodOnMouseLeave (Overrides RadControlOnMouseLeave(EventArgs).)
Protected methodOnMouseMove (Overrides RadControlOnMouseMove(MouseEventArgs).)
Protected methodOnMouseUp (Overrides RadControlOnMouseUp(MouseEventArgs).)
Protected methodOnMouseWheel (Overrides RadControlOnMouseWheel(MouseEventArgs).)
Protected methodOnNotifyPropertyChanged(PropertyChangedEventArgs) (Inherited from RadControl.)
Protected methodOnNotifyPropertyChanged(String)
Raises the PropertyChanged event
(Inherited from RadControl.)
Protected methodOnPaddingChanged (Inherited from RadControl.)
Protected methodOnPaint (Inherited from RadControl.)
Protected methodOnPanGesture
Fires the PanGesture event.
(Inherited from RadControl.)
Protected methodOnParentChanged (Inherited from RadControl.)
Protected methodOnPressAndTapGesture
Fires the PressAndTapGesture event.
(Inherited from RadControl.)
Protected methodOnPreviewKeyDown (Inherited from RadControl.)
Protected methodOnRightToLeftChanged (Inherited from RadControl.)
Protected methodOnRotateGesture
Fires the RotateGesture event.
(Inherited from RadControl.)
Protected methodOnScreenTipNeeded (Inherited from RadControl.)
Protected methodOnThemeChanged (Inherited from RadControl.)
Protected methodOnThemeNameChanged (Inherited from RadControl.)
Protected methodOnToolTipTextNeeded (Inherited from RadControl.)
Protected methodOnTwoFingerTapGesture
Fires the TwoFingerTapGesture event.
(Inherited from RadControl.)
Protected methodOnValidating (Overrides ControlOnValidating(CancelEventArgs).)
Protected methodOnZoomGesture
Fires the ZoomGesture event.
(Inherited from RadControl.)
Protected methodProcessAutoSizeChanged (Inherited from RadControl.)
Protected methodProcessCaptureChangeRequested
Processes a capture request from the specified element.
(Inherited from RadControl.)
Protected methodProcessCodedUIMessage (Inherited from RadControl.)
Protected methodProcessDialogKey (Overrides ControlProcessDialogKey(Keys).)
Protected methodProcessFocusRequested
Processes a focus request from the specified element.
(Inherited from RadControl.)
Protected methodProcessGesture (Inherited from RadControl.)
Protected methodProcessMnemonic (Inherited from RadControl.)
Public methodRefresh (Inherited from RadControl.)
Public methodRegisterHostedControl (Inherited from RadControl.)
Protected methodResetBackColorThemeOverrides (Inherited from RadControl.)
Protected methodResetForeColorThemeOverrides (Inherited from RadControl.)
Public methodResetSelectedProperty
Resets the selected property to its default value.
Public methodResolveStyleGroupForElement
Replaces the default style group for specific element.
(Inherited from RadControl.)
Public methodResumeUpdate (Inherited from RadControl.)
Public methodResumeUpdate(Boolean) (Inherited from RadControl.)
Protected methodScaleControl (Inherited from RadControl.)
Protected methodSetBackColorThemeOverrides (Inherited from RadControl.)
Protected methodSetBoundsCore (Inherited from RadControl.)
Protected methodSetForeColorThemeOverrides (Inherited from RadControl.)
Public methodSetIsInitializing
This method is used internally!
(Inherited from RadControl.)
Public methodShouldSerializeBackColor
Determines whether the BackColor property should be serialized.
(Inherited from RadControl.)
Public methodShouldSerializeFont
Determines whether the ForeColor property should be serialized.
(Inherited from RadControl.)
Public methodShouldSerializeForeColor
Determines whether the ForeColor property should be serialized.
(Inherited from RadControl.)
Protected methodShouldSerializeProperty
Determines whether the specified RadProperty should be serialized.
(Inherited from RadControl.)
Public methodSuspendUpdate (Inherited from RadControl.)
Public methodUnregisterHostedControl (Inherited from RadControl.)
Protected methodWndProc (Overrides RadControlWndProc(Message).)
Top
Events
  NameDescription
Public eventContextMenuOpening
Occurs when opening the context menu.
Public eventCreateItem
Occurs when a new item element is going to be created.
Public eventCreateItemElement
Occurs when a new item element is going to be created.
Public eventCustomGrouping
Fires for custom grouping operation.
Public eventEdited
Occurs when editing has been finished.
Public eventEditing
Occurs when editing is started.
Public eventEditorInitialized
Occurs when editor is initialized.
Public eventEditorRequired
Occurs when editor is required.
Public eventElementInvalidated (Inherited from RadControl.)
Public eventInitialized
Fires when the control is initialized.
(Inherited from RadControl.)
Public eventItemExpandedChanged
Occurs after the value of the Expanded property of a property grid item is changed.
Public eventItemExpandedChanging
Occurs before the value of the Expanded property of a property grid item is changed.
Public eventItemFormatting
Occurs when the item changes its state and needs to be formatted.
Public eventItemMouseClick
Occurs when a mouse button is clicked inside a PropertyGridItemElementBase
Public eventItemMouseDoubleClick
Occurs when a mouse button is double clicked inside a PropertyGridItemElementBase
Public eventItemMouseDown
Occurs when the user presses a mouse button over a property grid item.
Public eventItemMouseMove
Occurs when the user moves the mouse in the area of a property grid item.
Public eventPanGesture
Occurs when a pan gesture was sent by a touch input device.
(Inherited from RadControl.)
Public eventPressAndTapGesture
Occurs when a press-and-tap gesture was sent by a touch input device.
(Inherited from RadControl.)
Public eventPropertyChanged
Occurs when a property of an object changes change. Calling the event is developer's responsibility.
(Inherited from RadControl.)
Public eventPropertyValidated
Fires when a property has finished validating.
Public eventPropertyValidating
Fires when a property value is validating.
Public eventPropertyValueChanged
Occurs when a property value changes.
Public eventPropertyValueChanging
Occurs when item's value is changing.
Public eventRotateGesture
Occurs when a rotate gesture was sent by a touch input device.
(Inherited from RadControl.)
Public eventScreenTipNeeded
Occurs prior the ScreenTip of a RadItem instance inside the RadControl is displayed.
(Inherited from RadControl.)
Public eventSelectedGridItemChanged
Occurs after the property item is selected.
Remarks
For more information about handling events, see also SelectedItemChanging.
Public eventSelectedGridItemChanging
Occurs before a property grid item is selected.
Public eventSelectedObjectChanged
Occurs after the selected object is changed.
Public eventSelectedObjectChanging
Occurs before the selected object is changed.
Public eventThemeNameChanged
Fires when the theme name is changed.
(Inherited from RadControl.)
Public eventToolTipTextNeeded
Occurs when a RadItem instance inside the RadControl requires ToolTip text.
(Inherited from RadControl.)
Public eventTwoFingerTapGesture
Occurs when a two-finger-tap gesture was sent by a touch input device.
(Inherited from RadControl.)
Public eventValueChanged
Fires when the value of an editor changes.
Public eventValueChanging
Fires before the value in an editor is being changed. The action can be canceled.
Public eventZoomGesture
Occurs when a zoom gesture was sent by a touch input device.
(Inherited from RadControl.)
Top
Fields
  NameDescription
Protected fieldinvalidResizeRect (Inherited from RadControl.)
Protected fieldisAccessibilityRequested (Inherited from RadControl.)
Protected fieldisDisposing2 (Inherited from RadControl.)
Protected fieldisResizing2 (Inherited from RadControl.)
Top
See Also