A class that represents the header layout of RadTaskDialogPage
Definition
Namespace:Telerik.WinControls.UI.TaskDialog
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class RadTaskDialogHeaderLayout : LightVisualElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementRadTaskDialogHeaderLayout...
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadTaskDialogHeaderLayout class.
public RadTaskDialogHeaderLayout()
Initializes a new instance of the RadTaskDialogHeaderLayout class.
public RadTaskDialogHeaderLayout(RadTaskDialogIcon icon, string text)
The icon element.
textstringThe text.
Properties
Gets the element responsible for the background of icon and header text.
public LightVisualElement BackgroundElement { get; }
Gets the content area, which holds the page text, expander(description) text, progress bar, radio buttons and the command link buttons
public RadTaskDialogContentArea ContentArea { get; }
Gets the header text element.
public LightVisualElement HeaderTextElement { get; }
Gets the icon element.
public RadTaskDialogIcon Icon { get; set; }
Gets or sets a value indicating whether the header text and the icon will have equal heights. If [true] the Icon and HeaderTextElement will have equal height and the text and image will be aligned vertically. If [false] Icon and HeaderTextElement will have unique height, just to fit their content.
public bool UseEqualHeaderAndIconHeight { get; set; }
Gets or sets a value indicating, whether the content area will occupy the full width of the RadTaskDialogPage. If [false] the ContentArea will respect the width of the Icon. If [true] the ContentArea will occupy all the available width of the page.
public bool UseWideContentArea { get; set; }
Methods
Places the icon beside the header text, positions the content below, and spans the background across the header row. Right-to-left layout mirrors the icon and content placement.
Creates the background behind the icon and header text.
Creates the background, icon, bound header-text element, and page content area.
protected override void CreateChildElements()
Overrides:
Creates the area that contains the page message, description, progress bar, and choices.
Creates the child element that displays the header's Text.
protected virtual TaskDialogLightVisualElement CreateHeaderTextElement()
Creates the default icon element used in the header.
Disables the element's own text drawing because the header text is rendered by a child element.
protected override void InitializeFields()
Overrides:
Measures the icon and header text side by side, then measures the content beneath them. UseWideContentArea and UseEqualHeaderAndIconHeight control the content width and the space reserved below the header row.
Applies a preset gradient background for shield-bar icons and adjusts header text contrast; other icon types restore the background and text color defaults.
protected virtual void OnIconChanged()
Excludes the icon, header text, background, and content area from the base child-arrange pass; ArrangeOverride(SizeF) positions them together.
protected override bool ShouldArrangeChild(RadElement child)
The child to test.
Returns:false for the header's managed children; otherwise the base result.
Overrides:
Excludes the icon, header text, background, and content area from the base child-measure pass; MeasureOverride(SizeF) measures them with the header's width rules.
protected override bool ShouldMeasureChild(RadElement child)
The child to test.
Returns:false for the header's managed children; otherwise the base result.
Overrides: