Class RadDiagramItem

Abstract base implementation of the IDiagramItem interface.

Inheritance
System.Object
DisposableObject
RadObject
RadElement
VisualElement
UIElement
FrameworkElement
RadDiagramItem
RadDiagramShapeBase
RadDiagramConnection
Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls.UI.Diagrams
Assembly: Telerik.WinControls.RadDiagram.dll

Syntax

public abstract class RadDiagramItem : FrameworkElement, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IStylableNode, ISupportDrop, IDiagramItem, ISerializable, ISupportMouseOver, IPropertyChanged, IGroupable, ISupportManipulation, ISupportVirtualization, IContainerChild, ICollapsible

Constructors

RadDiagramItem()

Initializes a new instance of the RadDiagramItem class.

Declaration
protected RadDiagramItem()

Fields

AllowCopyProperty

Identifies the AllowCopy dependency property.

Declaration
public static readonly RadProperty AllowCopyProperty
Field Value
RadProperty

AllowCutProperty

Identifies the AllowCut dependency property.

Declaration
public static readonly RadProperty AllowCutProperty
Field Value
RadProperty

AllowDeleteProperty

Identifies the AllowDelete dependency property.

Declaration
public static readonly RadProperty AllowDeleteProperty
Field Value
RadProperty

AllowPasteProperty

Identifies the AllowPaste dependency property.

Declaration
public static readonly RadProperty AllowPasteProperty
Field Value
RadProperty

EditTemplateProperty

Identifies the EditTemplate dependency property.

Declaration
public static readonly RadProperty EditTemplateProperty
Field Value
RadProperty

editTextBox

Declaration
protected RadTextBoxControlElement editTextBox
Field Value
RadTextBoxControlElement

EndEditEvent

Identifies the EndEdit routed event.

Declaration
public static readonly RoutedEvent EndEditEvent
Field Value
RoutedEvent

GroupProperty

Identifies the Group dependency property.

Declaration
public static readonly RadProperty GroupProperty
Field Value
RadProperty

IsConnectorsManipulationEnabledProperty

Identifies the IsConnectorsManipulationEnabled dependency property.

Declaration
public static readonly RadProperty IsConnectorsManipulationEnabledProperty
Field Value
RadProperty

IsDraggingEnabledProperty

Identifies the IsDraggingEnabled dependency property.

Declaration
public static readonly RadProperty IsDraggingEnabledProperty
Field Value
RadProperty

IsEditableProperty

Identifies the IsEditable dependency property.

Declaration
public static readonly RadProperty IsEditableProperty
Field Value
RadProperty

IsInEditModeProperty

Identifies the IsInEditMode dependency property.

Declaration
public static readonly RadProperty IsInEditModeProperty
Field Value
RadProperty

IsManipulationAdornerVisibleProperty

Identifies the IsManipulationAdornerVisible dependency property.

Declaration
public static readonly RadProperty IsManipulationAdornerVisibleProperty
Field Value
RadProperty

IsResizingEnabledProperty

Identifies the IsResizingEnabled dependency property.

Declaration
public static readonly RadProperty IsResizingEnabledProperty
Field Value
RadProperty

IsRotationEnabledProperty

Identifies the IsRotationEnabled dependency property.

Declaration
public static readonly RadProperty IsRotationEnabledProperty
Field Value
RadProperty

IsSelectedProperty

Identifies the IsSelected dependency property.

Declaration
public static readonly RadProperty IsSelectedProperty
Field Value
RadProperty

PositionProperty

Identifies the Position dependency property.

Declaration
public static readonly RadProperty PositionProperty
Field Value
RadProperty

StrokeDashArrayProperty

Identifies the StrokeDashArray dependency property.

Declaration
public static readonly RadProperty StrokeDashArrayProperty
Field Value
RadProperty

StrokeProperty

Identifies the Stroke dependency property.

Declaration
public static readonly RadProperty StrokeProperty
Field Value
RadProperty

StrokeThicknessProperty

Identifies the StrokeThickness dependency property.

Declaration
public static readonly RadProperty StrokeThicknessProperty
Field Value
RadProperty

Properties

ActualSize

The actual size of the item.

Declaration
protected virtual Size ActualSize { get; }
Property Value
Size

Alignment

Gets or sets the preferred location of the element if its size is less than its parent size.

Declaration
public override ContentAlignment Alignment { get; set; }
Property Value
System.Drawing.ContentAlignment

Overrides

AllowCopy

Gets or sets a value indicating whether copying is allowed.

Declaration
public bool AllowCopy { get; set; }
Property Value
System.Boolean

True if copying is allowed; otherwise, false.
Implements

AllowCut

Gets or sets a value indicating whether cutting is allowed.

Declaration
public bool AllowCut { get; set; }
Property Value
System.Boolean

True if cutting is allowed; otherwise, false.
Implements

AllowDelete

Gets or sets a value indicating whether deleting is allowed.

Declaration
public bool AllowDelete { get; set; }
Property Value
System.Boolean

True if deleting is allowed; otherwise, false.
Implements

AllowPaste

Gets or sets a value indicating whether pasting is allowed.

Declaration
public bool AllowPaste { get; set; }
Property Value
System.Boolean

True if pasting is allowed; otherwise, false.
Implements

AngleTransform

Declaration
public override float AngleTransform { get; set; }
Property Value
System.Single

Overrides

Bounds

Gets the bounds.

Declaration
public virtual Rect Bounds { get; }
Property Value
Rect

The bounds.
Implements

Content

Declaration
public object Content { get; set; }
Property Value
System.Object

Implements

DataBoundItem

Declaration
public object DataBoundItem { get; set; }
Property Value
System.Object

Diagram

Gets the owning diagram of this instance.

Declaration
protected IGraphInternal Diagram { get; }
Property Value
IGraphInternal

Id

Gets the unique identifier of this entity.

Declaration
public string Id { get; }
Property Value
System.String

An identifier for this entity.
Implements

IsConnectorsManipulationEnabled

Gets or sets a value indicating whether manipulation on the connectors is enabled.

Declaration
public bool IsConnectorsManipulationEnabled { get; set; }
Property Value
System.Boolean

True if manipulation on connectors is enabled; otherwise, false.
Implements

IsDraggingEnabled

Gets or sets a value indicating whether dragging is enabled.

Declaration
public bool IsDraggingEnabled { get; set; }
Property Value
System.Boolean

True if dragging is enabled; otherwise, false.
Implements

IsDynamic

Gets or sets whether this item is dynamically generated.

Declaration
public bool IsDynamic { get; set; }
Property Value
System.Boolean

If true then this item will not be serialized as part of the diagram.
Implements
Remarks

In some applications or embeddings of RadDiagram (e.g. workflows) there are shapes or connections which are generated as part of some layout or organization. In those cases it doesn't make sense to serialize the elements which are automatically generated as part of the application. By setting this property to true the serialization pipeline will omit the element.

IsEditable

Gets or sets a value indicating whether editing is enabled on this item.

Declaration
public bool IsEditable { get; set; }
Property Value
System.Boolean

True if editing is enabled; otherwise, false.
Implements
Remarks

Note that the similar higher-level IsEditable can potentially overrule this setting.

IsEnabled

Declaration
public virtual bool IsEnabled { get; set; }
Property Value
System.Boolean

Implements

IsInEditMode

Gets or sets a value indicating whether this instance is in edit mode.

Declaration
public bool IsInEditMode { get; set; }
Property Value
System.Boolean

True if this instance is in edit mode; otherwise, false.
Implements

IsManipulationAdornerVisible

Gets or sets a value indicating whether the manipulation adorner is visible.

Declaration
public bool IsManipulationAdornerVisible { get; set; }
Property Value
System.Boolean

True if the manipulation adorner is visible; otherwise, false.
Implements

IsResizingEnabled

Gets or sets a value indicating whether resizing is enabled.

Declaration
public bool IsResizingEnabled { get; set; }
Property Value
System.Boolean

True if resizing is enabled; otherwise, false.
Implements

IsRotationEnabled

Gets or sets a value indicating whether rotation is enabled.

Declaration
public bool IsRotationEnabled { get; set; }
Property Value
System.Boolean

true if this rotation is enabled; otherwise, false.
Implements

IsSelected

Gets or sets whether the diagram entity is selected.

Declaration
public bool IsSelected { get; set; }
Property Value
System.Boolean

True if selected; otherwise, false.
Implements

IsSelectedInGroup

Gets a value indicating whether this instance is selected in group.

Declaration
protected bool IsSelectedInGroup { get; set; }
Property Value
System.Boolean

True if this item is selected in group; otherwise, false.

IsServiceManipulation

Gets whether any service is manipulating at the moment.

Declaration
protected bool IsServiceManipulation { get; }
Property Value
System.Boolean

ParentContainer

ParentContainer

Declaration
public IContainerShape ParentContainer { get; }
Property Value
IContainerShape

Implements

ParentGroup

Gets or sets the group.

Declaration
public IGroup ParentGroup { get; set; }
Property Value
IGroup

The group.
Implements

Position

Gets or sets the position of the top left corner of the bounding rectangle of the item.

Declaration
public Point Position { get; set; }
Property Value
Point

Implements

RightToLeft

Gets or sets the direction of flow of the elements and whether elements are aligned to support locales using right-to-left fonts.

Declaration
public override bool RightToLeft { get; set; }
Property Value
System.Boolean

Overrides

ServiceLocator

Gets the service locator.

Declaration
protected IGraphServiceLocator ServiceLocator { get; }
Property Value
IGraphServiceLocator

Services

Gets the diagram's services.

Declaration
[Obsolete("Use the ServiceLocator property instead.", false)]
protected IGraphServiceLocator Services { get; }
Property Value
IGraphServiceLocator

StretchHorizontally

Declaration
public override bool StretchHorizontally { get; set; }
Property Value
System.Boolean

Overrides

StretchVertically

Declaration
public override bool StretchVertically { get; set; }
Property Value
System.Boolean

Overrides

Stroke

Gets or sets the stroke of this item.

Declaration
public virtual Brush Stroke { get; set; }
Property Value
System.Drawing.Brush

The stroke.

StrokeDashArray

Gets or sets the stroke dash array of this item.

Declaration
public DoubleCollection StrokeDashArray { get; set; }
Property Value
DoubleCollection

The stroke dash array.

StrokeThickness

Gets or sets the stroke thickness of this item.

Declaration
public double StrokeThickness { get; set; }
Property Value
System.Double

The stroke thickness.

X

Gets or sets the horizontal position of this item.

Declaration
public double X { get; set; }
Property Value
System.Double

The x-coordinate.

Y

Gets or sets the vertical position of this item.

Declaration
public double Y { get; set; }
Property Value
System.Double

The y-coordinate.

ZIndex

Gets or sets the ZIndex of this instance.

Declaration
public override int ZIndex { get; set; }
Property Value
System.Int32

Overrides
Implements

Methods

CallBeginEditEvent()

Declaration
protected virtual void CallBeginEditEvent()

CallEndEditEvent(Object)

Declaration
protected virtual void CallEndEditEvent(object editedContent)
Parameters
System.Object editedContent

CustomizeTextBoxEditor()

Declaration
protected virtual void CustomizeTextBoxEditor()

Deserialize(SerializationInfo)

Deserializes the serialization info in this diagram entity.

Declaration
public virtual void Deserialize(SerializationInfo info)
Parameters
SerializationInfo info

A SerializationInfo instance.
Implements

Initialize(IGraphServiceLocator, IGraphInternal)

Initializes the specified service locator and parent graph.

Declaration
protected virtual void Initialize(IGraphServiceLocator serviceLocator, IGraphInternal graph)
Parameters
IGraphServiceLocator serviceLocator

The service locator.
IGraphInternal graph

The diagram control.

InitializeGlobalSettingsFromDiagram(RadDiagramElement)

Declaration
protected virtual void InitializeGlobalSettingsFromDiagram(RadDiagramElement diagramParent)
Parameters
RadDiagramElement diagramParent

OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call System.Windows.Controls.Control.ApplyTemplate. In simplest terms, this means the method is called just before a UI element displays in an application. For more information, see Remarks.

Declaration
public override void OnApplyTemplate()
Overrides

OnGroupNameChanged()

Called when the group name changes.

Declaration
protected virtual void OnGroupNameChanged()

OnIsConnectorsManipulationEnabledChanged(Boolean, Boolean)

Called when connectors manipulation changes.

Declaration
protected virtual void OnIsConnectorsManipulationEnabledChanged(bool newValue, bool oldValue)
Parameters
System.Boolean newValue

The new value.
System.Boolean oldValue

The old value.

OnIsEditableChanged(Boolean, Boolean)

Called when IsEditable has changed.

Declaration
protected virtual void OnIsEditableChanged(bool oldIsEditable, bool isEditable)
Parameters
System.Boolean oldIsEditable

The old value of the property.
System.Boolean isEditable

The current value of the property.

OnIsInEditModeChanged(Boolean, Boolean)

Called when IsInEditMode changes.

Declaration
protected virtual void OnIsInEditModeChanged(bool oldIsInEditMode, bool isInEditMode)
Parameters
System.Boolean oldIsInEditMode

The old value of the property.
System.Boolean isInEditMode

The current value of the property.

OnIsSelectedChanged(Boolean, Boolean)

Called when the IsSelected property has changed.

Declaration
protected virtual void OnIsSelectedChanged(bool oldValue, bool newValue)
Parameters
System.Boolean oldValue

The old value of the IsSelected property.
System.Boolean newValue

The new value of the IsSelected property.

OnParentChanged(RadElement)

Declaration
protected override void OnParentChanged(RadElement previousParent)
Parameters
RadElement previousParent

Overrides

OnPositionChanged(Point, Point)

Called when position changes.

Declaration
protected virtual void OnPositionChanged(Point oldPosition, Point newPosition)
Parameters
Point oldPosition

The old position.
Point newPosition

The new position.

OnPositionCoerced(Point)

Called when [position coerced].

Declaration
protected virtual object OnPositionCoerced(Point position)
Parameters
Point position

The position.
Returns
System.Object

OnPropertyChanged(String)

Called when a property value changed.

Declaration
protected virtual void OnPropertyChanged(string propertyName)
Parameters
System.String propertyName

Name of the property.

OnSizeChanged(Size, Size)

Called when the size changes.

Declaration
protected virtual void OnSizeChanged(Size newSize, Size oldSize)
Parameters
Size newSize

The new size.
Size oldSize

The old size.

OnStrokeThicknessChanged()

Invoked when the StrokeThickness property has changed.

Declaration
protected virtual void OnStrokeThicknessChanged()

OnZIndexChanged(Int32, Int32)

Called when the ZIndex changes.

Declaration
protected virtual void OnZIndexChanged(int newValue, int oldValue)
Parameters
System.Int32 newValue

The new value.
System.Int32 oldValue

The old value.

RefreshIsSelectedInGroup()

Refreshes the is selected in group property.

Declaration
protected virtual void RefreshIsSelectedInGroup()

Serialize()

Serializes this instance.

Declaration
public virtual SerializationInfo Serialize()
Returns
SerializationInfo

Implements

UpdateVisualStates()

Updates the visual states.

Declaration
protected virtual void UpdateVisualStates()

Events

BeginEdit

Identifies the BeginEdit routed event.

Declaration
public event EventHandler BeginEdit
Event Type
System.EventHandler

EndEdit

Occurs when the editing ends.

Declaration
public event EventHandler<RadRoutedEditEventArgs> EndEdit
Event Type
System.EventHandler<RadRoutedEditEventArgs>

ParentGroupChanged

Occurs when [group changed].

Declaration
public event EventHandler<PropertyEventArgs<IGroup>> ParentGroupChanged
Event Type
System.EventHandler<PropertyEventArgs<IGroup>>

Implements

PreviewBeginEdit

Occurs before the editing starts.

Declaration
public event CancelEventHandler PreviewBeginEdit
Event Type
System.ComponentModel.CancelEventHandler

PreviewEndEdit

Occurs before the editing ends.

Declaration
public event CancelEventHandler PreviewEndEdit
Event Type
System.ComponentModel.CancelEventHandler

PropertyChanged

Declaration
public event EventHandler<PropertyEventArgs> PropertyChanged
Event Type
System.EventHandler<PropertyEventArgs>

Implements

Explicit Interface Implementations

ICollapsible.IsCollapsed

Gets or sets a value indicating whether this item is collapsed.

Declaration
bool ICollapsible.IsCollapsed { get; set; }
Returns
System.Boolean

Implements

IDiagramItem.Initialize(IGraphServiceLocator, IGraphInternal)

Initializes the specified service locator.

Declaration
void IDiagramItem.Initialize(IGraphServiceLocator serviceLocator, IGraphInternal graph)
Parameters
IGraphServiceLocator serviceLocator

The service locator.
IGraphInternal graph

The diagram.
Implements

ISupportMouseOver.get_IsMouseOver()

Declaration
bool ISupportMouseOver.get_IsMouseOver()
Returns
System.Boolean

Implements
Telerik.Windows.Diagrams.Core.ISupportMouseOver.get_IsMouseOver()

ISupportVirtualization.VirtualizationState

Get a value indicating item state regarding virtualization.

Declaration
ItemVisibility ISupportVirtualization.VirtualizationState { get; set; }
Returns
ItemVisibility

Implements

Extension Methods