FocusPrimitive
Represents a primitive element that renders focus indicators for UI controls.
FocusPrimitive is responsible for drawing focus rectangles and other visual indicators that show when a control has keyboard focus. It typically renders a dotted or dashed border around the focused element to provide clear visual feedback to users.
The primitive supports various focus styles including standard Windows focus rectangles, custom border styles, and gradient-based focus indicators. It works in conjunction with BorderPrimitive to provide comprehensive focus visualization.
FocusPrimitive is essential for accessibility compliance and keyboard navigation support, ensuring that users can clearly identify which control currently has input focus.
Definition
Namespace:Telerik.WinControls.Primitives
Assembly:Telerik.WinControls.dll
Syntax:
public class FocusPrimitive : BasePrimitive, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IStylableNode, IPrimitiveInheritance: objectDisposableObjectRadObjectRadElementVisualElementBasePrimitiveFocusPrimitive...
Implements:
Inherited Members
Constructors
Fields
public static readonly RadProperty BorderBoxStylePropertypublic static RadProperty ForeColor2Propertypublic static RadProperty ForeColor3Propertypublic static RadProperty ForeColor4Propertypublic static RadProperty GradientAnglePropertypublic static RadProperty GradientStylePropertypublic static RadProperty InnerColor2Propertypublic static RadProperty InnerColor3Propertypublic static RadProperty InnerColor4Propertypublic static RadProperty InnerColorPropertyProperties
Gets or sets the border box style for the focus indicator.
public BorderBoxStyle BoxStyle { get; set; }A BorderBoxStyle value that determines how the focus border is rendered.
The box style affects how the focus border appears, including whether it's a single border, four separate borders, or outer and inner borders for enhanced visibility.
Gets or sets a value indicating the way element will fill its available size when parent element is calculating element size and location.
public override RadFitToSizeMode FitToSizeMode { get; set; }Overrides:
Gets or sets color used by radial, glass, office glass, gel, and vista gradients. This is one of the colors that are used in the gradient effect.
[TypeConverter(typeof(RadColorEditorConverter))]
public virtual Color ForeColor2 { get; set; }Gets or sets color used by radial, glass, office glass, and vista gradients. This is one of the colors that are used in the gradient effect.
[TypeConverter(typeof(RadColorEditorConverter))]
public virtual Color ForeColor3 { get; set; }Gets or sets color used by radial, glass, office glass, and vista gradients. This is one of the colors that are used in the gradient effect.
[TypeConverter(typeof(RadColorEditorConverter))]
public virtual Color ForeColor4 { get; set; }Gets or sets gradient angle for linear gradient measured in degrees.
public float GradientAngle { get; set; }Gets or sets gradient style. Possible styles are solid, linear, radial, glass, office glass, gel, and vista.
public GradientStyles GradientStyle { get; set; }Gets or sets color used by radial, glass, office glass, gel, and vista gradients. This is one of the colors that are used in the gradient effect.
[TypeConverter(typeof(RadColorEditorConverter))]
public virtual Color InnerColor { get; set; }Gets or sets color used by radial, glass, office glass, gel, and vista gradients. This is one of the colors that are used in the gradient effect.
[TypeConverter(typeof(RadColorEditorConverter))]
public virtual Color InnerColor2 { get; set; }Gets or sets color used by radial, glass, office glass, gel, and vista gradients. This is one of the colors that are used in the gradient effect.
[TypeConverter(typeof(RadColorEditorConverter))]
public virtual Color InnerColor3 { get; set; }Gets or sets color used by radial, glass, office glass, gel, and vista gradients. This is one of the colors that are used in the gradient effect.
[TypeConverter(typeof(RadColorEditorConverter))]
public virtual Color InnerColor4 { get; set; }Methods
Initializes member fields to their default values. This method is called prior the CreateChildItems one and allows for initialization of members on which child elements depend.
protected override void InitializeFields()Overrides:
When overridden in a derived class, performs the actual painting of the primitive.
public override void PaintPrimitive(IGraphics graphics, float angle, SizeF scale)The IGraphics object used for painting operations.
anglefloatThe rotation angle in degrees to apply during painting.
scaleSizeFThe scaling factor to apply during painting.
Overrides:
This is the core method that derived primitive classes must override to implement their specific rendering logic. The base implementation is empty and should be overridden.