Struct ComboBox 

pub struct ComboBox { /* private fields */ }

Dropdown whose closed face is a Label (text and/or image).

let current = Label::new("Tokyo Night", None);
ComboBox::new("theme", current).width(200.0).show_ui(ui, |ui| {
    ui.label("Tokyo Night Light");
});

Implementations

impl ComboBox

pub fn new(id_salt: impl Hash + Debug, selected_item: Label) -> Self

Create a combo box keyed by id_salt, showing selected_item on the button.

pub fn visuals(self, visuals: ComboBoxVisuals) -> Self

Override the chrome that would otherwise come from the installed theme.

pub fn label(self, label: impl Into<WidgetText>) -> Self

Optional caption painted to the left of the button.

pub fn width(self, width: f32) -> Self

Set the exact width of the combo box button. If not set, the width adapts to the content, icon, and minimum width.

pub fn popup_max_height(self, height: f32) -> Self

Set the maximum height of the popup menu. Default is ui.spacing().combo_height.

pub fn icon( self, icon_fn: impl FnOnce(&Ui, Rect, &WidgetVisuals, bool) + 'static, ) -> Self

Replace the default disclosure triangle with a custom painter.

The bool argument is true while the popup is open.

pub fn wrap_mode(self, wrap_mode: TextWrapMode) -> Self

Set the wrap mode for the selected text displayed in the button.

pub fn close_behavior(self, close_behavior: PopupCloseBehavior) -> Self

How the popup closes. Default: PopupCloseBehavior::CloseOnClick.

pub fn show_ui<R>( self, ui: &mut Ui, menu_contents: impl FnOnce(&mut Ui) -> R, ) -> Option<InnerResponse<R>>

Paint the button and, while open, the popup. Returns the inner response of the menu closure when the popup is visible.