Struct Editor 

pub struct Editor { /* private fields */ }

The Layout Editor allows modifying a Layout while ensuring all the different invariants of the Layout objects are upheld no matter what kind of operations are being applied. It provides the current state of the editor as state objects that can be visualized by any kind of User Interface.

Implementations

impl Editor

pub fn state(&self) -> State

Calculates the Layout Editor’s state in order to visualize it.

impl Editor

pub fn new(layout: Layout) -> Result<Self>

Creates a new Layout Editor that modifies the Layout provided. Creation of the Layout Editor fails when a Layout with no components is provided.

pub fn close(self) -> Layout

Closes the Layout Editor and gives back access to the modified Layout. In case you want to implement a Cancel Button, just drop the Layout object you get here.

pub fn layout_state(&mut self, timer: &Snapshot<'_>) -> LayoutState

Calculates the layout’s state based on the timer provided. You can use this to visualize all of the components of a layout, while it is still being edited by the Layout Editor.

pub fn update_layout_state( &mut self, state: &mut LayoutState, timer: &Snapshot<'_>, )

Updates the layout’s state based on the timer provided. You can use this to visualize all of the components of a layout, while it is still being edited by the Layout Editor.

pub fn select(&mut self, index: usize)

Selects the component with the given index in order to modify its settings. Only a single component is selected at any given time. You may not provide an invalid index.

pub fn add_component<C: Into<Component>>(&mut self, component: C)

Adds the component provided to the end of the layout. The newly added component becomes the selected component.

pub fn can_remove_component(&self) -> bool

Checks if the currently selected component can be removed. If there’s only one component in the layout, it can’t be removed.

pub fn remove_component(&mut self)

Removes the currently selected component, unless there’s only one component in the layout. The next component becomes the selected component. If there’s none, the previous component becomes the selected component instead.

pub const fn can_move_component_up(&self) -> bool

Checks if the currently selected component can be moved up. If the first component is selected, it can’t be moved up.

pub fn move_component_up(&mut self)

Moves the selected component up, unless the first component is selected.

pub fn can_move_component_down(&self) -> bool

Checks if the currently selected component can be moved down. If the last component is selected, it can’t be moved down.

pub fn move_component_down(&mut self)

Moves the selected component down, unless the last component is selected.

pub fn move_component(&mut self, dst_index: usize)

Moves the selected component to the index provided. You may not provide an invalid index.

pub fn duplicate_component(&mut self)

Duplicates the currently selected component. The copy gets placed right after the selected component and becomes the newly selected component.

pub fn set_component_settings_value(&mut self, index: usize, value: Value)

Sets a setting’s value of the selected component by its setting index to the given value.

Panics

This panics if the type of the value to be set is not compatible with the type of the setting’s value. A panic can also occur if the index of the setting provided is out of bounds.

pub fn set_general_settings_value(&mut self, index: usize, value: Value)

Sets a setting’s value of the general settings by its setting index to the given value.

Panics

This panics if the type of the value to be set is not compatible with the type of the setting’s value. A panic can also occur if the index of the setting provided is out of bounds.