# yuiPointerAcquisitionResult

A yui pointer acquisition result record carrying treeIdentity, status, pointerId, routeTargetId, endpointTargetId, and related state.

Last updated: 2026-09-09

Package: ui | Status: source-declared

Tags: cpu, method, source-example, thing, ui, yeho

Build YUI's reusable control, layout, interaction, text, accessibility, and retained-rendering models.

```yh
external thing yuiPointerAcquisitionResult
```

- yuiTreeInstanceIdentity treeIdentity: Stores tree identity as yuiTreeInstanceIdentity.
- text status: Stores status as text.
- text pointerId: Stores pointer id as text.
- text routeTargetId: Stores route target id as text.
- text endpointTargetId: Stores endpoint target id as text.
- text continuousTargetId: Stores continuous target id as text.
- bool captured: Stores captured as bool.
- bool endpointHit: Stores endpoint hit as bool.
- bool sweptHit: Stores swept hit as bool.
- bool sweptOnly: Stores swept only as bool.
- bool sweepAdmitted: Stores sweep admitted as bool.
- int candidatesChecked: Stores candidates checked as int.
- int providerGeneration: Stores provider generation as int.
- int timestampMicroseconds: Stores timestamp microseconds as int.
- int sampleSequence: Stores sample sequence as int.
- int treeRevision: Stores tree revision as int.
- bool treeBound: Stores tree bound as bool.
- text diagnostic: Stores diagnostic as text.
- yuiPointerAcquisitionResult(): Yui pointer acquisition result.
- BindTree(yuiTree tree): Bind tree.
- BelongsToTree(yuiTree tree) returns bool: Belongs to tree.
- CanBeginSemanticDown(yuiTree tree) returns bool: Can begin semantic down.
- CanActivate(yuiTree tree, text pressedNodeId) returns bool: Can activate.
- Fingerprint() returns text: Fingerprint.

## Use yuiPointerAcquisitionResult

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

Verification: type checked

```yh
using ui

// Build YUI's reusable control, layout, interaction, text, accessibility, and retained-rendering models.
yuiPointerAcquisitionResult sample = yuiPointerAcquisitionResult()
Console.Log(Text.From(sample.status))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiPointerAcquisitionResult/usage --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiPointerAcquisitionResult.BindTree

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

Verification: type checked

```yh
using ui

// Bind tree.
yuiPointerAcquisitionResult instance = yuiPointerAcquisitionResult()
yuiTree argument_tree = yuiTree("id")
instance.BindTree(argument_tree)
Console.Log("BindTree completed")

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiPointerAcquisitionResult/method-BindTree-19 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiPointerAcquisitionResult.BelongsToTree

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

Verification: type checked

```yh
using ui

// Belongs to tree.
yuiPointerAcquisitionResult instance = yuiPointerAcquisitionResult()
yuiTree argument_tree = yuiTree("id")
bool result = instance.BelongsToTree(argument_tree)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiPointerAcquisitionResult/method-BelongsToTree-20 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiPointerAcquisitionResult.CanBeginSemanticDown

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

Verification: type checked

```yh
using ui

// Can begin semantic down.
yuiPointerAcquisitionResult instance = yuiPointerAcquisitionResult()
yuiTree argument_tree = yuiTree("id")
bool result = instance.CanBeginSemanticDown(argument_tree)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiPointerAcquisitionResult/method-CanBeginSemanticDown-21 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiPointerAcquisitionResult.CanActivate

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

Verification: type checked

```yh
using ui

// Can activate.
yuiPointerAcquisitionResult instance = yuiPointerAcquisitionResult()
yuiTree argument_tree = yuiTree("id")
text argument_pressedNodeId = "argument pressed Node Id"
bool result = instance.CanActivate(argument_tree, argument_pressedNodeId)
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiPointerAcquisitionResult/method-CanActivate-22 --backend cpu-oracle -o /tmp/yeho-example
/tmp/yeho-example
```


## yuiPointerAcquisitionResult.Fingerprint

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

Verification: type checked

```yh
using ui

// Fingerprint.
yuiPointerAcquisitionResult instance = yuiPointerAcquisitionResult()
text result = instance.Fingerprint()
Console.Log(Text.From(result))

```

Save this beside start.yh as project.mech:

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

[app]
kind = "headless"

[[dependencies]]
package = "graphics.image"
version = "0.1.0"
path = "../../../yeho/packages/graphics/image"

[[dependencies]]
package = "graphics.text"
version = "0.1.0"
path = "../../../yeho/packages/graphics/text"

[[dependencies]]
package = "host.ui_services"
version = "0.1.0"
path = "../../../yeho/packages/host/ui_services"

[[dependencies]]
package = "ui"
version = "0.2.0"
path = "../../../yeho/packages/ui"

```

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/ui--yuiPointerAcquisitionResult/method-Fingerprint-23 --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/ui/interaction-model.yh

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