DockTheme
Styling theme for the docking system configuring palette colors (DockColor), tab geometry, split handles, shadows, and window resize grips.
Overview
DockTheme configures all visual aspects of the docking subsystem.
Factory Presets
| Theme Factory | Palette & Style |
|---|---|
DockTheme.defaultTheme() |
Standard dark IDE theme. |
DockTheme.editor() |
High-contrast code editor palette. |
DockTheme.classic() |
Clean light-mode palette. |
Metrics & Styling
Configure tab height (tabHeight), corner radii (tabRadius), split handle thickness (splitThickness), floating window shadows, and resize grips.
Customizing Docking Theme Colors and Metrics
Related links
- DockColor: Semantic color roles used throughout DockTheme to style tabs, split bars, floating window chrome, and drop preview zones.
- DockingRoot: Root visual widget for the IDE docking system hosting dock tree nodes, tab strips, split handles, drop previews, and tear-off floating window integrations.
API
DockTheme::accentThickness()
Returns the thickness of the active tab accent stripe.
Returns float: Thickness of active tab indicator in pixels..
DockTheme::accentThickness(float)
Sets the thickness of the active tab accent stripe.
| Parameter | Type | Description |
|---|---|---|
accentThickness |
float |
Thickness of the active tab accent indicator. |
Returns DockTheme: This theme instance for method chaining..
DockTheme::classic()
Creates a classic blue-tinted docking theme instance.
Returns DockTheme: A new or modified DockTheme instance..
DockTheme::closeGap()
Returns the gap between tab text and close button.
Returns float: Gap between title text and close button in pixels..
DockTheme::closeSize()
Returns the size of the tab close button.
Returns float: Close button icon dimension in pixels..
DockTheme::closeSize(float)
Sets the size of the tab close button.
| Parameter | Type | Description |
|---|---|---|
closeSize |
float |
Size of the close button in tab headers. |
Returns DockTheme: This theme instance for method chaining..
DockTheme::color(DockColor)
Returns the live mutable color corresponding to the specified role.
| Parameter | Type | Description |
|---|---|---|
role |
DockColor |
Semantic color role. |
Returns MutableColor: MutableColorView instance for modification..
DockTheme::color(DockColor, ColorView)
Sets the color assigned to a specific role.
| Parameter | Type | Description |
|---|---|---|
role |
DockColor |
Semantic color role. |
color |
ColorView |
Color view to assign. |
Returns DockTheme: This theme instance for method chaining..
DockTheme::copy()
Clones this theme into an independent mutable copy.
Returns DockTheme: A new or modified DockTheme instance..
DockTheme::defaultTheme()
Returns the global default docking theme.
Returns DockTheme: A new or modified DockTheme instance..
DockTheme::defaultTheme(DockTheme)
Replaces the global default docking theme.
| Parameter | Type | Description |
|---|---|---|
theme |
DockTheme |
Source theme to copy from. |
DockTheme::editor()
Creates a modern dark editor docking theme instance.
Returns DockTheme: A new or modified DockTheme instance..
DockTheme::gripSize()
Returns the side size of the bottom-right window resize grip.
Returns float: Resize grip dimension in pixels..
DockTheme::gripSize(float)
Sets the side size of the window resize grip.
| Parameter | Type | Description |
|---|---|---|
gripSize |
float |
Size of window resize grips. |
Returns DockTheme: This theme instance for method chaining..
DockTheme::iconGap()
Returns the gap between tab icon and title text.
Returns float: Gap between icon and title text in pixels..
DockTheme::iconSize()
Returns the tab icon dimension in pixels.
Returns float: Tab header icon dimension in pixels..
DockTheme::iconSize(float)
Sets the tab icon size.
| Parameter | Type | Description |
|---|---|---|
iconSize |
float |
Size of icons in tab headers. |
Returns DockTheme: This theme instance for method chaining..
DockTheme::resizeGrip()
Returns the current window resize grip style.
Returns ResizeGripStyle: Configured resize grip style..
DockTheme::resizeGrip(ResizeGripStyle)
Sets the window resize grip visual style.
| Parameter | Type | Description |
|---|---|---|
resizeGrip |
ResizeGripStyle |
Resize grip painter style. |
Returns DockTheme: This theme instance for method chaining..
DockTheme::splitStyle()
Returns the split handle visual style (BLOCK or SEAM).
Returns SplitHandleStyle: Visual style of split handles..
DockTheme::splitStyle(SplitHandleStyle)
Sets the split handle visual style.
| Parameter | Type | Description |
|---|---|---|
splitStyle |
SplitHandleStyle |
Visual style of split handles. |
Returns DockTheme: This theme instance for method chaining..
DockTheme::splitThickness()
Returns the thickness of split handles between docked leaves.
Returns float: Split handle bar thickness in pixels..
DockTheme::splitThickness(float)
Sets the thickness of split handles.
| Parameter | Type | Description |
|---|---|---|
splitThickness |
float |
Thickness of split handles between dock nodes. |
Returns DockTheme: This theme instance for method chaining..
DockTheme::tabHeight()
Returns the height of tab strips and window title bars in pixels.
Returns float: Tab header bar height in pixels..
DockTheme::tabHeight(float)
Sets the height of tab strips and title bars.
| Parameter | Type | Description |
|---|---|---|
tabHeight |
float |
Height of docking tab headers in pixels. |
Returns DockTheme: This theme instance for method chaining..
DockTheme::tabMaxWidth()
Returns the maximum width of a tab.
Returns float: Maximum tab width in pixels..
DockTheme::tabMaxWidth(float)
Sets the maximum tab width.
| Parameter | Type | Description |
|---|---|---|
tabMaxWidth |
float |
Maximum tab width in pixels. |
Returns DockTheme: This theme instance for method chaining..
DockTheme::tabMinWidth()
Returns the minimum width of a tab.
Returns float: Minimum tab width in pixels..
DockTheme::tabMinWidth(float)
Sets the minimum tab width.
| Parameter | Type | Description |
|---|---|---|
tabMinWidth |
float |
Minimum tab width in pixels. |
Returns DockTheme: This theme instance for method chaining..
DockTheme::tabPaddingX()
Returns the horizontal inner padding of tabs.
Returns float: Horizontal padding inside tabs in pixels..
DockTheme::tabPaddingX(float)
Sets the horizontal inner padding of tabs.
| Parameter | Type | Description |
|---|---|---|
tabPaddingX |
float |
Horizontal padding inside docking tabs. |
Returns DockTheme: This theme instance for method chaining..
DockTheme::tabRadius()
Returns the top corner radius of tabs.
Returns float: Tab corner radius in pixels..
DockTheme::tabRadius(float)
Sets the top corner radius of tabs.
| Parameter | Type | Description |
|---|---|---|
tabRadius |
float |
Corner radius of docking tabs in pixels. |
Returns DockTheme: This theme instance for method chaining..
DockTheme::tearOffHeight()
Returns the tear-off preview window height.
Returns float: Default height of torn-off windows in pixels..
DockTheme::tearOffPreviewEnabled()
Returns true if tear-off compact preview sizing is enabled.
Returns boolean: True if tear-off preview is enabled..
DockTheme::tearOffPreviewSize(float, float)
Configures compact preview dimensions while a tab is being torn off from the dock.
| Parameter | Type | Description |
|---|---|---|
width |
float |
Default width of torn-off floating windows. |
height |
float |
Default height of torn-off floating windows. |
Returns DockTheme: This theme instance for method chaining..
DockTheme::tearOffWidth()
Returns the tear-off preview window width.
Returns float: Default width of torn-off windows in pixels..
DockTheme::windowRadius()
Returns the corner radius of floating dock windows.
Returns float: Floating window corner radius in pixels..
DockTheme::windowRadius(float)
Sets the corner radius of floating dock windows.
| Parameter | Type | Description |
|---|---|---|
windowRadius |
float |
Corner radius for floating windows. |
Returns DockTheme: This theme instance for method chaining..
DockTheme::windowShadowSize()
Returns the blur size of floating window drop shadows.
Returns float: Floating window shadow size in pixels..
DockTheme::windowShadowSize(float)
Sets the blur size of floating window drop shadows (0 to disable).
| Parameter | Type | Description |
|---|---|---|
windowShadowSize |
float |
Shadow blur size for floating windows. |
Returns DockTheme: This theme instance for method chaining..