Visualizes a property-grid item with its label, value, hierarchy indicators, and in-place editor.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class PropertyGridItemElement : PropertyGridItemElementBase, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider, IVirtualizedElement<PropertyGridItemBase>
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementPropertyGridItemElementBasePropertyGridItemElement...
Derived Classes:
Implements:
Inherited Members
Constructors
public PropertyGridItemElement()
Fields
Identifies whether the item has child rows.
public static RadProperty HasChildrenProperty
Identifies the theme state indicating that this item is nested under another property.
public static RadProperty IsChildItemProperty
Identifies whether an editor is currently attached to this item.
public static RadProperty IsInEditModeProperty
Identifies the theme state indicating that the item's value differs from its original value.
public static RadProperty IsModifiedProperty
Identifies the read-only state used by the item theme.
public static RadProperty IsReadOnlyProperty
Properties
Gets the logical item attached to this visual element.
public override PropertyGridItemBase Data { get; }
Overrides:
Gets the input editor currently attached to the row, or null when no editor is attached.
public IInputEditor Editor { get; }
Gets the property grid item expander element.
public PropertyGridExpanderElement ExpanderElement { get; }
Gets the header element of the PropertyGridItemElement.
public PropertyGridRowHeaderElement HeaderElement { get; }
Gets the property grid item indent element
public PropertyGridIndentElement IndentElement { get; }
Gets or sets a value indicating whether this item has a parent or not.
public bool IsChildItem { get; set; }
Gets whether an input editor is currently attached to the value element.
public bool IsInEditMode { get; }
Gets or sets a value indicating whether this item has changed its value or not.
public bool IsModified { get; set; }
Gets or sets a value indicating whether this property can be edited.
public bool IsReadOnly { get; set; }
Gets the property grid item text element.
public virtual PropertyGridContentElement TextElement { get; }
Gets the property grid item value element
public PropertyGridValueElement ValueElement { get; }
Methods
Attaches an editor's visual element to the value element and synchronizes the row layout.
public virtual void AddEditor(IInputEditor editor)
The editor to attach.
Attaches a logical item to this visual element.
public override void Attach(PropertyGridItemBase data, object context)
The logical item.
contextobjectThe context.
Overrides:
Creates the row's header, indentation, expander, label, and value elements.
protected override void CreateChildElements()
Overrides:
Creates the expander element that toggles the item's child rows.
protected virtual PropertyGridExpanderElement CreatePropertyGridExpanderElement()
The element used to expand or collapse child rows.
Creates the indentation element; override to provide a specialized hierarchy indent.
protected virtual PropertyGridIndentElement CreatePropertyGridIndentElement()
The element used for hierarchy indentation.
Creates the row-header element; override to provide a specialized header.
protected virtual PropertyGridRowHeaderElement CreatePropertyGridRowHeaderElement()
The element used for the row header.
Creates the element that displays the property label.
protected virtual PropertyGridTextElement CreatePropertyGridTextElement()
The element used for the property label.
Creates the element that displays the property value and hosts its editor.
protected virtual PropertyGridValueElement CreatePropertyGridValueElement()
The element used for the property value.
Detaches the currently attached logical item.
public override void Detach()
Overrides:
Gets the visual element associated with the current editor.
protected RadItem GetEditorElement(IValueEditor editor)
The editor cast to a visual item when the stored editor is not a BaseInputEditor.
Returns:The active editor's element, or null when it is not a visual item.
Initializes the row element's default layout and mouse-input behavior.
protected override void InitializeFields()
Overrides:
Determines if a logical item is compatible with this visual element.
public override bool IsCompatible(PropertyGridItemBase data, object context)
The logical item to be checked for compatibility.
contextobjectThe context.
Returns:Overrides:
Gets a value indicating whether a given point is in a location where resize should be initialized when the left mouse button is pressed.
Requests completion of an active edit, then tracks a divider drag when the pointer is over it; canceled validation does not stop resizing.
protected override void OnMouseDown(MouseEventArgs e)
The mouse event data.
Overrides:
Resizes the value column while dragging its divider, or updates the resize cursor when hovering over the divider.
protected override void OnMouseMove(MouseEventArgs e)
The mouse event data.
Overrides:
Stops value-column resizing and releases mouse capture after the pointer is released.
protected override void OnMouseUp(MouseEventArgs e)
The mouse event data.
Overrides:
Removes the editor's visual element when it is the editor currently attached to this row.
public virtual void RemoveEditor(IInputEditor editor)
The editor to remove.
Syncronizes changes with other elements.
public override void Synchronize()
Overrides: