Struct VSplitter 

pub struct VSplitter { /* private fields */ }

Implementations

impl VSplitter

pub fn new<T>(pos: T, layout: Layout, resize_behavior: ResizeBehavior) -> Self

where Coordinate: From<T>,

Creates a new Vertical Splitter control with the specified position, layout and resize behavior The position can be a percentage (e.g. a float value) or an absolute value (e.g. an unsigned value) The resize behavior can be one of the following values:

• ResizeBehavior::PreserveAspectRatio - the aspect ratio of the panels is preserved when the splitter is resized
• ResizeBehavior::PreserveLeftPanelSize - the size of the left panel is preserved when the splitter is resized
• ResizeBehavior::PreserveRightPanelSize - the size of the right panel is preserved when the splitter is resized

Example

use appcui::prelude::*;
 
let mut vs = VSplitter::new(0.5,layout!("d:f"),vsplitter::ResizeBehavior::PreserveRightPanelSize);
vs.add(vsplitter::Panel::Left,panel!("Left,l:1,r:1,t:1,b:1"));
vs.add(vsplitter::Panel::Right,panel!("Right,l:1,r:1,t:1,b:1"));

pub fn add<T>(&mut self, panel: Panel, control: T) -> Handle<T>

where T: Control + NotWindow + NotDesktop + 'static,

Adds a new control to the specified panel of the splitter (left or right)

Example

use appcui::prelude::*;

let mut vs = VSplitter::new(0.5,layout!("d:f"),vsplitter::ResizeBehavior::PreserveRightPanelSize);
vs.add(vsplitter::Panel::Left,button!("PressMe,x:1,y:1,w:12"));
vs.add(vsplitter::Panel::Right,button!("PressMe,x:1,y:1,w:12"));   

pub fn set_min_width<T>(&mut self, panel: Panel, min_size: T)

where Dimension: From<T>,

Sets the minimum width for the left or right panel The value can be a percentage (e.g. a float value) or an absolute value (e.g. an unsigned value)

Example

use appcui::prelude::*;
 
let mut vs = VSplitter::new(0.5,layout!("d:f"),vsplitter::ResizeBehavior::PreserveRightPanelSize);
vs.add(vsplitter::Panel::Left,button!("PressMe,x:1,y:1,w:12"));
vs.add(vsplitter::Panel::Right,button!("PressMe,x:1,y:1,w:12"));
// minim 10 chars from left
vs.set_min_width(vsplitter::Panel::Left,10); 
// minim 20% from right
vs.set_min_width(vsplitter::Panel::Right,0.2);

pub fn position(&self) -> i32

Returns the absolute position of the splitter (in characters)

pub fn set_position<T>(&mut self, pos: T)

where Coordinate: From<T>,

Sets the position of the splitter. The value can be a percentage (e.g. a float value) or an absolute value (e.g. an unsigned value)

Methods from Deref<Target = ControlBase>

pub fn size(&self) -> Size

Returns the size of a control

pub fn client_size(&self) -> Size

Returns the client size of a control. In most cases it is the same as the size returned the method .get_size(). However, if the control has margins (for example in case of a Window) this size will be smaller.

pub fn set_size(&mut self, width: u16, height: u16)

Sets the new size for a control (to a specified size given by parameters width and height). Keep in mind that this method will change the existing layout to an a layout based on top-left corner (given by controls x and y coordonates) and the new provided size. Any dock or alignment properties will be removed. This method has no effect on a Desktop control.

pub fn position(&self) -> Point

Returns the relatove position (x,y) of the current control to its parent.

pub fn set_position(&mut self, x: i32, y: i32)

Sets the new position for a control (to a specified coordonate given by parameters x and y). Keep in mind that this method will change the existing layout to an a layout based on top-left corner (given by coordonates x and y) and the controls current width and height. Any dock or alignment properties will be removed. This method has no effect on a Desktop control.

pub fn set_enabled(&mut self, enabled: bool)

Sets the enabled state of a control. This method has no effect on a Desktop or a Window control that will always be enabled.

pub fn set_visible(&mut self, visible: bool)

Can be used to make a control visible or not. This method has no effect on the Desktop control that will always be visible.

Examples

use appcui::prelude::*;
let mut button = button!("'Click me',x:1,y:1,w:15");
button.set_visible(false); // this will hide the button

pub fn set_components_toolbar_margins(&mut self, left: u8, top: u8)

pub fn expanded_size(&self) -> Size

pub fn request_focus(&mut self) -> bool

A control can use this method to request focus

pub fn timer(&mut self) -> Option<&mut Timer>

pub fn is_visible(&self) -> bool

Returns true if the current control is visible or false otherwise

pub fn is_enabled(&self) -> bool

Returns true if the current control is enabled or false otherwise

pub fn is_active(&self) -> bool

Returns true if the current control is active (enabled and visible at the same time) or false otherwise

pub fn can_receive_input(&self) -> bool

Returns true if the current control can receive focus or false otherwise. If the control is not visible or it is disable this function will return false.

pub fn has_focus(&self) -> bool

Returns true if the current control has the focus or false otherwise

pub fn is_mouse_over(&self) -> bool

Returns true if the mouse cursor is over the current control or false otherwise

pub fn set_size_bounds( &mut self, min_width: u16, min_height: u16, max_width: u16, max_height: u16, )

Sets the bounds (minim and maxim sized allowed for a control). If the size of a control is outside its bounds, its size will be adjusted automatically. This method has no effect on a Desktop control.

pub fn set_hotkey<T>(&mut self, hotkey: T)

where Key: From<T>,

Sets the hot-key associated with a control. Use Key::None to clear an existing hotkey

pub fn hotkey(&self) -> Key

Returns the hotkey associated to a control or Key::None otherwise.

pub fn raise_custom_event(&self, class_hash: u64, event_id: u32)

pub fn request_update(&self)

pub fn register_menu(&mut self, menu: Menu) -> Handle<Menu>

pub fn show_menu( &self, handle: Handle<Menu>, x: i32, y: i32, max_size: Option<Size>, )

pub fn menuitem<T>( &self, menu_handle: Handle<Menu>, menuitem_handle: Handle<T>, ) -> Option<&T>

where T: MenuItem,

pub fn menuitem_mut<T>( &mut self, menu_handle: Handle<Menu>, menuitem_handle: Handle<T>, ) -> Option<&mut T>

where T: MenuItem,

pub fn appbar(&mut self) -> &mut AppBar

pub fn theme(&self) -> &Theme

pub fn update_layout(&mut self, layout: Layout)

Updates the layout of the current control

Trait Implementations

impl AccordionEvents for VSplitter

fn on_panel_changed( &mut self, _handle: Handle<Accordion>, _new_panel_index: u32, _old_panel_index: u32, ) -> EventProcessStatus

impl AppBarEvents for VSplitter

fn on_button_click(&mut self, _button: Handle<Button>)

Called when a button is clicked.

fn on_togglebutton_state_changed( &mut self, _togglebutton: Handle<ToggleButton>, _selected: bool, )

Called when a toggle button’s state changes.

fn on_switchbutton_state_changed( &mut self, _switchbutton: Handle<SwitchButton>, _selected: bool, )

Called when a switch button’s state changes.

fn on_update(&self, _appbar: &mut AppBar)

Called when the app bar needs to be updated. By default, all items are hidden and whenever the focus changes, the AppCUI framework hides all items and starts from the focus control and moves to its parent and calls this method. In this method you should call appbar.show(…) method to show the items you want to show.

impl ButtonEvents for VSplitter

fn on_pressed(&mut self, _handle: Handle<Button>) -> EventProcessStatus

impl CharPickerEvents for VSplitter

fn on_char_changed( &mut self, _handle: Handle<CharPicker>, _code: Option<char>, ) -> EventProcessStatus

impl CheckBoxEvents for VSplitter

fn on_status_changed( &mut self, _handle: Handle<CheckBox>, _checked: bool, ) -> EventProcessStatus

impl ColorPickerEvents for VSplitter

fn on_color_changed( &mut self, _handle: Handle<ColorPicker>, _color: Color, ) -> EventProcessStatus

impl ComboBoxEvents for VSplitter

fn on_selection_changed( &mut self, _handle: Handle<ComboBox>, ) -> EventProcessStatus

impl Control for VSplitter

impl CustomEvents for VSplitter

fn on_event( &mut self, _handle: Handle<()>, _class_hash: u64, _event_id: u32, ) -> EventProcessStatus

impl DatePickerEvents for VSplitter

fn on_date_changed( &mut self, _handle: Handle<DatePicker>, _date: NaiveDate, ) -> EventProcessStatus

impl Deref for VSplitter

type Target = ControlBase

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for VSplitter

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl DesktopEvents for VSplitter

fn on_start(&mut self)

fn on_close(&mut self) -> ActionRequest

fn on_update_window_count(&mut self, _count: usize)

impl GenericBackgroundTaskEvents for VSplitter

fn on_start(&mut self, _handle: Handle<()>) -> EventProcessStatus

fn on_update(&mut self, _handle: Handle<()>) -> EventProcessStatus

fn on_finish(&mut self, _handle: Handle<()>) -> EventProcessStatus

fn on_query(&mut self, _handle: Handle<()>) -> EventProcessStatus

impl GenericCommandBarEvents for VSplitter

fn on_update_commandbar(&self, _commandbar: &mut CommandBar)

fn on_event(&mut self, _command_id: u32)

impl GenericDropDownListEvents for VSplitter

fn on_selection_changed( &mut self, _handle: Handle<()>, _type_id: TypeId, ) -> EventProcessStatus

impl GenericGraphViewEvents for VSplitter

fn on_current_node_changed( &mut self, _handle: Handle<()>, _type_id: TypeId, ) -> EventProcessStatus

fn on_node_action( &mut self, _handle: Handle<()>, _type_id: TypeId, _node_index: usize, ) -> EventProcessStatus

fn on_request_new_node( &mut self, _handle: Handle<()>, _type_id: TypeId, _p: Point, ) -> EventProcessStatus

fn on_request_new_edge( &mut self, _handle: Handle<()>, _type_id: TypeId, _from: u32, _to: u32, ) -> EventProcessStatus

fn on_selection_changed( &mut self, _handle: Handle<()>, _type_id: TypeId, ) -> EventProcessStatus

impl GenericListViewEvents for VSplitter

fn on_current_item_changed( &mut self, _handle: Handle<()>, _type_id: TypeId, ) -> EventProcessStatus

fn on_group_collapsed( &mut self, _handle: Handle<()>, _type_id: TypeId, _group: Group, ) -> EventProcessStatus

fn on_group_expanded( &mut self, _handle: Handle<()>, _type_id: TypeId, _group: Group, ) -> EventProcessStatus

fn on_selection_changed( &mut self, _handle: Handle<()>, _type_id: TypeId, ) -> EventProcessStatus

fn on_item_action( &mut self, _handle: Handle<()>, _type_id: TypeId, _index: usize, ) -> EventProcessStatus

impl GenericMenuEvents for VSplitter

fn on_menu_open(&self, _menu: &mut Menu)

Called when a menu is about to be opened.

fn on_command( &mut self, _menu: Handle<Menu>, _item: Handle<Command>, _command: u32, )

Called when a command menu item is activated.

fn on_check( &mut self, _menu: Handle<Menu>, _item: Handle<CheckBox>, _command: u32, _checked: bool, )

Called when a checkbox menu item’s state changes.

fn on_select( &mut self, _menu: Handle<Menu>, _item: Handle<SingleChoice>, _command: u32, )

Called when a single choice menu item is selected.

impl GenericNumericSelectorEvents for VSplitter

fn on_value_changed( &mut self, _handle: Handle<()>, _type_id: TypeId, ) -> EventProcessStatus

impl GenericSelectorEvents for VSplitter

fn on_selection_changed( &mut self, _handle: Handle<()>, _type_id: TypeId, ) -> EventProcessStatus

impl GenericTreeViewEvents for VSplitter

fn on_current_item_changed( &mut self, _handle: Handle<()>, _type_id: TypeId, _current_item: Handle<()>, ) -> EventProcessStatus

fn on_item_collapsed( &mut self, _handle: Handle<()>, _type_id: TypeId, _item: Handle<()>, _recursive: bool, ) -> EventProcessStatus

fn on_item_expanded( &mut self, _handle: Handle<()>, _type_id: TypeId, _item: Handle<()>, _recursive: bool, ) -> EventProcessStatus

fn on_selection_changed( &mut self, _handle: Handle<()>, _type_id: TypeId, ) -> EventProcessStatus

fn on_item_action( &mut self, _handle: Handle<()>, _type_id: TypeId, _current_item: Handle<()>, ) -> EventProcessStatus

impl KeySelectorEvents for VSplitter

fn on_key_changed( &mut self, _handle: Handle<KeySelector>, _new_key: Key, _old_key: Key, ) -> EventProcessStatus

impl ListBoxEvents for VSplitter

fn on_current_item_changed( &mut self, _handle: Handle<ListBox>, _index: usize, ) -> EventProcessStatus

fn on_item_checked( &mut self, _handle: Handle<ListBox>, _index: usize, _checked: bool, ) -> EventProcessStatus

impl MarkdownEvents for VSplitter

fn on_external_link( &mut self, _handle: Handle<Markdown>, _link: &str, ) -> EventProcessStatus

fn on_backspace_navigation( &mut self, _handle: Handle<Markdown>, ) -> EventProcessStatus

impl NotDesktop for VSplitter

impl NotWindow for VSplitter

impl OnDefaultAction for VSplitter

fn on_default_action(&mut self)

impl OnExpand for VSplitter

fn on_expand(&mut self, _direction: ExpandedDirection)

fn on_pack(&mut self)

impl OnFocus for VSplitter

fn on_focus(&mut self)

fn on_lose_focus(&mut self)

impl OnKeyPressed for VSplitter

fn on_key_pressed(&mut self, key: Key, _character: char) -> EventProcessStatus

impl OnMouseEvent for VSplitter

fn on_mouse_event(&mut self, event: &MouseEvent) -> EventProcessStatus

impl OnPaint for VSplitter

fn on_paint(&self, surface: &mut Surface, theme: &Theme)

impl OnResize for VSplitter

fn on_resize(&mut self, old_size: Size, new_size: Size)

impl OnSiblingSelected for VSplitter

fn on_sibling_selected(&mut self, _handle: Handle<()>)

impl OnThemeChanged for VSplitter

fn on_theme_changed(&mut self, _theme: &Theme)

impl OnWindowRegistered for VSplitter

fn on_registered(&mut self)

impl PasswordEvents for VSplitter

fn on_accept(&mut self, _handle: Handle<Password>) -> EventProcessStatus

fn on_cancel(&mut self, _handle: Handle<Password>) -> EventProcessStatus

impl PathFinderEvents for VSplitter

fn on_path_updated(&mut self, _handle: Handle<PathFinder>) -> EventProcessStatus

impl RadioBoxEvents for VSplitter

fn on_selected(&mut self, _handle: Handle<RadioBox>) -> EventProcessStatus

impl RichTextFieldEvents for VSplitter

fn on_validate( &mut self, _handle: Handle<RichTextField>, _text: &str, ) -> EventProcessStatus

fn on_text_changed( &mut self, _handle: Handle<RichTextField>, ) -> EventProcessStatus

impl TabEvents for VSplitter

fn on_tab_changed( &mut self, _handle: Handle<Tab>, _new_tab_index: u32, _old_tabl_index: u32, ) -> EventProcessStatus

impl TextFieldEvents for VSplitter

fn on_validate( &mut self, _handle: Handle<TextField>, _text: &str, ) -> EventProcessStatus

fn on_text_changed(&mut self, _handle: Handle<TextField>) -> EventProcessStatus

impl ThreeStateBoxEvents for VSplitter

fn on_status_changed( &mut self, _handle: Handle<ThreeStateBox>, _state: State, ) -> EventProcessStatus

impl TimePickerEvents for VSplitter

fn on_time_changed( &mut self, _handle: Handle<TimePicker>, _time: NaiveTime, ) -> EventProcessStatus

impl TimerEvents for VSplitter

fn on_start(&mut self) -> EventProcessStatus

fn on_resume(&mut self, _ticks: u64) -> EventProcessStatus

fn on_pause(&mut self, _ticks: u64) -> EventProcessStatus

fn on_update(&mut self, _ticks: u64) -> EventProcessStatus

impl ToggleButtonEvents for VSplitter

fn on_selection_changed( &mut self, _handle: Handle<ToggleButton>, _selected: bool, ) -> EventProcessStatus

impl ToolBarEvents for VSplitter

fn on_button_clicked(&mut self, _handle: Handle<Button>) -> EventProcessStatus

Called when a toolbar button is clicked.

fn on_checkbox_clicked( &mut self, _handle: Handle<CheckBox>, _checked: bool, ) -> EventProcessStatus

Called when a toolbar checkbox is clicked, changing its checked state.

fn on_choice_selected( &mut self, _handle: Handle<SingleChoice>, ) -> EventProcessStatus

Called when a toolbar single choice item is selected.

impl WindowEvents for VSplitter

fn on_layout_changed(&mut self, _old_layout: Rect, _new_layout: Rect)

fn on_activate(&mut self)

called whenver the window receives focus

fn on_deactivate(&mut self)

called whenever the window loses focus.

fn on_accept(&mut self)

called whenever the ENTER key is intercepted by the Window For modal windows the behavior should be to use .exit_with(...) method to exit. for a regular (non-modal) window this callback is never called)

fn on_cancel(&mut self) -> ActionRequest

called whenever the ESC key is interpreted by the Window