Struct native_windows_gui::GridLayout

pub struct GridLayout { /* private fields */ }

A layout that lays out widgets in a grid NWG layouts use interior mutability to manage their controls.

A GridLayouts has the following properties:

• margin - The top, right, bottom, left margins of the layout - (default: [5, 5, 5, 5])
• spacing - The spacing between children controls - (default: 5)
• min_size - The minimum size of the layout - (default: [0, 0])
• max_size - The maximum size of the layout - (default: [u32::max_value(), u32::max_value()])
• max_column - Number of columns - (default: None),
• max_row - Number of rows - (default: None),

    use native_windows_gui as nwg;
    fn layout(layout: &nwg::GridLayout, window: &nwg::Window, item1: &nwg::Button, item2: &nwg::Button) {
        nwg::GridLayout::builder()
            .parent(window)
            .max_row(Some(6))
            .spacing(5)
            .margin([0,0,0,0])
            .child(0, 0, item1)
            .child_item(nwg::GridLayoutItem::new(item2, 1, 0, 2, 1))
            .build(&layout);
    }

Implementations

impl GridLayout

pub fn builder() -> GridLayoutBuilder

pub fn add_child<W: Into<ControlHandle>>(&self, col: u32, row: u32, c: W)

Add a children control to the grid layout. This is a simplified interface over add_child_item

Panic:

• If the layout is not initialized
• If the control is not window-like (HWND handle)

pub fn add_child_item(&self, i: GridLayoutItem)

Add a children control to the grid layout.

Panic: - If the layout is not initialized - If the control is not window-like (HWND handle)

pub fn remove_child<W: Into<ControlHandle>>(&self, c: W)

Remove the children control in the layout. See also remove_child_by_pos. Note that the child control won’t be hidden after being removed from the control.

This method won’t do anything if there is no control at the specified position.

Panic:

• If the layout is not initialized

pub fn remove_child_by_pos(&self, col: u32, row: u32)

Remove the children control in the layout. See also remove_child_by_pos. Note that the child control won’t be hidden after being removed from the control.

This method won’t do anything if there is no control at the specified position.

Panic:

• If the layout is not initialized

pub fn move_child<W: Into<ControlHandle>>(&self, c: W, col: u32, row: u32)

Move the selected control to a new position in the grid layout. The old position becomes empty (as if remove_child was called). However it won’t remove the control at the new position if there is one.

This method won’t do anything if there is no control at the specified position.

Panic:

• If the layout is not initialized

pub fn move_child_by_pos<W: Into<ControlHandle>>(
    &self,
    col: u32,
    row: u32,
    new_col: u32,
    new_row: u32
)

Move the selected control to a new position in the grid layout. The old position becomes empty (as if remove_child was called). However it won’t remove the control at the new position if there is one.

This method won’t do anything if there is no control at the specified position.

Panic:

• If the layout is not initialized

pub fn has_child<W: Into<ControlHandle>>(&self, c: W) -> bool

Check if a window control is a children of the layout

Panic:

• If the layout is not initialized
• If the child is not a window-like control

pub fn resize(&self, w: u32, h: u32)

Resize the layout as if the parent window had the specified size.

Arguments: w: New width of the layout h: New height of the layout

Panic:

• The layout must have been successfully built otherwise this function will panic.

pub fn fit(&self)

Resize the layout to fit the parent window size

Panic:

• The layout must have been successfully built otherwise this function will panic.

pub fn margin(&self, m: [u32; 4])

Set the margins of the layout. The four values are in this order: top, right, bottom, left.

pub fn spacing(&self, sp: u32)

Set the size of the space between the children in the layout. Default value is 5.

pub fn min_size(&self, sz: [u32; 2])

Sets the minimum size of the layout

pub fn max_size(&self, sz: [u32; 2])

Sets the maximum size of the layout

pub fn max_column(&self, count: Option<u32>)

Set the number of column in the layout

pub fn max_row(&self, count: Option<u32>)

Set the number of row in the layout

Trait Implementations

impl Clone for GridLayout

fn clone(&self) -> GridLayout

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for GridLayout

fn default() -> GridLayout

Returns the “default value” for a type.