Overview
This page documents all fields in theImGuiStyle structure. For usage patterns and common customizations, see Style.
ImGuiStyle Structure
Font Fields
Current base font size before external global factors are applied. Use
PushFont(NULL, size) to modify.Main global scale factor. May be set by application once, or exposed to end-user.
Additional global scale factor from viewport/monitor DPI. In docking branch: automatically overwritten when changing monitor DPI if
io.ConfigDpiScaleFonts is enabled.Alpha Fields
Global alpha applies to everything in Dear ImGui. Range: 0.0f to 1.0f.
Additional alpha multiplier applied by
BeginDisabled(). Multiply over current value of Alpha.Window Fields
Padding within a window.
Radius of window corners rounding. Set to 0.0f to have rectangular windows. Large values tend to lead to artifacts.
Thickness of border around windows. Generally set to 0.0f or 1.0f.
Hit-testing extent outside/inside resizing border. Extend determination of hovered window.
Minimum window size. This is a global setting. Use
SetNextWindowSizeConstraints() for per-window constraints.Alignment for title bar text. Defaults to left-aligned, vertically centered.
Side of the collapsing/docking button in the title bar (None/Left/Right).
Frame Fields
Padding within a framed rectangle (used by most widgets).
Radius of frame corners rounding. Set to 0.0f to have rectangular frames.
Thickness of border around frames. Generally set to 0.0f or 1.0f.
Spacing Fields
Horizontal and vertical spacing between widgets/lines.
Horizontal and vertical spacing between within elements of a composed widget (e.g. a slider and its label).
Padding within a table cell. CellPadding.x is locked for entire table. CellPadding.y may be altered between rows.
Expand reactive bounding box for touch-based systems where touch position is not accurate enough.
Horizontal indentation when entering a tree node. Generally equals
(FontSize + FramePadding.x*2).Minimum horizontal spacing between two columns. Preferably >
(FramePadding.x + 1).Scrollbar Fields
Width of the vertical scrollbar, Height of the horizontal scrollbar.
Radius of grab corners for scrollbar.
Padding of scrollbar grab within its frame (same for both axes).
Grab & Slider Fields
Minimum width/height of a grab box for slider/scrollbar.
Radius of grabs corners rounding. Set to 0.0f to have rectangular slider grabs.
The size in pixels of the dead-zone around zero on logarithmic sliders that cross zero.
Tab Fields
Radius of upper corners of a tab. Set to 0.0f to have rectangular tabs.
Thickness of border around tabs.
Minimum tab width, to make tabs larger than their contents. Tab bar buttons are not affected.
Minimum tab width after shrinking, when using
ImGuiTabBarFlags_FittingPolicyMixed policy.Thickness of tab-bar separator, which takes on the tab active color to denote focus.
Thickness of tab-bar overline, which highlights the selected tab.
Behavior Fields
Delay for
IsItemHovered(ImGuiHoveredFlags_Stationary). Time required to consider mouse stationary.Delay for
IsItemHovered(ImGuiHoveredFlags_DelayShort).Delay for
IsItemHovered(ImGuiHoveredFlags_DelayNormal).Default flags when using
IsItemHovered(ImGuiHoveredFlags_ForTooltip) or BeginItemTooltip() while using mouse.Default flags when using
IsItemHovered(ImGuiHoveredFlags_ForTooltip) or BeginItemTooltip() while using keyboard/gamepad.