Enums and value types
Every enum and every value type a component property or an item model carries, with what each member means. A property page links here from its type.
Value types
A length, a colour, a text appearance: built from a static member, or written as its parts.
ColorVariant
| Member | Meaning |
|---|---|
FromRgb(byte red, byte green, byte blue, ColorAdjustment adjustment = ColorAdjustment.None, int factor = 0, byte opacity = 255) | |
FromColor(Color color, ColorAdjustment adjustment = ColorAdjustment.None, int factor = 0) | |
TryParseHex(string text, ColorVariant variant) | |
MinFactor | |
MaxFactor | |
ColorName Name | |
ColorAdjustment Adjustment | |
int Factor | |
byte Opacity | |
int? Rgb |
UIActionArgument
Represents a value, binding, or contextual value passed to a UI action.
| Member | Meaning |
|---|---|
Literal(object value) | Creates a literal action argument from a value. |
CurrentItem() | Creates an action argument resolved from the current item. |
CurrentItemKey() | Creates an action argument resolved from the current item key. |
EventKey(int index) | Creates an action argument resolved from the key at index of the event's own key chain. |
Bind(UIBindingPath binding) | Creates an action argument resolved from a binding path. |
UIActionArgumentKind Kind | How this argument is resolved. |
object Value | The literal value for literal arguments, and the place in the event's key chain for an event key. |
UIBindingPath? Binding | The binding path for binding arguments. |
UIBindingPath
Represents a recursive binding path and the context used to resolve it.
| Member | Meaning |
|---|---|
Relative(RecursivePath path) | Creates a binding path resolved relative to the current binding context. |
Parent(RecursivePath path) | Creates a binding path resolved relative to the parent binding context. |
Root(RecursivePath path) | Creates a binding path resolved relative to the root binding context. |
RecursivePath Path | The recursive binding path. |
UIBindingScope Scope | The context used to resolve the path. |
UIComponentReference
Identifies an authoring component reference before compilation/runtime resolution.
| Member | Meaning |
|---|---|
ValidateDynamicParameters(object[] dynamicParameters) | Validates that all dynamic parameters are supported reference parameter values. |
string Id | The authoring component id. |
object[] DynamicParameters | Dynamic reference parameters used for templated or repeated component instances. |
bool HasDynamicParameters | Whether this reference contains dynamic parameters. |
UICornerRadius
Represents corner radius values for a rectangular UI element.
| Member | Meaning |
|---|---|
All(double topLeft, double topRight, double bottomRight, double bottomLeft) | Creates a corner radius with an independent value for each corner. |
Uniform(double radius) | Creates a corner radius applying the same value to all four corners. |
Top(double radius) | Creates a corner radius rounding only the top corners, leaving the bottom corners square. |
Bottom(double radius) | Creates a corner radius rounding only the bottom corners, leaving the top corners square. |
double TopLeft | The top-left corner's radius, in pixels. |
double TopRight | The top-right corner's radius, in pixels. |
double BottomRight | The bottom-right corner's radius, in pixels. |
double BottomLeft | The bottom-left corner's radius, in pixels. |
UIGridPlacement
Represents a component placement in a fixed-column grid.
UIGridPlacement.Column and UIGridPlacement.Row are 1-based.
| Member | Meaning |
|---|---|
At(int column, int row, int columnSpan = 1, int rowSpan = 1) | Creates a placement at the given column and row with the given spans. |
GridColumns | Gets the number of columns in the standard UI grid. |
int Column | The 1-based column the component starts in. |
int Row | The 1-based row the component starts in. |
int ColumnSpan | How many columns the component covers. |
int RowSpan | How many rows the component covers. |
UIGridUnit
Represents a grid track size, with the floor and ceiling a splitter may move it between.
The platform holds what its layout can hold — a star track's floor, a content track's floor or ceiling — and a GridSplitter clamps to the rest; a fixed track's bounds only say how far it may be dragged.
| Member | Meaning |
|---|---|
Star(double value = 1, double? min = null, double? max = null) | Creates a proportional (star-sized) grid track, optionally bounded by a minimum and/or maximum in pixels. |
Absolute(double value, double? min = null, double? max = null) | Creates a fixed-size grid track, optionally bounded for a splitter by a minimum and/or maximum in pixels. |
Auto(double? min = null, double? max = null) | Creates a content-sized grid track, optionally bounded by a minimum and/or maximum. |
UIGridUnitType Unit | How the track is sized: a fixed length, a share of the free space, or its content. |
double Value | The size in the unit's own terms. |
double? MinValue | The floor a splitter may drag the track down to. |
double? MaxValue | The ceiling a splitter may drag the track up to. |
bool HasBounds | Whether the track carries a floor or a ceiling. |
UILayoutLength
Represents a layout length value.
| Member | Meaning |
|---|---|
Auto() | Creates a layout length that sizes automatically to its content. |
Absolute(double value) | Creates a layout length with a fixed absolute value. |
Fill() | The whole of what the parent gives. |
UILayoutLengthKind Kind | Whether the length is absolute, a share of the free space, or the content's own. |
double Value | The length in the kind's own terms; ignored by the kinds that carry none. |
UIProperty
Represents a UI component property key.
| Member | Meaning |
|---|---|
string Name | The property name. |
UIPropertyReference
Identifies a component property by authoring component reference and property key.
| Member | Meaning |
|---|---|
UIComponentReference Component | The authoring component reference. |
UIProperty Property | The component property key. |
UISelectionStyle
What a chosen item looks like: its ground, its ink, and a mark on one edge; any unset part keeps the control's own default.
Reaches the stylesheet as four custom properties (--ui-selected-*), so a custom look and the built-in ones share one rule set.
| Member | Meaning |
|---|---|
Ground(UIThemeColor background) | A chosen item that says so only by its ground. |
Marked(UISelectionMark mark, UIThemeColor? markColor = null) | A chosen item that says so by a line on one edge, in the given colour or the theme's primary. |
UIThemeColor? Background | The ground a chosen item is drawn on. |
UIThemeColor? Foreground | The ink a chosen item's text takes. |
UISelectionMark? Mark | The edge a chosen item is marked on. |
UIThemeColor? MarkColor | The mark's own colour. |
bool? Bold | Whether a chosen item's text is drawn bold. |
UITemporalStep
Represents a step value for temporal input components.
| Member | Meaning |
|---|---|
Days(int value) | Creates a step measured in days. |
Hours(int value) | Creates a step measured in hours. |
Minutes(int value) | Creates a step measured in minutes. |
Seconds(int value) | Creates a step measured in seconds. |
UITemporalStepUnit Unit | The unit one step counts in. |
int Value | How many units one step moves. |
UITextAppearance
Represents a text's typography: either a semantic UITextType role, or an explicit UITextAppearance.Size override.
When UITextAppearance.Size is set, it always wins over UITextAppearance.Role — mirroring how UIThemeColor's explicit override wins over its semantic style.
| Member | Meaning |
|---|---|
FromRole(UITextType role) | Creates a text appearance tracking the given semantic UITextType role live. |
Custom(double size, int? weight = null, double? lineHeight = null, double? letterSpacing = null) | Creates a text appearance from an explicit font size, optionally overriding weight, line-height, and letter-spacing. |
Display | The largest, most prominent typographic role, for hero-style text, tracked live via UITextAppearance.FromRole. |
Title | The typographic role for primary headings, tracked live via UITextAppearance.FromRole. |
Subtitle | The typographic role for secondary headings, tracked live via UITextAppearance.FromRole. |
Body | The typographic role for regular body text, tracked live via UITextAppearance.FromRole. |
Caption | The typographic role for small, supplementary text, tracked live via UITextAppearance.FromRole. |
Overline | The typographic role for small label text placed above content, tracked live via UITextAppearance.FromRole. |
UITextType? Role | The semantic role the theme's typography sizes the text from; used only while Size is unset. |
double? Size | An explicit size, in pixels, which wins over the role. |
int? Weight | An explicit font weight; read only alongside an explicit size. |
double? LineHeight | An explicit line height, in pixels; read only alongside an explicit size. |
double? LetterSpacing | An explicit letter spacing, in pixels; read only alongside an explicit size. |
UIThemeColor
Represents a themed color: either a semantic UIColorStyle role, or an explicit UIThemeColor.Light/UIThemeColor.Dark override, which always wins when both are set.
| Member | Meaning |
|---|---|
FromStyle(UIColorStyle style) | Creates a theme color tracking the given semantic UIColorStyle role live. |
FromColorVariant(ColorName name, ColorAdjustment adjustment = ColorAdjustment.None, int factor = 0, byte opacity = 255) | Creates a theme color from a fixed color variant, used identically in both light and dark mode. |
FromColorVariant(ColorVariant color) | Creates a theme color from a fixed color variant, used identically in both light and dark mode. |
Create(ColorVariant? light, ColorVariant? dark) | Creates a theme color from explicit light and dark overrides. |
TryParse(string text, UIThemeColor color) | Reads the canonical wire form a client sends back: @Role for a semantic role, #RRGGBBAA for an explicit colour, or Name/Adjustment/factor/opacity for a palette variant. |
Default | Presets mirroring each UIColorStyle role, theme-aware via UIThemeColor.FromStyle. |
Primary | The theme's primary brand color, tracked live via UIThemeColor.FromStyle. |
Accent | The theme's secondary accent color, tracked live via UIThemeColor.FromStyle. |
Background | The page/surface background color, tracked live via UIThemeColor.FromStyle. |
Surface | A raised surface's background color (e.g. a card), tracked live via UIThemeColor.FromStyle. |
OnPrimary | A color intended to sit on top of UIThemeColor.Primary, tracked live via UIThemeColor.FromStyle. |
OnAccent | A color intended to sit on top of UIThemeColor.Accent, tracked live via UIThemeColor.FromStyle. |
OnBackground | A color intended to sit on top of UIThemeColor.Background, tracked live via UIThemeColor.FromStyle. |
OnSurface | A color intended to sit on top of UIThemeColor.Surface, tracked live via UIThemeColor.FromStyle. |
Info | The informational status color, tracked live via UIThemeColor.FromStyle. |
Warning | The warning status color, tracked live via UIThemeColor.FromStyle. |
Success | The success status color, tracked live via UIThemeColor.FromStyle. |
Danger | The danger/error status color, tracked live via UIThemeColor.FromStyle. |
OnInfo | A color intended to sit on top of UIThemeColor.Info, tracked live via UIThemeColor.FromStyle. |
OnWarning | A color intended to sit on top of UIThemeColor.Warning, tracked live via UIThemeColor.FromStyle. |
OnSuccess | A color intended to sit on top of UIThemeColor.Success, tracked live via UIThemeColor.FromStyle. |
OnDanger | A color intended to sit on top of UIThemeColor.Danger, tracked live via UIThemeColor.FromStyle. |
Muted | A dimmed variant of the ambient color, for secondary/de-emphasized text, tracked live via UIThemeColor.FromStyle. |
Selected | The chrome token indicating a selected item or state, tracked live via UIThemeColor.FromStyle. |
FocusRing | The focus indicator ring color, tracked live via UIThemeColor.FromStyle. |
Border | The default border color, tracked live via UIThemeColor.FromStyle. |
Shadow | The drop shadow color, tracked live via UIThemeColor.FromStyle. |
Overlay | The modal/scrim overlay color, tracked live via UIThemeColor.FromStyle. |
UIColorStyle? Style | The semantic role the palette resolves the colour from. |
ColorVariant? Light | An explicit colour for the light theme, which wins over the style. |
ColorVariant? Dark | An explicit colour for the dark theme, which wins over the style. |
UIThickness
Represents thickness values for the four sides of a rectangular UI element.
| Member | Meaning |
|---|---|
All(double left, double top, double right, double bottom) | Creates a thickness with an independent value for each side. |
Uniform(double value) | Creates a thickness applying the same value to all four sides. |
Symmetric(double horizontal, double vertical) | Creates a thickness applying one value to the left/right sides and another to the top/bottom sides. |
double Left | The left side's value, in pixels. |
double Top | The top side's value, in pixels. |
double Right | The right side's value, in pixels. |
double Bottom | The bottom side's value, in pixels. |
UIValidationMessage
A validation message a controller puts on an input: the severity and the text. Null on the property means none.
| Member | Meaning |
|---|---|
Error(string message) | A message that refuses the value. |
Warning(string message) | A message that warns about the value without refusing it. |
Info(string message) | A message that only tells the viewer something about the value. |
UIValidationSeverity Severity | How the message is drawn and whether it refuses a submit. |
string Message | The text shown under the input, or in its marker's tooltip. |
Enums
ColorAdjustment
| Member | Meaning |
|---|---|
None | |
Shade | |
Tint |
ColorName
| Member | Meaning |
|---|---|
IronFog | |
SilverNight | |
BronzeDusk | |
StellarRed | |
NebulaRose | |
LunarPink | |
SolarAmber | |
NebulaGold | |
LunarYellow | |
EclipseOlive | |
NebulaLime | |
LunarSage | |
AuroraGreen | |
NebulaMint | |
LunarFern | |
AstralTeal | |
NebulaCyan | |
LunarMoss | |
QuantumBlue | |
NebulaAqua | |
LunarAzure | |
NovaPurple | |
NebulaViolet | |
LunarLavender | |
Comet | |
Flare | |
Ember | |
Photon | |
Vortex | |
Halo |
UIActionArgumentKind
Defines how an interaction action argument is resolved.
| Member | Meaning |
|---|---|
Literal | The argument value is a fixed literal. |
CurrentItem | The argument value is the current item of the enclosing items scope. |
CurrentItemKey | The argument value is the key of the current item of the enclosing items scope. |
Binding | The argument value is resolved from a binding. |
EventKey | The argument value is one key of the event's own chain, by its place in it — for an event that names its keys itself. |
UIAlignment
Defines cross-axis or main-axis alignment for UI layout.
| Member | Meaning |
|---|---|
Start | Aligns content to the start of the axis. |
Center | Aligns content to the center of the axis. |
End | Aligns content to the end of the axis. |
Stretch | Stretches content to fill the axis. |
UIBadgeType
Defines visual variants for badge-like components.
| Member | Meaning |
|---|---|
Primary | The theme's primary brand color variant. |
Accent | The theme's secondary accent color variant. |
Info | The informational status color variant. |
Warning | The warning status color variant. |
Success | The success status color variant. |
Danger | The danger/error status color variant. |
Surface | A card-like distinct background variant with no color accent. |
UIBindingMode
Defines how data flows between a binding source and a UI target.
| Member | Meaning |
|---|---|
OneWay | Updates flow only from the binding source to the UI target. |
TwoWay | Updates flow in both directions between the binding source and the UI target. |
OneWayToSource | Updates flow only from the UI target to the binding source. |
OnSubmit | Target-to-source updates are buffered until an explicit submit occurs. |
UIBindingScope
Defines the component context used to resolve a binding path.
| Member | Meaning |
|---|---|
Relative | Resolves the binding path relative to the component's own context. |
Parent | Resolves the binding path relative to the parent component's context. |
Root | Resolves the binding path relative to the root context. |
UIButtonSize
How much room a button takes, independent of what it holds.
| Member | Meaning |
|---|---|
Small | Sized to sit inside a row, a toolbar or a list without setting its height. |
Medium | The ordinary control height — a button standing on its own. |
Large | A call to action, where the button is the point of what it sits in. |
UIButtonType
Defines visual variants for button-like components.
| Member | Meaning |
|---|---|
Primary | The theme's primary brand color variant. |
Accent | The theme's secondary accent color variant. |
Danger | The danger/error status color variant. |
Outline | A bordered variant with a transparent background. |
Ghost | A borderless, transparent-background variant. |
Link | A variant styled as an inline text link. |
Surface | A raised surface with no tint of its own — what a row in a list of destinations looks like, and the variant ActionComponent starts on. |
UIColorInputVariant
How a colour input presents itself when it is closed.
| Member | Meaning |
|---|---|
Field | A field, reading the colour as text, with a swatch beside it and the picker's own button. |
Swatch | A swatch alone, with the colour written across it. |
UIColorStyle
Defines semantic color roles used by UI components.
| Member | Meaning |
|---|---|
Default | No explicit color override; inherits the ambient color. |
Primary | The theme's primary brand color. |
Accent | The theme's secondary accent color. |
Background | The page/surface background color. |
Surface | A raised surface's background color (e.g. a card). |
OnPrimary | A color intended to sit on top of UIColorStyle.Primary. |
OnAccent | A color intended to sit on top of UIColorStyle.Accent. |
OnBackground | A color intended to sit on top of UIColorStyle.Background. |
OnSurface | A color intended to sit on top of UIColorStyle.Surface. |
Info | The informational status color. |
Warning | The warning status color. |
Success | The success status color. |
Danger | The danger/error status color. |
OnInfo | A color intended to sit on top of UIColorStyle.Info. |
OnWarning | A color intended to sit on top of UIColorStyle.Warning. |
OnSuccess | A color intended to sit on top of UIColorStyle.Success. |
OnDanger | A color intended to sit on top of UIColorStyle.Danger. |
Muted | A dimmed variant of the ambient color, for secondary/de-emphasized text. |
Selected | The color indicating a selected item or state. |
FocusRing | The color of the focus indicator ring around focused elements. |
Border | The default border color. |
Shadow | The color used for drop shadows. |
Overlay | The color used for modal/scrim overlay backgrounds. |
UIColorTextFormat
How a colour input writes the colour it holds.
| Member | Meaning |
|---|---|
Hex | #RRGGBB, and #RRGGBBAA once the colour is not fully opaque. |
Rgb | rgb(r, g, b), and rgba(r, g, b, a) once the colour is not fully opaque. |
UIComparisonOperator
Defines comparison operators used by UI validation and interaction rules.
| Member | Meaning |
|---|---|
Required | The value must be present (not null, empty, or whitespace). |
Equal | The value must equal the comparison value. |
NotEqual | The value must not equal the comparison value. |
Greater | The value must be greater than the comparison value. |
GreaterOrEqual | The value must be greater than or equal to the comparison value. |
Less | The value must be less than the comparison value. |
LessOrEqual | The value must be less than or equal to the comparison value. |
Like | The value must contain the comparison value as a substring. |
In | The value must be contained in the comparison value's collection. |
Regex | The value must match the comparison value as a regular expression. |
LikeIgnoreCase | The value must contain the comparison value as a substring, ignoring case. |
UIDayOfWeek
Defines days of week using Monday as the first day.
| Member | Meaning |
|---|---|
Monday | Monday. |
Tuesday | Tuesday. |
Wednesday | Wednesday. |
Thursday | Thursday. |
Friday | Friday. |
Saturday | Saturday. |
Sunday | Sunday. |
UIGridUnitType
Defines the unit type used by grid layout measurements.
| Member | Meaning |
|---|---|
Star | A proportional share of the remaining available space. |
Absolute | A fixed size expressed in device-independent units. |
Auto | Sized to fit its content, optionally bounded by a minimum and/or maximum. |
UIGroupSeparator
Defines what a bar draws between two groups of its items.
| Member | Meaning |
|---|---|
None | Nothing: the groups run into each other. |
Gap | A step of air wider than the spacing between items. |
Rule | A hairline across the bar. |
UIIconSize
Defines standard icon sizes used by UI components.
| Member | Meaning |
|---|---|
Small | The smallest standard icon size. |
Medium | The default, medium icon size. |
Large | The largest standard icon size. |
UIImageFit
Defines how an image is fitted into its layout bounds; null leaves it to the platform's default.
| Member | Meaning |
|---|---|
Fill | Stretches the image to fill its bounds, ignoring aspect ratio. |
Contain | Scales the image to fit entirely within its bounds while preserving aspect ratio. |
Cover | Scales the image to cover its bounds while preserving aspect ratio, cropping if needed. |
None | Renders the image at its natural size, without scaling. |
UIImageInputShape
The shape an image input takes.
| Member | Meaning |
|---|---|
Picture | A large picture: a drop area with the picture as its preview. |
Avatar | A small round picture replaced in place — a person, a team, a project. |
Inline | A row like the file input's: a thumbnail, the picture's name, and the pick control at the end. |
UIInputAppearance
Defines how an input draws the surface around its field.
| Member | Meaning |
|---|---|
Filled | One fill and no visible edge: the field reads as the surface one level above the page it sits on. |
Outline | No fill, and a border all the way round. |
Underline | No fill, and a single rule under the text — what an edit-in-place field wants. |
Ghost | No box until it is touched: the text sits on whatever is behind it, a wash under the pointer says it can be edited, the ring says it is. Tighter than the others, for a field that stands in a row of a list. |
UIItemsHostMode
How an items host holds its rows.
| Member | Meaning |
|---|---|
Plain | Every row is in the document. |
Virtualized | The client holds every item's value and keeps only the rows in view in the document. |
Windowed | The items come from a source on the controller, one window at a time. |
UIItemsLayoutType
Defines layout modes for items-based components.
| Member | Meaning |
|---|---|
Stack | Lays out items sequentially along a single axis. |
Wrap | Flows items left to right, wrapping onto new lines when space runs out. An item takes its content's width; a template root with a placement takes that span of the 24-column grid instead (a span of 6 is four items to a line). |
UIItemsSortDirection
Defines the sort direction for an items view.
| Member | Meaning |
|---|---|
Ascending | Sorts items from lowest to highest. |
Descending | Sorts items from highest to lowest. |
UILayoutLengthKind
Defines the kind of layout length value.
| Member | Meaning |
|---|---|
Auto | The length is determined automatically based on content. |
Absolute | The length is a fixed value expressed in device-independent units. |
Fill | The whole of what the parent gives: a page that fills the viewport, a pane that fills its track. |
UIMenuItemKind
Defines what one entry of a menu is: a selectable item, a section header, a separator, an option with a check mark, or a setting whose choices open beside it.
| Member | Meaning |
|---|---|
Item | A selectable entry: icon, title, and either a URL or a command. |
Header | A caption introducing the entries below it. Not selectable. |
Separator | A rule between entries. Carries no content. |
Check | An option that is on or off: a check mark at the entry's end says which. The click is the entry's command; the controller flips Checked. |
Select | A setting: its current Value at the entry's end, and its nested entries — the choices — opening beside it on click, whatever the menu's fold. |
UIOrientation
Defines horizontal or vertical orientation.
| Member | Meaning |
|---|---|
Horizontal | Content flows along the horizontal axis. |
Vertical | Content flows along the vertical axis. |
UIOverflow
Defines whether a container clips content that overflows its bounds.
| Member | Meaning |
|---|---|
Hidden | Content that overflows the container's bounds is clipped. |
Show | Content that overflows the container's bounds remains visible. |
UIPopupPlacement
Defines where a popup prefers to sit relative to its anchor; a side with no room for it flips to its opposite.
| Member | Meaning |
|---|---|
BottomStart | Below the anchor, aligned to its start edge. |
Bottom | Below the anchor, centered on it. |
BottomEnd | Below the anchor, aligned to its end edge. |
TopStart | Above the anchor, aligned to its start edge. |
Top | Above the anchor, centered on it. |
TopEnd | Above the anchor, aligned to its end edge. |
LeftStart | To the left of the anchor, aligned to its start edge. |
Left | To the left of the anchor, centered on it. |
LeftEnd | To the left of the anchor, aligned to its end edge. |
RightStart | To the right of the anchor, aligned to its start edge. |
Right | To the right of the anchor, centered on it. |
RightEnd | To the right of the anchor, aligned to its end edge. |
UIProgressVariant
Defines progress indicator presentation variants.
| Member | Meaning |
|---|---|
Linear | Renders progress as a horizontal bar. |
Circular | Renders progress as a circular ring. |
UIResponsiveTier
One of the viewport tiers a UIResponsive value names — where each starts above the base is the platform's breakpoint table (640, 768, 1280 and 1536 CSS pixels on the web).
| Member | Meaning |
|---|---|
Base | The narrowest viewport, where every responsive value starts; a column hidden below it is never hidden. |
Sm | |
Md | |
Xl | |
Xxl |
UIScrollAnchor
Defines how a scrollable container reacts when its content grows.
| Member | Meaning |
|---|---|
None | The container keeps its scroll position, which is the platform's own behavior. |
End | The container follows content appended at the end while the viewer is already at the end. |
UIScrollMode
Defines scroll behavior for scrollable UI regions.
| Member | Meaning |
|---|---|
Disabled | Scrolling is disabled; overflowing content is not reachable by scrolling. |
Auto | Scrolling is enabled only when content overflows the available space. |
Always | Scrolling is always enabled, regardless of whether content overflows. |
UIScrollSnapMode
Defines the strictness with which a scrollable region snaps to item boundaries.
| Member | Meaning |
|---|---|
Disabled | Scroll snapping is disabled. |
Proximity | The scroll position snaps to the nearest boundary only when it comes to rest near one. |
Mandatory | The scroll position always snaps to a boundary at the end of scrolling. |
UISearchSelectionDisplayMode
Defines how a selected search item is displayed in the search input.
| Member | Meaning |
|---|---|
KeepSearchInput | Keeps the user's typed search text in the input after a selection is made. |
ReplaceWithSelectedItem | Replaces the input's text with the selected item's display value. |
UISelectionMark
Defines the edge a chosen item draws its mark on — the line a tab has under it, a sidebar entry has beside it — or that it draws none.
| Member | Meaning |
|---|---|
None | No mark: the ground and the ink say it. |
Left | A line down the left edge. |
Right | A line down the right edge. |
Top | A line along the top edge. |
Bottom | A line along the bottom edge. |
UISelectionMode
Defines how many of a list's items the viewer can have chosen at once.
| Member | Meaning |
|---|---|
None | None: the rows are not chosen by clicking them. |
One | One at a time — choosing a row lets the previous one go. |
Many | Any number — a click toggles the row it lands on. |
UISide
Defines the edge of its parent a component is attached to — the side a panel folds toward when it collapses.
| Member | Meaning |
|---|---|
Left | The left edge. |
Right | The right edge. |
Top | The top edge. |
Bottom | The bottom edge. |
UISplitButtonMode
Which part of a split button opens its menu.
| Member | Meaning |
|---|---|
Split | The main part runs the button's own command; the end part opens the menu. |
Menu | The whole button opens the menu — a menu button; the button's own click command is not used. |
UISurfaceStyle
What a bordered surface is made of.
| Member | Meaning |
|---|---|
Background | The page's own background inside a border — a surface that reads as part of the page. |
Raised | A panel lifted off the page it sits on, with its own fill and shadow. |
Tinted | The surface's own colour mixed into the page instead of painted over it; takes the colour from Background, falling back to the theme's primary when none is set. |
UITemporalStepUnit
Defines time units used by temporal input step values.
| Member | Meaning |
|---|---|
Day | The step value is expressed in days. |
Hour | The step value is expressed in hours. |
Minute | The step value is expressed in minutes. |
Second | The step value is expressed in seconds. |
UITextAlignment
Defines text alignment within its layout bounds.
| Member | Meaning |
|---|---|
Start | Aligns text to the leading edge of its container. |
Center | Centers text within its container. |
End | Aligns text to the trailing edge of its container. |
Justify | Stretches text so each line fills the width of its container. |
UITextAreaResizeMode
Defines resize behavior for multiline text input components.
| Member | Meaning |
|---|---|
None | The text area cannot be resized by the user. |
Vertical | The text area can be resized vertically only. |
Horizontal | The text area can be resized horizontally only. |
Both | The text area can be resized both horizontally and vertically. |
UITextBadgeAlignment
Defines where a trailing badge sits against the text beside it.
| Member | Meaning |
|---|---|
Title | On the title's own line, at its far end — the badge marks the title. |
Content | Centred against title and description together — the badge stands for the whole block. |
UITextBadgePlacement
Defines where a badge in text content is placed.
| Member | Meaning |
|---|---|
Inline | The badge is placed inline within the text content. |
Trailing | The badge is placed after the text content. |
UITextIconAlignment
Where a text body's leading icon sits against the text beside it.
| Member | Meaning |
|---|---|
Title | On the title's own line, with the description flowing underneath it — the icon marks the title. |
Content | Centred against title and description together — the icon stands for the whole block, as in a list row or a card header. |
UITextInputType
Defines semantic input types for text input components.
| Member | Meaning |
|---|---|
Text | Plain, unformatted text input. |
Email | Input intended for an email address, with matching keyboard/validation hints. |
Password | Input intended for a password, masking the entered characters. |
Search | Input intended for a search query. |
Tel | Input intended for a telephone number, with matching keyboard hints. |
Url | Input intended for a URL, with matching keyboard/validation hints. |
UITextType
Defines semantic text roles used by text components.
| Member | Meaning |
|---|---|
Display | The largest, most prominent typographic role, for hero-style text. |
Title | The typographic role for primary headings. |
Subtitle | The typographic role for secondary headings. |
Body | The typographic role for regular body text. |
Caption | The typographic role for small, supplementary text. |
Overline | The typographic role for small label text placed above content. |
UITextWrapMode
Defines text wrapping behavior. A wrapping text is clamped by MaxLines, with an ellipsis on the last line it keeps.
| Member | Meaning |
|---|---|
NoWrap | Text is kept on a single line, overflowing its container if needed. |
Wrap | Text wraps onto multiple lines as needed to fit its container. |
UIThemeMode
The two themes a surface can be forced into. null means "inherit" on a component and "follow the platform" on a session.
| Member | Meaning |
|---|---|
Light | Always uses the light theme. |
Dark | Always uses the dark theme. |
UIValidationPresentation
Where a field's validation message goes: a line under the field, or a mark at its edge that speaks in a tooltip.
| Member | Meaning |
|---|---|
Auto | A line under the field, except where the field sits in a cell of a grid — a table's, a key-value row's — where it is a mark. |
Message | A line under the field, wherever the field is. |
Marker | A mark at the field's edge, the message in its tooltip; the field keeps its height. |
UIValidationSeverity
What a validation message means: an error stops a submit, a warning and an info only say something.
| Member | Meaning |
|---|---|
Error | Blocks a submit and draws both the required marker and the field's edge. |
Warning | Colours the field's edge but never blocks a submit. |
Info | Speaks only under the field, without touching its edge or blocking a submit. |
UIValidationTrigger
Defines when a UI validation rule is evaluated.
| Member | Meaning |
|---|---|
Change | The rule is evaluated whenever the value changes. |
Blur | The rule is evaluated when the input loses focus. |
Submit | The rule is evaluated when the form is submitted. |
UIVisibility
Defines what a component does with the room it was given: fills it, keeps it empty, or gives it back.
| Member | Meaning |
|---|---|
Visible | Drawn, and taking part in everything: layout, hit-testing, focus and assistive technology. |
Hidden | Not drawn, but still holding its place — the layout around it does not move. |
Collapsed | Gone from the layout as well: everything after it closes the gap. |