# Window.PointerEventValue

Last updated: 2026-09-09

Read a field from a latched pointer event without pumping or changing it.

Built into Yeho; no import is needed. These additions have Windows CPU-oracle developer-host evidence. Kyber rejects these operations; this does not qualify Starfish or other targets.

`Window.PointerEventValue(int handle, int field) -> int`

Windows CPU-oracle only. Invalid handles or fields return zero. Other hosts throw window.pointer.unsupported. Native fields are provider-specific rather than a portable multitouch guarantee. Handle 0 only illustrates the type-checked call shape.

Contract and host execution evidence: yeho/docs/runtime/hardware-host-tools.md. This small example was type checked, not executed.

## Parameters

- handle (int): Window handle whose latest event was latched by PollPointerEvent.
- field (int): Stable field ID: 0 kind, 1 sequence, 2 discontinuity, 15 wheel delta, 16/17 client coordinates, 20 capture, 21 capture lost, 22 cancelled.

## Type-checked example

```yeho
int handle = 0
bool available = Window.PollPointerEvent(handle)
int kind = Window.PointerEventValue(handle, 0)
```

project.mech:

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

[app]
kind = "headless"
```

Source: yeho/src/compiler/common/intrinsic_registry.cpp:1113