Struct FocuserProxy

pub struct FocuserProxy { /* private fields */ }

Implementations

impl FocuserProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.ui.views/Focuser.

pub fn take_event_stream(&self) -> FocuserEventStream

Get a Stream of events from the remote end of the protocol.

Panics

Panics if the event stream was already taken.

pub fn request_focus( &self, view_ref: ViewRef, ) -> QueryResponseFut<FocuserRequestFocusResult, DefaultFuchsiaResourceDialect>

Asks the server to transfer focus to the View specified by view_ref, with the authority of the requestor ViewRef. Such a request may be honored or denied.

If the request was honored, and it triggers a focus change, a FocusEvent (with focused=true) is issued to the newly-focused View, and a FocusEvent (with focused=false) is issued to the previous View.

The result callback indicates that the request was received and honored. It does not guarantee that the requested View actually received a FocusEvent in time.

The request may be denied for many reasons, for example:

• if view_ref is invalid
• if there is no View backed by view_ref
• if there is no requestor ViewRef accessible to Focuser
• if the requestor ViewRef lacks authority over view_ref’s View
• if view_ref’s View is not hittable or may not receive focus etc. A denied request is indicated with a Error.

pub fn set_auto_focus( &self, payload: FocuserSetAutoFocusRequest, ) -> QueryResponseFut<FocuserSetAutoFocusResult, DefaultFuchsiaResourceDialect>

Sets the auto focus target to the View specified by view_ref. To unset the target, pass in an empty table.

If a target has been set, then whenever the caller’s View would receive focus, an attempt is made to transfer focus immediately to the target instead. If the target is unfocusable, the new target is the first focusable ancestor of the target instead. Setting an auto focus target places no limitations on simultaneous use of RequestFocus().

An auto focus target is “valid” only while it is a descendant of the caller’s View in the ViewTree. Specifying an invalid auto focus target is allowed, since it may become valid later. It is the client’s responsibility to ensure the target is a valid receiver of auto focus.

If the target is invalid when the auto focus behavior would trigger, then the attempt to move focus will silently fail and focus will remain with the caller’s View. A target may become invalid and then become valid again any number of times; auto focus will continue to function whenever the target is in a valid state, and will continue to ignore the target while it’s in an invalid state.

If the focus would by some further automatic mechanism return to the caller’s View (e.g. if the target is unfocusable), then focus will remain with the caller’s View.

AutoFocusError is currently never returned, and is reserved for possible future use.

Trait Implementations

impl Clone for FocuserProxy

fn clone(&self) -> FocuserProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for FocuserProxy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FocuserProxyInterface for FocuserProxy

type RequestFocusResponseFut = QueryResponseFut<Result<(), Error>>

type SetAutoFocusResponseFut = QueryResponseFut<Result<(), AutoFocusError>>

fn request_focus(&self, view_ref: ViewRef) -> Self::RequestFocusResponseFut

fn set_auto_focus( &self, payload: FocuserSetAutoFocusRequest, ) -> Self::SetAutoFocusResponseFut

impl Proxy for FocuserProxy

type Protocol = FocuserMarker

The protocol which this Proxy controls.

fn from_channel(inner: AsyncChannel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Result<AsyncChannel, Self>

Attempt to convert the proxy back into a channel.

fn as_channel(&self) -> &AsyncChannel

Get a reference to the proxy’s underlying channel.

fn into_client_end(self) -> Result<ClientEnd<Self::Protocol>, Self>

Attempt to convert the proxy back into a client end.

fn is_closed(&self) -> bool

Returns true if the proxy has received the PEER_CLOSED signal.

fn on_closed(&self) -> OnSignals<'_, Unowned<'_, Handle>>

Returns a future that completes when the proxy receives the PEER_CLOSED signal.