Struct Context 

pub struct Context<'a, T> { /* private fields */ }

The app context, with specialized behavior for the given entity.

Implementations

impl<'a, T: 'static> Context<'a, T>

pub fn entity_id(&self) -> EntityId

The entity id of the entity backing this context.

pub fn entity(&self) -> Entity<T>

Returns a handle to the entity belonging to this context.

pub fn weak_entity(&self) -> WeakEntity<T>

Returns a weak handle to the entity belonging to this context.

pub fn observe<W>( &mut self, entity: &Entity<W>, on_notify: impl FnMut(&mut T, Entity<W>, &mut Context<'_, T>) + 'static, ) -> Subscription

where T: 'static, W: 'static,

Arranges for the given function to be called whenever Context::notify is called with the given entity.

pub fn observe_self( &mut self, on_event: impl FnMut(&mut T, &mut Context<'_, T>) + 'static, ) -> Subscription

where T: 'static,

Observe changes to ourselves

pub fn subscribe<T2, Evt>( &mut self, entity: &Entity<T2>, on_event: impl FnMut(&mut T, Entity<T2>, &Evt, &mut Context<'_, T>) + 'static, ) -> Subscription

where T: 'static, T2: 'static + EventEmitter<Evt>, Evt: 'static,

Subscribe to an event type from another entity

pub fn subscribe_self<Evt>( &mut self, on_event: impl FnMut(&mut T, &Evt, &mut Context<'_, T>) + 'static, ) -> Subscription

where T: 'static + EventEmitter<Evt>, Evt: 'static,

Subscribe to an event type from ourself

pub fn on_release( &self, on_release: impl FnOnce(&mut T, &mut App) + 'static, ) -> Subscription

where T: 'static,

Register a callback to be invoked when GPUI releases this entity.

pub fn observe_release<T2>( &self, entity: &Entity<T2>, on_release: impl FnOnce(&mut T, &mut T2, &mut Context<'_, T>) + 'static, ) -> Subscription

where T: Any, T2: 'static,

Register a callback to be run on the release of another entity

pub fn observe_global<G: 'static>( &mut self, f: impl FnMut(&mut T, &mut Context<'_, T>) + 'static, ) -> Subscription

where T: 'static,

Register a callback to for updates to the given global

pub fn on_app_restart( &self, on_restart: impl FnMut(&mut T, &mut App) + 'static, ) -> Subscription

where T: 'static,

Register a callback to be invoked when the application is about to restart.

pub fn on_app_quit<Fut>( &self, on_quit: impl FnMut(&mut T, &mut Context<'_, T>) -> Fut + 'static, ) -> Subscription

where Fut: 'static + Future<Output = ()>, T: 'static,

Arrange for the given function to be invoked whenever the application is quit. The future returned from this callback will be polled for up to crate::SHUTDOWN_TIMEOUT until the app fully quits.

pub fn notify(&mut self)

Tell GPUI that this entity has changed and observers of it should be notified.

pub fn spawn<AsyncFn, R>(&self, f: AsyncFn) -> Task<R>

where T: 'static, AsyncFn: AsyncFnOnce(WeakEntity<T>, &mut AsyncApp) -> R + 'static, R: 'static,

Spawn the future returned by the given function. The function is provided a weak handle to the entity owned by this context and a context that can be held across await points. The returned task must be held or detached.

pub fn listener<E: ?Sized>( &self, f: impl Fn(&mut T, &E, &mut Window, &mut Context<'_, T>) + 'static, ) -> impl Fn(&E, &mut Window, &mut App) + 'static

Convenience method for accessing view state in an event callback.

Many GPUI callbacks take the form of Fn(&E, &mut Window, &mut App), but it’s often useful to be able to access view state in these callbacks. This method provides a convenient way to do so.

pub fn processor<E, R>( &self, f: impl Fn(&mut T, E, &mut Window, &mut Context<'_, T>) -> R + 'static, ) -> impl Fn(E, &mut Window, &mut App) -> R + 'static

Convenience method for producing view state in a closure. See listener for more details.

pub fn on_drop( &self, f: impl FnOnce(&mut T, &mut Context<'_, T>) + 'static, ) -> Deferred<impl FnOnce()>

Run something using this entity and cx, when the returned struct is dropped

pub fn focus_view<W: Focusable>( &mut self, view: &Entity<W>, window: &mut Window, )

Focus the given view in the given window. View type is required to implement Focusable.

pub fn on_next_frame( &self, window: &mut Window, f: impl FnOnce(&mut T, &mut Window, &mut Context<'_, T>) + 'static, )

where T: 'static,

Sets a given callback to be run on the next frame.

pub fn defer_in( &mut self, window: &Window, f: impl FnOnce(&mut T, &mut Window, &mut Context<'_, T>) + 'static, )

Schedules the given function to be run at the end of the current effect cycle, allowing entities that are currently on the stack to be returned to the app.

pub fn observe_in<V2>( &mut self, observed: &Entity<V2>, window: &mut Window, on_notify: impl FnMut(&mut T, Entity<V2>, &mut Window, &mut Context<'_, T>) + 'static, ) -> Subscription

where V2: 'static, T: 'static,

Observe another entity for changes to its state, as tracked by Context::notify.

pub fn subscribe_in<Emitter, Evt>( &mut self, emitter: &Entity<Emitter>, window: &Window, on_event: impl FnMut(&mut T, &Entity<Emitter>, &Evt, &mut Window, &mut Context<'_, T>) + 'static, ) -> Subscription

where Emitter: EventEmitter<Evt>, Evt: 'static,

Subscribe to events emitted by another entity. The entity to which you’re subscribing must implement the EventEmitter trait. The callback will be invoked with a reference to the current view, a handle to the emitting Entity, the event, a mutable reference to the Window, and the context for the entity.

pub fn on_release_in( &mut self, window: &Window, on_release: impl FnOnce(&mut T, &mut Window, &mut App) + 'static, ) -> Subscription

Register a callback to be invoked when the view is released.

The callback receives a handle to the view’s window. This handle may be invalid, if the window was closed before the view was released.

pub fn observe_release_in<T2>( &self, observed: &Entity<T2>, window: &Window, on_release: impl FnMut(&mut T, &mut T2, &mut Window, &mut Context<'_, T>) + 'static, ) -> Subscription

where T: 'static, T2: 'static,

Register a callback to be invoked when the given Entity is released.

pub fn observe_window_bounds( &self, window: &mut Window, callback: impl FnMut(&mut T, &mut Window, &mut Context<'_, T>) + 'static, ) -> Subscription

Register a callback to be invoked when the window is resized.

pub fn observe_window_activation( &self, window: &mut Window, callback: impl FnMut(&mut T, &mut Window, &mut Context<'_, T>) + 'static, ) -> Subscription

Register a callback to be invoked when the window is activated or deactivated.

pub fn observe_window_appearance( &self, window: &mut Window, callback: impl FnMut(&mut T, &mut Window, &mut Context<'_, T>) + 'static, ) -> Subscription

Registers a callback to be invoked when the window appearance changes.

pub fn observe_keystrokes( &mut self, f: impl FnMut(&mut T, &KeystrokeEvent, &mut Window, &mut Context<'_, T>) + 'static, ) -> Subscription

Register a callback to be invoked when a keystroke is received by the application in any window. Note that this fires after all other action and event mechanisms have resolved and that this API will not be invoked if the event’s propagation is stopped.

pub fn observe_pending_input( &self, window: &mut Window, callback: impl FnMut(&mut T, &mut Window, &mut Context<'_, T>) + 'static, ) -> Subscription

Register a callback to be invoked when the window’s pending input changes.

pub fn on_focus( &mut self, handle: &FocusHandle, window: &mut Window, listener: impl FnMut(&mut T, &mut Window, &mut Context<'_, T>) + 'static, ) -> Subscription

Register a listener to be called when the given focus handle receives focus. Returns a subscription and persists until the subscription is dropped.

pub fn on_focus_in( &mut self, handle: &FocusHandle, window: &mut Window, listener: impl FnMut(&mut T, &mut Window, &mut Context<'_, T>) + 'static, ) -> Subscription

Register a listener to be called when the given focus handle or one of its descendants receives focus. This does not fire if the given focus handle - or one of its descendants - was previously focused. Returns a subscription and persists until the subscription is dropped.

pub fn on_blur( &mut self, handle: &FocusHandle, window: &mut Window, listener: impl FnMut(&mut T, &mut Window, &mut Context<'_, T>) + 'static, ) -> Subscription

Register a listener to be called when the given focus handle loses focus. Returns a subscription and persists until the subscription is dropped.

pub fn on_focus_lost( &mut self, window: &mut Window, listener: impl FnMut(&mut T, &mut Window, &mut Context<'_, T>) + 'static, ) -> Subscription

Register a listener to be called when nothing in the window has focus. This typically happens when the node that was focused is removed from the tree, and this callback lets you chose a default place to restore the users focus. Returns a subscription and persists until the subscription is dropped.

pub fn on_focus_out( &mut self, handle: &FocusHandle, window: &mut Window, listener: impl FnMut(&mut T, FocusOutEvent, &mut Window, &mut Context<'_, T>) + 'static, ) -> Subscription

Register a listener to be called when the given focus handle or one of its descendants loses focus. Returns a subscription and persists until the subscription is dropped.

pub fn spawn_in<AsyncFn, R>(&self, window: &Window, f: AsyncFn) -> Task<R>

where R: 'static, AsyncFn: AsyncFnOnce(WeakEntity<T>, &mut AsyncWindowContext) -> R + 'static,

Schedule a future to be run asynchronously. The given callback is invoked with a WeakEntity<V> to avoid leaking the entity for a long-running process. It’s also given an AsyncWindowContext, which can be used to access the state of the entity across await points. The returned future will be polled on the main thread.

pub fn observe_global_in<G: Global>( &mut self, window: &Window, f: impl FnMut(&mut T, &mut Window, &mut Context<'_, T>) + 'static, ) -> Subscription

Register a callback to be invoked when the given global state changes.

pub fn on_action( &mut self, action_type: TypeId, window: &mut Window, listener: impl Fn(&mut T, &dyn Any, DispatchPhase, &mut Window, &mut Context<'_, T>) + 'static, )

Register a callback to be invoked when the given Action type is dispatched to the window.

pub fn focus_self(&mut self, window: &mut Window)

where T: Focusable,

Move focus to the current view, assuming it implements Focusable.

impl<T> Context<'_, T>

pub fn emit<Evt>(&mut self, event: Evt)

where T: EventEmitter<Evt>, Evt: 'static,

Emit an event of the specified type, which can be handled by other entities that have subscribed via subscribe methods on their respective contexts.

Methods from Deref<Target = App>

pub fn shutdown(&mut self)

Quit the application gracefully. Handlers registered with Context::on_app_quit will be given 100ms to complete before exiting.

pub fn keyboard_layout(&self) -> &dyn PlatformKeyboardLayout

Get the id of the current keyboard layout

pub fn keyboard_mapper(&self) -> &Rc<dyn PlatformKeyboardMapper>

Get the current keyboard mapper.

pub fn on_keyboard_layout_change<F>(&self, callback: F) -> Subscription

where F: 'static + FnMut(&mut App),

Invokes a handler when the current keyboard layout changes

pub fn quit(&self)

Gracefully quit the application via the platform’s standard routine.

pub fn refresh_windows(&mut self)

Schedules all windows in the application to be redrawn. This can be called multiple times in an update cycle and still result in a single redraw.

pub fn observe<W>( &mut self, entity: &Entity<W>, on_notify: impl FnMut(Entity<W>, &mut App) + 'static, ) -> Subscription

where W: 'static,

Arrange a callback to be invoked when the given entity calls notify on its respective context.

pub fn subscribe<T, Event>( &mut self, entity: &Entity<T>, on_event: impl FnMut(Entity<T>, &Event, &mut App) + 'static, ) -> Subscription

where T: 'static + EventEmitter<Event>, Event: 'static,

Arrange for the given callback to be invoked whenever the given entity emits an event of a given type. The callback is provided a handle to the emitting entity and a reference to the emitted event.

pub fn windows(&self) -> Vec<AnyWindowHandle>

Returns handles to all open windows in the application. Each handle could be downcast to a handle typed for the root view of that window. To find all windows of a given type, you could filter on

pub fn window_stack(&self) -> Option<Vec<AnyWindowHandle>>

Returns the window handles ordered by their appearance on screen, front to back.

The first window in the returned list is the active/topmost window of the application.

This method returns None if the platform doesn’t implement the method yet.

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

Returns a handle to the window that is currently focused at the platform level, if one exists.

pub fn open_window<V: 'static + Render>( &mut self, options: WindowOptions, build_root_view: impl FnOnce(&mut Window, &mut App) -> Entity<V>, ) -> Result<WindowHandle<V>>

Opens a new window with the given option and the root view returned by the given function. The function is invoked with a Window, which can be used to interact with window-specific functionality.

pub fn activate(&self, ignoring_other_apps: bool)

Instructs the platform to activate the application by bringing it to the foreground.

pub fn hide(&self)

Hide the application at the platform level.

pub fn hide_other_apps(&self)

Hide other applications at the platform level.

pub fn unhide_other_apps(&self)

Unhide other applications at the platform level.

pub fn set_tray_icon(&self, icon: Option<&[u8]>)

Set the system tray icon.

pub fn set_tray_menu(&self, menu: Vec<TrayMenuItem>)

Set the system tray menu items.

pub fn set_tray_tooltip(&self, tooltip: &str)

Set the system tray tooltip.

pub fn set_tray_panel_mode(&self, enabled: bool)

Enable or disable tray panel mode. When enabled, clicking the tray icon fires TrayIconEvent::LeftClick instead of showing the NSMenu.

pub fn tray_icon_bounds(&self) -> Option<Bounds<Pixels>>

Get the screen bounds of the tray icon, useful for positioning a panel below it.

pub fn on_tray_icon_event( &self, callback: impl FnMut(TrayIconEvent, &mut App) + 'static, )

Register a callback for system tray icon events.

pub fn on_tray_menu_action( &self, callback: impl FnMut(SharedString, &mut App) + 'static, )

Register a callback for when a tray menu item is clicked.

pub fn register_global_hotkey( &self, id: u32, keystroke: &Keystroke, ) -> Result<()>

Register a global hotkey with the given ID and keystroke.

pub fn unregister_global_hotkey(&self, id: u32)

Unregister a previously registered global hotkey.

pub fn on_global_hotkey(&self, callback: impl FnMut(u32) + 'static)

Register a callback for global hotkey events.

pub fn focused_window_info(&self) -> Option<FocusedWindowInfo>

Get information about the currently focused window from any application.

pub fn accessibility_status(&self) -> PermissionStatus

Check accessibility permission status.

pub fn request_accessibility_permission(&self)

Request accessibility permission from the user.

pub fn microphone_status(&self) -> PermissionStatus

Check microphone permission status.

pub fn request_microphone_permission( &self, callback: impl FnOnce(bool) + 'static, )

Request microphone permission from the user.

pub fn set_auto_launch(&self, app_id: &str, enabled: bool) -> Result<()>

Set whether the application should auto-launch at login.

pub fn is_auto_launch_enabled(&self, app_id: &str) -> bool

Check whether the application is set to auto-launch at login.

pub fn show_notification(&self, title: &str, body: &str) -> Result<()>

Show an OS notification.

pub fn set_keep_alive_without_windows(&self, keep_alive: bool)

Set whether the application should stay alive when all windows are closed.

pub fn on_system_power_event( &self, callback: impl FnMut(SystemPowerEvent, &mut App) + 'static, )

Register a callback for system power events (sleep, wake, shutdown).

pub fn start_power_save_blocker( &self, kind: PowerSaveBlockerKind, ) -> Option<u32>

Start a power save blocker to prevent the system from sleeping or the display from dimming.

pub fn stop_power_save_blocker(&self, id: u32)

Stop a previously started power save blocker by its ID.

pub fn system_idle_time(&self) -> Option<Duration>

Get the duration since the last user input event.

pub fn network_status(&self) -> NetworkStatus

Get the current network connectivity status.

pub fn on_network_status_change( &self, callback: impl FnMut(NetworkStatus, &mut App) + 'static, )

Register a callback for network connectivity status changes.

pub fn on_media_key_event( &self, callback: impl FnMut(MediaKeyEvent, &mut App) + 'static, )

Register a callback for media key events (play, pause, next, previous).

pub fn request_user_attention(&self, attention_type: AttentionType)

Request the user’s attention by bouncing the dock icon or flashing the taskbar.

pub fn cancel_user_attention(&self)

Cancel a previous user attention request.

pub fn set_dock_badge(&self, label: Option<&str>)

Set the dock badge label (macOS) or taskbar overlay text.

pub fn show_context_menu( &self, position: Point<Pixels>, items: Vec<TrayMenuItem>, callback: impl FnMut(SharedString, &mut App) + 'static, )

Show a context menu at the given screen position with the specified menu items.

pub fn show_dialog(&self, options: DialogOptions) -> Receiver<usize>

Show a native dialog with the given options, returning the index of the clicked button.

pub fn os_info(&self) -> OsInfo

Get operating system information (name, version, architecture).

pub fn biometric_status(&self) -> BiometricStatus

Check whether biometric authentication (Touch ID, Windows Hello) is available.

pub fn authenticate_biometric( &self, reason: &str, callback: impl FnOnce(bool) + Send + 'static, )

Authenticate the user via biometrics with the given reason string.

pub fn set_crash_handler( &self, app_version: Option<String>, handler: impl Fn(CrashReport) + Send + Sync + 'static, )

Install a panic hook that captures crash reports with backtraces and OS info.

pub fn displays(&self) -> Vec<Rc<dyn PlatformDisplay>>

Returns the list of currently active displays.

pub fn primary_display(&self) -> Option<Rc<dyn PlatformDisplay>>

Returns the primary display that will be used for new windows.

pub fn compute_window_bounds( &self, size: Size<Pixels>, position: &WindowPosition, ) -> Bounds<Pixels>

Compute window bounds from a desired size and a semantic position.

pub fn is_screen_capture_supported(&self) -> bool

Returns whether screen_capture_sources may work.

pub fn screen_capture_sources( &self, ) -> Receiver<Result<Vec<Rc<dyn ScreenCaptureSource>>>>

Returns a list of available screen capture sources.

pub fn find_display(&self, id: DisplayId) -> Option<Rc<dyn PlatformDisplay>>

Returns the display with the given ID, if one exists.

pub fn window_appearance(&self) -> WindowAppearance

Returns the appearance of the application’s windows.

pub fn write_to_primary(&self, item: ClipboardItem)

Writes data to the primary selection buffer. Only available on Linux.

pub fn write_to_clipboard(&self, item: ClipboardItem)

Writes data to the platform clipboard.

pub fn read_from_primary(&self) -> Option<ClipboardItem>

Reads data from the primary selection buffer. Only available on Linux.

pub fn read_from_clipboard(&self) -> Option<ClipboardItem>

Reads data from the platform clipboard.

pub fn write_credentials( &self, url: &str, username: &str, password: &[u8], ) -> Task<Result<()>>

Writes credentials to the platform keychain.

pub fn read_credentials( &self, url: &str, ) -> Task<Result<Option<(String, Vec<u8>)>>>

Reads credentials from the platform keychain.

pub fn delete_credentials(&self, url: &str) -> Task<Result<()>>

Deletes credentials from the platform keychain.

pub fn open_url(&self, url: &str)

Directs the platform’s default browser to open the given URL.

pub fn register_url_scheme(&self, scheme: &str) -> Task<Result<()>>

Registers the given URL scheme (e.g. zed for zed:// urls) to be opened by the current app.

On some platforms (e.g. macOS) you may be able to register URL schemes as part of app distribution, but this method exists to let you register schemes at runtime.

pub fn app_path(&self) -> Result<PathBuf>

Returns the full pathname of the current app bundle.

Returns an error if the app is not being run from a bundle.

pub fn compositor_name(&self) -> &'static str

On Linux, returns the name of the compositor in use.

Returns an empty string on other platforms.

pub fn path_for_auxiliary_executable(&self, name: &str) -> Result<PathBuf>

Returns the file URL of the executable with the specified name in the application bundle

pub fn prompt_for_paths( &self, options: PathPromptOptions, ) -> Receiver<Result<Option<Vec<PathBuf>>>>

Displays a platform modal for selecting paths.

When one or more paths are selected, they’ll be relayed asynchronously via the returned oneshot channel. If cancelled, a None will be relayed instead. May return an error on Linux if the file picker couldn’t be opened.

pub fn prompt_for_new_path( &self, directory: &Path, suggested_name: Option<&str>, ) -> Receiver<Result<Option<PathBuf>>>

Displays a platform modal for selecting a new path where a file can be saved.

The provided directory will be used to set the initial location. When a path is selected, it is relayed asynchronously via the returned oneshot channel. If cancelled, a None will be relayed instead. May return an error on Linux if the file picker couldn’t be opened.

pub fn reveal_path(&self, path: &Path)

Reveals the specified path at the platform level, such as in Finder on macOS.

pub fn open_with_system(&self, path: &Path)

Opens the specified path with the system’s default application.

pub fn should_auto_hide_scrollbars(&self) -> bool

Returns whether the user has configured scrollbars to auto-hide at the platform level.

pub fn restart(&mut self)

Restarts the application.

pub fn set_restart_path(&mut self, path: PathBuf)

Sets the path to use when restarting the application.

pub fn http_client(&self) -> Arc<dyn HttpClient>

Returns the HTTP client for the application.

pub fn set_http_client(&mut self, new_client: Arc<dyn HttpClient>)

Sets the HTTP client for the application.

pub fn svg_renderer(&self) -> SvgRenderer

Returns the SVG renderer used by the application.

pub fn to_async(&self) -> AsyncApp

Creates an AsyncApp, which can be cloned and has a static lifetime so it can be held across await points.

pub fn background_executor(&self) -> &BackgroundExecutor

Obtains a reference to the executor, which can be used to spawn futures.

pub fn foreground_executor(&self) -> &ForegroundExecutor

Obtains a reference to the executor, which can be used to spawn futures.

pub fn spawn<AsyncFn, R>(&self, f: AsyncFn) -> Task<R>

where AsyncFn: AsyncFnOnce(&mut AsyncApp) -> R + 'static, R: 'static,

Spawns the future returned by the given function on the main thread. The closure will be invoked with AsyncApp, which allows the application state to be accessed across await points.

pub fn defer(&mut self, f: impl FnOnce(&mut App) + 'static)

Schedules the given function to be run at the end of the current effect cycle, allowing entities that are currently on the stack to be returned to the app.

pub fn asset_source(&self) -> &Arc<dyn AssetSource>

Accessor for the application’s asset source, which is provided when constructing the App.

pub fn text_system(&self) -> &Arc<TextSystem>

Accessor for the text system.

pub fn has_global<G: Global>(&self) -> bool

Check whether a global of the given type has been assigned.

pub fn global<G: Global>(&self) -> &G

Access the global of the given type. Panics if a global for that type has not been assigned.

pub fn try_global<G: Global>(&self) -> Option<&G>

Access the global of the given type if a value has been assigned.

pub fn global_mut<G: Global>(&mut self) -> &mut G

Access the global of the given type mutably. Panics if a global for that type has not been assigned.

pub fn default_global<G: Global + Default>(&mut self) -> &mut G

Access the global of the given type mutably. A default value is assigned if a global of this type has not yet been assigned.

pub fn set_global<G: Global>(&mut self, global: G)

Sets the value of the global of the given type.

pub fn remove_global<G: Global>(&mut self) -> G

Remove the global of the given type from the app context. Does not notify global observers.

pub fn observe_global<G: Global>( &mut self, f: impl FnMut(&mut Self) + 'static, ) -> Subscription

Register a callback to be invoked when a global of the given type is updated.

pub fn observe_new<T: 'static>( &self, on_new: impl 'static + Fn(&mut T, Option<&mut Window>, &mut Context<'_, T>), ) -> Subscription

Arrange for the given function to be invoked whenever a view of the specified type is created. The function will be passed a mutable reference to the view along with an appropriate context.

pub fn observe_release<T>( &self, handle: &Entity<T>, on_release: impl FnOnce(&mut T, &mut App) + 'static, ) -> Subscription

where T: 'static,

Observe the release of a entity. The callback is invoked after the entity has no more strong references but before it has been dropped.

pub fn observe_release_in<T>( &self, handle: &Entity<T>, window: &Window, on_release: impl FnOnce(&mut T, &mut Window, &mut App) + 'static, ) -> Subscription

where T: 'static,

Observe the release of a entity. The callback is invoked after the entity has no more strong references but before it has been dropped.

pub fn observe_keystrokes( &mut self, f: impl FnMut(&KeystrokeEvent, &mut Window, &mut App) + 'static, ) -> Subscription

Register a callback to be invoked when a keystroke is received by the application in any window. Note that this fires after all other action and event mechanisms have resolved and that this API will not be invoked if the event’s propagation is stopped.

pub fn intercept_keystrokes( &mut self, f: impl FnMut(&KeystrokeEvent, &mut Window, &mut App) + 'static, ) -> Subscription

Register a callback to be invoked when a keystroke is received by the application in any window. Note that this fires before all other action and event mechanisms have resolved unlike App::observe_keystrokes which fires after. This means that cx.stop_propagation calls within interceptors will prevent action dispatch

pub fn bind_keys(&mut self, bindings: impl IntoIterator<Item = KeyBinding>)

Register key bindings.

pub fn clear_key_bindings(&mut self)

Clear all key bindings in the app.

pub fn key_bindings(&self) -> Rc<RefCell<Keymap>>

Get all key bindings in the app.

pub fn on_action<A: Action>( &mut self, listener: impl Fn(&A, &mut Self) + 'static, )

Register a global handler for actions invoked via the keyboard. These handlers are run at the end of the bubble phase for actions, and so will only be invoked if there are no other handlers or if they called cx.propagate().

pub fn stop_propagation(&mut self)

Event handlers propagate events by default. Call this method to stop dispatching to event handlers with a lower z-index (mouse) or higher in the tree (keyboard). This is the opposite of Self::propagate. It’s also possible to cancel a call to Self::propagate by calling this method before effects are flushed.

pub fn propagate(&mut self)

Action handlers stop propagation by default during the bubble phase of action dispatch dispatching to action handlers higher in the element tree. This is the opposite of Self::stop_propagation. It’s also possible to cancel a call to Self::stop_propagation by calling this method before effects are flushed.

pub fn build_action( &self, name: &str, data: Option<Value>, ) -> Result<Box<dyn Action>, ActionBuildError>

Build an action from some arbitrary data, typically a keymap entry.

pub fn all_action_names(&self) -> &[&'static str]

Get all action names that have been registered. Note that registration only allows for actions to be built dynamically, and is unrelated to binding actions in the element tree.

pub fn all_bindings_for_input(&self, input: &[Keystroke]) -> Vec<KeyBinding>

Returns key bindings that invoke the given action on the currently focused element, without checking context. Bindings are returned in the order they were added. For display, the last binding should take precedence.

pub fn action_schemas( &self, generator: &mut SchemaGenerator, ) -> Vec<(&'static str, Option<Schema>)>

Get all non-internal actions that have been registered, along with their schemas.

pub fn deprecated_actions_to_preferred_actions( &self, ) -> &HashMap<&'static str, &'static str>

Get a map from a deprecated action name to the canonical name.

pub fn action_deprecation_messages( &self, ) -> &HashMap<&'static str, &'static str>

Get a map from an action name to the deprecation messages.

pub fn action_documentation(&self) -> &HashMap<&'static str, &'static str>

Get a map from an action name to the documentation.

pub fn on_app_quit<Fut>( &self, on_quit: impl FnMut(&mut App) -> Fut + 'static, ) -> Subscription

where Fut: 'static + Future<Output = ()>,

Register a callback to be invoked when the application is about to quit. It is not possible to cancel the quit event at this point.

pub fn on_app_restart( &self, on_restart: impl 'static + FnMut(&mut App), ) -> Subscription

Register a callback to be invoked when the application is about to restart.

These callbacks are called before any on_app_quit callbacks.

pub fn on_window_closed( &self, on_closed: impl FnMut(&mut App) + 'static, ) -> Subscription

Register a callback to be invoked when a window is closed The window is no longer accessible at the point this callback is invoked.

pub fn is_action_available(&mut self, action: &dyn Action) -> bool

Checks if the given action is bound in the current context, as defined by the app’s current focus, the bindings in the element tree, and any global action listeners.

pub fn set_menus(&self, menus: Vec<Menu>)

Sets the menu bar for this application. This will replace any existing menu bar.

pub fn get_menus(&self) -> Option<Vec<OwnedMenu>>

Gets the menu bar for this application.

pub fn set_dock_menu(&self, menus: Vec<MenuItem>)

Sets the right click menu for the app icon in the dock

pub fn perform_dock_menu_action(&self, action: usize)

Performs the action associated with the given dock menu item, only used on Windows for now.

pub fn add_recent_document(&self, path: &Path)

Adds given path to the bottom of the list of recent paths for the application. The list is usually shown on the application icon’s context menu in the dock, and allows to open the recent files via that context menu. If the path is already in the list, it will be moved to the bottom of the list.

pub fn update_jump_list( &self, menus: Vec<MenuItem>, entries: Vec<SmallVec<[PathBuf; 2]>>, ) -> Vec<SmallVec<[PathBuf; 2]>>

Updates the jump list with the updated list of recent paths for the application, only used on Windows for now. Note that this also sets the dock menu on Windows.

pub fn dispatch_action(&mut self, action: &dyn Action)

Dispatch an action to the currently active window or global action handler See crate::Action for more information on how actions work

pub fn has_active_drag(&self) -> bool

Is there currently something being dragged?

pub fn active_drag_cursor_style(&self) -> Option<CursorStyle>

Gets the cursor style of the currently active drag operation.

pub fn stop_active_drag(&mut self, window: &mut Window) -> bool

Stops active drag and clears any related effects.

pub fn set_active_drag_cursor_style( &mut self, cursor_style: CursorStyle, window: &mut Window, ) -> bool

Sets the cursor style for the currently active drag operation.

pub fn set_prompt_builder( &mut self, renderer: impl Fn(PromptLevel, &str, Option<&str>, &[PromptButton], PromptHandle, &mut Window, &mut App) -> RenderablePromptHandle + 'static, )

Set the prompt renderer for GPUI. This will replace the default or platform specific prompts with this custom implementation.

pub fn reset_prompt_builder(&mut self)

Reset the prompt builder to the default implementation.

pub fn remove_asset<A: Asset>(&mut self, source: &A::Source)

Remove an asset from GPUI’s cache

pub fn fetch_asset<A: Asset>( &mut self, source: &A::Source, ) -> (Shared<Task<A::Output>>, bool)

Asynchronously load an asset, if the asset hasn’t finished loading this will return None.

Note that the multiple calls to this method will only result in one Asset::load call at a time, and the results of this call will be cached

pub fn focus_handle(&self) -> FocusHandle

Obtain a new FocusHandle, which allows you to track and manipulate the keyboard focus for elements rendered within this window.

pub fn notify(&mut self, entity_id: EntityId)

Tell GPUI that an entity has changed and observers of it should be notified.

pub fn get_name(&self) -> Option<&'static str>

Returns the name for this App.

pub fn can_select_mixed_files_and_dirs(&self) -> bool

Returns true if the platform file picker supports selecting a mix of files and directories.

pub fn drop_image( &mut self, image: Arc<RenderImage>, current_window: Option<&mut Window>, )

Removes an image from the sprite atlas on all windows.

If the current window is being updated, it will be removed from App.windows, you can use current_window to specify the current window. This is a no-op if the image is not in the sprite atlas.

pub fn set_inspector_renderer(&mut self, f: InspectorRenderer)

Sets the renderer for the inspector.

pub fn register_inspector_element<T: 'static, R: IntoElement>( &mut self, f: impl 'static + Fn(InspectorElementId, &T, &mut Window, &mut App) -> R, )

Registers a renderer specific to an inspector state.

pub fn init_colors(&mut self)

Initializes gpui’s default colors for the application.

These colors can be accessed through cx.default_colors().

Trait Implementations

impl<T> AppContext for Context<'_, T>

type Result<U> = U

The result type for this context, used for async contexts that can’t hold a direct reference to the application context.

fn new<U: 'static>( &mut self, build_entity: impl FnOnce(&mut Context<'_, U>) -> U, ) -> Entity<U>

Create a new entity in the app context.

fn reserve_entity<U: 'static>(&mut self) -> Reservation<U>

Reserve a slot for a entity to be inserted later. The returned Reservation allows you to obtain the EntityId for the future entity.

fn insert_entity<U: 'static>( &mut self, reservation: Reservation<U>, build_entity: impl FnOnce(&mut Context<'_, U>) -> U, ) -> Self::Result<Entity<U>>

Insert a new entity in the app context based on a Reservation previously obtained from reserve_entity.

fn update_entity<U: 'static, R>( &mut self, handle: &Entity<U>, update: impl FnOnce(&mut U, &mut Context<'_, U>) -> R, ) -> R

Update a entity in the app context.

fn as_mut<'a, E>( &'a mut self, handle: &Entity<E>, ) -> Self::Result<GpuiBorrow<'a, E>>

where E: 'static,

Update a entity in the app context.

fn read_entity<U, R>( &self, handle: &Entity<U>, read: impl FnOnce(&U, &App) -> R, ) -> Self::Result<R>

where U: 'static,

Read a entity from the app context.

fn update_window<R, F>( &mut self, window: AnyWindowHandle, update: F, ) -> Result<R>

where F: FnOnce(AnyView, &mut Window, &mut App) -> R,

Update a window for the given handle.

fn read_window<U, R>( &self, window: &WindowHandle<U>, read: impl FnOnce(Entity<U>, &App) -> R, ) -> Result<R>

where U: 'static,

Read a window off of the application context.

fn background_spawn<R>( &self, future: impl Future<Output = R> + Send + 'static, ) -> Task<R>

where R: Send + 'static,

Spawn a future on a background thread

fn read_global<G, R>( &self, callback: impl FnOnce(&G, &App) -> R, ) -> Self::Result<R>

where G: Global,

Read a global from this app context

impl<T> Borrow<App> for Context<'_, T>

fn borrow(&self) -> &App

Immutably borrows from an owned value.

impl<T> BorrowMut<App> for Context<'_, T>

fn borrow_mut(&mut self) -> &mut App

Mutably borrows from an owned value.

impl<'a, T> Deref for Context<'a, T>

type Target = App

The resulting type after dereferencing.

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

Dereferences the value.

impl<'a, T> DerefMut for Context<'a, T>

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

Mutably dereferences the value.