Struct CheckBoxes 

pub struct CheckBoxes { /* private fields */ }

Several check boxes in one focusable control, with one bit of value each.

Matches Borland: TCheckBoxes.

Implementations

impl CheckBoxes

pub fn new(bounds: Rect, labels: Vec<String>) -> Self

Create the cluster from labels, one per row.

A tilde-wrapped letter, as in "~B~old", becomes that item’s Alt hotkey. At most MAX_CLUSTER_ITEMS labels are kept.

pub fn set_labels(&mut self, labels: Vec<String>)

Replace the labels, keeping the value bits that still apply.

pub fn item_count(&self) -> usize

Number of items.

pub fn value(&self) -> u32

The raw bitmask: bit n is item n.

pub fn set_value(&mut self, value: u32)

Set the raw bitmask. Bits past the last item are dropped.

pub fn focused_item(&self) -> usize

Index of the item the arrow keys are on.

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

Move the arrow-key focus within the cluster.

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

Whether one item can be chosen. Disabled items draw dimmed.

pub fn is_enabled(&self, index: usize) -> bool

Whether one item can be chosen.

pub fn set_on_change(&mut self, command: CommandId)

Command broadcast when the value changes. Zero, the default, sends none.

impl CheckBoxes

pub fn is_checked(&self, index: usize) -> bool

Whether one box is ticked.

pub fn set_checked(&mut self, index: usize, checked: bool)

Tick or untick one box.

pub fn checked_items(&self) -> Vec<usize>

The ticked boxes, in order.

Trait Implementations

impl View for CheckBoxes

fn core(&self) -> &ViewCore

Base fields shared by every view (Borland: the TView data members).

fn core_mut(&mut self) -> &mut ViewCore

fn state(&self) -> StateFlags

Get view state flags

fn set_state(&mut self, state: StateFlags)

Set view state flags

fn can_focus(&self) -> bool

fn draw(&mut self, terminal: &mut Terminal)

fn handle_event(&mut self, event: &mut Event)

fn set_palette_chain(&mut self, node: Option<PaletteChainNode>)

Set the QCell-based palette chain node for this view. Called by parent (Group/Window) during draw to establish the safe owner chain.

fn get_palette(&self) -> Option<Palette>

Get this view’s palette for the Borland indirect palette system Matches Borland: TView::getPalette()

fn as_any(&self) -> &dyn Any

Downcast to concrete type (immutable) Allows accessing specific view type methods from trait object

fn as_any_mut(&mut self) -> &mut dyn Any

Downcast to concrete type (mutable) Allows accessing specific view type methods from trait object

fn bounds(&self) -> Rect

The rectangle this view occupies in its owner’s coordinate space (Borland: origin and size). A child at (2, 3) stays at (2, 3) however its owner moves.

fn set_bounds(&mut self, bounds: Rect)

fn extent(&self) -> Rect

The view’s own coordinate space, (0, 0) to its size (Borland: TView::getExtent). This is the rectangle draw writes into and the space mouse positions arrive in.

fn set_focus(&mut self, focused: bool)

Set focus state - default implementation uses State::FOCUSED flag Views should override only if they need custom focus behavior

fn window_number(&self) -> Option<u8>

Window number for Alt+1..9 selection (Borland: TWindow::number).

fn is_focused(&self) -> bool

Check if view is focused - reads State::FOCUSED flag

fn options(&self) -> Options

Get view option flags (Options::SELECTABLE, Options::PRE_PROCESS, Options::POST_PROCESS, etc.)

fn set_options(&mut self, options: Options)

Set view option flags

fn grow_mode(&self) -> GrowFlags

Get this view’s grow mode flags (Borland: TView::growMode).

fn set_grow_mode(&mut self, grow_mode: GrowFlags)

Set this view’s grow mode flags (Borland: TView::growMode).

fn set_state_flag(&mut self, flag: StateFlags, enable: bool)

Set or clear specific state flag(s) Matches Borland’s TView::setState(ushort aState, Boolean enable) If enable is true, sets the flag(s), otherwise clears them

fn get_state_flag(&self, flag: StateFlags) -> bool

Check if specific state flag(s) are set Matches Borland’s TView::getState(ushort aState)

fn has_shadow(&self) -> bool

Check if view has shadow enabled

fn shadow_bounds(&self) -> Rect

Get bounds including shadow area

fn update_cursor(&self, _terminal: &mut Terminal)

Update cursor state (called after draw) Views that need to show a cursor when focused should override this

fn zoom(&mut self, _max_bounds: Rect)

Zoom (maximize/restore) the view with given maximum bounds Matches Borland: TWindow::zoom() toggles between current and max size Default implementation does nothing (only windows support zoom)

fn valid(&mut self, _command: CommandId) -> bool

Validate the view before performing a command (usually closing) Matches Borland: TView::valid(ushort command) - returns Boolean Returns true if the view’s state is valid for the given command Used for “Save before closing?” type scenarios and input validation

fn idle(&mut self)

Called periodically while the application is idle, so animations and timers can advance (Borland: TProgram::idle, which keeps running during execView). Overlay widgets added with Application::add_overlay_widget get this on every idle tick; the default does nothing.

fn as_group(&self) -> Option<&dyn GroupLike>

The container interface of this view, if it is one (Borland: dynamic_cast<TGroup*>). Containers built on Group return Some; leaf views keep the default None. Application::exec_view uses it to read a modal view’s end state without knowing its concrete type.

fn as_group_mut(&mut self) -> Option<&mut dyn GroupLike>

fn dump_to_file(&self, terminal: &Terminal, path: &str) -> Result<()>

Dump this view’s region of the terminal buffer to an ANSI file for debugging

fn get_redraw_union(&self) -> Option<Rect>

Get the union rect of previous and current bounds for redrawing Matches Borland: TView::locate() calculates union of old and new bounds Returns None if the view hasn’t moved since last redraw Used by Desktop to implement Borland’s drawUnderRect pattern

fn clear_move_tracking(&mut self)

Clear movement tracking after redrawing Matches Borland: Called after drawUnderRect completes

fn make_global(&self, local_x: i16, local_y: i16) -> (i16, i16)

Convert a point in this view’s space to its owner’s space (Borland: TView::makeGlobal, but one hop: there is no owner chain to walk, and a group translates as it dispatches, so one hop is all a view ever needs).

fn make_local(&self, owner_x: i16, owner_y: i16) -> (i16, i16)

Convert a point in the owner’s space to this view’s space (Borland: TView::makeLocal, one hop; see make_global).

fn draw_shadow(&self, terminal: &mut Terminal)

Draw shadow for this view Draws a shadow offset dynamically based on terminal cell aspect ratio Shadow is semi-transparent - darkens the underlying content by 50% This matches the Borland Turbo Vision behavior more closely

fn label_link(&self) -> Option<ViewId>

Get the linked control ViewId for labels Matches Borland: TLabel::link field Returns Some(ViewId) if this is a label with a linked control, None otherwise Used by Group to implement focus transfer when clicking labels

fn init_after_add(&mut self)

Initialize internal owner pointers after view is added to parent and won’t move This is called by parent’s add() method after the view is in its final position Views that contain other views by value should override this to set up owner chains Default implementation does nothing

fn constrain_to_parent_bounds(&mut self)

Constrain view bounds to parent/owner bounds Used after positioning (e.g., centering) to ensure view stays within valid area Matches Borland: TView::locate() constrains position to owner bounds

fn get_palette_chain(&self) -> Option<&PaletteChainNode>

Get the QCell-based palette chain node for this view. Used by map_color() to safely walk the owner chain.

fn set_owner_extent(&mut self, _extent: Rect)

Tell the view how big its owner is, for drag and resize limits (Borland: TFrame::dragWindow reads owner->owner->getExtent()). Called by Desktop when adding windows.

fn map_color(&self, color_index: u8) -> Attr

Map a logical color index to an actual color attribute Matches Borland: TView::mapColor(uchar index)