# nativeWindowReferenceState

A native window reference state record carrying id, ownerId, title, x, y, and related state.

Last updated: 2026-09-09

Package: window.multi | Status: source-declared

Tags: cpu, method, multi, source-example, thing, window, window.multi, yeho

Describe multiple windows, input events, lifecycle, and capabilities with typed records.

```yh
external thing nativeWindowReferenceState
```

- text id: Stores id as text.
- text ownerId: Stores owner id as text.
- text title: Stores title as text.
- int x: Stores x as int.
- int y: Stores y as int.
- int width: Stores width as int.
- int height: Stores height as int.
- bool open: Stores open as bool.
- bool visible: Stores visible as bool.
- bool focused: Stores focused as bool.
- bool minimized: Stores minimized as bool.
- int scalePercent: Stores scale percent as int.
- text monitorId: Stores monitor id as text.
- int redrawCount: Stores redraw count as int.
- int keyboardCount: Stores keyboard count as int.
- int pointerCount: Stores pointer count as int.
- bool closeRequested: Stores close requested as bool.
- nativeWindowReferenceState(nativeWindowSpec spec): Native window reference state.
- Describe() returns text: Describe.

## Use nativeWindowReferenceState

A complete small caller. Values are illustrative; check the returned result and package requirements before connecting live resources.

Verification: type checked

```yh
using window.multi

// Describe multiple windows, input events, lifecycle, and capabilities with typed records.
nativeWindowReferenceState sample = nativeWindowReferenceState(nativeWindowSpec("id", "owner Id", "Inventory", 1, 1, true))
Console.Log(Text.From(sample.id))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferencestate"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceState/usage --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## nativeWindowReferenceState.Describe

A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.

Verification: type checked

```yh
using window.multi

// Describe.
nativeWindowReferenceState instance = nativeWindowReferenceState(nativeWindowSpec("id", "owner Id", "Inventory", 1, 1, true))
text result = instance.Describe()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

```toml
manifestVersion = "2"
package = "api.example.window_multi__nativewindowreferencestate"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"

[[dependencies]]
package = "window.multi"
version = "0.1.0"
path = "../../../yeho/packages/window/multi"

```

Extract the example archive beside the yeho and dolphin checkouts. This example requires those source dependencies and a current developer compiler.

```sh
./yeho/build/dolphin-metal/yehoc ./api-examples/window.multi--nativeWindowReferenceState/method-Describe-18 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


Package presence and a declaration do not establish support on every host. Host services need their platform and lifecycle setup.

Source: yeho/packages/window/multi/10-reference-runtime.yh

AI training permission: https://demonhunterlabs.com/ai-use