QuickOpenOverlay
Family: Navigation & Workflow
Namespace: Tessera.Controls
Use QuickOpenOverlay when this interaction is the best match for your screen workflow.
When to use
- You need a
QuickOpenOverlay-style interaction inside the navigation & workflow lane. - A titled widget surface improves scanability in dense shells.
- You want explicit user-driven events routed into app state updates.
Minimal usage
csharp.cs
using Tessera.Controls;
using Tessera.Layout;
var widget = new QuickOpenOverlay
{
Title = "QuickOpenOverlay"
};
return Screen.Build(window => window.Body(body => body.Center(widget, width: 44, height: 9)));Common pitfalls
- Do not choose
QuickOpenOverlayby name only; validate it against the target workflow. - Keep this control scoped to the navigation & workflow concern; avoid cross-layer state coupling.
- Handle control events by posting/processing messages; avoid hidden mutation in render paths.
- Set focused/normal styles intentionally so keyboard focus remains obvious.
- Keep disabled state explicit and reversible so users understand why actions are blocked.
Public properties
| Property | Type |
|---|---|
BorderStyle | BorderStyle |
BorderStyleText | TesseraStyle |
DisabledStyle | TesseraStyle |
EmptyText | string |
FocusedBorderStyleText | TesseraStyle |
FocusedTitleStyle | TesseraStyle |
FocusMarker | string |
Glyphs | QuickOpenOverlayGlyphSet |
HoveredItemStyle | TesseraStyle |
IsDisabled | bool |
IsFocused | bool |
IsOpen | bool |
IsReadOnly | bool |
ItemStyle | TesseraStyle |
MatchMarkerStyle | TesseraStyle |
MaxVisibleItems | int |
NoMatchesText | string |
Padding | Thickness |
Placeholder | string |
PlaceholderStyle | TesseraStyle |
Query | string |
QueryTextStyle | TesseraStyle |
SelectedItemStyle | TesseraStyle |
ShowFocusMarker | bool |
Title | string |
TitleStyle | TesseraStyle |
Public events
| Event | Type |
|---|---|
Cancelled | EventHandler? |
Submitted | EventHandler<QuickOpenOverlaySubmittedEventArgs>? |