API 参考
正在准备搜索索引…

ImGui.Begin

  • 开始窗口或向窗口追加内容。

    参数

    name
    string | Uint8Array

    窗口名称,用于持久 ID 和标题显示;可用 ### 将标题与 ID 分离。

    p_open
    null | Uint8Array = null

    Uint8Array[0] 中的可选打开状态,只能写入 0(关闭)或 1(打开)。 关闭按钮写入 0;null 不显示关闭按钮。原生调用直接访问此可写内存。

    flags
    number = 0

    控制此操作的 ImGuiWindowFlags 选项;可用 | 组合兼容的标志位。

    返回值

    boolean

    应提交窗口内容时返回 true;折叠或完全裁剪时为 false。即使为 false 也必须调用 End()。

    • Begin() 将窗口压入栈并开始追加内容。每次 Begin() 后都必须调用 End(),即使返回 false 也不例外。

    • 返回 false 表示窗口已折叠或完全被裁剪,可跳过窗口内容,但仍须调用 End()。与大多数 BeginXXX()/EndXXX() 对不同,Begin() 和 BeginChild() 始终要求匹配的结束调用。

    • 将 Uint8Array 作为 p_open 传入可显示关闭按钮。首个元素保存打开状态;点击关闭按钮会将 p_open[0] 写为 0。传入 null 则不显示关闭按钮。应用根据该状态决定是否再次调用 Begin()。

    • 同一帧内可通过多组 Begin()/End() 向同一窗口追加内容。只有首次 Begin() 会采用 flags 和 p_open。

    • 窗口栈底始终包含名为 "Debug" 的窗口。

    源码与继承

Icons made by Lorc, Delapouite & Skoll · game-icons.net · CC BY 3.0