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