Module widget 

Widget types and styling.

Structs

Action

A typed click target: owner 0 = the screen, k = items control k; slot = the command (or Action::SELECT); index = the item index inside an items control (0 elsewhere).

Cell

The grid cell(s) a widget occupies — WPF’s Grid.Row, Grid.Column, Grid.RowSpan, Grid.ColumnSpan. Only a grid reads it; out-of-range values are clamped to the grid (like WPF).

GridSpec

A grid’s rows, columns and the space between them. No rows (columns) = one * row (column), like WPF.

Image

An image widget’s data — see image.

StateFlags

Interaction state bits of a widget — see Widget::state.

StateStyles

A widget’s state patches: each applies when the widget’s state contains its flags; later rules win.

Style

Visual and layout style for a widget.

StylePatch

Paint-only style overrides — never affect layout.

TextBox

A text box’s content and editing state, as drawn this frame. Built by text_box (text, placeholder, max length, event names); the caret, selection and horizontal scroll are filled in each frame by TextBoxState::apply.

Track

One row or column of a GridSpec: its size and the limits on it.

Widget

A single widget in the UI tree.

Enums

Dock

WinForms-style dock — which edge(s) the widget attaches to inside its parent.

FocusStyle

How a focused widget shows its focus indicator.

GridLength

How a grid row or column is sized — WPF’s GridLength.

HAlign

Where a widget sits horizontally in the space its parent gives it — WPF’s HorizontalAlignment. In a grid cell None means Stretch; in a Column it overrides the parent’s align for this child.

Stretch

How an image fills the box it’s given — WPF’s Stretch.

Units

A size value — either a fixed pixel amount, a CSS-style percentage of the parent’s own resolved content size (0.0–100.0), or Auto (size to content/available space, this crate’s original behaviour).

VAlign

Where a widget sits vertically — WPF’s VerticalAlignment; see HAlign.

WidgetKind

Constants

PLACEHOLDER_COLOR

Placeholder text color of a text box.

SELECTION_COLOR

Selection highlight behind selected text.

TEXT_BOX_BORDER

Border of an unfocused text box (vanilla EditBox).

TEXT_BOX_FOCUS_BORDER

Border of a focused text box unless focus_color is set.

Functions

button

grid

WPF’s Grid: a container of rows and columns — give it Widget::rows and Widget::cols (Tracks: pixels, Auto or * shares) and put each child in a cell with Widget::cell / Widget::span. A child fills its cell unless it has Widget::halign / Widget::valign (or an explicit size); Widget::margin insets it.

image

An image from a Yog image source — "item:apple", "block:stone", "sprite:button", "mymod:gui/logo" (see yog_gfx::image) — the host resolves it for its Minecraft version. Sized to the image’s natural size (16×16 until the host told it) unless given w/h; scaled into the widget per Widget::stretch (default Uniform), nearest-neighbour.

inv_slot

An inventory-slot decoration (icon + stack-count overlay) for item_id (empty string = empty slot) with count items. Purely decorative — real drag-and-drop still goes through the vanilla Slot this overlays.

item_slot

label

panel

scroll_view

A vertically scrolling column: clips its children, scrolls them by Widget::scroll_y and draws a scrollbar when they overflow — WPF’s ScrollViewer around a StackPanel. Give it a fixed (or flex) height.

spacer

text_box

A single-line text input holding text — black box, grey border (white while focused), like vanilla’s EditBox. Its text, caret and focus live in a TextBoxState that the code-behind keeps and applies to it each frame.