UISettings UISettings UISettings UISettings Class

Contains a set of common app user interface settings and operations.

Syntax

Declaration

public sealed class UISettingspublic sealed class UISettingsPublic NotInheritable Class UISettings

Remarks

void SDKSample::HighContrast::UI::UIGetSettings_Click(Platform::Object^ sender, Windows::UI::Xaml::RoutedEventArgs^ e)
{ 
  Button^ b = safe_cast<Button^>(sender);
  if (b != nullptr)
  {
    UISettings^ pUserSettings = ref new UISettings();
    Platform::String^ Buffer;
    Windows::UI::Color Color;

        Buffer =  "Hand Preference " + (pUserSettings->HandPreference == HandPreference::RightHanded ? "right" : "left") + "\n";
        Buffer += "Cursor Size "  + pUserSettings->CursorSize.Width.ToString() + " x " + pUserSettings->CursorSize.Height.ToString() + "\n";
        Buffer += "Scrollbar Size "  + pUserSettings->ScrollBarSize.Width.ToString() + " x " + pUserSettings->ScrollBarSize.Height.ToString() + "\n";
        Buffer += "Scrollbar Arrow Size "   + pUserSettings->ScrollBarArrowSize.Width.ToString() + " x " + pUserSettings->ScrollBarArrowSize.Height.ToString() + "\n";
        Buffer += "Scrollbar Thumb Box Size " + pUserSettings->ScrollBarThumbBoxSize.Width.ToString() + " x " + pUserSettings->ScrollBarThumbBoxSize.Height.ToString() + "\n";
        Buffer += "Message Duration "  + pUserSettings->MessageDuration.ToString() + "\n";
        Buffer += "Animations Enabled "  + (pUserSettings->AnimationsEnabled ? "true" : "false") + "\n"; 
        Buffer += "Caret Browsing Enabled "  + (pUserSettings->CaretBrowsingEnabled ? "true" : "false") + "\n";
        Buffer += "Caret Blink Rate "  + pUserSettings->CaretBlinkRate.ToString() + "\n";
        Buffer += "Caret Width " + pUserSettings->CaretWidth.ToString() + "\n";
        Buffer += "Double Click Time " + pUserSettings->DoubleClickTime.ToString() + "\n";
        Buffer += "Mouse Hover Time " + pUserSettings->MouseHoverTime.ToString() + "\n";

        Buffer += "System Colors: \n";

        Color = pUserSettings->UIElementColor(UIElementType::ActiveCaption);
        Buffer += "Active Caption: " + Color.R.ToString() + ", " + Color.G.ToString() + ", " + Color.B.ToString() + "\n";
        Color = pUserSettings->UIElementColor(UIElementType::Background);
        Buffer += "Background: " + Color.R.ToString() + ", " + Color.G.ToString() + ", " + Color.B.ToString() + "\n";
        Color = pUserSettings->UIElementColor(UIElementType::ButtonFace);
        Buffer += "Button Face: " + Color.R.ToString() + ", " + Color.G.ToString() + ", " + Color.B.ToString() + "\n";
        Color = pUserSettings->UIElementColor(UIElementType::ButtonText);
        Buffer += "Button Text: " + Color.R.ToString() + ", " + Color.G.ToString() + ", " + Color.B.ToString() + "\n";
        Color = pUserSettings->UIElementColor(UIElementType::CaptionText);
        Buffer += "Caption Text: " + Color.R.ToString() + ", " + Color.G.ToString() + ", " + Color.B.ToString() + "\n";
        Color = pUserSettings->UIElementColor(UIElementType::GrayText);
        Buffer += "Gray Text: " + Color.R.ToString() + ", " + Color.G.ToString() + ", " + Color.B.ToString() + "\n";
        Color = pUserSettings->UIElementColor(UIElementType::Highlight);
        Buffer += "Highlight: " + Color.R.ToString() + ", " + Color.G.ToString() + ", " + Color.B.ToString() + "\n";
        Color = pUserSettings->UIElementColor(UIElementType::HighlightText);
        Buffer += "Highlight Text: " + Color.R.ToString() + ", " + Color.G.ToString() + ", " + Color.B.ToString() + "\n";
        Color = pUserSettings->UIElementColor(UIElementType::Hotlight);
        Buffer += "Hotlight: " + Color.R.ToString() + ", " + Color.G.ToString() + ", " + Color.B.ToString() + "\n";
        Color = pUserSettings->UIElementColor(UIElementType::InactiveCaption);
        Buffer += "Inactive Caption: " + Color.R.ToString() + ", " + Color.G.ToString() + ", " + Color.B.ToString() + "\n";
        Color = pUserSettings->UIElementColor(UIElementType::InactiveCaptionText);
        Buffer += "Inactive Caption Text: " + Color.R.ToString() + ", " + Color.G.ToString() + ", " + Color.B.ToString() + "\n";
        Color = pUserSettings->UIElementColor(UIElementType::Window);
        Buffer += "Window: " + Color.R.ToString() + ", " + Color.G.ToString() + ", " + Color.B.ToString() + "\n";
        Color = pUserSettings->UIElementColor(UIElementType::WindowText);
        Buffer += "Window Text: " + Color.R.ToString() + ", " + Color.G.ToString() + ", " + Color.B.ToString() + "\n";

    UIOutputTextBlock->Text = Buffer;
  }
}

Constructors summary

Creates a new default instance of the UISettings class.

Properties summary

Gets whether animations are enabled for the user interface.

Gets the blink rate of a new caret created by the app view.

Gets whether the caret can be used for browse operations.

Gets the width of a new caret created by the app view.

Gets the size of a new cursor created by the app view.

Gets the maximum allowed time between clicks in a double-click operation.

Gets the directional preference of the user interface created by the app view.

Gets the length of time a message is displayed for the app view.

Gets the amount of time the mouse pointer can rest in a hover rectangle before a hover event is raised.

Gets the size of a scroll bar arrow for windows associated with the app view.

Gets the size of a scroll bar for windows associated with the app view.

Gets the size of a thumb box for windows associated with the app view.

Gets the value of the system text size setting.

Methods summary

Returns the color value of the specified color type.

Gets the color used for a specific user interface element type, such as a button face or window text.

Events summary

Occurs when color values have changed.

Occurs when the system text size setting is changed.

Constructors

  • UISettings()
    UISettings()
    UISettings()
    UISettings()

    Creates a new default instance of the UISettings class.

    public UISettings()public UISettings()Public Function UISettings() As

Properties

  • AnimationsEnabled
    AnimationsEnabled
    AnimationsEnabled
    AnimationsEnabled

    Gets whether animations are enabled for the user interface.

    public bool AnimationsEnabled { get; }public bool AnimationsEnabled { get; }Public ReadOnly Property AnimationsEnabled As bool

    Property Value

    • bool
      bool
      bool
      bool

      true if animations are enabled; false if not.

  • CaretBlinkRate
    CaretBlinkRate
    CaretBlinkRate
    CaretBlinkRate

    Gets the blink rate of a new caret created by the app view.

    public uint CaretBlinkRate { get; }public uint CaretBlinkRate { get; }Public ReadOnly Property CaretBlinkRate As uint

    Property Value

    • uint
      uint
      uint
      uint

      The blink rate of the new caret, in milliseconds.

  • CaretBrowsingEnabled
    CaretBrowsingEnabled
    CaretBrowsingEnabled
    CaretBrowsingEnabled

    Gets whether the caret can be used for browse operations.

    public bool CaretBrowsingEnabled { get; }public bool CaretBrowsingEnabled { get; }Public ReadOnly Property CaretBrowsingEnabled As bool

    Property Value

    • bool
      bool
      bool
      bool

      True if the caret can be used for browse operations; false if it cannot.

  • CaretWidth
    CaretWidth
    CaretWidth
    CaretWidth

    Gets the width of a new caret created by the app view.

    public uint CaretWidth { get; }public uint CaretWidth { get; }Public ReadOnly Property CaretWidth As uint

    Property Value

    • uint
      uint
      uint
      uint

      The width of a new caret, in pixels.

  • CursorSize
    CursorSize
    CursorSize
    CursorSize

    Gets the size of a new cursor created by the app view.

    public Size CursorSize { get; }public Size CursorSize { get; }Public ReadOnly Property CursorSize As Size

    Property Value

  • DoubleClickTime
    DoubleClickTime
    DoubleClickTime
    DoubleClickTime

    Gets the maximum allowed time between clicks in a double-click operation.

    public uint DoubleClickTime { get; }public uint DoubleClickTime { get; }Public ReadOnly Property DoubleClickTime As uint

    Property Value

    • uint
      uint
      uint
      uint

      The delta of a double-click operation, in milliseconds.

  • HandPreference
    HandPreference
    HandPreference
    HandPreference

    Gets the directional preference of the user interface created by the app view.

    public HandPreference HandPreference { get; }public HandPreference HandPreference { get; }Public ReadOnly Property HandPreference As HandPreference

    Property Value

  • MessageDuration
    MessageDuration
    MessageDuration
    MessageDuration

    Gets the length of time a message is displayed for the app view.

    public uint MessageDuration { get; }public uint MessageDuration { get; }Public ReadOnly Property MessageDuration As uint

    Property Value

    • uint
      uint
      uint
      uint

      The duration the message is displayed, in seconds.

  • MouseHoverTime
    MouseHoverTime
    MouseHoverTime
    MouseHoverTime

    Gets the amount of time the mouse pointer can rest in a hover rectangle before a hover event is raised.

    public uint MouseHoverTime { get; }public uint MouseHoverTime { get; }Public ReadOnly Property MouseHoverTime As uint

    Property Value

    • uint
      uint
      uint
      uint

      The hover time before a hover event is raised, in milliseconds.

  • ScrollBarArrowSize
    ScrollBarArrowSize
    ScrollBarArrowSize
    ScrollBarArrowSize

    Gets the size of a scroll bar arrow for windows associated with the app view.

    public Size ScrollBarArrowSize { get; }public Size ScrollBarArrowSize { get; }Public ReadOnly Property ScrollBarArrowSize As Size

    Property Value

  • ScrollBarSize
    ScrollBarSize
    ScrollBarSize
    ScrollBarSize

    Gets the size of a scroll bar for windows associated with the app view.

    public Size ScrollBarSize { get; }public Size ScrollBarSize { get; }Public ReadOnly Property ScrollBarSize As Size

    Property Value

  • ScrollBarThumbBoxSize
    ScrollBarThumbBoxSize
    ScrollBarThumbBoxSize
    ScrollBarThumbBoxSize

    Gets the size of a thumb box for windows associated with the app view.

    public Size ScrollBarThumbBoxSize { get; }public Size ScrollBarThumbBoxSize { get; }Public ReadOnly Property ScrollBarThumbBoxSize As Size

    Property Value

  • TextScaleFactor
    TextScaleFactor
    TextScaleFactor
    TextScaleFactor

    Gets the value of the system text size setting.

    public double TextScaleFactor { get; }public double TextScaleFactor { get; }Public ReadOnly Property TextScaleFactor As double

    Property Value

    • double
      double
      double
      double

      The value ranges from 1 to 2. Very small text is scaled up by a factor equal to this value, or very close to it. You can use the value to scale non-text visuals proportionately with the text. But be aware that not all text is scaled by the same factor. Generally speaking, the larger text is to begin with, the less it’s affected by scaling.

Methods

  • GetColorValue(Windows.UI.ViewManagement.UIColorType)
    GetColorValue(Windows.UI.ViewManagement.UIColorType)
    GetColorValue(Windows.UI.ViewManagement.UIColorType)
    GetColorValue(Windows.UI.ViewManagement.UIColorType)

    Returns the color value of the specified color type.

    public Color GetColorValue(Windows.UI.ViewManagement.UIColorType)public Color GetColorValue(Windows.UI.ViewManagement.UIColorType)Public Function GetColorValue(Windows.UI.ViewManagement.UIColorType) As Color

    Parameters

    Returns

    Remarks

    The UIColorType value is not supported and will cause an exception if used as the desiredColor parameter.

  • UIElementColor(Windows.UI.ViewManagement.UIElementType)
    UIElementColor(Windows.UI.ViewManagement.UIElementType)
    UIElementColor(Windows.UI.ViewManagement.UIElementType)
    UIElementColor(Windows.UI.ViewManagement.UIElementType)

    Gets the color used for a specific user interface element type, such as a button face or window text.

    public Color UIElementColor(Windows.UI.ViewManagement.UIElementType)public Color UIElementColor(Windows.UI.ViewManagement.UIElementType)Public Function UIElementColor(Windows.UI.ViewManagement.UIElementType) As Color

    Parameters

    Returns

Events

  • ColorValuesChanged
    ColorValuesChanged
    ColorValuesChanged
    ColorValuesChanged

    Occurs when color values have changed.

    public event TypedEventHandler ColorValuesChangedpublic event TypedEventHandler ColorValuesChangedPublic Event ColorValuesChanged
  • TextScaleFactorChanged
    TextScaleFactorChanged
    TextScaleFactorChanged
    TextScaleFactorChanged

    Occurs when the system text size setting is changed.

    public event TypedEventHandler TextScaleFactorChangedpublic event TypedEventHandler TextScaleFactorChangedPublic Event TextScaleFactorChanged

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Attributes

Windows.Foundation.Metadata.MarshalingBehaviorAttribute
Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.ActivatableAttribute

Details

Assembly

Windows.UI.ViewManagement.dll