#include <wx/aui/dockart.h>

Inheritance diagram for wxAuiDockArt:

Detailed Description

wxAuiDockArt is part of the wxAUI class framework.

wxAuiDockArt is the art provider: provides all drawing functionality to the wxAui dock manager. This allows the dock manager to have a pluggable look-and-feel.

By default, a wxAuiManager uses an instance of this class called wxAuiDefaultDockArt which provides bitmap art and a colour scheme that is adapted to the major platforms' look. You can either derive from that class to alter its behaviour or write a completely new dock art class. Call wxAuiManager::SetArtProvider to force wxAUI to use your new dock art provider.

Library: wxAui

Category: Window Docking (wxAUI)

See also: wxAuiManager, wxAuiPaneInfo

Public Member Functions
	wxAuiDockArt ()
	Constructor. More...

virtual	~wxAuiDockArt ()
	Destructor. More...

virtual wxAuiDockArt *	Clone ()=0
	Create a copy of this wxAuiDockArt instance. More...

virtual void	DrawBackground (wxDC &dc, wxWindow *window, int orientation, const wxRect &rect)=0
	Draws a background. More...

virtual void	DrawBorder (wxDC &dc, wxWindow *window, const wxRect &rect, wxAuiPaneInfo &pane)=0
	Draws a border. More...

virtual void	DrawCaption (wxDC &dc, wxWindow *window, const wxString &text, const wxRect &rect, wxAuiPaneInfo &pane)=0
	Draws a caption. More...

virtual void	DrawGripper (wxDC &dc, wxWindow *window, const wxRect &rect, wxAuiPaneInfo &pane)=0
	Draws a gripper. More...

virtual void	DrawPaneButton (wxDC &dc, wxWindow *window, int button, int button_state, const wxRect &rect, wxAuiPaneInfo &pane)=0
	Draws a button in the pane's title bar. More...

virtual void	DrawSash (wxDC &dc, wxWindow *window, int orientation, const wxRect &rect)=0
	Draws a sash between two windows. More...

virtual wxColour	GetColour (int id)=0
	Get the colour of a certain setting. More...

virtual wxFont	GetFont (int id)=0
	Get a font setting. More...

virtual int	GetMetric (int id)=0
	Get the value of a certain setting. More...

virtual int	GetMetricForWindow (int id, wxWindow *window)
	Get metric value scaled by the DPI of the given window if appropriate. More...

virtual void	SetColour (int id, const wxColour &colour)=0
	Set a certain setting with the value colour. More...

virtual void	SetFont (int id, const wxFont &font)=0
	Set a font setting. More...

virtual void	SetMetric (int id, int new_val)=0
	Set a certain setting with the value new_val. More...

Constructor & Destructor Documentation

◆ wxAuiDockArt()

wxAuiDockArt::wxAuiDockArt ( )

Constructor.

◆ ~wxAuiDockArt()

virtual wxAuiDockArt::~wxAuiDockArt ( )

virtual

Destructor.

Member Function Documentation

◆ Clone()

virtual wxAuiDockArt* wxAuiDockArt::Clone ( )

pure virtual

Create a copy of this wxAuiDockArt instance.

Implemented in wxAuiDefaultDockArt.

◆ DrawBackground()

virtual void wxAuiDockArt::DrawBackground	(	wxDC &	dc,
		wxWindow *	window,
		int	orientation,
		const wxRect &	rect
	)

pure virtual

Draws a background.

Implemented in wxAuiDefaultDockArt.

◆ DrawBorder()

virtual void wxAuiDockArt::DrawBorder	(	wxDC &	dc,
		wxWindow *	window,
		const wxRect &	rect,
		wxAuiPaneInfo &	pane
	)

pure virtual

Draws a border.

Implemented in wxAuiDefaultDockArt.

◆ DrawCaption()

virtual void wxAuiDockArt::DrawCaption	(	wxDC &	dc,
		wxWindow *	window,
		const wxString &	text,
		const wxRect &	rect,
		wxAuiPaneInfo &	pane
	)

pure virtual

Draws a caption.

Implemented in wxAuiDefaultDockArt.

◆ DrawGripper()

virtual void wxAuiDockArt::DrawGripper	(	wxDC &	dc,
		wxWindow *	window,
		const wxRect &	rect,
		wxAuiPaneInfo &	pane
	)

pure virtual

Draws a gripper.

Implemented in wxAuiDefaultDockArt.

◆ DrawPaneButton()

virtual void wxAuiDockArt::DrawPaneButton	(	wxDC &	dc,
		wxWindow *	window,
		int	button,
		int	button_state,
		const wxRect &	rect,
		wxAuiPaneInfo &	pane
	)

pure virtual

Draws a button in the pane's title bar.

button can be one of the values of wxAuiButtonId. button_state can be one of the values of wxAuiPaneButtonState.

Implemented in wxAuiDefaultDockArt.

◆ DrawSash()

virtual void wxAuiDockArt::DrawSash	(	wxDC &	dc,
		wxWindow *	window,
		int	orientation,
		const wxRect &	rect
	)

pure virtual

Draws a sash between two windows.

Implemented in wxAuiDefaultDockArt.

◆ GetColour()

virtual wxColour wxAuiDockArt::GetColour ( int id )

pure virtual

Get the colour of a certain setting.

id can be one of the colour values of wxAuiPaneDockArtSetting.

Implemented in wxAuiDefaultDockArt.

◆ GetFont()

virtual wxFont wxAuiDockArt::GetFont ( int id )

pure virtual

Get a font setting.

Implemented in wxAuiDefaultDockArt.

◆ GetMetric()

virtual int wxAuiDockArt::GetMetric ( int id )

pure virtual

Get the value of a certain setting.

id can be one of the size values of wxAuiPaneDockArtSetting.

This function returns the same value that was set by SetMetric(), use GetMetricForWindow() to get the value appropriate for the given window for metrics that express sizes.

Implemented in wxAuiDefaultDockArt.

◆ GetMetricForWindow()

virtual int wxAuiDockArt::GetMetricForWindow	(	int	id,
		wxWindow *	window
	)

virtual

Get metric value scaled by the DPI of the given window if appropriate.

Call this function instead of GetMetric() to get the metric value scaled by the window DPI for the metrics that are expressed in pixels and must be scaled.

The default implementation doesn't scale wxAUI_DOCKART_SASH_SIZE and wxAUI_DOCKART_PANE_BORDER_SIZE metrics in order to allow setting them to just a single pixel (which is the default value for the latter in wxAuiDefaultDockArt) even in high DPI. You may override this function in your custom art implementation to scale these metrics too if you prefer to have thicker borders in high DPI.

Note that values of wxAUI_DOCKART_GRADIENT_TYPE are not expressed in pixels and so should never be scaled by this function.

Since: 3.3.0

◆ SetColour()

virtual void wxAuiDockArt::SetColour	(	int	id,
		const wxColour &	colour
	)

pure virtual

Set a certain setting with the value colour.

id can be one of the colour values of wxAuiPaneDockArtSetting.

Implemented in wxAuiDefaultDockArt.

◆ SetFont()

virtual void wxAuiDockArt::SetFont	(	int	id,
		const wxFont &	font
	)

pure virtual

Set a font setting.

Implemented in wxAuiDefaultDockArt.

◆ SetMetric()

virtual void wxAuiDockArt::SetMetric	(	int	id,
		int	new_val
	)

pure virtual

Set a certain setting with the value new_val.

id can be one of the size values of wxAuiPaneDockArtSetting.

The interpretation of new_val depends on the metric being set, see GetMetricForWindow().

Implemented in wxAuiDefaultDockArt.

Detailed Description

Public Member Functions

Constructor & Destructor Documentation

◆ wxAuiDockArt()

◆ ~wxAuiDockArt()

Member Function Documentation

◆ Clone()

◆ DrawBackground()

◆ DrawBorder()

◆ DrawCaption()

◆ DrawGripper()

◆ DrawPaneButton()

◆ DrawSash()

◆ GetColour()

◆ GetFont()

◆ GetMetric()

◆ GetMetricForWindow()

◆ SetColour()

◆ SetFont()

◆ SetMetric()