U​ISettings U​ISettings U​ISettings U​ISettings Class

Definition

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
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()

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

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

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

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

public : unsigned short CaretBlinkRate { get; }public uint CaretBlinkRate { get; }Public ReadOnly Property CaretBlinkRate As uint// You can use this property in JavaScript.
Value
unsigned short 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 : 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

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

public : unsigned short CaretWidth { get; }public uint CaretWidth { get; }Public ReadOnly Property CaretWidth As uint// You can use this property in JavaScript.
Value
unsigned short 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// You can use this property in JavaScript.
Value
Size Size Size Size

The size of a new cursor.

DoubleClickTime DoubleClickTime DoubleClickTime DoubleClickTime

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

public : unsigned short DoubleClickTime { get; }public uint DoubleClickTime { get; }Public ReadOnly Property DoubleClickTime As uint// You can use this property in JavaScript.
Value
unsigned short 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// You can use this property in JavaScript.
Value
HandPreference HandPreference HandPreference HandPreference

The directional preference of the user interface.

MessageDuration MessageDuration MessageDuration MessageDuration

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

public : unsigned short MessageDuration { get; }public uint MessageDuration { get; }Public ReadOnly Property MessageDuration As uint// You can use this property in JavaScript.
Value
unsigned short 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 : unsigned short MouseHoverTime { get; }public uint MouseHoverTime { get; }Public ReadOnly Property MouseHoverTime As uint// You can use this property in JavaScript.
Value
unsigned short 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// You can use this property in JavaScript.
Value
Size Size Size Size

The size of a scroll bar arrow.

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

The size of the scroll bar.

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

The size of the thumb box.

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// 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)

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

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)

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

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

Events

AdvancedEffectsEnabledChanged AdvancedEffectsEnabledChanged AdvancedEffectsEnabledChanged AdvancedEffectsEnabledChanged

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

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

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