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

ImGui.BeginListBox

  • 开始带边框、可滚动的列表框区域。

    参数

    label
    string | Uint8Array

    控件标签;交互控件也用它生成 ID。可用 ## 后缀区分 ID 而不显示后缀。

    size

    列表框的像素尺寸;零宽度使用当前项宽,零高度约容纳七项,负值相对剩余区域对齐。

    返回值

    boolean

    此作用域打开或激活且可提交内容时返回 true。仅为 true 时调用 EndListBox();为 false 时跳过内容和配对结束调用。

    控件:列表框。

    • 本质上是 BeginChild/EndChild 的薄封装,使用 ImGuiChildFlags.FrameStyle 改变样式,并显示标签。

    • 不需要标签时,直接使用带 ImGuiChildFlags.FrameStyle 的 BeginChild() 通常就能得到相同效果。

    • 可通过创建 Selectable() 或其他任意项目,自由提交内容和管理选择状态。

    • 简化版/旧 ListBox() API 是 BeginListBox()/EndListBox() 的辅助封装,为方便使用而保留,与创建组合框的方式类似。

    • 框宽度:size.x > 0.0 为自定义;size.x < 0.0 或 -FLT_MIN 为右对齐;size.x = 0.0(默认)使用当前 ItemWidth。

    • 框高度:size.y > 0.0 为自定义;size.y < 0.0 或 -FLT_MIN 为底部对齐;size.y = 0.0(默认)使用可容纳约 7 个项目的任意默认高度。打开带框的滚动区域。

    源码与继承

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