KWindowConfig Namespace Reference

Functions
KCONFIGGUI_EXPORT void	restoreWindowPosition (QWindow *window, const KConfigGroup &config)
KCONFIGGUI_EXPORT void	restoreWindowScreenPosition (QWindow *window, const QScreen *screen, const KConfigGroup &config)
KCONFIGGUI_EXPORT void	restoreWindowSize (QWindow *window, const KConfigGroup &config)
KCONFIGGUI_EXPORT void	saveWindowPosition (const QWindow *window, KConfigGroup &config, KConfigGroup::WriteConfigFlags options=KConfigGroup::Normal)
KCONFIGGUI_EXPORT void	saveWindowSize (const QWindow *window, KConfigGroup &config, KConfigGroup::WriteConfigFlags options=KConfigGroup::Normal)

Detailed Description

Save and load window sizes into a config.

Function Documentation

restoreWindowPosition()

void KWindowConfig::restoreWindowPosition	(	QWindow *	window,
		const KConfigGroup &	config
	)

Restores the window's screen position from the configuration and calls restoreWindowScreenPosition.

This function has no effect on Wayland, where the compositor is responsible for window positioning.

Note

the group must be set before calling

Parameters

window	The window whose position to restore.
config	The config group to read from.

Since

5.74

Definition at line 197 of file kwindowconfig.cpp.

restoreWindowScreenPosition()

void KWindowConfig::restoreWindowScreenPosition	(	QWindow *	window,
		const QScreen *	screen,
		const KConfigGroup &	config
	)

Restores the window's position on provided screen from the configuration.

This function has no effect on Wayland, where the compositor is responsible for window positioning.

Note

the group must be set before calling

Parameters

window	The window whose position to restore.
screen	Screen on which window should be placed.
config	The config group to read from.

Since

5.99

Definition at line 225 of file kwindowconfig.cpp.

restoreWindowSize()

void KWindowConfig::restoreWindowSize	(	QWindow *	window,
		const KConfigGroup &	config
	)

Restores the dialog's size from the configuration according to the screen size.

If you're calling this from a constructor (for a mainwindow or dialog, for instance) you should first call winId() so that a QWindow is created, then you can call windowHandle() to pass to this method.

Example code:

create(); // ensure there's a window created
const QSize availableSize = windowHandle()->screen()->availableSize();
windowHandle()->resize(availableSize.width() * 0.7, availableSize.height() * 0.5); // default size
KWindowConfig::restoreWindowSize(windowHandle(), KSharedConfig::openConfig()->group("MyDialog"));
resize(windowHandle()->size()); // workaround for QTBUG-40584

Note

the group must be set before calling

Parameters

window	The window to restore size.
config	The config group to read from.

Since

5.0.

Definition at line 142 of file kwindowconfig.cpp.

saveWindowPosition()

void KWindowConfig::saveWindowPosition	(	const QWindow *	window,
		KConfigGroup &	config,
		KConfigGroup::WriteConfigFlags	options = KConfigGroup::Normal
	)

Saves the window's position either to the global or application config file.

This function has no effect on Wayland, where the compositor is responsible for window positioning.

Note

the group must be set before calling

Parameters

window	The window whose position to save.
config	The config group to read from.
options	passed to KConfigGroup::writeEntry()

Since

5.74

Definition at line 177 of file kwindowconfig.cpp.

saveWindowSize()

void KWindowConfig::saveWindowSize	(	const QWindow *	window,
		KConfigGroup &	config,
		KConfigGroup::WriteConfigFlags	options = KConfigGroup::Normal
	)

Saves the window's size dependent on the screen dimension either to the global or application config file.

Note

the group must be set before calling

Parameters

window	The window to save size.
config	The config group to read from.
options	passed to KConfigGroup::writeEntry()

Since

5.0

Definition at line 111 of file kwindowconfig.cpp.