UISettings UISettings UISettings UISettings Class

Definition

Namespace:
Windows.UI.ViewManagement Windows.UI.ViewManagement Windows.UI.ViewManagement Windows.UI.ViewManagement
Edit

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

public : sealed class UISettings : IUISettings, IUISettings2, IUISettings3, IUISettings4public sealed class UISettings : IUISettings, IUISettings2, IUISettings3, IUISettings4Public NotInheritable Class UISettings Implements IUISettings, IUISettings2, IUISettings3, IUISettings4// You can use this class in JavaScript.
Attributes
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

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

UISettings() UISettings() UISettings() UISettings()

Edit

Creates a new default instance of the UISettings class.

public : UISettings()public UISettings()Public Sub New()// You can use this method in JavaScript.

Properties

AdvancedEffectsEnabled AdvancedEffectsEnabled AdvancedEffectsEnabled AdvancedEffectsEnabled

Edit

Gets a value that indicates whether the system Transparency effects setting is enabled.

public : PlatForm::Boolean AdvancedEffectsEnabled { get; }public bool AdvancedEffectsEnabled { get; }Public ReadOnly Property AdvancedEffectsEnabled As bool// You can use this property in JavaScript.
Value
PlatForm::Boolean bool bool bool

true if Transparency UI effects are enabled; otherwise, false.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

AnimationsEnabled AnimationsEnabled AnimationsEnabled AnimationsEnabled

Edit

Gets whether animations are enabled for the user interface.

public : PlatForm::Boolean AnimationsEnabled { get; }public bool AnimationsEnabled { get; }Public ReadOnly Property AnimationsEnabled As bool// You can use this property in JavaScript.
Value
PlatForm::Boolean bool bool bool

true if animations are enabled; false if not.

CaretBlinkRate CaretBlinkRate CaretBlinkRate CaretBlinkRate

Edit

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

public : unsigned int CaretBlinkRate { get; }public uint CaretBlinkRate { get; }Public ReadOnly Property CaretBlinkRate As uint// You can use this property in JavaScript.
Value
unsigned int uint uint uint

The blink rate of the new caret, in milliseconds.

CaretBrowsingEnabled CaretBrowsingEnabled CaretBrowsingEnabled CaretBrowsingEnabled

Edit

Gets whether the caret can be used for browse operations.

public : PlatForm::Boolean CaretBrowsingEnabled { get; }public bool CaretBrowsingEnabled { get; }Public ReadOnly Property CaretBrowsingEnabled As bool// You can use this property in JavaScript.
Value
PlatForm::Boolean bool bool bool

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

CaretWidth CaretWidth CaretWidth CaretWidth

Edit

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

public : unsigned int CaretWidth { get; }public uint CaretWidth { get; }Public ReadOnly Property CaretWidth As uint// You can use this property in JavaScript.
Value
unsigned int uint uint uint

The width of a new caret, in pixels.

CursorSize CursorSize CursorSize CursorSize

Edit

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// You can use this property in JavaScript.
Value
Size Size Size Size

The size of a new cursor.

DoubleClickTime DoubleClickTime DoubleClickTime DoubleClickTime

Edit

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

public : unsigned int DoubleClickTime { get; }public uint DoubleClickTime { get; }Public ReadOnly Property DoubleClickTime As uint// You can use this property in JavaScript.
Value
unsigned int uint uint uint

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

HandPreference HandPreference HandPreference HandPreference

Edit

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// You can use this property in JavaScript.
Value
HandPreference HandPreference HandPreference HandPreference

The directional preference of the user interface.

MessageDuration MessageDuration MessageDuration MessageDuration

Edit

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

public : unsigned int MessageDuration { get; }public uint MessageDuration { get; }Public ReadOnly Property MessageDuration As uint// You can use this property in JavaScript.
Value
unsigned int uint uint uint

The duration the message is displayed, in seconds.

MouseHoverTime MouseHoverTime MouseHoverTime MouseHoverTime

Edit

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

public : unsigned int MouseHoverTime { get; }public uint MouseHoverTime { get; }Public ReadOnly Property MouseHoverTime As uint// You can use this property in JavaScript.
Value
unsigned int uint uint uint

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

ScrollBarArrowSize ScrollBarArrowSize ScrollBarArrowSize ScrollBarArrowSize

Edit

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// You can use this property in JavaScript.
Value
Size Size Size Size

The size of a scroll bar arrow.

ScrollBarSize ScrollBarSize ScrollBarSize ScrollBarSize

Edit

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// You can use this property in JavaScript.
Value
Size Size Size Size

The size of the scroll bar.

ScrollBarThumbBoxSize ScrollBarThumbBoxSize ScrollBarThumbBoxSize ScrollBarThumbBoxSize

Edit

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// You can use this property in JavaScript.
Value
Size Size Size Size

The size of the thumb box.

TextScaleFactor TextScaleFactor TextScaleFactor TextScaleFactor

Edit

Gets the value of the system text size setting.

public : double TextScaleFactor { get; }public double TextScaleFactor { get; }Public ReadOnly Property TextScaleFactor As double// You can use this property in JavaScript.
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(UIColorType) GetColorValue(UIColorType) GetColorValue(UIColorType) GetColorValue(UIColorType)

Edit

Returns the color value of the specified color type.

public : Color GetColorValue(UIColorType desiredColor)public Color GetColorValue(UIColorType desiredColor)Public Function GetColorValue(desiredColor As UIColorType) As Color// You can use this method in JavaScript.
Parameters
desiredColor
UIColorType UIColorType UIColorType UIColorType

An enumeration value that specifies the type of color to get a value for.

Returns
Color Color Color Color

The color value of the specified color type.

Remarks

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

UIElementColor(UIElementType) UIElementColor(UIElementType) UIElementColor(UIElementType) UIElementColor(UIElementType)

Edit

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

public : Color UIElementColor(UIElementType desiredElement)public Color UIElementColor(UIElementType desiredElement)Public Function UIElementColor(desiredElement As UIElementType) As Color// You can use this method in JavaScript.
Parameters
desiredElement
UIElementType UIElementType UIElementType UIElementType

The type of element for which the color will be obtained.

Returns
Color Color Color Color

The color of the element type, expressed as a 32-bit color value.

Events

AdvancedEffectsEnabledChanged AdvancedEffectsEnabledChanged AdvancedEffectsEnabledChanged AdvancedEffectsEnabledChanged

Edit

Occurs when the system advanced UI effects setting is enabled or disabled.

public : event TypedEventHandler AdvancedEffectsEnabledChanged<UISettings,  object>public event TypedEventHandler AdvancedEffectsEnabledChanged<UISettings,  object>Public Event AdvancedEffectsEnabledChanged<UISettings,  object>// You can use this event in JavaScript.
Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

ColorValuesChanged ColorValuesChanged ColorValuesChanged ColorValuesChanged

Edit

Occurs when color values have changed.

public : event TypedEventHandler ColorValuesChanged<UISettings,  object>public event TypedEventHandler ColorValuesChanged<UISettings,  object>Public Event ColorValuesChanged<UISettings,  object>// You can use this event in JavaScript.

TextScaleFactorChanged TextScaleFactorChanged TextScaleFactorChanged TextScaleFactorChanged

Edit

Occurs when the system text size setting is changed.

public : event TypedEventHandler TextScaleFactorChanged<UISettings,  object>public event TypedEventHandler TextScaleFactorChanged<UISettings,  object>Public Event TextScaleFactorChanged<UISettings,  object>// You can use this event in JavaScript.

See Also