#include <TitleBar.h>

Inheritance diagram for KDDockWidgets::Core::TitleBar:

[legend]

Collaboration diagram for KDDockWidgets::Core::TitleBar:

[legend]

Public Member Functions
	TitleBar (Core::View *)

	TitleBar (FloatingWindow *parent)
	Creates the TitleBar used by Floating windows.

	TitleBar (Group *parent)
	Creates the TitleBar used by tab groups.

virtual	~TitleBar () override

bool	closeButtonEnabled () const

DockWidget::List	dockWidgets () const
	the list of dockwidgets under this TitleBar. There should always be at least 1. If more than 1 then they are tabbed.

Private *	dptr () const

QString	floatButtonToolTip () const

bool	floatButtonVisible () const

FloatingWindow *	floatingWindow () const
	getter for m_floatingWindow

void	focus (Qt::FocusReason reason)

Core::Group *	group () const
	getter for m_group

bool	hasIcon () const
	returns whether this title bar has an icon

Icon	icon () const
	the icon

bool	isFloating () const
	Returns true if this title-bar is the title bar of a floating window.

bool	isFocused () const
	returns whether any of the DockWidgets this TitleBar controls has a child focus Not to be confused with QWidget::hasFocus(), which just refers to 1 widget. This works more like QtQuick's FocusScope

bool	isMDI () const override
	From Draggable interface.

bool	isStandalone () const
	Returns whether this titlebar is standalone. See comment in the ctor.

bool	isWindow () const override

MainWindow *	mainWindow () const
	If this title bar belongs to a dock widget docked into the main window, returns the main window Returns nullptr otherwise.

std::unique_ptr< WindowBeingDragged >	makeWindow () override

TitleBarButtonType	maximizeButtonType () const

bool	maximizeButtonVisible () const

void	onAutoHideClicked ()

void	onCloseClicked ()

bool	onDoubleClicked ()

void	onFloatClicked ()

void	onMaximizeClicked ()

void	onMinimizeClicked ()

void	setCloseButtonEnabled (bool)

void	setFloatButtonVisible (bool)

void	setIcon (const Icon &icon)

void	setTitle (const QString &title)

Core::DockWidget *	singleDockWidget () const override final

bool	supportsAutoHideButton () const
	returns whether this title bar supports the auto-hide button

bool	supportsFloatingButton () const
	returns whether this title bar supports a floating/docking button

bool	supportsMaximizeButton () const
	returns whether this title bar supports a maximize/restore button

bool	supportsMinimizeButton () const
	returns whether this title bar supports a minimize button

TabBar *	tabBar () const
	Returns the tab bar which is under this title bar. It's only nullptr for the case of having a Floating Window with more than one nested Frame.

QString	title () const

bool	titleBarIsFocusable () const

void	toggleMaximized ()

void	updateButtons ()
	updates the close button enabled state

Public Member Functions inherited from KDDockWidgets::Core::Controller
	Controller (ViewType type, View *)

virtual	~Controller ()

bool	close ()

void	destroyLater ()

Controller::Private *	dptr () const

Rect	geometry () const

int	height () const

bool	inDtor () const

bool	is (ViewType) const
	Returns whether this controller is of the specified type.

bool	isVisible () const

Point	mapToGlobal (Point) const

Point	pos () const

Rect	rect () const

void	setParentView (View *parent)

void	setVisible (bool)

void	show () const

Size	size () const

ViewType	type () const
	Returns the type of this controller.

View *	view () const
	Returns the view associated with this controller, if any.

int	width () const

std::shared_ptr< View >	window () const

int	x () const

int	y () const

Protected Member Functions
bool	isOverlayed () const

Protected Member Functions inherited from KDDockWidgets::Core::Controller
virtual void	setParentView_impl (View *parent)

Additional Inherited Members
Protected Attributes inherited from KDDockWidgets::Core::Controller
bool	m_inDtor = false

Detailed Description

Definition at line 31 of file core/TitleBar.h.

Constructor & Destructor Documentation

◆ TitleBar() [1/3]

TitleBar::TitleBar ( FloatingWindow * parent )

explicit

Creates the TitleBar used by Floating windows.

Definition at line 68 of file core/TitleBar.cpp.

References KDDockWidgets::Core::FloatingWindow::dptr(), and updateButtons().

◆ TitleBar() [2/3]

TitleBar::TitleBar ( Group * parent )

explicit

Creates the TitleBar used by tab groups.

Definition at line 42 of file core/TitleBar.cpp.

References KDDockWidgets::Core::Group::dptr().

◆ TitleBar() [3/3]

TitleBar::TitleBar ( Core::View * view )

explicit

Creates a standalone TitleBar That means it's not associated with any docking. To allow users to reuse it. For example, to add a title bar to a QMessageBox popup on EGLFS

See also: isStandalone()

Definition at line 87 of file core/TitleBar.cpp.

◆ ~TitleBar()

TitleBar::~TitleBar ( )

overridevirtual

Definition at line 116 of file core/TitleBar.cpp.

Member Function Documentation

◆ closeButtonEnabled()

bool TitleBar::closeButtonEnabled ( ) const

Definition at line 543 of file core/TitleBar.cpp.

Referenced by c_KDDockWidgets__Core__TitleBar__closeButtonEnabled(), and KDDockWidgets::QtQuick::TitleBar::closeButtonEnabled().

◆ dockWidgets()

Core::DockWidget::List TitleBar::dockWidgets ( ) const

the list of dockwidgets under this TitleBar. There should always be at least 1. If more than 1 then they are tabbed.

Definition at line 600 of file core/TitleBar.cpp.

References KDToolBox::StlContainerAdaptor::StdVectorAdaptor< T, Args >::append(), KDDockWidgets::Core::Group::dockWidgets(), group(), and KDDockWidgets::Core::FloatingWindow::groups().

Referenced by onFloatClicked(), and singleDockWidget().

◆ dptr()

TitleBar::Private * TitleBar::dptr ( ) const

Definition at line 692 of file core/TitleBar.cpp.

Referenced by KDDockWidgets::flutter::TitleBar::init(), KDDockWidgets::QtQuick::TitleBar::init(), and KDDockWidgets::QtWidgets::TitleBar::init().

◆ floatButtonToolTip()

QString TitleBar::floatButtonToolTip ( ) const

Definition at line 660 of file core/TitleBar.cpp.

Referenced by c_KDDockWidgets__Core__TitleBar__floatButtonToolTip(), KDDockWidgets::QtQuick::TitleBar::floatButtonToolTip(), and KDDockWidgets::QtWidgets::TitleBar::init().

◆ floatButtonVisible()

bool TitleBar::floatButtonVisible ( ) const

Definition at line 183 of file core/TitleBar.cpp.

Referenced by c_KDDockWidgets__Core__TitleBar__floatButtonVisible(), KDDockWidgets::QtQuick::TitleBar::floatButtonVisible(), and KDDockWidgets::QtWidgets::TitleBar::init().

◆ floatingWindow()

Core::FloatingWindow * TitleBar::floatingWindow ( ) const

getter for m_floatingWindow

Definition at line 264 of file core/TitleBar.cpp.

Referenced by c_KDDockWidgets__Core__TitleBar__floatingWindow(), and makeWindow().

◆ focus()

void TitleBar::focus ( Qt::FocusReason reason )

Will focus the last user widget (below this titlebar) that had focus Requires Config::Flag_TitleBarIsFocusable

Definition at line 269 of file core/TitleBar.cpp.

References KDDockWidgets::Config::Flag_TitleBarIsFocusable, KDDockWidgets::Core::FloatingWindow::focus(), and KDDockWidgets::Config::self().

Referenced by KDDockWidgets::QtQuick::TitleBar::event(), and KDDockWidgets::QtWidgets::TitleBar::focusInEvent().

◆ group()

Core::Group * TitleBar::group ( ) const

getter for m_group

Definition at line 259 of file core/TitleBar.cpp.

Referenced by c_KDDockWidgets__Core__TitleBar__group(), dockWidgets(), and tabBar().

◆ hasIcon()

bool TitleBar::hasIcon ( ) const

returns whether this title bar has an icon

Definition at line 254 of file core/TitleBar.cpp.

Referenced by c_KDDockWidgets__Core__TitleBar__hasIcon(), and KDDockWidgets::QtQuick::TitleBar::hasIcon().

◆ icon()

Icon TitleBar::icon ( ) const

the icon

Definition at line 163 of file core/TitleBar.cpp.

Referenced by KDDockWidgets::Core::Group::icon(), KDDockWidgets::QtWidgets::TitleBar::iconRect(), KDDockWidgets::QtWidgets::TitleBar::init(), and setIcon().

◆ isFloating()

bool TitleBar::isFloating ( ) const

Returns true if this title-bar is the title bar of a floating window.

Definition at line 627 of file core/TitleBar.cpp.

References KDDockWidgets::Core::Group::isFloating().

Referenced by c_KDDockWidgets__Core__TitleBar__isFloating(), KDDockWidgets::QtQuick::TitleBar::isFloating(), and onFloatClicked().

◆ isFocused()

bool TitleBar::isFocused ( ) const

returns whether any of the DockWidgets this TitleBar controls has a child focus Not to be confused with QWidget::hasFocus(), which just refers to 1 widget. This works more like QtQuick's FocusScope

Definition at line 642 of file core/TitleBar.cpp.

References KDDockWidgets::Core::View::isActiveWindow(), KDDockWidgets::Core::FocusScope::isFocused(), and KDDockWidgets::Core::Controller::view().

Referenced by c_KDDockWidgets__Core__TitleBar__isFocused(), and KDDockWidgets::QtQuick::TitleBar::isFocused().