ComboBox

import { ComboBox } from "std-widgets.slint";
export component Example inherits Window {
    width: 100px;
    height: 100px;
    background: transparent;
    ComboBox {
        x: 5px; y: 5px;
        width: 100px;
        model: ["first", "second", "third"];
        current-value: "first";
    }
}

slint

A button that, when clicked, opens a popup to select a value.

Properties

current-index

int(in-out)default: 0

The index of the selected value.

ComboBox {
    model: ["first", "second", "third"];
    current-index: 1;
}

slint

current-value

string(in-out)default: ""

The currently selected text.

Note

Writing to current-value — from host code (Rust, C++, JavaScript, Python), declaratively at instantiation (as in the example above), or imperatively from .slint code — looks up the written value in model and moves current-index to the first matching row. If the value isn’t found in model, the selection is cleared (current-index becomes -1 and current-value becomes ""), the same as setting current-index out of range. Prefer writing current-index directly when the row’s position is already known.

This lookup only runs when the write actually changes current-value. Writing the value it already holds — including when the model has duplicate entries and a later one is currently selected — is a no-op and does not move the selection.

enabled

booldefault: true

Defaults to true. When false, the combobox can’t be interacted with

font-family

stringdefault: ""

The font family of the selected value and of the values in the drop down list.

font-italic

booldefault: false

The italic state of the font of the selected value and of the values in the drop down list.

has-focus

bool(out)

Set to true when the combobox has keyboard focus.

model

[string]default: []

The list of possible values

ComboBox {
    model: ["first", "second", "third"];
}

slint

Note

When setting this property, the ComboBox will try to preserve the current-index. If the current-index is larger than the new model length, it is set to the last item in the model.

Callbacks

selected(string)

A value was selected from the combo box by the user. The argument is the currently selected value.

ComboBox {
    model: ["first", "second", "third"];
    selected(value) => {
        debug("Selected value: ", value);
    }
}

slint