TopBar QML Type
A toolbar displayed above the property list in the control panel. More...
| Import Statement: | import QtInterfaceFramework.ControlPanelHelper 1.0 |
| Inherits: |
Properties
- availableZones : var
- currentZoneIndex : int
- interfaceName : string
- isZoned : bool
- propertyFilter : int
- propertySearchText : string
Signals
- zoneChanged(int index)
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.