Class
SeparatorElement

Represents the visual element that renders a separator line with optional shadow effect. This element serves as the core visual component for RadSeparator and supports both horizontal and vertical orientations.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

cs-api-definition

[ComVisible(false)]
public class SeparatorElement : LightVisualElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider

Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementSeparatorElement

Derived Classes: TrackBarTickElement

Implements: IBindableComponentIBorderElementIBoxElementIBoxStyleIComponentICustomTypeDescriptorIDisposableIDrawFillElementIFillElementIImageElementINotifyPropertyChangedIPrimitiveElementIShapedElementIShortcutProviderIStylableElementIStylableNodeISupportDragISupportDropISupportSystemSkinITextPrimitiveITextProvider

Constructors

SeparatorElement()

Declaration

cs-api-definition

public SeparatorElement()

Fields

OrientationProperty

Identifies the Orientation dependency property that determines whether the separator is rendered horizontally or vertically.

Declaration

cs-api-definition

public static RadProperty OrientationProperty

Field Value

RadProperty

ShadowOffsetProperty

Identifies the ShadowOffset dependency property that defines the pixel offset of the shadow relative to the main separator line.

Declaration

cs-api-definition

public static RadProperty ShadowOffsetProperty

Field Value

RadProperty

ShowShadowProperty

Identifies the ShowShadow dependency property that controls whether the shadow effect is displayed alongside the main separator line.

Declaration

cs-api-definition

public static RadProperty ShowShadowProperty

Field Value

RadProperty

Properties

Line1

Gets the primary line primitive that renders the main separator line with a black color.

Declaration

cs-api-definition

public LinePrimitive Line1 { get; }

Property Value

LinePrimitive

Line2

Gets the secondary line primitive that renders the shadow effect with a light gray color when ShowShadow is enabled.

Declaration

cs-api-definition

public LinePrimitive Line2 { get; }

Property Value

LinePrimitive

Orientation

Gets or sets the orientation of the separator line, determining whether it is displayed horizontally or vertically.

Declaration

cs-api-definition

public Orientation Orientation { get; set; }

Property Value

Orientation

ShadowOffset

Gets or sets the pixel offset of the shadow effect relative to the main separator line. This value is only used when ShowShadow is true.

Declaration

cs-api-definition

public Point ShadowOffset { get; set; }

Property Value

Point

ShowShadow

Gets or sets a value indicating whether the shadow effect is displayed alongside the main separator line.

Declaration

cs-api-definition

public bool ShowShadow { get; set; }

Property Value

bool

Methods

ArrangeOverride(SizeF)

Arranges the child line primitives within the specified bounds, positioning them according to the orientation and shadow offset settings.

Declaration

cs-api-definition

protected override SizeF ArrangeOverride(SizeF finalSize)

Parameters

finalSize

SizeF

The final size that the element should use to arrange itself and its children

Returns

SizeF

The actual size used by the element

Overrides LightVisualElement.ArrangeOverride(SizeF)

CreateChildElements()

Creates the child line primitive elements that compose the visual separator, including the main line and optional shadow line.

Declaration

cs-api-definition

protected override void CreateChildElements()

Overrides RadElement.CreateChildElements()

InitializeFields()

Initializes the default field values for the separator element, setting horizontal orientation and disabling fill and border drawing.

Declaration

cs-api-definition

protected override void InitializeFields()

Overrides LightVisualElement.InitializeFields()

MeasureOverride(SizeF)

Measures the desired size of the separator element based on the orientation and shadow settings, ensuring proper layout calculation.

Declaration

cs-api-definition

protected override SizeF MeasureOverride(SizeF availableSize)

Parameters

availableSize

SizeF

The available size that the element can use for layout

Returns

SizeF

The desired size of the separator element based on its child line primitives and orientation

Overrides LightVisualElement.MeasureOverride(SizeF)

ClassSeparatorElement

Class
SeparatorElement