KWindowInsetsController Class

Access to window insets colors. More...

Header: #include <KWindowInsetsController>
CMake: find_package(KF6 REQUIRED COMPONENTS GuiAddons)
target_link_libraries(mytarget PRIVATE KF6::GuiAddons)
Since: 6.7
In QML: WindowInsetsController
Inherits: QObject

Properties

Public Functions

QColor navigationBarBackgroundColor() const
void setNavigationBarBackgroundColor(const QColor &color)
void setStatusBarBackgroundColor(const QColor &color)
QColor statusBarBackgroundColor() const

Signals

Detailed Description

On most platforms this does nothing, on Android it allows to customize the (top) status bar and (botton) navigation bar background colors, e.g. to match the current window or application colors.

Note that the foreground colors on Android are automatically chosen based on the background color.

Component.onComplete: {
    WindowInsetsController.statusBarBackgroundColor = Kirigami.Theme.backgroundColor;
    WindowInsetsController.navigationBarBackgroundColor = Kirigami.Theme.backgroundColor;
}

Property Documentation

Background color of the navigation bar.

Access functions:

QColor navigationBarBackgroundColor() const
void setNavigationBarBackgroundColor(const QColor &color)

Notifier signal:

void navigationBarBackgroundColorChanged()

statusBarBackgroundColor : QColor

Background color of the status bar.

Access functions:

QColor statusBarBackgroundColor() const
void setStatusBarBackgroundColor(const QColor &color)

Notifier signal:

void statusBarBackgroundColorChanged()