Struct PromptHandle 

pub struct PromptHandle { /* private fields */ }

A handle that a prompt builder uses to show a prompt and report the user’s answer.

GPUI creates a PromptHandle for each prompt that it draws in the window, and passes it to the builder set with App::set_prompt_builder. The builder calls PromptHandle::with_view with the view it renders, and returns the result. The answer goes to the receiver that Window::prompt returned.

Implementations

impl PromptHandle

pub fn with_view<V: Prompt + Render>( self, view: Entity<V>, window: &mut Window, cx: &mut App, ) -> RenderablePromptHandle

Shows view as the prompt, and returns the handle the window renders.

The window focuses view. When view emits a PromptResponse, its index is sent to the prompt’s receiver, the window drops the prompt, and focus returns to the element that had it before. The handle is consumed, so a prompt can be answered once. Later responses from view are ignored. If a newer prompt replaces view before it is answered, its response is ignored too, and the newer prompt keeps the window.