Class FillPrimitive

Represents a primitive element that renders background fills and gradients.

Inheritance
System.Object
DisposableObject
RadObject
RadElement
VisualElement
BasePrimitive
FillPrimitive
LinePrimitive
OutLookGripPrimitive
ProgressBarPrimitive
RadioPrimitive
TrackBarPrimitive
FormCaptionFillPrimitive
RulerPrimitive
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.Primitives
Assembly: Telerik.WinControls.dll

Syntax

public class FillPrimitive : BasePrimitive, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IStylableNode, IPrimitive, IFillElement, IPrimitiveElement, IShapedElement
Remarks

FillPrimitive is used to paint solid colors, gradients, and other fill patterns as the background of RadElements. It supports various gradient styles including linear, radial, elliptical, and more.

The fill can be configured with multiple colors (up to 4) and various gradient properties such as angle, percentage positions, and gradient style to create complex visual effects.

This primitive is commonly used as a background element in most Telerik controls to provide visual styling and theming capabilities.

Constructors

FillPrimitive()

Declaration
public FillPrimitive()

Fields

BackColor2Property

Declaration
public static RadProperty BackColor2Property
Field Value
RadProperty

BackColor3Property

Declaration
public static RadProperty BackColor3Property
Field Value
RadProperty

BackColor4Property

Declaration
public static RadProperty BackColor4Property
Field Value
RadProperty

GradientAngleProperty

Declaration
public static RadProperty GradientAngleProperty
Field Value
RadProperty

GradientPercentage2Property

Declaration
public static RadProperty GradientPercentage2Property
Field Value
RadProperty

GradientPercentageProperty

Declaration
public static RadProperty GradientPercentageProperty
Field Value
RadProperty

GradientStyleProperty

Declaration
public static RadProperty GradientStyleProperty
Field Value
RadProperty

NumberOfColorsProperty

Declaration
public static RadProperty NumberOfColorsProperty
Field Value
RadProperty

PaintUsingParentShapeProperty

Declaration
public static RadProperty PaintUsingParentShapeProperty
Field Value
RadProperty

Properties

BackColor2

Gets or sets background color. This property is applicable to radial, glass, office glass, gel, and vista gradients.

Declaration
[RadPropertyDefaultValue("BackColor2", typeof(FillPrimitive))]
public virtual Color BackColor2 { get; set; }
Property Value
System.Drawing.Color

Implements

BackColor3

Gets or sets background color. This property is applicable to radial, glass, office glass, and vista gradients.

Declaration
[RadPropertyDefaultValue("BackColor3", typeof(FillPrimitive))]
public virtual Color BackColor3 { get; set; }
Property Value
System.Drawing.Color

Implements

BackColor4

Gets or sets background color. This property is applicable to radial, glass, office glass, and vista gradients.

Declaration
[RadPropertyDefaultValue("BackColor4", typeof(FillPrimitive))]
public virtual Color BackColor4 { get; set; }
Property Value
System.Drawing.Color

Implements

FitToSizeMode

Declaration
public override RadFitToSizeMode FitToSizeMode { get; set; }
Property Value
RadFitToSizeMode

Overrides

GradientAngle

Gets or sets gradient angle for linear gradient.

Declaration
[RadPropertyDefaultValue("GradientAngle", typeof(FillPrimitive))]
public virtual float GradientAngle { get; set; }
Property Value
System.Single

Implements

GradientPercentage

Gets or sets GradientPercentage for linear, glass, office glass, gel, vista, and radial gradients.

Declaration
[RadPropertyDefaultValue("GradientPercentage", typeof(FillPrimitive))]
public virtual float GradientPercentage { get; set; }
Property Value
System.Single

Implements

GradientPercentage2

Gets or sets GradientPercentage for office glass, vista, and radial gradients.

Declaration
[RadPropertyDefaultValue("GradientPercentage2", typeof(FillPrimitive))]
public virtual float GradientPercentage2 { get; set; }
Property Value
System.Single

Implements

GradientStyle

Gets and sets the gradient style. The possible values are defined in the gradient style enumeration: solid, linear, radial, glass, office glass, gel, and vista.

Declaration
[RadPropertyDefaultValue("GradientStyle", typeof(FillPrimitive))]
public virtual GradientStyles GradientStyle { get; set; }
Property Value
GradientStyles

Implements

NumberOfColors

Gets or sets the number of used colors in the gradient effect.

Declaration
[RadPropertyDefaultValue("NumberOfColors", typeof(FillPrimitive))]
public virtual int NumberOfColors { get; set; }
Property Value
System.Int32

Implements

PaintUsingParentShape

Specifies whether the FillPrimitive should fill the GraphicsPath defined by its Parent.Shape. If false, it will fill its bounding rectangle.

Declaration
[RadPropertyDefaultValue("PaintUsingParentShape", typeof(FillPrimitive))]
public bool PaintUsingParentShape { get; set; }
Property Value
System.Boolean

ShouldPaintUsingParentShape

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

Overrides

ShouldUsePaintBufferState

This property is used internally!

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

Methods

GetDefaultValue(RadPropertyValue, Object)

Declaration
protected override object GetDefaultValue(RadPropertyValue propVal, object baseDefaultValue)
Parameters
RadPropertyValue propVal

System.Object baseDefaultValue

Returns
System.Object

Overrides

GetStylablePropertiesFilter()

Declaration
public override Filter GetStylablePropertiesFilter()
Returns
Filter

Overrides

InitializeFields()

Declaration
protected override void InitializeFields()
Overrides

OnBoundsChanged(RadPropertyChangedEventArgs)

Declaration
protected override void OnBoundsChanged(RadPropertyChangedEventArgs e)
Parameters
RadPropertyChangedEventArgs e

Overrides

OnPropertyChanged(RadPropertyChangedEventArgs)

Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters
RadPropertyChangedEventArgs e

Overrides

PaintPrimitive(IGraphics, Single, SizeF)

Draws the primitive on the screen.

Declaration
public override void PaintPrimitive(IGraphics g, float angle, SizeF scale)
Parameters
IGraphics g

System.Single angle

System.Drawing.SizeF scale

Overrides

ShouldSerializeProperty(PropertyDescriptor)

Declaration
public override bool? ShouldSerializeProperty(PropertyDescriptor property)
Parameters
System.ComponentModel.PropertyDescriptor property

Returns
System.Nullable<System.Boolean>

Overrides

ShouldUsePaintBuffer()

Declaration
protected virtual bool ShouldUsePaintBuffer()
Returns
System.Boolean

Explicit Interface Implementations

IPrimitiveElement.BorderThickness

Declaration
float IPrimitiveElement.BorderThickness { get; }
Returns
System.Single

Implements

IPrimitiveElement.GetExactPaintingRectangle(Single, SizeF)

Declaration
RectangleF IPrimitiveElement.GetExactPaintingRectangle(float angle, SizeF scale)
Parameters
System.Single angle

System.Drawing.SizeF scale

Returns
System.Drawing.RectangleF

Implements

IPrimitiveElement.GetPaintRectangle(Single, Single, SizeF)

Declaration
RectangleF IPrimitiveElement.GetPaintRectangle(float left, float angle, SizeF scale)
Parameters
System.Single left

System.Single angle

System.Drawing.SizeF scale

Returns
System.Drawing.RectangleF

Implements

IPrimitiveElement.IsDesignMode

Declaration
bool IPrimitiveElement.IsDesignMode { get; }
Returns
System.Boolean

Implements

IPrimitiveElement.ShouldUsePaintBuffer()

Declaration
bool IPrimitiveElement.ShouldUsePaintBuffer()
Returns
System.Boolean

Implements

IShapedElement.GetCurrentShape()

Declaration
ElementShape IShapedElement.GetCurrentShape()
Returns
ElementShape

Implements

Extension Methods