On this page

TopBar QML Type

A toolbar displayed above the property list in the control panel. More...

Import Statement: import QtInterfaceFramework.ControlPanelHelper 1.0
Inherits:

Rectangle

Properties

Signals

Detailed Description

TopBar shows the selected interface name, a ZoneSelector drop-down (for zoned interfaces), a SearchField for filtering properties, and filter buttons that toggle between all, non-zoned, and zoned properties. Filter buttons and the zone selector are only visible when isZoned is true.

Usage

TopBar {
    interfaceName: "ClimateControl"
    isZoned: true
    availableZones: ["FrontLeft", "FrontRight", "Rear"]
    currentZoneIndex: 0
    onZoneChanged: function(index) {
        controlPanel.selectZone(index)
    }
}

Property Documentation

availableZones : var

This property holds the list of available zone names for the ZoneSelector drop-down.

currentZoneIndex : int

This property holds the index of the currently selected zone in availableZones.

interfaceName : string

This property holds the name of the currently selected interface, displayed in the toolbar header.

isZoned : bool

This property holds whether the current interface supports zones. When true, the zone selector and filter buttons are shown.

propertyFilter : int

This property holds the active property filter index. 0 means all properties, 1 means non-zoned only, and 2 means zoned only.

propertySearchText : string

This property holds the current text in the property search field, used to filter the property list below.

Signal Documentation

zoneChanged(int index)

This signal is emitted when the user selects a different zone. The index parameter is the position in availableZones.

Note: The corresponding handler is onZoneChanged.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.