qtstatusbar

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 110 Open GitHub ↗

StatusBar for Qt allows setting the status bar color and theme on Android and iOS.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# StatusBar for Qt

StatusBar for Qt allows setting the status bar **color** <sup>[1]</sup>
and **theme** <sup>[2]</sup> on Android and iOS.

## Android

![screenshot](https://raw.githubusercontent.com/jpnurmi/qtstatusbar/master/example/android.png "Nexus 6")

1. **NOTE**: *`StatusBar::color` requires Android 5.0 Lollipop (API level 21) or later.*
2. **NOTE**: *`StatusBar::theme` requires Android 6.0 Marshmallow (API level 23) or later.*

## iOS

![screenshot](https://raw.githubusercontent.com/jpnurmi/qtstatusbar/master/example/ios.png "iPhone 6s")

It is recommended to set the `Qt.MaximizeUsingFullscreenGeometryHint`
window flag, and take the difference between `Screen.height` and
`Screen.desktopAvailableHeight` into account. For example:

ApplicationWindow {
        flags: Qt.Window | Qt.MaximizeUsingFullscreenGeometryHint

header: ToolBar {
            topPadding: Qt.platform.os === "ios" ? Screen.height - Screen.desktopAvailableHeight : 0
        }
    }

1. **NOTE**: *`StatusBar::color` is not available on iOS.*

## Build

The easiest way to include `StatusBar` to a project is to copy over the
contents of the `src` folder and include `statusbar.pri` in the project
file (see [example/statusbar.pro](example/statusbar.pro)):

include(path/to/statusbar.pri)

## Register

Registering the QML type in C++ (see [example/main.cpp](example/main.cpp)):

#include "statusbar.h"
    
    int main(int argc, char* argv[])
    {
        QGuiApplication app(argc, argv);

qmlRegisterType<StatusBar>("StatusBar", 0, 1, "StatusBar"); // <==

QQmlApplicationEngine engine;
        engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
        
        return app.exec();
    }

## Usage

Example usage in QML (see [example/main.qml](example/main.qml)):

import StatusBar 0.1

StatusBar {
        theme: StatusBar.Dark // or Material.Dark
        color: Material.color(Material.Indigo, Material.Shade700)
    }

qtstatusbar

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README