Skip to end of metadata
Go to start of metadata

Remarks

Derived from FieldLabel, UXRibbonFieldLabel represents a data field that typically consists of a label and an input control. The label of a FieldLabel can be customized through the Header property, while the input control is defined in the Content property. Beside input controls, you can actually use any kind of controls as the content such as check box, radio button, combo box and so on. For more information, see FieldLabel Overview.

XAML

The result looks like the following figure.

To learn more about ribbon controls, see Working with Ribbon Controls.

Definition

public class UXRibbonFieldLabel : FieldLabel,

IRibbonKeyTipAction, IRibbonControl

Summary

The following table summarizes the members exposed in this class.

Public Constructors

UXRibbonFieldLabel Constructor()Creates a new instance of UXRibbonFieldLabel class.

Public Properties

IconGets or sets a value that specifies the control icon.
LargeIconGets or sets a value that specifies the control large icon.
LargeImageHeightGets or sets a value that specifies the large image height.
LargeImageWidthGets or sets a value that specifies the large image width.
MaximumSizeGets or sets a value that specifies the control maximum size.
MaxLargeButtonWidthGets or sets a value that specifies the maximum width when size is large.
MinimumSizeGets or sets a value that specifies the control minimum size.
MinLargeButtonWidthGets or sets a value that specifies the minimum width of the button when the Size property is Large.
SizeGets or sets a value that specifies the control size.

Fields

IconPropertyIdentifies the Icon dependency property.
LargeIconPropertyIdentifies the LargeIcon dependency property.
LargeImageHeightPropertyIdentifies the LargeImageHeight dependency property.
LargeImageWidthPropertyIdentifies the LargeImageWidth dependency property.
MaximumSizePropertyIdentifies the MaximumSize dependency property.
MaxLargeButtonWidthPropertyIdentifies the MaxLargeButtonWidth dependency property.
MinimumSizePropertyIdentifies the MinimumSize dependency property.
MinLargeButtonWidthPropertyIdentifies the MaxLargeButtonWidth dependency property.
SizePropertyIdentifies the Size dependency property.

Public Methods

InitializeTemplates()Initializes control templates.
OnApplyTemplate()When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call System.Windows.Controls.Control.ApplyTemplate(). In simplest terms, this means the method is called just before a UI element displays in an application. For more information, see Remarks.
RaiseAction()Raise the action in element that implements IRibbonKeyTipAction.

Protected Methods

GoToLargeState(bool)Active the large visual state.
GoToLargeState()Active the large visual state.
GoToMediumState(bool)Active the medium visual state.
GoToMediumState()Active the medium visual state.
GoToSmallState(bool)Active the small visual state.
GoToSmallState()Active the small visual state.

Public Constructors

public UXRibbonFieldLabel()

Creates a new instance of UXRibbonFieldLabel class.

Public Properties

public ImageSource Icon { get; set; }

Gets or sets a value that specifies the control icon.

public ImageSource LargeIcon { get; set; }

Gets or sets a value that specifies the control large icon.

public double LargeImageHeight { get; set; }

Gets or sets a value that specifies the large image height.

public double LargeImageWidth { get; set; }

Gets or sets a value that specifies the large image width.

public RibbonControlSize MaximumSize { get; set; }

Gets or sets a value that specifies the control maximum size.

public double MaxLargeButtonWidth { get; set; }

Gets or sets a value that specifies the maximum width when size is large.

public RibbonControlSize MinimumSize { get; set; }

Gets or sets a value that specifies the control minimum size.

public double MinLargeButtonWidth { get; set; }

Gets or sets a value that specifies the minimum width of the button when the Size property is Large.

public RibbonControlSize Size { get; set; }

Gets or sets a value that specifies the control size.

Fields

public static readonly DependencyProperty IconProperty

Identifies the Icon dependency property.

public static readonly DependencyProperty LargeIconProperty

Identifies the LargeIcon dependency property.

public static readonly DependencyProperty LargeImageHeightProperty

Identifies the LargeImageHeight dependency property.

public static readonly DependencyProperty LargeImageWidthProperty

Identifies the LargeImageWidth dependency property.

public static readonly DependencyProperty MaximumSizeProperty

Identifies the MaximumSize dependency property.

public static readonly DependencyProperty MaxLargeButtonWidthProperty

Identifies the MaxLargeButtonWidth dependency property.

public static readonly DependencyProperty MinimumSizeProperty

Identifies the MinimumSize dependency property.

public static readonly DependencyProperty MinLargeButtonWidthProperty

Identifies the MaxLargeButtonWidth dependency property.

public static readonly DependencyProperty SizeProperty

Identifies the Size dependency property.

Public Methods

public void InitializeTemplates()

Initializes control templates.

public void OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call System.Windows.Controls.Control.ApplyTemplate(). In simplest terms, this means the method is called just before a UI element displays in an application. For more information, see Remarks.

public void RaiseAction()

Raise the action in element that implements IRibbonKeyTipAction.

Protected Methods

protected void GoToLargeState(bool animate)

Active the large visual state.

Parameters

animate 

 

protected void GoToLargeState()

Active the large visual state.

protected void GoToMediumState(bool animate)

Active the medium visual state.

Parameters

animate 

 

protected void GoToMediumState()

Active the medium visual state.

protected void GoToSmallState(bool animate)

Active the small visual state.

Parameters

animate 

 

protected void GoToSmallState()

Active the small visual state.

  • No labels