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

Represents a lightweight visual element that supports text, border, image, background color, and foreground color with various layout adjustments. This element provides efficient rendering capabilities for common UI scenarios while implementing text and image primitive interfaces.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
public class LightVisualElement : UIItemBase, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider

Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElement...

Derived Classes: AIPromptButtonsContainerAIPromptOutputVisualItemAIPromptToolbarAIPromptToolbarItemAIPromptViewBaseRadAIPromptElementAlertWindowButtonsPanelAlertWindowCaptionGripAlertWindowContentElementAlertWindowTextAndSystemButtonsElementArrowElementBackstageVisualElementBaseChatCardElementBaseChatItemElementBaseChatOverlayBaseListViewVisualItemBaseMapElementBaseTimeSpanPickerUIComponentBaseWaitingBarIndicatorElementBaseWizardElementRadCalculatorTextAreaElementCalendarVisualElementCardViewEditorItemChartTitleElementChartWrapperChatEditPreviewElementChatMessageActionsElementChatMessageAvatarElementChatMessageBubbleElementChatMessageNameElementChatMessageStatusElementChatReplyBubbleElementChatReplyPreviewBubbleElementChatReplyPreviewElementChatToolbarScrollLeftButtonElementChatToolbarScrollRightButtonElementCollapsiblePanelButtonElementCollapsiblePanelTextElementColorEditorColorBoxAIChatMainMessageElementAIChatTitleElementDataFilterEditorElementDescriptionContentListVisualItemDetailListViewCellElementDraggableLayoutControlOverlayElementDrillBackButtonExpanderItemFilterMenuCalendarElementFilterMenuListElementFilterMenuTreeElementBaseFilterViewCategoryElementFilterViewCategoryExpandButtonElementFilterViewHeaderElementFlightCardAirportInfoFormulaBarButtonsElementFormulaBarNameBoxElementFormulaBarTextBoxElementGanttIndentCellElementGanttViewTimelineItemBottomStackElementGanttViewTimelineItemElementGanttViewVisualElementGaugeVisualElementRadLinearGaugeElementRadRadialGaugeElementGridAIWaitingElementGridGroupHeaderItemGridGroupHeaderItemsContainerGridGroupHeaderListGridHeaderElementGridHyperlinkCellContentElementGridTableBodyElementGridVisualElementGroupPanelSizeGripElementHeaderPresenterElementHeatMapTitleElementLegendItemGradientLegendItemHeaderElementLegendItemMarkerLegendItemTitleLegendTitleElementHorizontalScrollableStackElementImageEditorCanvasElementImageEditorCommandsElementImageEditorZoomElementInnerItemInnerItemLayoutElementLayoutControlContainerElementLayoutControlItemBaseLegendItemMarkerLegendItemTitleLegendTitleElementLightVisualButtonElementLiveTileFrameElementMapCopyrightLabelElementMapLegendElementMapLegendItemColorElementMapLegendItemElementMapLegendItemTextElementMapLegendSubtitleElementMapLegendTitleElementMapNavigationBarElementMapNavigationElementMapScaleIndicatorElementMapSearchBarElementMapSearchIconElementBaseNavigationElementNavigationElementLayoutNavigationViewBackgroundItemNavigationViewHeaderElementOverlayPopupElementPdfSignatureElementPdfSizeGripElementPictureBoxBasePanelElementPictureBoxCanvasElementPipsContainerPipsPagerItemPivotCellElementPivotDescriptorContainerPivotFieldDescriptorElementPivotFilterFunctionButtonPivotFilterMenuTreeElementPivotGroupElementProgressBarTextElementProgressIndicatorElementPromptInputAttachedFilesElementPromptInputButtonsPanelElementPropertyGridContentElementPropertyGridErrorIndicatorElementPropertyGridHelpContentElementPropertyGridHelpElementPropertyGridHelpTitleElementPropertyGridItemElementBasePropertyGridSizeGripElementPropertyGridSplitElementPropertyValueButtonElementRadBreadCrumbElementRadCalculatorButtonRadCalculatorContentElementRadCalculatorElementRadCalculatorMemoryElementRadCalendarFastNavigationElementRadChartElementRadChatElementRadClockElementRadCollapsiblePanelElementRadCommandBarArrowButtonRadCommandBarOverflowPanelElementRadCommandBarVisualElementRadDataLayoutElementRadDesktopAlertElementRadDiagramElementRadDropDownListEditableAreaElementRadFilterViewElementRadFixedPageElementRadGanttViewElementRadGroupBoxElementRadHeatMapElementRadImageEditorElementRadListViewElementRadListVisualItemRadPageViewElementBaseRadPanoramaElementRadPdfViewerContainerRadPictureBoxElementRadPivotGridElementRadProgressBarElementRadPromptInputElementRadRibbonBarElementRadSparklineElementRadSpeechToTextButtonElementRadSpreadsheetElementRadSpreadsheetFormulaBarRadSpreadsheetSheetSelectorRadSpreadsheetStatusBarRadStepProgressBarElementRadTabbedFormControlCaptionRadTabbedFormControlContentAreaElementRadTabbedFormControlElementRadTabbedFormControlItemRadTabbedFormControlTabsElementRadTaskBoardColumnElementRadTaskBoardColumnHeaderElementRadTaskBoardElementRadTaskCardElementRadTaskCardTagElementRadTaskCardUserElementRadTaskDialogFootnoteRadTaskDialogIconRadTaskDialogPageRadTaskDialogProgressBarRadTileElementRadTimePickerContentElementRadTimeSpanPickerContentElementRadToggleSwitchElementRadToolbarFormControlElementRadTreeMapElementRadVirtualGridElementRadVirtualKeyboardElementRadWaitingBarElementRadWebCamElementRadWizardElementRangeSelectorVisualElementRibbonFormElementSchedulerNavigatorElementSchedulerVisualElementScrollViewElementContainerScrollViewElement<T>SeparatorElementSheetSelectorTabItemBaseSheetTabItemsContainerElementSparkWrapperSplashScreenLightVisualElementWatermarkTextElementContainerSpreadsheetAIPanelElementSpreadsheetSheetSelectorGripElementStackLayoutElementStackLayoutElementLiteStepConnectionElementStepContentElementStepItemIndicatorElementStepProgressItemSuggestedActionElementTabbedFormElementRadTaskDialogCommandAreaRadTaskDialogContentAreaRadTaskDialogControlElementRadTaskDialogHeaderLayoutTaskDialogExpanderButtonElementTaskDialogLightVisualElementTextBoxWrapPanelTileGroupElementTimeHeaderArrowTimePickerDoneButtonElementTimeSpanPickerDoneButtonElementTimeTableVisualElementToggleSwitchPartElementToggleSwitchThumbElementToolbarActionElementToolbarFormElementTrackBarVisualElementTrackballInfoElementLegendItemMarkerLegendItemTitleLegendTitleElementTreeMapTitleElementTreeNodeImageElementTreeViewVisualValidationHelperElementVirtualGridCellElementVirtualGridDetailViewCellElementVirtualGridPagingPanelElementVirtualGridRowElementVirtualGridWaitingElementWaitingBarContentElementWaitingBarSeparatorElementWaitingBarTextElementWizardPageWizardViewSecondaryTextElementThumb...

Implements: IBindableComponentIBorderElementIBoxElementIBoxStyleIComponentICustomTypeDescriptorIDisposableIDrawFillElementIFillElementIImageElementINotifyPropertyChangedIPrimitiveElementIShapedElementIShortcutProviderIStylableElementIStylableNodeISupportDragISupportDropISupportSystemSkinITextPrimitiveITextProvider...

Inherited Members UIItemBase.PaintFill(IGraphics, float, SizeF)UIItemBase.GetFillPaintRect(float, SizeF)UIItemBase.PaintFill(IGraphics, float, SizeF, RectangleF)UIItemBase.PaintBorder(IGraphics, float, SizeF)UIItemBase.PaintBorder(IGraphics, float, SizeF, RectangleF)UIItemBase.OnBoundsChanged(RadPropertyChangedEventArgs)UIItemBase.GetBorderPaintRect(float, SizeF)UIItemBase.ShouldUsePaintBuffer()RadItem.KeyDownEventRadItem.KeyPressEventRadItem.KeyUpEventRadItem.FocusCommandRadItem.ActionCommandRadItem.UseDefaultDisabledPaintPropertyRadItem.TextPropertyRadItem.TextOrientationPropertyRadItem.FlipTextPropertyRadItem.IsAddNewItemPropertyRadItem.ToolTipTextPropertyRadItem.EnableElementShadowPropertyRadItem.ShadowDepthPropertyRadItem.ShadowColorPropertyRadItem.IsPaintingRippleRadItem.EnableRippleAnimationPropertyRadItem.RippleAnimationColorPropertyRadItem.EnableFocusBorderPropertyRadItem.FocusBorderColorPropertyRadItem.FocusBorderWidthPropertyRadItem.EnableFocusBorderAnimationPropertyRadItem.EnableHighlightPropertyRadItem.HighlightColorPropertyRadItem.EnableBorderHighlightPropertyRadItem.BorderHighlightColorPropertyRadItem.BorderHighlightThicknessPropertyRadItem.VisualStatePropertyRadItem.SetOwnerCollection(RadItemOwnerCollection)RadItem.Select()RadItem.OnSelect()RadItem.Deselect()RadItem.OnDeselect()RadItem.DoKeyDown(KeyEventArgs)RadItem.DoKeyPress(KeyPressEventArgs)RadItem.DoKeyUp(KeyEventArgs)RadItem.OnKeyDown(KeyEventArgs)RadItem.OnKeyPress(KeyPressEventArgs)RadItem.OnKeyUp(KeyEventArgs)RadItem.RaiseBubbleEvent(RadElement, RoutedEventArgs)RadItem.OnPropertyChanging(RadPropertyChangingEventArgs)RadItem.OnEnabledChanged(RadPropertyChangedEventArgs)RadItem.OnTextChanging(TextChangingEventArgs)RadItem.OnTextChanged(EventArgs)RadItem.OnTextOrientationChanged(EventArgs)RadItem.OnFlipTextChanged(EventArgs)RadItem.PaintOverride(IGraphics, Rectangle, float, SizeF, bool)RadItem.OnMouseDown(MouseEventArgs)RadItem.OnMouseUp(MouseEventArgs)RadItem.OnMouseLeave(EventArgs)RadItem.StartRippleAnimation(MouseEventArgs)RadItem.UpdateFocusBorder(bool)RadItem.ContainsText()RadItem.ProcessDialogKey(Keys)RadItem.ProcessCmdKey(ref Message, Keys)RadItem.RaiseKeyDown(KeyEventArgs)RadItem.RaiseKeyPress(KeyPressEventArgs)RadItem.RaiseKeyUp(KeyEventArgs)RadItem.ReplaceDefaultDescriptors(PropertyDescriptorCollection)RadItem.CallOnGesture(GestureEventArgs)RadItem.OnGesture(GestureEventArgs)RadItem.OnTwoFingerTapGesture(GestureEventArgs)RadItem.OnPressAndTapGesture(PressAndTapGestureEventArgs)RadItem.OnPanGesture(PanGestureEventArgs)RadItem.OnRotateGesture(RotateGestureEventArgs)RadItem.OnZoomGesture(ZoomGestureEventArgs)RadItem.CanDragCore(Point)RadItem.GetDragContextCore()RadItem.GetDragHintCore()RadItem.ProcessDragDrop(Point, ISupportDrag)RadItem.ProcessDragOver(Point, ISupportDrag)RadItem.ProcessDragEnter(Point, ISupportDrag)RadItem.ProcessDragLeave(Point, ISupportDrag)RadItem.UpdateOnShortcutsChanged()RadItem.CanHandleShortcut(ShortcutEventArgs)RadItem.IsOnActiveForm(Control, bool)RadItem.SetThemeValueOverride(RadProperty, object, string)RadItem.SetThemeValueOverride(RadProperty, object, string, string)RadItem.SetThemeValueOverride(RadProperty, object, string, Type)RadItem.ResetThemeValueOverride(RadProperty)RadItem.ResetThemeValueOverride(RadProperty, string)RadItem.ResetThemeValueOverrides()RadItem.GetAvailableVisualStates()RadItem.ShouldFallbackToDefaultTheme()RadItem.UseDefaultDisabledPaintRadItem.TextOrientationRadItem.FlipTextRadItem.CanHaveOwnStyleRadItem.TextRadItem.SelectableRadItem.DefaultAutoToolTipRadItem.ShouldHandleMouseInputRadItem.KeyTipRadItem.ParentItemRadItem.ShortcutsHandlerRadItem.EnableElementShadowRadItem.ShadowDepthRadItem.ShadowColorRadItem.EnableRippleAnimationRadItem.RippleAnimationColorRadItem.EnableFocusBorderRadItem.FocusBorderColorRadItem.FocusBorderWidthRadItem.EnableFocusBorderAnimationRadItem.EnableHighlightRadItem.HighlightColorRadItem.EnableBorderHighlightRadItem.BorderHighlightColorRadItem.BorderHighlightThicknessRadItem.MnemonicTextRadItem.ToolTipTextRadItem.ThemeRoleRadItem.VisualStateRadItem.StateManagerRadItem.AllowDragRadItem.AllowDropRadItem.ShortcutsRadItem.AccessibleDescriptionRadItem.AccessibleNameRadItem.AccessibleRoleRadItem.TextChangingRadItem.TextChangedRadItem.TextOrientationChangedRadItem.FlipTextChangedRadItem.QueryAccessibilityHelpRadItem.KeyDownRadItem.KeyPressRadItem.KeyUpRadItem.ZoomGestureRadItem.RotateGestureRadItem.PanGestureRadItem.TwoFingerTapGestureRadItem.PressAndTapGestureRadComponentElement.ToString()RadComponentElement.GetService(Type)RadComponentElement.CanRaiseEventsRadComponentElement.ContainerRadComponentElement.DesignModeRadComponentElement.SiteRadComponentElement.DataBindingsVisualElement.DefaultSizePropertyVisualElement.ForeColorPropertyVisualElement.BackColorPropertyVisualElement.FontPropertyVisualElement.SmoothingModePropertyVisualElement.OpacityPropertyVisualElement.CustomFontPropertyVisualElement.CustomFontSizePropertyVisualElement.CustomFontStylePropertyVisualElement.OnFontChanged(EventArgs)VisualElement.PaintChildren(IGraphics, Rectangle, float, SizeF, bool)VisualElement.PrePaintElement(IGraphics)VisualElement.PostPaintElement(IGraphics)VisualElement.GetScaledFont(float)VisualElement.GetScaledFont(float, Font)VisualElement.DefaultSizeVisualElement.ForeColorVisualElement.BackColorVisualElement.FontVisualElement.CustomFontVisualElement.CustomFontSizeVisualElement.CustomFontStyleVisualElement.SmoothingModeVisualElement.OpacityVisualElement.FontChangedRadElement.BoundsPropertyRadElement.BorderThicknessPropertyRadElement.PaddingPropertyRadElement.MarginPropertyRadElement.AlignmentPropertyRadElement.AutoSizeModePropertyRadElement.FitToSizeModePropertyRadElement.MinSizePropertyRadElement.EnabledPropertyRadElement.CanFocusPropertyRadElement.IsItemFocusedPropertyRadElement.IsFocusedPropertyRadElement.IsMouseOverPropertyRadElement.IsMouseOverElementPropertyRadElement.IsMouseDownPropertyRadElement.ShouldPaintPropertyRadElement.VisibilityPropertyRadElement.NamePropertyRadElement.ClassPropertyRadElement.ClipDrawingPropertyRadElement.ShapePropertyRadElement.MouseClickedEventRadElement.MouseDoubleClickedEventRadElement.MouseDownEventRadElement.MouseUpEventRadElement.MouseWheelEventRadElement.ChildElementAddedEventRadElement.ParentChangedEventRadElement.BoundsChangedEventRadElement.VisibilityChangingEventRadElement.EnabledChangedEventRadElement.ControlChangedEventRadElement.BackgroundShapePropertyRadElement.BackgroundShapePaintModePropertyRadElement.ContainsFocusPropertyRadElement.ContainsMousePropertyRadElement.MaxSizePropertyRadElement.RightToLeftPropertyRadElement.AutoSizePropertyRadElement.ZIndexPropertyRadElement.AngleTransformPropertyRadElement.ScaleTransformPropertyRadElement.PositionOffsetPropertyRadElement.TagPropertyRadElement.StretchHorizontallyPropertyRadElement.StretchVerticallyPropertyRadElement.UseCompatibleTextRenderingPropertyRadElement.ClickModePropertyRadElement.styleVersionRadElement.paintSystemSkinRadElement.SetPropertyValueCommandRadElement.GetPropertyValueCommandRadElement.StylePropertyRadElement.CallCreateChildElements()RadElement.SuspendReferenceUpdate()RadElement.ResumeReferenceUpdate()RadElement.CreateChildElements()RadElement.OnLoad(bool)RadElement.LoadCore()RadElement.OnUnload(ComponentThemableElementTree, bool)RadElement.UnloadCore(ComponentThemableElementTree)RadElement.OnUnloaded(ComponentThemableElementTree)RadElement.OnElementTreeChanged(ComponentThemableElementTree)RadElement.OnBeginDispose()RadElement.SetParent(RadElement)RadElement.OnParentChanged(RadElement)RadElement.UpdateReferences(ComponentThemableElementTree, bool, bool)RadElement.ResetLayout(bool)RadElement.HasInvisibleAncestor()RadElement.ResetLayoutCore()RadElement.InvalidateArrange()RadElement.InvalidateArrange(bool)RadElement.InvalidateMeasure()RadElement.InvalidateMeasure(bool)RadElement.UpdateLayout()RadElement.SuspendLayout()RadElement.SuspendLayout(bool)RadElement.ResumeLayout(bool)RadElement.ResumeLayout(bool, bool)RadElement.Arrange(RectangleF)RadElement.Measure(SizeF)RadElement.SetBounds(Rectangle)RadElement.SetBounds(int, int, int, int)RadElement.GetBoundingRectangle(Size)RadElement.GetBoundingRectangle(Rectangle)RadElement.GetDesiredSize(bool)RadElement.PointToScreen(Point)RadElement.PointFromScreen(Point)RadElement.PointToControl(Point)RadElement.PointFromControl(Point)RadElement.LocationToControl()RadElement.RectangleToScreen(Rectangle)RadElement.HitTest(Point)RadElement.OnRenderSizeChanged(SizeChangedInfo)RadElement.OnChildDesiredSizeChanged(RadElement)RadElement.OnLayoutPropertyChanged(RadPropertyChangedEventArgs)RadElement.ArrangeCore(RectangleF)RadElement.MeasureCore(SizeF)RadElement.ShouldArrangeChild(RadElement)RadElement.ShouldMeasureChild(RadElement)RadElement.MeasureChildren(SizeF)RadElement.GetArrangeRect(RectangleF)RadElement.CanExecuteLayoutOperation()RadElement.CalcLayoutOffset(PointF)RadElement.LockBounds()RadElement.UnlockBounds()RadElement.SetBoundsCore(Rectangle)RadElement.IsInValidState(bool)RadElement.Invalidate()RadElement.Invalidate(bool)RadElement.GetInvalidateBounds()RadElement.NotifyInvalidate(RadElement)RadElement.OnTransformationInvalidated()RadElement.PerformLayoutTransformation(ref RadMatrix)RadElement.PerformPaintTransformation(ref RadMatrix)RadElement.IsInGetAsBitmap()RadElement.PaintElementSkin(IGraphics)RadElement.PaintBackgroundShape(IGraphics)RadElement.PostPaintChildren(IGraphics, Rectangle, float, SizeF)RadElement.PaintChild(RadElement, IGraphics, Rectangle, float, SizeF, bool)RadElement.PaintShadow(RadElement, IGraphics)RadElement.PaintShadowCore(Graphics, Rectangle, RadItem)RadElement.GetShadowRect(ref Rectangle, int)RadElement.PaintFocusCues(IGraphics, Rectangle)RadElement.GetAsBitmap(IGraphics, Brush, float, SizeF)RadElement.GetAsTransformedBitmap(IGraphics, Brush, float, SizeF)RadElement.GetAsTransformedBitmap(Brush, float, SizeF)RadElement.GetAsTransformedBitmap(Rectangle, Brush, float, SizeF)RadElement.GetAsBitmapEx(Brush, float, SizeF)RadElement.GetAsBitmap(Brush, float, SizeF)RadElement.IsInVisibleClipBounds(Rectangle)RadElement.SetClipping(Graphics)RadElement.ShouldPaintChild(RadElement)RadElement.GetFocusRect()RadElement.GetCurrentShape()RadElement.GetPaintRectangle(float, float, SizeF)RadElement.GetPatchedRect(RectangleF, float, SizeF)RadElement.GetXPVisualStyle()RadElement.GetVistaVisualStyle()RadElement.InitializeSystemSkinPaint()RadElement.UnitializeSystemSkinPaint()RadElement.GetSystemSkinPaintBounds()RadElement.OnUseSystemSkinChanged(EventArgs)RadElement.ShouldPaintSystemSkin()RadElement.ComposeShouldPaintSystemSkin()RadElement.ResetStyleSettings(bool)RadElement.ResetStyleSettings(bool, RadProperty)RadElement.ProcessBehaviors(RadPropertyChangedEventArgs)RadElement.AddBehavior(PropertyChangeBehavior)RadElement.GetBehaviors()RadElement.RemoveBehavior(PropertyChangeBehavior)RadElement.ClearBehaviors()RadElement.AddRangeBehavior(PropertyChangeBehaviorCollection)RadElement.SetThemeApplied(bool)RadElement.OnStyleChanged(RadPropertyChangedEventArgs)RadElement.UnapplyStyle()RadElement.RemoveRangeBehaviors(PropertyChangeBehaviorCollection)RadElement.RemoveBehaviors(PropertyChangeBehavior)RadElement.RemoveRangeRoutedEventBehaviors(RoutedEventBehaviorCollection)RadElement.GetThemeEffectiveType()RadElement.GetChildrenByType(Type)RadElement.GetChildrenByBaseType(Type)RadElement.FindAncestorByThemeEffectiveType(Type)RadElement.FindAncestor<T>()RadElement.IsAncestorOf(RadElement)RadElement.FindDescendant<T>()RadElement.FindDescendant(Predicate<RadElement>)RadElement.FindDescendant(Type)RadElement.EnumDescendants(TreeTraversalMode)RadElement.EnumDescendants(Predicate<RadElement>, TreeTraversalMode)RadElement.EnumDescendants(Filter, TreeTraversalMode)RadElement.GetDescendants(Predicate<RadElement>, TreeTraversalMode)RadElement.GetDescendants(Filter, TreeTraversalMode)RadElement.GetAncestors(Filter)RadElement.GetAncestors(Predicate<RadElement>)RadElement.RaiseRoutedEvent(RadElement, RoutedEventArgs)RadElement.RaiseTunnelEvent(RadElement, RoutedEventArgs)RadElement.OnBubbleEvent(RadElement, RoutedEventArgs)RadElement.IsEventInProcess(RaisedRoutedEvent)RadElement.RegisterRoutedEvent(string, Type)RadElement.GetRegisterRoutedEvent(string, Type)RadElement.GetRegisterRoutedEvent(string, string)RadElement.GetRegisterRoutedEvent(string)RadElement.OnChildrenChanged(RadElement, ItemsChangeOperation)RadElement.GetChildren(ChildrenListOptions)RadElement.SendToBack()RadElement.BringToFront()RadElement.IsChildOf(RadElement)RadElement.Focus()RadElement.Focus(bool)RadElement.SetFocusPropertySafe(bool)RadElement.KillFocus()RadElement.OnCLREventsRise(RoutedEventArgs)RadElement.OnMouseHover(EventArgs)RadElement.OnParentEnabledChanged(RadPropertyChangedEventArgs)RadElement.OnLostMouseCapture(MouseEventArgs)RadElement.OnClick(EventArgs)RadElement.OnDoubleClick(EventArgs)RadElement.OnMouseEnter(EventArgs)RadElement.PerformClick()RadElement.OnMouseWheel(MouseEventArgs)RadElement.DoMouseWheel(MouseEventArgs)RadElement.DoClick(EventArgs)RadElement.DoDoubleClick(EventArgs)RadElement.IsInputKey(InputKeyEventArgs)RadElement.MouseEventArgsFromControl(MouseEventArgs)RadElement.DoMouseDown(MouseEventArgs)RadElement.DoMouseUp(MouseEventArgs)RadElement.DoMouseMove(MouseEventArgs)RadElement.ShowScreenTip(ScreenTipNeededEventArgs)RadElement.HideScreenTip()RadElement.DoMouseHover(EventArgs)RadElement.OnShowScreenTip(ComponentInputBehavior)RadElement.RaiseClick(EventArgs)RadElement.RaiseDoubleClick(EventArgs)RadElement.RaiseMouseWheel(MouseEventArgs)RadElement.UpdateContainsFocus(bool)RadElement.DoMouseEnter(EventArgs)RadElement.DoMouseLeave(EventArgs)RadElement.GetValue(RadProperty)RadElement.AddStylePropertySetting(IPropertySetting)RadElement.SetValueCore(RadPropertyValue, object, object, ValueSource)RadElement.NotifyChildren(RadPropertyChangedEventArgs)RadElement.OnLocationChanged(RadPropertyChangedEventArgs)RadElement.OnDisplayPropertyChanged(RadPropertyChangedEventArgs)RadElement.CanRaisePropertyChangeNotifications(RadPropertyValue)RadElement.IsPropertyCancelable(RadPropertyMetadata)RadElement.OnParentPropertyChanged(RadPropertyChangedEventArgs)RadElement.PerformDispose(bool)RadElement.DisposeChildren()RadElement.GetStylableChildrenHierarchy()RadElement.GetStylableChildren()RadElement.GetBorderThickness(BorderPrimitive)RadElement.DpiScaleChanged(SizeF)RadElement.ElementStateRadElement.DesiredSizeRadElement.IsLayoutSuspendedRadElement.BoundingRectangleRadElement.ControlBoundingRectangleRadElement.BypassLayoutPoliciesRadElement.IsArrangeValidRadElement.IsMeasureValidRadElement.TreeLevelRadElement.TransformRadElement.TotalTransformRadElement.ShouldPaintUsingParentShapeRadElement.UseSystemSkinRadElement.PropagateStyleToChildrenRadElement.ThemeEffectiveTypeRadElement.ElementTreeRadElement.ChildrenRadElement.ChildrenHierarchyRadElement.ParentRadElement.RoutedEventBehaviorsRadElement.LayoutableChildrenCountRadElement.ContainsFocusRadElement.NotifyParentOnMouseInputRadElement.IsAbleToRespondToMouseEventsRadElement.AutoSizeRadElement.BoundsRadElement.LocationRadElement.SizeRadElement.BorderThicknessRadElement.PaddingRadElement.MarginRadElement.AlignmentRadElement.AutoSizeModeRadElement.FitToSizeModeRadElement.EnabledRadElement.IsFocusedRadElement.IsMouseOverRadElement.IsMouseOverElementRadElement.IsMouseDownRadElement.InvalidateChildrenOnChildChangedRadElement.VisibilityRadElement.IsElementVisibleRadElement.NameRadElement.ClassRadElement.ClipDrawingRadElement.ShapeRadElement.MinSizeRadElement.MaxSizeRadElement.ZIndexRadElement.RightToLeftRadElement.UseCompatibleTextRenderingRadElement.BackgroundShapeRadElement.BackgroundShapePaintModeRadElement.ContainsMouseRadElement.CaptureRadElement.ScaleTransformRadElement.AngleTransformRadElement.PositionOffsetRadElement.SerializePropertiesRadElement.SerializeElementRadElement.SerializeChildrenRadElement.RenderingMaxFramerateRadElement.IsThemeAppliedRadElement.ShouldApplyThemeRadElement.UseCenteredAngleTransformRadElement.TagRadElement.StretchHorizontallyRadElement.StretchVerticallyRadElement.ClickModeRadElement.DoubleClickEnabledRadElement.CaptureOnMouseDownRadElement.IsItemHoveredRadElement.StyleRadElement.AutoToolTipRadElement.ScreenTipRadElement.AutoNumberKeyTipRadElement.DpiScaleFactorRadElement.LayoutUpdatedRadElement.MouseHoverRadElement.MouseMoveRadElement.MouseDownRadElement.MouseUpRadElement.ClickRadElement.DoubleClickRadElement.MouseEnterRadElement.MouseWheelRadElement.EnabledChangedRadElement.MouseLeaveRadElement.ChildrenChangedRadElement.LostMouseCaptureRadObject.BindingContextPropertyRadObject.RadTypeRadObject.ClearPropertyStore()RadObject.SuspendPropertyNotifications()RadObject.ResumePropertyNotifications()RadObject.GetPropertyValue(RadProperty)RadObject.SetDefaultValueOverride(RadProperty, object)RadObject.SetValue(RadProperty, object)RadObject.ResetValue(RadProperty)RadObject.ResetLocalValue(RadProperty)RadObject.ResetValue(RadProperty, ValueResetFlags)RadObject.UpdateValue(RadProperty)RadObject.GetValueSource(RadProperty)RadObject.GetRegisteredRadProperty(string)RadObject.UpdateValueCore(RadPropertyValue)RadObject.ResetValueCore(RadPropertyValue, ValueResetFlags)RadObject.GetDefaultValue(RadPropertyValue, object)RadObject.CoerceValue(RadPropertyValue, object)RadObject.ShouldSerializeProperty(RadProperty)RadObject.BindProperty(RadProperty, RadObject, RadProperty, PropertyBindingOptions)RadObject.UnbindProperty(RadProperty)RadObject.GetInheritedValue(RadProperty)RadObject.OnNotifyPropertyChanged(string)RadObject.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadObject.OnShouldSerializeProperty(ShouldSerializePropertyEventArgs)RadObject.PropertyValuesRadObject.PropertyFilterRadObject.RadObjectTypeRadObject.BindingContextRadObject.PropertyChangedRadObject.RadPropertyChangedRadObject.RadPropertyChangingDisposableObject.GetBitState(long)DisposableObject.SetBitState(long, bool)DisposableObject.Dispose()DisposableObject.Dispose(bool)DisposableObject.DisposeUnmanagedResources()DisposableObject.BitStateDisposableObject.EventsDisposableObject.IsDisposingDisposableObject.IsDisposedDisposableObject.DisposedDisposableObject.Disposing...

Constructors

C#
public LightVisualElement()

Fields

Identifies the second background color used by multi-color fill styles.

C#
public static RadProperty BackColor2Property

Identifies the third background color used by multi-color fill styles.

C#
public static RadProperty BackColor3Property

Identifies the fourth background color used by multi-color fill styles.

C#
public static RadProperty BackColor4Property

Identifies how the background image is positioned and scaled within the element's bounds.

C#
public static RadProperty BackgroundImageLayoutProperty

Identifies the image painted behind the element's content; rendering also depends on DrawBackgroundImage and BackgroundImageLayout.

C#
public static RadProperty BackgroundImageProperty

Identifies the color used for the bottom edge in FourBorders mode.

C#
public static RadProperty BorderBottomColorProperty

Identifies the shadow color applied to the bottom border edge.

C#
public static RadProperty BorderBottomShadowColorProperty

Identifies the bottom-edge width used in FourBorders mode.

C#
public static RadProperty BorderBottomWidthProperty

Identifies whether the border uses one uniform outline, four independent edges, or nested outlines.

C#
public static RadProperty BorderBoxStyleProperty

Identifies the second color used by multi-color border gradient styles.

C#
public static RadProperty BorderColor2Property

Identifies the third color used by border gradient styles that support at least three colors.

C#
public static RadProperty BorderColor3Property

Identifies the fourth color used by border gradient styles that support four colors.

C#
public static RadProperty BorderColor4Property

Identifies the primary color used by solid and gradient border rendering.

C#
public static RadProperty BorderColorProperty

Identifies the custom dash-and-gap sequence used when the border dash style is custom.

C#
public static RadProperty BorderDashPatternProperty

Identifies the dash style applied to border lines.

C#
public static RadProperty BorderDashStyleProperty

Identifies which border edge is drawn over another when four-border edges overlap.

C#
public static RadProperty BorderDrawModeProperty

Identifies the angle in degrees used for a linear border gradient.

C#
public static RadProperty BorderGradientAngleProperty

Identifies the gradient style used to render the border colors.

C#
public static RadProperty BorderGradientStyleProperty

Identifies the second inner-border color used by OuterInnerBorders.

C#
public static RadProperty BorderInnerColor2Property

Identifies the third inner-border color used by OuterInnerBorders.

C#
public static RadProperty BorderInnerColor3Property

Identifies the fourth inner-border color used by OuterInnerBorders.

C#
public static RadProperty BorderInnerColor4Property

Identifies the first inner-border color used by OuterInnerBorders.

C#
public static RadProperty BorderInnerColorProperty

Identifies the color used for the left edge in FourBorders mode.

C#
public static RadProperty BorderLeftColorProperty

Identifies the shadow color applied to the left border edge.

C#
public static RadProperty BorderLeftShadowColorProperty

Identifies the left-edge width used in FourBorders mode.

C#
public static RadProperty BorderLeftWidthProperty

Identifies the color used for the right edge in FourBorders mode.

C#
public static RadProperty BorderRightColorProperty

Identifies the shadow color applied to the right border edge.

C#
public static RadProperty BorderRightShadowColorProperty

Identifies the right-edge width used in FourBorders mode.

C#
public static RadProperty BorderRightWidthProperty

Identifies the color used for the top edge in FourBorders mode.

C#
public static RadProperty BorderTopColorProperty

Identifies the shadow color applied to the top border edge.

C#
public static RadProperty BorderTopShadowColorProperty

Identifies the top-edge width used in FourBorders mode.

C#
public static RadProperty BorderTopWidthProperty

Identifies the uniform border width used in SingleBorder mode.

C#
public static RadProperty BorderWidthProperty

Identifies whether text is clipped to the calculated text-painting rectangle.

C#
public static RadProperty ClipTextProperty

Identifies the text-rendering mode used for disabled elements when default disabled painting is active.

C#
public static RadProperty DisabledTextRenderingHintProperty

Identifies whether the image behind the element's content is painted.

C#
public static RadProperty DrawBackgroundImageProperty

Identifies whether the element paints its border; layout can still reserve border thickness independently.

C#
public static RadProperty DrawBorderProperty

Identifies whether the element paints its background fill, including solid and gradient colors.

C#
public static RadProperty DrawFillProperty

Identifies whether the element's main image is painted.

C#
public static RadProperty DrawImageProperty

Identifies whether non-empty text is rendered by the element.

C#
public static RadProperty DrawTextProperty

Identifies whether transparent-color processing is enabled for images.

C#
public static RadProperty EnableImageTransparencyProperty

Identifies the direction, in degrees, of a linear background fill gradient.

C#
public static RadProperty GradientAngleProperty

Identifies the second color-distribution percentage used by background gradients.

C#
public static RadProperty GradientPercentage2Property

Identifies the first color-distribution percentage used by background gradients.

C#
public static RadProperty GradientPercentageProperty

Identifies the rendering style used for the element's background fill.

C#
public static RadProperty GradientStyleProperty

Identifies the color of the optional horizontal line.

C#
public static RadProperty HorizontalLineColorProperty

Identifies the width of the optional horizontal line; the rendered width is scaled for the current DPI.

C#
public static RadProperty HorizontalLineWidthProperty

Identifies the alignment of the main image within the element's bounds.

C#
public static RadProperty ImageAlignmentProperty

Identifies the index of the main image in the associated .

C#
public static RadProperty ImageIndexProperty

Identifies the key of the main image in the associated .

C#
public static RadProperty ImageKeyProperty

Identifies how the main image is positioned and scaled within the element's bounds.

C#
public static RadProperty ImageLayoutProperty

Identifies the opacity used for images; disabled rendering can override it through DisabledImageOpacity.

C#
public static RadProperty ImageOpacityProperty

Identifies the main image, whose placement is coordinated with text by ImageAlignment and TextImageRelation.

C#
public static RadProperty ImageProperty

Identifies the color treated as transparent when EnableImageTransparency is enabled.

C#
public static RadProperty ImageTransparentColorProperty

Identifies how many background colors participate in the fill, including additional colors such as BackColor2.

C#
public static RadProperty NumberOfColorsProperty

Identifies whether the element paints its optional horizontal line.

C#
public static RadProperty ShowHorizontalLineProperty

Identifies the scalable vector image associated with the element.

C#
public static RadProperty SvgImageProperty

Identifies the alignment of text within the element's bounds.

C#
public static RadProperty TextAlignmentProperty

Identifies how the text and main image are arranged relative to each other or overlaid.

C#
public static RadProperty TextImageRelationProperty

Identifies the rendering quality and anti-aliasing mode used for text.

C#
public static RadProperty TextRenderingHintProperty

Identifies whether text wraps to additional lines when it exceeds the available width.

C#
public static RadProperty TextWrapProperty

Properties

Gets or sets a value indicating whether automatic text ellipsis will be applied when text cannot fit within the available space.

C#
public bool AutoEllipsis { get; set; }

Implements: ITextProvider.AutoEllipsis

Gets or sets the second background color used in gradient fill effects for multi-color gradient styles.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BackColor2 { get; set; }

Overrides: UIItemBase.BackColor2

Gets or sets the third background color used in gradient fill effects for multi-color gradient styles.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BackColor3 { get; set; }

Overrides: UIItemBase.BackColor3

Gets or sets the fourth background color used in gradient fill effects for multi-color gradient styles.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BackColor4 { get; set; }

Overrides: UIItemBase.BackColor4

Gets or sets the background image displayed behind the element's content. This image is rendered according to the BackgroundImageLayout property.

C#
[TypeConverter(typeof(ImageTypeConverter))]
public virtual Image BackgroundImage { get; set; }

Gets or sets the layout mode for the background image, determining how it is positioned and scaled within the element bounds.

C#
public virtual ImageLayout BackgroundImageLayout { get; set; }

Gets or sets the color of the bottom border when using FourBorders style.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderBottomColor { get; set; }

Overrides: UIItemBase.BorderBottomColor

Gets or sets the shadow color for the bottom border, providing a visual depth effect when rendered.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderBottomShadowColor { get; set; }

Overrides: UIItemBase.BorderBottomShadowColor

Gets or sets the width of the bottom border when using FourBorders style. This value is automatically scaled based on the current DPI settings of the display.

C#
public override float BorderBottomWidth { get; set; }

Overrides: UIItemBase.BorderBottomWidth

Gets or sets the border drawing style that determines how border appearance is configured. SingleBorder applies uniform appearance to all sides, while FourBorders allows individual configuration of each side's color, width, and shadow properties.

C#
public override BorderBoxStyle BorderBoxStyle { get; set; }

Overrides: UIItemBase.BorderBoxStyle

Gets or sets the primary border color used for solid borders or as the first color in gradient border effects.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderColor { get; set; }

Overrides: UIItemBase.BorderColor

Gets or sets the second color used in gradient border effects for radial, glass, office glass, gel, and vista gradient styles.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderColor2 { get; set; }

Overrides: UIItemBase.BorderColor2

Gets or sets the third color used in gradient border effects for radial, glass, office glass, and vista gradient styles.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderColor3 { get; set; }

Overrides: UIItemBase.BorderColor3

Gets or sets the fourth color used in gradient border effects for radial, glass, office glass, and vista gradient styles.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderColor4 { get; set; }

Overrides: UIItemBase.BorderColor4

Gets or sets the custom dash pattern array for border rendering when using custom dashed line styles.

C#
public override float[] BorderDashPattern { get; set; }

Overrides: UIItemBase.BorderDashPattern

Gets or sets the style of dashed lines used for border rendering when dashed border effects are applied.

C#
public override DashStyle BorderDashStyle { get; set; }

Overrides: UIItemBase.BorderDashStyle

Gets or sets the drawing order for border lines when using FourBorders style. This property determines which border lines are drawn on top when borders overlap at corners.

C#
public override BorderDrawModes BorderDrawMode { get; set; }

Overrides: UIItemBase.BorderDrawMode

Gets or sets the angle in degrees for linear gradient borders. This property determines the direction of the gradient effect when BorderGradientStyle is set to linear gradient.

C#
public override float BorderGradientAngle { get; set; }

Overrides: UIItemBase.BorderGradientAngle

Gets or sets the gradient style for border rendering. Available styles include solid, linear, radial, glass, office glass, gel, and vista. Each style provides different visual effects for the border appearance.

C#
public override GradientStyles BorderGradientStyle { get; set; }

Overrides: UIItemBase.BorderGradientStyle

Gets or sets the primary inner border color used in outer-inner border configurations for gradient border effects.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderInnerColor { get; set; }

Overrides: UIItemBase.BorderInnerColor

Gets or sets the second inner border color used in outer-inner border configurations for gradient border effects.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderInnerColor2 { get; set; }

Overrides: UIItemBase.BorderInnerColor2

Gets or sets the third inner border color used in outer-inner border configurations for gradient border effects.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderInnerColor3 { get; set; }

Overrides: UIItemBase.BorderInnerColor3

Gets or sets the fourth inner border color used in outer-inner border configurations for gradient border effects.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderInnerColor4 { get; set; }

Overrides: UIItemBase.BorderInnerColor4

Gets or sets the color of the left border when using FourBorders style.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderLeftColor { get; set; }

Overrides: UIItemBase.BorderLeftColor

Gets or sets the shadow color for the left border, providing a visual depth effect when rendered.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderLeftShadowColor { get; set; }

Overrides: UIItemBase.BorderLeftShadowColor

Gets or sets the width of the left border when using FourBorders style. This value is automatically scaled based on the current DPI settings of the display.

C#
public override float BorderLeftWidth { get; set; }

Overrides: UIItemBase.BorderLeftWidth

Gets or sets the color of the right border when using FourBorders style.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderRightColor { get; set; }

Overrides: UIItemBase.BorderRightColor

Gets or sets the shadow color for the right border, providing a visual depth effect when rendered.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderRightShadowColor { get; set; }

Overrides: UIItemBase.BorderRightShadowColor

Gets or sets the width of the right border when using FourBorders style. This value is automatically scaled based on the current DPI settings of the display.

C#
public override float BorderRightWidth { get; set; }

Overrides: UIItemBase.BorderRightWidth

Gets or sets the color of the top border when using FourBorders style.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderTopColor { get; set; }

Overrides: UIItemBase.BorderTopColor

Gets or sets the shadow color for the top border, providing a visual depth effect when rendered.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public override Color BorderTopShadowColor { get; set; }

Overrides: UIItemBase.BorderTopShadowColor

Gets or sets the width of the top border when using FourBorders style. This value is automatically scaled based on the current DPI settings of the display.

C#
public override float BorderTopWidth { get; set; }

Overrides: UIItemBase.BorderTopWidth

Gets or sets the uniform width of all border sides when using SingleBorder style. This value is automatically scaled based on the current DPI settings of the display.

C#
public override float BorderWidth { get; set; }

Overrides: UIItemBase.BorderWidth

Gets or sets a value indicating whether the element can receive input focus.

C#
public override bool CanFocus { get; set; }

Overrides: RadElement.CanFocus

Gets or sets a value indicating whether text should be clipped to the calculated text painting rectangle boundaries.

C#
public bool ClipText { get; set; }

Gets or sets the opacity level applied to images when they are in a disabled state.

C#
public virtual double DisabledImageOpacity { get; set; }

If the value is set to a number outside the range 0.0 to 1.0, the property will use the value of the ImageOpacity property instead. The opacity value must be between 0.0 (fully transparent) and 1.0 (fully opaque).

Gets or sets the text rendering hint used specifically when this element is in a disabled state. This allows for different text rendering quality when the element is disabled versus enabled.

C#
public virtual TextRenderingHint DisabledTextRenderingHint { get; set; }

Gets or sets a value indicating whether HTML formatting in text content should be disabled, forcing plain text rendering.

C#
public bool DisableHTMLRendering { get; set; }

Gets or sets a value indicating whether the element should render its background image during the paint operation. This property controls the visibility of the image specified by the BackgroundImage property.

C#
public bool DrawBackgroundImage { get; set; }

Gets or sets a value indicating whether the element should render its border during the paint operation. This property controls the visibility of all border styles including single borders, four borders, and outer-inner borders.

C#
public override bool DrawBorder { get; set; }

Overrides: UIItemBase.DrawBorder

Gets or sets a value indicating whether the element should render its background fill during the paint operation. This property controls the visibility of gradient fills, solid colors, and other background painting effects.

C#
public override bool DrawFill { get; set; }

Overrides: UIItemBase.DrawFill

Gets or sets a value indicating whether the element should render its main image during the paint operation. This property controls the visibility of the image specified by the Image property.

C#
public bool DrawImage { get; set; }

Gets or sets a value indicating whether the element should render its text content during the paint operation. When set to false, the text will not be visible even if the text property is set.

C#
public virtual bool DrawText { get; set; }

Gets or sets a value indicating whether image transparency effects are enabled for this element.

C#
public bool EnableImageTransparency { get; set; }

Gets or sets the angle in degrees for linear gradient background effects. This determines the direction of the gradient.

C#
public override float GradientAngle { get; set; }

Overrides: UIItemBase.GradientAngle

Gets or sets the first gradient percentage that controls the distribution of colors in gradient background effects.

C#
public override float GradientPercentage { get; set; }

Overrides: UIItemBase.GradientPercentage

Gets or sets the second gradient percentage that controls the distribution of colors in gradient background effects.

C#
public override float GradientPercentage2 { get; set; }

Overrides: UIItemBase.GradientPercentage2

Gets or sets the gradient style for background fill rendering. Available styles include solid, linear, radial, glass, office glass, gel, and vista.

C#
public override GradientStyles GradientStyle { get; set; }

Overrides: UIItemBase.GradientStyle

Gets or sets the color of the horizontal line when ShowHorizontalLine is enabled.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public virtual Color HorizontalLineColor { get; set; }

Gets or sets the width in pixels of the horizontal line when ShowHorizontalLine is enabled. This value is automatically scaled based on current DPI settings.

C#
public virtual int HorizontalLineWidth { get; set; }

Gets or sets the main image displayed on the element. The image position is controlled by ImageAlignment and TextImageRelation properties.

C#
[TypeConverter(typeof(ImageTypeConverter))]
public virtual Image Image { get; set; }

Implements: IImageElement.Image

Gets or sets the alignment of the image within the element bounds, controlling both horizontal and vertical positioning.

C#
public virtual ContentAlignment ImageAlignment { get; set; }

Gets or sets the type of image to draw, determining whether to render bitmap images or SVG images based on availability and configuration. Determines whether the Image or SvgImage property will be painted. Note that if SvgImage == null, this property will always return "ImageDrawType.Image".

C#
[Browsable(false)]
public virtual ImageDrawType ImageDrawType { get; set; }

Gets or sets the index of the image from the associated to display on this element.

C#
[RelatedImageList("ElementTree.Control.ImageList")]
[TypeConverter("Telerik.WinControls.UI.Design.NoneExcludedImageIndexConverter, Telerik.WinControls.UI.Design, Version=2026.3.1026.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual int ImageIndex { get; set; }

Implements: IImageElement.ImageIndex

Gets or sets the key of the image from the associated to display on this element.

C#
[TypeConverter("Telerik.WinControls.UI.Design.RadImageKeyConverter, Telerik.WinControls.UI.Design, Version=2026.3.1026.48, Culture=neutral, PublicKeyToken=5bb2a467cbec794e")]
public virtual string ImageKey { get; set; }

Implements: IImageElement.ImageKey

Gets or sets the layout mode for the main image, determining how it is positioned and scaled within the element bounds.

C#
public virtual ImageLayout ImageLayout { get; set; }

Gets or sets the opacity level for image rendering, where 1.0 represents fully opaque and 0.0 represents fully transparent.

C#
public virtual double ImageOpacity { get; set; }

Gets or sets the color that will be treated as transparent when rendering images on this element.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color ImageTransparentColor { get; set; }

Gets the layout manager that controls the positioning and sizing of text and image content within this element.

C#
public virtual LayoutManagerPart Layout { get; }

Gets or sets a value indicating whether trailing spaces in text should be included in text measurement calculations.

C#
[Browsable(false)]
public bool MeasureTrailingSpaces { get; set; }

Implements: ITextProvider.MeasureTrailingSpaces

Gets or sets the number of colors used in gradient background effects. This determines how many color properties are utilized.

C#
public override int NumberOfColors { get; set; }

Overrides: UIItemBase.NumberOfColors

Gets or sets a value indicating whether the element should be painted.

C#
public override bool ShouldPaint { get; set; }

Overrides: RadElement.ShouldPaint

Children visibility is not be affected.

Gets or sets a value indicating whether a horizontal line should be rendered across the element.

C#
public virtual bool ShowHorizontalLine { get; set; }

Gets or sets a value indicating whether keyboard access cues (underlines for mnemonics) should be displayed for this element.

C#
[Browsable(false)]
public virtual bool ShowKeyboardCues { get; set; }

Implements: ITextProvider.ShowKeyboardCues

Gets or sets the SVG image to be displayed on this element as a scalable vector graphic.

C#
public virtual RadSvgImage SvgImage { get; set; }

Gets or sets the alignment of text within the element bounds, controlling both horizontal and vertical positioning.

C#
public virtual ContentAlignment TextAlignment { get; set; }

Implements: ITextProvider.TextAlignment

Gets or sets the spatial relationship between text and image content. This determines how text and image are positioned relative to each other.

C#
public TextImageRelation TextImageRelation { get; set; }

Gets the text formatting and measurement settings assembled from this element's current text-related properties.

C#
public TextParams TextParams { get; }

Gets or sets the text rendering hint that determines the quality and anti-aliasing mode used when rendering text on this element. This property affects the visual appearance and readability of text displayed by the element.

C#
public virtual TextRenderingHint TextRenderingHint { get; set; }

Gets or sets a value indicating whether text will automatically wrap to multiple lines when it exceeds the element's width.

C#
public virtual bool TextWrap { get; set; }

Implements: ITextProvider.TextWrap

Gets or sets a value indicating whether ampersand characters (&) in text will be treated as mnemonic access key indicators.

C#
public virtual bool UseMnemonic { get; set; }

Implements: ITextProvider.UseMnemonic

Methods

Starts animation for an animated main or background image, registering its frame-change callback only once while that image is active in the given role.

C#
protected virtual void AnimateImage(Image image, bool isBackgroundImage)
Parameters:imageImage

The image to animate.

isBackgroundImagebool

true for the background image; false for the main image.

Arranges a single child element according to its fit-to-size mode within the allocated space.

C#
protected virtual void ArrangeElement(RadElement element, SizeF finalSize)
Parameters:elementRadElement

The child element to arrange.

finalSizeSizeF

The final size available for arranging the element.

Arranges the content and child elements within the final allocated space, positioning text, images, and child elements.

C#
protected override SizeF ArrangeOverride(SizeF finalSize)
Parameters:finalSizeSizeF

The final area within the parent that this element should use to arrange itself and its children.

Returns:

SizeF

The actual size used by the element after arrangement.

Overrides: RadElement.ArrangeOverride(SizeF)

Calculates the final desired size by combining the element's content size with child elements' size requirements.

C#
protected virtual SizeF CalculateDesiredSize(SizeF availableSize, SizeF desiredSize, SizeF elementsDesiredSize)
Parameters:availableSizeSizeF

The available space that a parent element can allocate.

desiredSizeSizeF

The desired size calculated from content and layout requirements.

elementsDesiredSizeSizeF

The desired size calculated from child elements.

Returns:

SizeF

The final desired size taking into account all size constraints.

Clips an image to fit within the specified rectangle and size constraints, creating a new image if necessary.

C#
protected virtual Image ClipImage(Image image, Rectangle imageRectange, Size size)
Parameters:imageImage

The source image to clip.

imageRectangeRectangle

The rectangle defining the clipping area within the source image.

sizeSize

The target size for the clipped image.

Returns:

Image

The clipped image, or the original image if no clipping is needed.

Creates the text settings used by text measurement and painting from the element's current properties. Override to customize those settings for a derived element.

C#
protected virtual TextParams CreateTextParams()
Returns:

TextParams

A snapshot of the element's text, formatting, and rendering settings.

Disposes of managed resources including cached images and SVG images when the element is being disposed.

C#
protected override void DisposeManagedResources()

Overrides: UIItemBase.DisposeManagedResources()

Draws a horizontal line across the element when text is present, positioning the line based on text alignment and size.

C#
protected virtual void DrawHorizontalLine(IGraphics graphics)
Parameters:graphicsIGraphics

The graphics context used for rendering the horizontal line.

Draws a horizontal line across the element when no text is present and ShowHorizontalLine is enabled.

C#
protected virtual void DrawHorizontalLineWithoutText(IGraphics graphics)
Parameters:graphicsIGraphics

The graphics context used for rendering the horizontal line.

Creates a bitmap snapshot of the element, using anti-aliased text while rendering when backColor is transparent. After a successful render, restores the original TextRenderingHint.

C#
public override Bitmap GetAsBitmapEx(Color backColor, float totalAngle, SizeF totalScale)
Parameters:backColorColor

The background color to use for the snapshot.

totalAnglefloat

The rotation angle applied while rendering.

totalScaleSizeF

The scale applied while rendering.

Returns:

Bitmap

The rendered bitmap, or null if the element is not loaded or has no positive size.

Overrides: RadElement.GetAsBitmapEx(Color, float, SizeF)

Gets the border thickness for this element instance by delegating to the static GetBorderThickness(LightVisualElement, bool) method.

C#
protected virtual Padding GetBorderThickness(bool checkDrawBorder)
Parameters:checkDrawBorderbool

When true, returns zero thickness if DrawBorder is false.

Returns:

Padding

A Padding structure representing the border thickness.

Calculates the border thickness for a LightVisualElement based on its border configuration and drawing state.

C#
public static Padding GetBorderThickness(LightVisualElement element, bool checkDrawBorder)
Parameters:elementLightVisualElement

The LightVisualElement instance to calculate border thickness for.

checkDrawBorderbool

When true, returns zero thickness if DrawBorder is false; otherwise ignores the drawing state.

Returns:

Padding

A Padding structure representing the calculated border thickness for all sides.

Calculates the client area offset by combining padding and optionally border thickness.

C#
protected virtual Padding GetClientOffset(bool includeBorder)
Parameters:includeBorderbool

When true, includes border thickness in the offset calculation.

Returns:

Padding

A Padding structure representing the total client area offset.

Calculates the client rectangle area available for content within the element bounds, optionally including border space.

C#
protected virtual RectangleF GetClientRectangle(bool includeBorder, SizeF finalSize)
Parameters:includeBorderbool

When true, accounts for border thickness in the client rectangle calculation.

finalSizeSizeF

The total size of the element from which to calculate the client rectangle.

Returns:

RectangleF

A RectangleF representing the available client area for content.

Calculates the content rectangle after subtracting padding and, when DrawBorder is true, border thickness. The returned width and height are never negative.

C#
protected override RectangleF GetClientRectangle(SizeF finalSize)
Parameters:finalSizeSizeF

The total size available to the element.

Returns:

RectangleF

The remaining rectangle available for content.

Overrides: RadElement.GetClientRectangle(SizeF)

Calculates the clipping rectangle for this element, taking into account border thickness and padding.

C#
protected override RectangleF GetClipRect()
Returns:

RectangleF

A RectangleF representing the clipping bounds for content rendering.

Overrides: RadElement.GetClipRect()

Returns the element's text face rectangle from the local origin, sized to its desired size.

C#
public RectangleF GetFaceRectangle()
Returns:

RectangleF

The text face bounds in the element's local coordinates.

Implements: ITextProvider.GetFaceRectangle()

Returns the explicitly assigned image draw type, or null when image selection is automatic.

C#
protected ImageDrawType? GetImageDrawTypeLocalValue()
Returns:

ImageDrawType?

The assigned ImageDrawType value, or null if no explicit value was set.

Returns this element's BorderWidth for painting instead of inheriting the parent's border thickness.

C#
public override float GetPaintingBorderWidth()
Returns:

float

The uniform border width configured on this element.

Overrides: UIItemBase.GetPaintingBorderWidth()

Creates the filter used to expose this element's declared properties together with appearance, behavior, and layout properties to styling operations.

C#
public override Filter GetStylablePropertiesFilter()
Returns:

Filter

A combined filter for the properties that can be styled on this element.

Overrides: RadElement.GetStylablePropertiesFilter()

Gets TextAlignment adjusted for the element's RightToLeft setting.

C#
protected ContentAlignment GetTextAlignment()
Returns:

ContentAlignment

The effective text alignment used by layout and painting.

Mirrors left and right alignment values when RightToLeft is enabled.

C#
protected ContentAlignment GetTextAlignment(ContentAlignment textAlignment)
Parameters:textAlignmentContentAlignment

The alignment to adjust.

Returns:

ContentAlignment

The adjusted alignment, or the original value when right-to-left layout is disabled.

Calculates the size required to display the text content within the proposed size constraints.

C#
public SizeF GetTextSize(SizeF proposedSize, TextParams textParams)
Parameters:proposedSizeSizeF

The proposed size constraints for the text measurement.

textParamsTextParams

The text parameters containing formatting and display options.

Returns:

SizeF

A SizeF representing the calculated text size.

Implements: ITextPrimitive.GetTextSize(SizeF, TextParams)

Calculates the size required to display the text content using the specified text parameters.

C#
public SizeF GetTextSize(TextParams textParams)
Parameters:textParamsTextParams

The text parameters containing formatting and display options.

Returns:

SizeF

A SizeF representing the calculated text size.

Implements: ITextPrimitive.GetTextSize(TextParams)

Initializes the internal fields and components of the LightVisualElement. This method sets up text primitives, image primitives, and layout management components.

C#
protected override void InitializeFields()

Overrides: RadItem.InitializeFields()

Maps fill, border, and image primitive properties to the corresponding properties on this element. A border setting also maps the primitive foreground color to BorderColor.

C#
public override RadProperty MapStyleProperty(RadProperty propertyToMap, string settingType)
Parameters:propertyToMapRadProperty

The primitive property referenced by the style.

settingTypestring

The style setting category; Border selects border-specific property mapping.

Returns:

RadProperty

The corresponding property on this element, or null when no mapping exists.

Overrides: RadElement.MapStyleProperty(RadProperty, string)

Measures all child elements when auto-sizing is enabled, calculating the space required for child elements.

C#
protected virtual SizeF MeasureElements(SizeF availableSize, SizeF clientSize, Padding borderThickness)
Parameters:availableSizeSizeF

The available space that a parent element can allocate.

clientSizeSizeF

The client area size available for content.

borderThicknessPadding

The thickness of the border that affects available space.

Returns:

SizeF

The desired size needed to accommodate all child elements.

Measures the desired size of the text content given the available space and text parameters.

C#
public SizeF MeasureOverride(SizeF availableSize, TextParams textParams)
Parameters:availableSizeSizeF

The available space for measuring the text content.

textParamsTextParams

The text parameters containing formatting and display options.

Returns:

SizeF

A SizeF representing the desired size of the text content.

Implements: ITextPrimitive.MeasureOverride(SizeF, TextParams)

Measures the desired size of the element by calculating the space needed for content, padding, and borders.

C#
protected override SizeF MeasureOverride(SizeF availableSize)
Parameters:availableSizeSizeF

The available space that a parent element can allocate to this element.

Returns:

SizeF

The desired size of the element including content, padding, and border space.

Overrides: RadElement.MeasureOverride(SizeF)

Called when animated image frame changes.

C#
protected virtual void OnAnimatedImageFrameChanged()

Handles state changes for bit flags, particularly managing text primitive implementation when HTML rendering is disabled.

C#
protected override void OnBitStateChanged(long key, bool oldValue, bool newValue)
Parameters:keylong

The bit flag key that was changed.

oldValuebool

The previous value of the bit flag.

newValuebool

The new value of the bit flag.

Overrides: DisposableObject.OnBitStateChanged(long, bool, bool)

Resolves the selected image-list image after loading and invalidates measurement when an image list is assigned.

C#
protected override void OnLoaded()

Overrides: RadElement.OnLoaded()

Forwards pointer movement to the active text primitive when HTML rendering is enabled, allowing its text block to update link interaction state.

C#
protected override void OnMouseMove(MouseEventArgs e)
Parameters:eMouseEventArgs

The mouse event data.

Overrides: RadItem.OnMouseMove(MouseEventArgs)

Handles mouse movement events for the text primitive, enabling text interaction features.

C#
public void OnMouseMove(object sender, MouseEventArgs e)
Parameters:senderobject

The source of the mouse move event.

eMouseEventArgs

The MouseEventArgs containing event data.

Implements: ITextPrimitive.OnMouseMove(object, MouseEventArgs)

Updates text rendering, image caches, and layout state when relevant visual properties change. Image-list index or key changes also refresh the image and invalidate measurement.

C#
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters:eRadPropertyChangedEventArgs

Overrides: UIItemBase.OnPropertyChanged(RadPropertyChangedEventArgs)

Refreshes the cached image and invalidates measurement when the root reports an image-list change.

C#
protected override void OnTunnelEvent(RadElement sender, RoutedEventArgs args)
Parameters:senderRadElementargsRoutedEventArgs

Overrides: RadElement.OnTunnelEvent(RadElement, RoutedEventArgs)

Renders the background image of the element according to the specified BackgroundImageLayout setting.

C#
protected virtual void PaintBackgroundImage(IGraphics graphics)
Parameters:graphicsIGraphics

The graphics context used for rendering the background image.

Orchestrates the painting of all content elements including background image, main image or SVG image, and text.

C#
protected virtual void PaintContent(IGraphics graphics)
Parameters:graphicsIGraphics

The graphics context used for rendering content.

Performs the main painting operation for the element, rendering fill, content, and border in the correct order.

C#
protected override void PaintElement(IGraphics graphics, float angle, SizeF scale)
Parameters:graphicsIGraphics

The graphics context used for rendering.

anglefloat

The rotation angle to apply during painting.

scaleSizeF

The scaling factor to apply during painting.

Overrides: VisualElement.PaintElement(IGraphics, float, SizeF)

Renders the main image of the element, handling image animation and thread-safe access to the cached image.

C#
protected virtual void PaintImage(IGraphics graphics)
Parameters:graphicsIGraphics

The graphics context used for rendering the image.

Paints the text primitive with the specified graphics context, transformation, and text parameters.

C#
public void PaintPrimitive(IGraphics graphics, float angle, SizeF scale, TextParams textParams)
Parameters:graphicsIGraphics

The graphics context used for painting.

anglefloat

The rotation angle to apply during painting.

scaleSizeF

The scale factor to apply during painting.

textParamsTextParams

The text parameters containing formatting and display options.

Implements: ITextPrimitive.PaintPrimitive(IGraphics, float, SizeF, TextParams)

Paints the text primitive with the specified graphics context and text parameters.

C#
public void PaintPrimitive(IGraphics graphics, TextParams textParams)
Parameters:graphicsIGraphics

The graphics context used for painting.

textParamsTextParams

The text parameters containing formatting and display options.

Implements: ITextPrimitive.PaintPrimitive(IGraphics, TextParams)

Renders the SVG image of the element when an SvgImage is available and image drawing is enabled.

C#
protected virtual void PaintSvgImage(IGraphics graphics)
Parameters:graphicsIGraphics

The graphics context used for rendering the SVG image.

Renders the text content of the element, including horizontal line effects when enabled.

C#
protected virtual void PaintText(IGraphics graphics)
Parameters:graphicsIGraphics

The graphics context used for rendering text.

Paints the active text primitive using the element's text parameters and current transforms.

C#
protected void PaintTextCore(IGraphics graphics)
Parameters:graphicsIGraphics

The graphics context used for painting.

Serializes SvgImageXml only when an SVG image exists and is stored locally or through a local binding; other properties use the base serialization decision.

C#
public override bool? ShouldSerializeProperty(PropertyDescriptor property)
Parameters:propertyPropertyDescriptor

The property descriptor to evaluate.

Returns:

bool?

The serialization decision for SvgImageXml, or the base class decision for other properties.

Overrides: RadItem.ShouldSerializeProperty(PropertyDescriptor)

Toggles the text primitive when text related properties are change.

C#
protected virtual void ToggleTextPrimitive(RadProperty property)
Parameters:propertyRadProperty

The changed property.

In this article
DefinitionConstructorsLightVisualElement()FieldsBackColor2PropertyBackColor3PropertyBackColor4PropertyBackgroundImageLayoutPropertyBackgroundImagePropertyBorderBottomColorPropertyBorderBottomShadowColorPropertyBorderBottomWidthPropertyBorderBoxStylePropertyBorderColor2PropertyBorderColor3PropertyBorderColor4PropertyBorderColorPropertyBorderDashPatternPropertyBorderDashStylePropertyBorderDrawModePropertyBorderGradientAnglePropertyBorderGradientStylePropertyBorderInnerColor2PropertyBorderInnerColor3PropertyBorderInnerColor4PropertyBorderInnerColorPropertyBorderLeftColorPropertyBorderLeftShadowColorPropertyBorderLeftWidthPropertyBorderRightColorPropertyBorderRightShadowColorPropertyBorderRightWidthPropertyBorderTopColorPropertyBorderTopShadowColorPropertyBorderTopWidthPropertyBorderWidthPropertyClipTextPropertyDisabledTextRenderingHintPropertyDrawBackgroundImagePropertyDrawBorderPropertyDrawFillPropertyDrawImagePropertyDrawTextPropertyEnableImageTransparencyPropertyGradientAnglePropertyGradientPercentage2PropertyGradientPercentagePropertyGradientStylePropertyHorizontalLineColorPropertyHorizontalLineWidthPropertyImageAlignmentPropertyImageIndexPropertyImageKeyPropertyImageLayoutPropertyImageOpacityPropertyImagePropertyImageTransparentColorPropertyNumberOfColorsPropertyShowHorizontalLinePropertySvgImagePropertyTextAlignmentPropertyTextImageRelationPropertyTextRenderingHintPropertyTextWrapPropertyPropertiesAutoEllipsisBackColor2BackColor3BackColor4BackgroundImageBackgroundImageLayoutBorderBottomColorBorderBottomShadowColorBorderBottomWidthBorderBoxStyleBorderColorBorderColor2BorderColor3BorderColor4BorderDashPatternBorderDashStyleBorderDrawModeBorderGradientAngleBorderGradientStyleBorderInnerColorBorderInnerColor2BorderInnerColor3BorderInnerColor4BorderLeftColorBorderLeftShadowColorBorderLeftWidthBorderRightColorBorderRightShadowColorBorderRightWidthBorderTopColorBorderTopShadowColorBorderTopWidthBorderWidthCanFocusClipTextDisabledImageOpacityDisabledTextRenderingHintDisableHTMLRenderingDrawBackgroundImageDrawBorderDrawFillDrawImageDrawTextEnableImageTransparencyGradientAngleGradientPercentageGradientPercentage2GradientStyleHorizontalLineColorHorizontalLineWidthImageImageAlignmentImageDrawTypeImageIndexImageKeyImageLayoutImageOpacityImageTransparentColorLayoutMeasureTrailingSpacesNumberOfColorsShouldPaintShowHorizontalLineShowKeyboardCuesSvgImageTextAlignmentTextImageRelationTextParamsTextRenderingHintTextWrapUseMnemonicMethodsAnimateImage(Image, bool)ArrangeElement(RadElement, SizeF)ArrangeOverride(SizeF)CalculateDesiredSize(SizeF, SizeF, SizeF)ClipImage(Image, Rectangle, Size)CreateTextParams()DisposeManagedResources()DrawHorizontalLine(IGraphics)DrawHorizontalLineWithoutText(IGraphics)GetAsBitmapEx(Color, float, SizeF)GetBorderThickness(bool)GetBorderThickness(LightVisualElement, bool)GetClientOffset(bool)GetClientRectangle(bool, SizeF)GetClientRectangle(SizeF)GetClipRect()GetFaceRectangle()GetImageDrawTypeLocalValue()GetPaintingBorderWidth()GetStylablePropertiesFilter()GetTextAlignment()GetTextAlignment(ContentAlignment)GetTextSize(SizeF, TextParams)GetTextSize(TextParams)InitializeFields()MapStyleProperty(RadProperty, string)MeasureElements(SizeF, SizeF, Padding)MeasureOverride(SizeF, TextParams)MeasureOverride(SizeF)OnAnimatedImageFrameChanged()OnBitStateChanged(long, bool, bool)OnLoaded()OnMouseMove(MouseEventArgs)OnMouseMove(object, MouseEventArgs)OnPropertyChanged(RadPropertyChangedEventArgs)OnTunnelEvent(RadElement, RoutedEventArgs)PaintBackgroundImage(IGraphics)PaintContent(IGraphics)PaintElement(IGraphics, float, SizeF)PaintImage(IGraphics)PaintPrimitive(IGraphics, float, SizeF, TextParams)PaintPrimitive(IGraphics, TextParams)PaintSvgImage(IGraphics)PaintText(IGraphics)PaintTextCore(IGraphics)ShouldSerializeProperty(PropertyDescriptor)ToggleTextPrimitive(RadProperty)
Not finding the help you need?
Contact Support