2.1. Built-in widgets — inputs, selection, color, plots, output

Built-in widgets shipped on top of the boost layer — the same [widget] mechanism users get. Covers the button family (button, small_button, arrow_button, image_button, invisible_button, checkbox, radio_button), the slider / drag / input numeric families across scalar and 2/3/4-vector float / int variants, color edits and pickers, selection widgets (combo, list_box, selectable), plot helpers (plot_lines, plot_histogram, progress_bar), and output widgets (text_show, label_text, bullet_text, help_marker).

Each widget def shapes its body around the per-kind state struct from imgui_boost_runtime plus a brief finalize helper. The helpers — click_finalize, toggle_finalize, radio_int_finalize, pending_value_finalize — collapse the repetitive widget_finalize lambda construction per family so each def stays focused on the ImGui call and per-frame state mutation.

2.1.1. Call macros

edit_input_int3

Function annotation edit_input_int3

input_text_callback

Function annotation input_text_callback

color_picker3

Function annotation color_picker3

text_filter

Function annotation text_filter

drag_int4

Function annotation drag_int4

slider_int3

Function annotation slider_int3

tree_node_ex

Function annotation tree_node_ex

color_edit4

Function annotation color_edit4

bullet_text

Function annotation bullet_text

drag_int

Function annotation drag_int

edit_input_int4

Function annotation edit_input_int4

text

Function annotation text

edit_input_float

Function annotation edit_input_float

button

Function annotation button

combo

Function annotation combo

radio_button

Function annotation radio_button

color_picker4

Function annotation color_picker4

text_wrapped

Function annotation text_wrapped

plot_lines

Function annotation plot_lines

Function annotation menu_label

spacing

Function annotation spacing

new_line

Function annotation new_line

edit_radio_button

Function annotation edit_radio_button

edit_collapsing_header

Function annotation edit_collapsing_header

edit_input_float2

Function annotation edit_input_float2

checkbox

Function annotation checkbox

edit_drag_float

Function annotation edit_drag_float

edit_drag_float2

Function annotation edit_drag_float2

edit_drag_float3

Function annotation edit_drag_float3

edit_drag_float4

Function annotation edit_drag_float4

edit_input_int

Function annotation edit_input_int

edit_input_int2

Function annotation edit_input_int2

text_unformatted

Function annotation text_unformatted

slider_float3

Function annotation slider_float3

edit_color_edit3

Function annotation edit_color_edit3

text_disabled

Function annotation text_disabled

edit_color_edit4

Function annotation edit_color_edit4

bullet

Function annotation bullet

edit_drag_int

Function annotation edit_drag_int

drag_float

Function annotation drag_float

drag_float3

Function annotation drag_float3

edit_drag_int2

Function annotation edit_drag_int2

edit_drag_int3

Function annotation edit_drag_int3

edit_drag_int4

Function annotation edit_drag_int4

drag_int2

Function annotation drag_int2

Function annotation set_item_tooltip

edit_slider_float

Function annotation edit_slider_float

combo_getter

Function annotation combo_getter

selectable_label

Function annotation selectable_label

input_float

Function annotation input_float

input_float2

Function annotation input_float2

input_float3

Function annotation input_float3

input_float4

Function annotation input_float4

vslider_float

Function annotation vslider_float

input_text_growable

Function annotation input_text_growable

drag_float4

Function annotation drag_float4

separator_text

Function annotation separator_text

slider_float

Function annotation slider_float

edit_slider_float2

Function annotation edit_slider_float2

Function annotation menu_item

drag_float_range2

Function annotation drag_float_range2

edit_slider_float3

Function annotation edit_slider_float3

edit_slider_float4

Function annotation edit_slider_float4

slider_int4

Function annotation slider_int4

slider_int

Function annotation slider_int

selectable

Function annotation selectable

edit_input_float3

Function annotation edit_input_float3

dummy

Function annotation dummy

color_edit3

Function annotation color_edit3

vslider_int

Function annotation vslider_int

plot_lines_getter

Function annotation plot_lines_getter

input_text_with_hint

Function annotation input_text_with_hint

edit_color_picker3

Function annotation edit_color_picker3

edit_color_picker4

Function annotation edit_color_picker4

input_text_multiline

Function annotation input_text_multiline

slider_float2

Function annotation slider_float2

drag_int_range2

Function annotation drag_int_range2

indent

Function annotation indent

edit_input_float4

Function annotation edit_input_float4

edit_combo

Function annotation edit_combo

radio_button_int

Function annotation radio_button_int

drag_float2

Function annotation drag_float2

align_text_to_frame_padding

Function annotation align_text_to_frame_padding

small_button

Function annotation small_button

drag_int3

Function annotation drag_int3

slider_int2

Function annotation slider_int2

arrow_button

Function annotation arrow_button

Function annotation set_tooltip

separator

Function annotation separator

edit_input_double

Function annotation edit_input_double

color_button

Function annotation color_button

plot_histogram

Function annotation plot_histogram

unindent

Function annotation unindent

slider_float4

Function annotation slider_float4

plot_histogram_getter

Function annotation plot_histogram_getter

edit_checkbox

Function annotation edit_checkbox

label_text

Function annotation label_text

invisible_button

Function annotation invisible_button

edit_slider_angle

Function annotation edit_slider_angle

edit_checkbox_flags

Function annotation edit_checkbox_flags

same_line

Function annotation same_line

image_button

Function annotation image_button

input_double

Function annotation input_double

image

Function annotation image

text_show

Function annotation text_show

input_text

Function annotation input_text

input_int

Function annotation input_int

input_int2

Function annotation input_int2

input_int3

Function annotation input_int3

input_int4

Function annotation input_int4

progress_bar

Function annotation progress_bar

edit_slider_int

Function annotation edit_slider_int

edit_slider_int2

Function annotation edit_slider_int2

edit_slider_int3

Function annotation edit_slider_int3

edit_slider_int4

Function annotation edit_slider_int4

text_colored

Function annotation text_colored

2.1.2. Uncategorized

passes_filter(state: TextFilterState; line: string ): bool 

Predicate companion to text_filter. Delegates to the hand-bound PassFilter(filter, text) standalone helper at src/dasIMGUI.main.cpp:305. While the editor is empty the underlying Filters ImVector is empty too and PassFilter returns true for all lines. NB: an exclude-only filter (e.g. -error) has no include terms either, so passes_filter(state, “”) returns true even though the filter is active — use is_active(state), not passes_filter(state, “”), to detect the active/inactive transition.

Arguments:

state : TextFilterState
line : string

is_active(state: TextFilterState ): bool 

ImGuiTextFilter::IsActive() — true iff parsing produced at least one include OR exclude term. Use this to gate filter-active vs filter-inactive code paths (e.g. clipper-cull vs sequential scan in scrolling log views).

Arguments:

state : TextFilterState

set_scroll_here_y(center_y_ratio: float = 1f )

SetScrollHereY(center_y_ratio) — scrolls the current window so the recently-submitted item is anchored at the given vertical ratio (0=top, 0.5=middle, 1=bottom). Common pattern: tail-follow scrolling regions call set_scroll_here_y(1.0f) after the last entry.

Arguments:

center_y_ratio : float

set_keyboard_focus_here(offset: int = 0 )

SetKeyboardFocusHere(offset) — moves keyboard focus to the item N items ahead (offset = 0) or behind (offset = -1, the item that was just submitted). REPL-style inputs use -1 after Enter to refocus the editbox for the next command.

Arguments:

offset : int

set_item_default_focus()

SetItemDefaultFocus() — marks the previous item as the default focus target on first frame of a window. Used on the primary input widget so the user can start typing immediately.

log_to_clipboard(auto_open_depth: int = -1 )

LogToClipboard(auto_open_depth) — starts capturing subsequent text-emitting widgets to the OS clipboard until log_finish() is called. auto_open_depth = -1 means capture all depths.

Arguments:

auto_open_depth : int

log_finish()

LogFinish() — stops the active log capture started by log_to_clipboard (or any other LogTo* call) and finalizes the clipboard contents.