BlzFrameGetChild

Parameters

frame	framehandle
index	integer

comment

Returns a direct child frame at a zero-based index. Valid indices are 0 to BlzFrameGetChildrenCount(frame) - 1. String and Texture SimpleFrame children are not included.

bug

This native performs no bounds checking. An invalid index can crash the game.

bug

In affected 1.32 builds, acquiring a frame through BlzFrameGetChild before acquiring the same frame through BlzGetOriginFrame can make the later origin-frame lookup return an invalid handle.

note

Default UI child counts and indices can change with game state. Prefer named frames or origin frames when available.

note

The first call that returns a child not yet known to the map script consumes a handle ID. Acquire it for all players before using it inside a GetLocalPlayer() block.

async

This function is asynchronous. The values it returns are not guaranteed to be the same for each player. If you attempt to use it in an synchronous manner it may cause a desync.

patch

1.32.10.18820

Source

common.j (raise an issue to discuss on Github or submit a PR)

return type

framehandle

Source code

native BlzFrameGetChild                            takes framehandle frame, integer index returns framehandle