Using 'hover_visibility_delay' allows us to hide the highlight and mouse cursor for a short time, which can be convenient to reduce visual noise.

Helper functions to demonstrate programmatic constraints

Portable helpers

Those light colors are better suited with a thicker font than the default one + FrameBorder

Dockables uses Name/ID in the global namespace. Non-dockable items use the ID stack.

Called on manual closure attempt

This is called only once a frame before by the first call to ItemTab() The reason we're not calling it in BeginTabBar() is to leave a chance to the us

The *TabId fields be already set by the docking system _before_ the actual TabItem was created, so we clear them regardless.

Note: we may scroll to tab that are not selected! e.g. using keyboard arrow keys

Render text label (with custom clipping) + Unsaved Document marker + Close Button logic We tend to lock style.FramePadding for a given tab-bar, hence

Apply queued resizing/reordering/hiding requests

[Internal] Called by TableSetColumnIndex()/TableNextColumn() This is called very frequently, so we need to be mindful of unnecessary overhead. FIXME-T

For reference, the average total _allocation count_ for a table is: + 0 (for ImGuiTable instance, we are pooling allocations in g.Tables) + 1 (for tab

[Internal] Called by TableNextRow()

FIXME-TABLE: This is a mess, need to redesign how we render borders (as some are also done in TableEndRow)

Output context menu into current window (generally a popup) FIXME-TABLE: Ideally this should be writable by the user. Full programmatic access to that

[Internal] Called by TableNextRow()/TableSetColumnIndex()/TableNextColumn()

[Internal] Called by TableNextRow()

Fix sort direction if currently set on a value which is unavailable (e.g. activating NoSortAscending/NoSortDescending)

Compact and remove unused settings data (currently only used by TestEngine)

Free up/compact internal Table buffers for when it gets unused

Get settings for a given table, NULL if none

Return the cell rectangle based on currently known height. - Important: we generally don't know our row height until the end of the row, so Max.y will

We allow querying for an extra column in order to poll the IsHovered state of the right-most section

Return the resizing ID for the right-side of the given column.

Note this is meant to be stored in column->WidthAuto, please generally use the WidthAuto field

Return -1 when table is not hovered. return columns_count if the unused space at the right of visible columns is hovered.

Maximum column content width given current layout. Use column->MinX so this value on a per-column basis.

[Public] Note: for row coloring we use ->RowBgColorCounter which is the same value without counting header rows

Return NULL if no sort specs (most often when ImGuiTableFlags_Sortable is not set) You can sort your data again when 'SpecsChanged == true'. It will b

Emit a column header (text + optional sort order) We cpu-clip text here so that all columns headers can be merged into a same draw call. Note that bec

[Public] This is a helper to output TableHeader() calls based on the column names declared in TableSetupColumn(). The intent is that advanced users wi

This function reorder draw channels based on matching clip rectangle, to facilitate merging them. Called by EndTable(). For simplicity we call it Tabl

[Public] Append into the next column, wrap and create a new row when already on last column

[Public] Starts into the first cell of a new row

Use -1 to open menu not specific to a given column.

Bg2 is used by Selectable (and possibly other widgets) to render to the background. Unlike our Bg0/1 channel which we uses for RowBg/CellBg/Borders an

Remove Table (currently only used by TestEngine)

Restore initial state of table (with or without saved settings)

Change user accessible enabled/disabled state of a column (often perceived as "showing/hiding" from users point of view) Note that end-user can use th

[Public] Append into a specific column

Note that the NoSortAscending/NoSortDescending flags are processed in TableSortSpecsSanitize(), and they may change/revert the value of SortDirection.

'width' = inner column width, without padding

Disable clipping then auto-fit, will take 2 frames (we don't take a shortcut for unclipped columns to reduce inconsistencies when e.g. resizing multip

Find existing settings

Apply to existing windows (if any)

See "COLUMN SIZING POLICIES" comments at the top of this file If (init_width_or_weight <= 0.0f) it is ignored

Allocate draw channels. Called by TableUpdateLayout() - We allocate them following storage order instead of display order so reordering columns won't

[Public]

Process hit-testing on resizing borders. Actual size change will be applied in EndTable() - Set table->HoveredColumnBorder with a short delay/timer to

Layout columns for the frame. This is in essence the followup to BeginTable(). Runs on the first call to TableNextRow(), to give a chance for TableSet

Note that Drag/Slider functions are only forwarding the min/max values clamping values if the ImGuiSliderFlags_AlwaysClamp flag is set! This is intend

Create text input in place of another active widget (e.g. used when doing a CTRL+Click on drag/slider widgets) FIXME: Facilitate using this in variety