On this page

InterfaceSelector QML Type

A sidebar panel that lists and filters available interfaces. More...

Import Statement: import QtInterfaceFramework.ControlPanelHelper 1.0
Inherits:

Rectangle

Properties

Signals

Detailed Description

InterfaceSelector displays all registered interfaces in a scrollable list with a search field for filtering by name. Each entry shows a zoned/non-zoned icon and the interface name. Selecting an entry emits interfaceSelected. A summary footer shows the interface count and whether the selected interface is zoned.

The list is filtered in real time as the user types into the built-in SearchField. When no interfaces match the query, a NoResultsFound placeholder is shown.

Usage

InterfaceSelector {
    interfaces: controlPanel.availableInterfaces
    currentInterfaceIndex: 0
    onInterfaceSelected: function(index) {
        controlPanel.selectInterface(index)
    }
}

Property Documentation

currentInterfaceIndex : int

This property holds the index of the currently selected interface in the interfaces list.

interfaces : var

This property holds the list of interface descriptors. Each element is a JavaScript object with at least name (string) and isZoned (bool) keys.

searchText : string

This property holds the current search filter text. Only interfaces whose name contains this text are shown.

Signal Documentation

interfaceSelected(int index)

This signal is emitted when the user selects an interface. The index parameter is the position in the original interfaces list.

Note: The corresponding handler is onInterfaceSelected.

© 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.