Struct Selection 

pub struct Selection<'a> { /* private fields */ }

A selection of surfaces matching a selector

Provides methods to interact with all matching surfaces at once. Created via Shell::select().

Implementations

impl<'a> Selection<'a>

pub fn on_callback<F, R>(&self, callback_name: &str, handler: F) -> &Self

where F: Fn(CallbackContext) -> R + Clone + 'static, R: IntoValue,

Registers a callback handler for all matching surfaces

shell.select(Surface::named("bar"))
    .on_callback("clicked", |ctx| {
        println!("Clicked: {}", ctx.surface_name());
    });

pub fn on_callback_with_args<F, R>( &self, callback_name: &str, handler: F, ) -> &Self

where F: Fn(&[Value], CallbackContext) -> R + Clone + 'static, R: IntoValue,

Registers a callback handler that receives Slint arguments

// Slint: callback item-clicked(string);
shell.select(Surface::named("menu"))
    .on_callback_with_args("item-clicked", |args, ctx| {
        if let Some(Value::String(item)) = args.get(0) {
            println!("{} clicked {}", ctx.surface_name(), item);
        }
    });

pub fn with_component<F>(&self, f: F)

where F: FnMut(&ComponentInstance),

Executes a function with each matching component instance

pub fn set_property(&self, name: &str, value: &Value) -> SelectionResult<()>

Sets a property value on all matching surfaces

Returns a SelectionResult that contains information about both successes and failures. Use .into_result() to convert to a standard Result if you want fail-fast behavior, or inspect .failures to handle partial failures gracefully.

pub fn get_property(&self, name: &str) -> SelectionResult<Value>

Gets property values from all matching surfaces

Returns a SelectionResult containing all successfully retrieved values and any failures. Use .into_result() to convert to a standard Result if you want fail-fast behavior, or inspect .values and .failures to handle partial failures gracefully.

pub fn configure<F>(&self, f: F)

where F: FnMut(&ComponentInstance, LayerSurfaceHandle<'_>),

Executes a configuration function with component and surface handle for matching surfaces

pub fn count(&self) -> usize

Returns the number of surfaces matching the selector

pub fn is_empty(&self) -> bool

Checks if no surfaces match the selector

pub fn info(&self) -> Vec<SurfaceInfo>

Returns information about all matching surfaces