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

ImGui.BeginChild

  • 开始具有独立滚动和裁剪区域的子窗口。

    参数

    str_id
    string | Uint8Array

    字符串标识符,与当前 ID 栈一起散列以区分此项或作用域。

    size

    子窗口像素宽高:0 使用剩余区域,正值固定尺寸,负值从剩余空间中减去其绝对值。

    child_flags
    number = 0

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

    window_flags
    number = 0

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

    返回值

    boolean

    应提交子窗口内容时返回 true,完全裁剪或折叠时为 false。即使为 false 也须调用 EndChild(),旧式 frame 辅助函数用 EndChildFrame()。

    子窗口在父窗口内提供独立的滚动和裁剪区域,也可嵌套其他子窗口。

    • 每个尺寸轴可独立设置:0 使用父窗口剩余空间;正值指定尺寸;负值表示距离可用内容区域右边界或下边界的间距。

    • ImGuiChildFlags.AutoResizeX 和 ImGuiChildFlags.AutoResizeY 根据内容自动调整对应轴。对于滚动区域,不建议同时启用两者。

    • 每次 BeginChild() 后都必须调用 EndChild(),即使返回 false 也不例外。false 表示子窗口已折叠或完全被裁剪,可跳过其内容。这与 Begin()/End() 相同,但不同于大多数仅在开始调用返回 true 时才结束的配对函数。

    • 从 1.90(2023 年 11 月)起,子窗口标志替代旧的布尔边框参数。无边框使用 0 或 ImGuiChildFlags.None,有边框使用 ImGuiChildFlags.Borders。边框标志保留数值 1 以兼容旧接口。

    源码与继承

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