Skip to content

ComboBox

Fluent / WinUI 3 ComboBox (Header, editable, ShowError chrome).

import QtQuick.Controls.QWinUI3 · src/style/QWinUI3/ComboBox.qml

Category: Styled controls · Library: v3.56

← Component index

Gallery: ComboBox — src/gallery/pages/ComboBoxPage.qml

Python: same QML type after qwinui3.setup_engine() — Python API.

Example

ComboBox {
    header: qsTr("Color")
    model: ["Red", "Green", "Blue"]
    onActivated: (index) => apply(index)
}

Notes

Header / description / errorMessage around the field; filled | outline appearance. editable uses an inline TextInput. FormLayout left headers: HeaderedComboBox.

API

Properties

Name Type Description
header string WinUI Header — label above the field
description string Supporting caption under the header (hidden while errorMessage is set)
errorMessage string Validation message — critical caption; also paints error chrome
hasError bool Form validation error flag (also treated as error when errorMessage is set)
appearance string Visual variant: filled | outline | "" (filled default)
lightScheme bool True in light theme (legacy)

Signals

No custom signals (use inherited signals from the base type).

Methods

No custom methods (use inherited methods from the base type).


Generated from module sources by scripts/generate_component_docs.py — do not edit by hand.