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

ImGui.BeginTable

  • 开始表格。

    参数

    str_id
    string | Uint8Array

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

    columns
    number

    要创建或冻结的列数。

    flags
    number = 0

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

    返回值

    boolean

    表格可见且可以提交行时为 true。仅为 true 时调用 EndTable();为 false 时跳过此作用域的所有表格命令。

    表格替代旧式 Columns API。示例和选项见 Demo > Tables、imgui_tables.cpp、ImGuiTableFlags 和 ImGuiTableColumnFlags。

    1. 调用 BeginTable(),返回 false 时跳过表格。
    2. 可通过 TableSetupColumn() 声明列,通过 TableSetupScrollFreeze() 冻结行或列。
    3. 可调用 TableHeadersRow(),使用已声明的列名生成表头。
    4. 填充单元格后,仅在 BeginTable() 返回 true 时调用 EndTable()。

    与旧式 Columns API 不同,必须显式选择首个单元格。TableNextColumn() 会自动换到下一行。以下序列均有效:

    TableNextRow() -> TableSetColumnIndex(0) -> Text("Hello 0") ->
    TableSetColumnIndex(1) -> Text("Hello 1")
    TableNextRow() -> TableNextColumn() -> Text("Hello 0") -> TableNextColumn()
    -> Text("Hello 1")
    TableNextColumn() -> Text("Hello 0") -> TableNextColumn() -> Text("Hello 1")
    

    TableNextRow() -> Text("Hello 0") 无效:未选择列,文本不会显示。

    此辅助函数使用 outer_size = (0, 0) 和 inner_width = 0。

    源码与继承

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