Struct ComboBox 

#[non_exhaustive]
pub struct ComboBox {
    pub id: WidgetId,
    pub options: Vec<String>,
    pub text: String,
    pub committed: String,
    pub open: bool,
    pub highlighted: Option<usize>,
    pub disabled: bool,
    pub focused: bool,
}

Declarative description of an editable combo box: free text plus a filtered dropdown of fixed options.

Examples

use quadraui::{ComboBox, ComboBoxEvent, Key, Modifiers, WidgetId};

let mut combo = ComboBox::new(
    WidgetId::new("form:fruit"),
    vec!["Apple".into(), "Apricot".into(), "Banana".into()],
);
combo.focused = true;

let event = combo.handle_key(&Key::Char('a'), &Modifiers::default());
assert_eq!(
    event,
    Some(ComboBoxEvent::TextChanged { id: combo.id.clone(), text: "a".into() })
);

combo.text = "ap".into();
assert_eq!(combo.filtered_indices(), vec![0, 1]);

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

id: WidgetId

options: Vec<String>

Fixed candidate list ComboBox::filtered_indices matches against.

text: String

Live edit buffer — what the field currently displays.

committed: String

Last confirmed value. Only changes via ComboBoxEvent::Committed — the host applies it the same way every other primitive’s events are applied.

open: bool

Whether the filtered dropdown is currently shown.

highlighted: Option<usize>

Cursor index into the filtered list (from ComboBox::filtered_indices), not the raw options list.

disabled: bool

When true, every method below returns None — same “disabled means inert, not hidden” contract every other primitive’s disabled flag follows.

focused: bool

Whether this field currently holds keyboard focus. Set by the host’s focus-traversal logic; read by ComboBox::handle_key to gate typed/arrow-key handling.

Implementations

impl ComboBox

pub fn new(id: WidgetId, options: Vec<String>) -> Self

A combo box over options, with an empty text buffer, closed dropdown, enabled and unfocused. Set text/open/disabled/ focused directly afterwards (every field is pub) rather than via a with_* chain — see docs/PRIMITIVE_RULES.md’s rule-8 history of why this crate stopped adding those.

pub fn filtered_indices(&self) -> Vec<usize>

Indices into ComboBox::options that case-insensitively contain ComboBox::text as a substring. Empty text matches every option.

pub fn layout<F>( &self, field_bounds: Rect, viewport: Rect, popup_width: f32, max_popup_height: f32, measure_item: F, ) -> ComboBoxLayout

where F: Fn(usize) -> CompletionItemMeasure,

Resolve the field’s own bounds plus, when open, the dropdown popup’s layout — built by handing the filtered options to a transient Completions value and delegating to its placement algorithm (prefer below the field, flip above on overflow, shift left on overflow, clip to viewport).

pub fn handle_key( &self, key: &Key, _modifiers: &Modifiers, ) -> Option<ComboBoxEvent>

Up/Down move the highlighted dropdown cursor; Enter commits; Escape cancels an open edit; digits/letters and Backspace edit text. Gated on focused and not disabled — any other key is unhandled (None).

pub fn click(&self, hit: ComboBoxHit) -> Option<ComboBoxEvent>

Pointer activation dispatcher: the host calls this after resolving a MouseDown/MouseUp position through ComboBoxLayout::hit_test. A hit on the field itself or outside the control produces no event — focusing the field is the host’s job, same as elsewhere in this crate.

Trait Implementations

impl Clone for ComboBox

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ComboBox

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ComboBox

fn default() -> Self

An empty combo box with no options. See ComboBox::new for one with a real id/options list.

impl<'de> Deserialize<'de> for ComboBox

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ComboBox

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ComboBox

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ComboBox