Struct MemoryNativeMenuBackend 

pub struct MemoryNativeMenuBackend { /* private fields */ }

Recording backend for headless tests. Captures the snapshot set per window, which window is active, item deltas, and cleared windows. Cloneable; clones share the recording so a test can keep a clone after handing one to NativeMenuHandle::new.

Implementations

impl MemoryNativeMenuBackend

pub fn new() -> Self

Build a new empty recording backend.

pub fn menu_for(&self, window_id: TeksiloWindowId) -> Option<NativeMenuSnapshot>

The snapshot currently set for window_id, if any.

pub fn active_window(&self) -> Option<TeksiloWindowId>

The window whose own menu shows, as on macOS: the one [key_window_bar] picks for the key window (the last activate_window), or a window that set one before any was activated. None while the application menu shows.

pub fn shows_app_menu(&self) -> bool

Whether the application menu is the one showing: no window’s own menu is (active_window is None).

pub fn deltas(&self) -> Vec<(MenuItemId, MenuItemDelta)>

All item deltas applied so far, in order.

pub fn cleared(&self) -> Vec<TeksiloWindowId>

Windows whose menus were cleared, in order.

pub fn app_menu(&self) -> Option<NativeMenuSnapshot>

The application menu last set, if any.

Trait Implementations

impl Clone for MemoryNativeMenuBackend

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for MemoryNativeMenuBackend

fn default() -> Self

Returns the “default value” for a type.

impl NativeMenuBackend for MemoryNativeMenuBackend

fn set_window_menu( &mut self, window_id: TeksiloWindowId, menu: NativeMenuSnapshot, _poster: Arc<dyn AppEventPoster>, )

Build (or replace) the native menu of window_id, a window with a menu of its own, from menu. For every item the user later chooses, the backend MUST post a NativeMenuEventPayload, with window_id_owner == window_id, through poster. If window_id is the key window (the last one activate_window named), or no window has been activated yet, the backend shows this menu.

fn activate_window(&mut self, window_id: TeksiloWindowId)

window_id became the key window (focus follows window): show the bar [key_window_bar] picks, its own menu if it set one, else the menu of the window it belongs to (see set_window_owner), else the application menu, or, when the application declared none, the bar shown before.

fn clear_window(&mut self, window_id: TeksiloWindowId)

Forget window_id’s menu (the window closed, or no longer has a menu of its own). If it was showing, show the application menu until another window becomes key.

fn update_item(&mut self, id: MenuItemId, delta: MenuItemDelta)

Apply a reactive delta to a single already-installed item, in every menu that carries it, the application menu included.

fn set_app_menu( &mut self, menu: NativeMenuSnapshot, _poster: Arc<dyn AppEventPoster>, declared: bool, )

Set the application menu: the menu shown whenever the key window has no menu of its own nor an owner with one, and while no window is open. teksilo-app sets it from the application tree at startup and again whenever it changes; it replaces any earlier one, and the bar is chosen again for the key window, as activate_window chooses it: an application menu declared while a window with no menu of its own is key shows at once. declared says whether the application declared it: false for the default App menu teksilo-app supplies when it declared none, which a key window without a menu does not bring up (see [key_window_bar]). For every item the user later chooses in it, the backend MUST post a NativeAppMenuEventPayload through poster. The default does nothing, for a backend whose menus belong to windows alone.