Struct gtk4::FlowBox

source ·

#[repr(transparent)]
pub struct FlowBox { /* private fields */ }

Expand description

A FlowBox puts child widgets in reflowing grid.

For instance, with the horizontal orientation, the widgets will be arranged from left to right, starting a new row under the previous row when necessary. Reducing the width in this case will require more rows, so a larger height will be requested.

Likewise, with the vertical orientation, the widgets will be arranged from top to bottom, starting a new column to the right when necessary. Reducing the height will require more columns, so a larger width will be requested.

The size request of a FlowBox alone may not be what you expect; if you need to be able to shrink it along both axes and dynamically reflow its children, you may have to wrap it in a ScrolledWindow to enable that.

The children of a FlowBox can be dynamically sorted and filtered.

Although a FlowBox must have only FlowBoxChild children, you can add any kind of widget to it via insert(), and a FlowBoxChild widget will automatically be inserted between the box and the widget.

Also see ListBox.

CSS nodes

flowbox
├── flowboxchild
│   ╰── <child>
├── flowboxchild
│   ╰── <child>
┊
╰── [rubberband]

FlowBox uses a single CSS node with name flowbox. FlowBoxChild uses a single CSS node with name flowboxchild. For rubberband selection, a subnode with name rubberband is used.

Accessibility

FlowBox uses the AccessibleRole::Grid role, and FlowBoxChild uses the AccessibleRole::GridCell role.

Implements

WidgetExt, glib::ObjectExt, AccessibleExt, BuildableExt, ConstraintTargetExt, OrientableExt, WidgetExtManual, AccessibleExtManual

Struct gtk4::FlowBox

Implementations§

impl FlowBox

pub fn new() -> FlowBox

pub fn builder() -> FlowBoxBuilder

pub fn append(&self, child: &impl IsA<Widget>)

pub fn bind_model<P: Fn(&Object) -> Widget + 'static>( &self, model: Option<&impl IsA<ListModel>>, create_widget_func: P )

pub fn activates_on_single_click(&self) -> bool

pub fn child_at_index(&self, idx: i32) -> Option<FlowBoxChild>

pub fn child_at_pos(&self, x: i32, y: i32) -> Option<FlowBoxChild>

pub fn column_spacing(&self) -> u32

pub fn is_homogeneous(&self) -> bool

pub fn max_children_per_line(&self) -> u32

pub fn min_children_per_line(&self) -> u32

pub fn row_spacing(&self) -> u32

pub fn selected_children(&self) -> Vec<FlowBoxChild>

pub fn selection_mode(&self) -> SelectionMode

pub fn insert(&self, widget: &impl IsA<Widget>, position: i32)

pub fn invalidate_filter(&self)

pub fn invalidate_sort(&self)

pub fn prepend(&self, child: &impl IsA<Widget>)

pub fn remove(&self, widget: &impl IsA<Widget>)

pub fn select_all(&self)

pub fn select_child(&self, child: &impl IsA<FlowBoxChild>)

pub fn selected_foreach<P: FnMut(&FlowBox, &FlowBoxChild)>(&self, func: P)

pub fn set_activate_on_single_click(&self, single: bool)

pub fn set_column_spacing(&self, spacing: u32)

pub fn set_filter_func<P: Fn(&FlowBoxChild) -> bool + 'static>( &self, filter_func: P )

pub fn set_hadjustment(&self, adjustment: &impl IsA<Adjustment>)

pub fn set_homogeneous(&self, homogeneous: bool)

pub fn set_max_children_per_line(&self, n_children: u32)

pub fn set_min_children_per_line(&self, n_children: u32)

pub fn set_row_spacing(&self, spacing: u32)

pub fn set_selection_mode(&self, mode: SelectionMode)

pub fn set_vadjustment(&self, adjustment: &impl IsA<Adjustment>)

pub fn unselect_all(&self)

pub fn unselect_child(&self, child: &impl IsA<FlowBoxChild>)

pub fn accepts_unpaired_release(&self) -> bool

pub fn set_accept_unpaired_release(&self, accept_unpaired_release: bool)

pub fn connect_activate_cursor_child<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn emit_activate_cursor_child(&self)

pub fn connect_child_activated<F: Fn(&Self, &FlowBoxChild) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_move_cursor<F: Fn(&Self, MovementStep, i32, bool, bool) -> bool + 'static>( &self, f: F ) -> SignalHandlerId

pub fn emit_move_cursor( &self, step: MovementStep, count: i32, extend: bool, modify: bool ) -> bool

pub fn connect_select_all<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn emit_select_all(&self)

pub fn connect_selected_children_changed<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_toggle_cursor_child<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn emit_toggle_cursor_child(&self)

pub fn connect_unselect_all<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn emit_unselect_all(&self)

pub fn connect_accept_unpaired_release_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_activate_on_single_click_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_column_spacing_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_homogeneous_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_max_children_per_line_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_min_children_per_line_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_row_spacing_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_selection_mode_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

impl FlowBox

pub fn unbind_model(&self)

pub fn unset_filter_func(&self)

pub fn unset_sort_func(&self)

pub fn set_sort_func<P: Fn(&FlowBoxChild, &FlowBoxChild) -> Ordering + 'static>( &self, sort_func: P )

Trait Implementations§

impl Clone for FlowBox

fn clone(&self) -> Self

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

impl Debug for FlowBox

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

impl Default for FlowBox

fn default() -> Self

impl Display for FlowBox

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

impl Hash for FlowBox

fn hash<H>(&self, state: &mut H)where H: Hasher,

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

impl Ord for FlowBox

fn cmp(&self, other: &Self) -> Ordering

fn max(self, other: Self) -> Selfwhere Self: Sized,