Skip to content

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

DockTheme theme = DockTheme.editor().copy()
        .tabHeight(24.0f)
        .splitThickness(6.0f);
  • 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..