Struct PaneGroup 

pub struct PaneGroup { /* private fields */ }

Stateful owner of a recursive pane split tree: which pane is active, how new panes’ content is created, and (via its Render impl) the split/close/focus keybinding wiring and active-pane highlight.

Create with cx.new(|cx| PaneGroup::new(cx, pane)), optionally .with_pane_factory(..) to control what split-created panes contain.

Implementations

impl PaneGroup

pub fn new(cx: &mut Context<'_, Self>, pane: Entity<Pane>) -> Self

Boots a single-leaf tree containing pane.

Takes cx: &mut Context<Self> (a refinement over phase-01’s new(pane: Entity<Pane>) pseudocode) — needed to allocate this group’s own FocusHandle and subscribe to pane’s [PaneEvent::Empty].

pub fn with_pane_factory( self, factory: impl Fn(&mut Context<'_, Pane>) -> Pane + 'static, ) -> Self

Sets the factory used to construct the Pane for every future split. Defaults to an empty Pane::new.

pub fn active_pane(&self) -> &Entity<Pane>

The currently active (keyboard/action target) pane.

pub fn set_active_pane( &mut self, pane: Entity<Pane>, cx: &mut Context<'_, Self>, )

Sets the active pane directly, for callers holding a specific Entity<Pane> handle (e.g. programmatically laying out an initial grid, or a “reveal this file’s pane” flow) rather than a keyboard direction. No tree-membership validation: setting a pane outside this group’s tree only makes subsequent split/close_active target a detached pane, which is inert (not a crash risk) but almost certainly not what the caller wants.

pub fn split(&mut self, dir: SplitDirection, cx: &mut Context<'_, Self>)

Splits the active pane in dir: appends a sibling into the active pane’s parent axis if it already runs along dir’s axis (N-way split), otherwise wraps the active pane in a new two-child axis. The new pane becomes active.

pub fn close_active( &mut self, cx: &mut Context<'_, Self>, ) -> Result<(), CannotRemoveLastPane>

Removes the active pane from the tree. Errs if it is the last pane.

pub fn focus(&mut self, dir: SplitDirection, cx: &mut Context<'_, Self>)

Moves the active pane to its neighbor in dir, if one exists in the same axis as the active pane’s immediate parent split.

Trait Implementations

impl Focusable for PaneGroup

fn focus_handle(&self, _cx: &App) -> FocusHandle

Returns the focus handle associated with this view.

impl Render for PaneGroup

fn render( &mut self, window: &mut Window, cx: &mut Context<'_, Self>, ) -> impl IntoElement

Render this view into an element tree.