New to Telerik UI for WPF? Start a free 30-day trial

RadDiagramItem

Class

Abstract base implementation of the IDiagramItem interface.

Definition

Namespace:Telerik.Windows.Controls.Diagrams

Assembly:Telerik.Windows.Controls.Diagrams.dll

Syntax:

public abstract class RadDiagramItem : ContentControl, IDiagramItem, ISerializable, ISupportMouseOver, IPropertyChanged, IGroupable, ISupportManipulation, ISupportVirtualization, IContainerChild, ICollapsible

Inheritance: objectRadDiagramItem

Derived Classes: RadDiagramShapeBaseRadDiagramConnection

Implements: ICollapsibleIContainerChildIDiagramItemIGroupableIPropertyChangedISerializableISupportManipulationISupportMouseOverISupportVirtualization...

Constructors

RadDiagramItem()

Initializes a new instance of the RadDiagramItem class.

protected RadDiagramItem()

Fields

AllowCopyProperty

DependencyProperty

Identifies the AllowCopy dependency property.

public static readonly DependencyProperty AllowCopyProperty

AllowCutProperty

DependencyProperty

Identifies the AllowCut dependency property.

public static readonly DependencyProperty AllowCutProperty

AllowDeleteProperty

DependencyProperty

Identifies the AllowDelete dependency property.

public static readonly DependencyProperty AllowDeleteProperty

AllowPasteProperty

DependencyProperty

Identifies the AllowPaste dependency property.

public static readonly DependencyProperty AllowPasteProperty

BeginEditEvent

RoutedEvent

Identifies the BeginEdit routed event.

public static readonly RoutedEvent BeginEditEvent

EditTemplateProperty

DependencyProperty

Identifies the EditTemplate dependency property.

public static readonly DependencyProperty EditTemplateProperty

EndEditEvent

RoutedEvent

Identifies the EndEdit routed event.

public static readonly RoutedEvent EndEditEvent

GroupProperty

DependencyProperty

Identifies the Group dependency property.

public static readonly DependencyProperty GroupProperty

IsConnectorsManipulationEnabledProperty

DependencyProperty

Identifies the IsConnectorsManipulationEnabled dependency property.

public static readonly DependencyProperty IsConnectorsManipulationEnabledProperty

IsDraggingEnabledProperty

DependencyProperty

Identifies the IsDraggingEnabled dependency property.

public static readonly DependencyProperty IsDraggingEnabledProperty

IsEditableProperty

DependencyProperty

Identifies the IsEditable dependency property.

public static readonly DependencyProperty IsEditableProperty

IsInEditModeProperty

DependencyProperty

Identifies the IsInEditMode dependency property.

public static readonly DependencyProperty IsInEditModeProperty

IsManipulationAdornerVisibleProperty

DependencyProperty

Identifies the IsManipulationAdornerVisible dependency property.

public static readonly DependencyProperty IsManipulationAdornerVisibleProperty

IsResizingEnabledProperty

DependencyProperty

Identifies the IsResizingEnabled dependency property.

public static readonly DependencyProperty IsResizingEnabledProperty

IsRotationEnabledProperty

DependencyProperty

Identifies the IsRotationEnabled dependency property.

public static readonly DependencyProperty IsRotationEnabledProperty

IsSelectedProperty

DependencyProperty

Identifies the IsSelected dependency property.

public static readonly DependencyProperty IsSelectedProperty

PositionProperty

DependencyProperty

Identifies the Position dependency property.

public static readonly DependencyProperty PositionProperty

PreviewBeginEditEvent

RoutedEvent

Identifies the PreviewBeginEdit routed event.

public static readonly RoutedEvent PreviewBeginEditEvent

PreviewEndEditEvent

RoutedEvent

Identifies the PreviewEndEdit routed event.

public static readonly RoutedEvent PreviewEndEditEvent

StrokeDashArrayProperty

DependencyProperty

Identifies the StrokeDashArray dependency property.

public static readonly DependencyProperty StrokeDashArrayProperty

StrokeProperty

DependencyProperty

Identifies the Stroke dependency property.

public static readonly DependencyProperty StrokeProperty

StrokeThicknessProperty

DependencyProperty

Identifies the StrokeThickness dependency property.

public static readonly DependencyProperty StrokeThicknessProperty

ZIndexProperty

DependencyProperty

Identifies the ZIndex dependency property.

public static readonly DependencyProperty ZIndexProperty

Properties

ActualSize

Size

The actual size of the item.

protected virtual Size ActualSize { get; }

AllowCopy

bool

Gets or sets a value indicating whether copying is allowed.

public bool AllowCopy { get; set; }

Property Value:

True if copying is allowed; otherwise, false.

Implements: ISupportManipulation.AllowCopy

AllowCut

bool

Gets or sets a value indicating whether cutting is allowed.

public bool AllowCut { get; set; }

Property Value:

True if cutting is allowed; otherwise, false.

Implements: ISupportManipulation.AllowCut

AllowDelete

bool

Gets or sets a value indicating whether deleting is allowed.

public bool AllowDelete { get; set; }

Property Value:

True if deleting is allowed; otherwise, false.

Implements: ISupportManipulation.AllowDelete

AllowPaste

bool

Gets or sets a value indicating whether pasting is allowed.

public bool AllowPaste { get; set; }

Property Value:

True if pasting is allowed; otherwise, false.

Implements: ISupportManipulation.AllowPaste

Bounds

Rect

Gets the bounds.

public virtual Rect Bounds { get; }

Property Value:

The bounds.

Implements: IDiagramItem.Bounds

Diagram

IGraphInternal

Gets the owning diagram of this instance.

protected IGraphInternal Diagram { get; }

Id

string

Gets the unique identifier of this entity.

public string Id { get; }

Property Value:

An identifier for this entity.

Implements: IDiagramItem.Id

IsConnectorsManipulationEnabled

bool

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

public bool IsConnectorsManipulationEnabled { get; set; }

Property Value:

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

Implements: ISupportManipulation.IsConnectorsManipulationEnabled

IsDraggingEnabled

bool

Gets or sets a value indicating whether dragging is enabled.

public bool IsDraggingEnabled { get; set; }

Property Value:

True if dragging is enabled; otherwise, false.

Implements: ISupportManipulation.IsDraggingEnabled

IsDynamic

bool

Gets or sets whether this item is dynamically generated.

public bool IsDynamic { get; set; }

Property Value:

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

Implements: IDiagramItem.IsDynamic

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

bool

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

public bool IsEditable { get; set; }

Property Value:

True if editing is enabled; otherwise, false.

Implements: IDiagramItem.IsEditable

Remarks:

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

IsInEditMode

bool

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

public bool IsInEditMode { get; set; }

Property Value:

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

Implements: IDiagramItem.IsInEditMode

IsManipulationAdornerVisible

bool

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

public bool IsManipulationAdornerVisible { get; set; }

Property Value:

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

Implements: ISupportManipulation.IsManipulationAdornerVisible

IsResizingEnabled

bool

Gets or sets a value indicating whether resizing is enabled.

public bool IsResizingEnabled { get; set; }

Property Value:

True if resizing is enabled; otherwise, false.

Implements: ISupportManipulation.IsResizingEnabled

IsRotationEnabled

bool

Gets or sets a value indicating whether rotation is enabled.

public bool IsRotationEnabled { get; set; }

Property Value:

true if this rotation is enabled; otherwise, false.

Implements: ISupportManipulation.IsRotationEnabled

IsSelected

bool

Gets or sets whether the diagram entity is selected.

public bool IsSelected { get; set; }

Property Value:

True if selected; otherwise, false.

Implements: IDiagramItem.IsSelected

IsSelectedInGroup

bool

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

protected bool IsSelectedInGroup { get; set; }

Property Value:

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

IsServiceManipulation

bool

Gets whether any service is manipulating at the moment.

protected bool IsServiceManipulation { get; }

ParentContainer

IContainerShape

Gets the parent container shape.

public IContainerShape ParentContainer { get; }

Property Value:

The parent container.

Implements: IContainerChild.ParentContainer

ParentGroup

IGroup

Gets or sets the group.

public IGroup ParentGroup { get; set; }

Property Value:

The group.

Implements: IGroupable.ParentGroup

Position

Point

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

public Point Position { get; set; }

Implements: IDiagramItem.Position

ServiceLocator

IGraphServiceLocator

Gets the service locator.

protected IGraphServiceLocator ServiceLocator { get; }

Stroke

Brush

Gets or sets the stroke of this item.

public Brush Stroke { get; set; }

Property Value:

The stroke.

StrokeDashArray

DoubleCollection

Gets or sets the stroke dash array of this item.

public DoubleCollection StrokeDashArray { get; set; }

Property Value:

The stroke dash array.

StrokeThickness

double

Gets or sets the stroke thickness of this item.

public double StrokeThickness { get; set; }

Property Value:

The stroke thickness.

X

double

Gets or sets the horizontal position of this item.

public double X { get; set; }

Property Value:

The x-coordinate.

Y

double

Gets or sets the vertical position of this item.

public double Y { get; set; }

Property Value:

The y-coordinate.

ZIndex

int

Gets or sets the ZIndex of this instance.

public int ZIndex { get; set; }

Implements: IDiagramItem.ZIndex

Methods

Deserialize(SerializationInfo)

Deserializes the serialization info in this diagram entity.

public virtual void Deserialize(SerializationInfo info)

Parameters:infoSerializationInfo

A SerializationInfo instance.

Implements: ISerializable.Deserialize(SerializationInfo)

Initialize(IGraphServiceLocator, IGraphInternal)

Initializes the specified service locator and parent graph.

protected virtual void Initialize(IGraphServiceLocator serviceLocator, IGraphInternal graph)

Parameters:serviceLocatorIGraphServiceLocator

The service locator.

graphIGraphInternal

The diagram control.

OnApplyTemplate()

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

public override void OnApplyTemplate()

OnCreateAutomationPeer()

AutomationPeer

Creates a peer associated with this object.

protected override AutomationPeer OnCreateAutomationPeer()

Returns:

AutomationPeer

An instance of the .

OnGroupNameChanged()

Called when the group name changes.

protected virtual void OnGroupNameChanged()

OnIsConnectorsManipulationEnabledChanged(bool, bool)

Called when connectors manipulation changes.

protected virtual void OnIsConnectorsManipulationEnabledChanged(bool newValue, bool oldValue)

Parameters:newValuebool

The new value.

oldValuebool

The old value.

OnIsEditableChanged(bool, bool)

Called when IsEditable has changed.

protected virtual void OnIsEditableChanged(bool oldIsEditable, bool isEditable)

Parameters:oldIsEditablebool

The old value of the property.

isEditablebool

The current value of the property.

OnIsInEditModeChanged(bool, bool)

Called when IsInEditMode changes.

protected virtual void OnIsInEditModeChanged(bool oldIsInEditMode, bool isInEditMode)

Parameters:oldIsInEditModebool

The old value of the property.

isInEditModebool

The current value of the property.

OnIsSelectedChanged(bool, bool)

Called when the IsSelected property has changed.

protected virtual void OnIsSelectedChanged(bool oldValue, bool newValue)

Parameters:oldValuebool

The old value of the IsSelected property.

newValuebool

The new value of the IsSelected property.

OnPositionChanged(Point, Point)

Called when position changes.

protected virtual void OnPositionChanged(Point oldPosition, Point newPosition)

Parameters:oldPositionPoint

The old position.

newPositionPoint

The new position.

OnPositionCoerced(Point)

object

Called when [position coerced].

protected virtual object OnPositionCoerced(Point position)

Parameters:positionPoint

The position.

Returns:

object

OnPropertyChanged(string)

Called when a property value changed.

protected virtual void OnPropertyChanged(string propertyName)

Parameters:propertyNamestring

Name of the property.

OnSizeChanged(Size, Size)

Called when the size changes.

protected virtual void OnSizeChanged(Size newSize, Size oldSize)

Parameters:newSizeSize

The new size.

oldSizeSize

The old size.

OnStrokeThicknessChanged()

Invoked when the StrokeThickness property has changed.

protected virtual void OnStrokeThicknessChanged()

OnZIndexChanged(int, int)

Called when the ZIndex changes.

protected virtual void OnZIndexChanged(int newValue, int oldValue)

Parameters:newValueint

The new value.

oldValueint

The old value.

RefreshIsSelectedInGroup()

Refreshes the is selected in group property.

protected virtual void RefreshIsSelectedInGroup()

Serialize()

SerializationInfo

Serializes this instance.

public virtual SerializationInfo Serialize()

Returns:

SerializationInfo

Implements: ISerializable.Serialize()

UpdateVisualStates()

Updates the visual states.

protected virtual void UpdateVisualStates()

Events

BeginEdit

RadRoutedEventHandler

Occurs when the editing begins.

public event RadRoutedEventHandler BeginEdit

EndEdit

EventHandler<RadRoutedEditEventArgs>

Occurs when the editing ends.

public event EventHandler<RadRoutedEditEventArgs> EndEdit

ParentGroupChanged

EventHandler<PropertyEventArgs<IGroup>>

Occurs when [group changed].

public event EventHandler<PropertyEventArgs<IGroup>> ParentGroupChanged

Implements: IGroupable.ParentGroupChanged

PreviewBeginEdit

RadRoutedEventHandler

Occurs before the editing starts.

public event RadRoutedEventHandler PreviewBeginEdit

PreviewEndEdit

EventHandler<RadRoutedEditEventArgs>

Occurs before the editing ends.

public event EventHandler<RadRoutedEditEventArgs> PreviewEndEdit

PropertyChanged

EventHandler<PropertyEventArgs>

Occurs when a property value changes.

public event EventHandler<PropertyEventArgs> PropertyChanged

Implements: IPropertyChanged.PropertyChanged