Struct TextInputMethodConnection 

pub struct TextInputMethodConnection { /* private fields */ }

A manager-owned connection to one semantic input owner. Platform adapters capture it when the client is installed. It never redirects to a newer focused element, and retaining it does not retain its owner or client.

The input method manager creates a connection only for a client that opts in by implementing TextInputMethodEditing (TextInputMethodClient::input_method_editing returns Some); for every other client TextInputMethodClient::input_method_connection is None and the platform backends keep their upstream behaviour (docs/porting/winui-rich-text.md, decision D5).

Implementations

impl TextInputMethodConnection

pub fn owner(&self) -> Option<Ref<InputElement>>

The original input owner, only while this connection remains valid.

pub fn is_current(&self) -> bool

pub fn input_scope_names(&self) -> Option<Rc<[InputScopeNameValue]>>

The input scopes of the owner (TextInputOptions.InputScopeNames), while this connection remains valid. Backends read them here within 0.4, where they are not a field of TextInputOptions (decision D8).

pub fn effective_input_scope(&self) -> Option<InputScopeNameValue>

The first input scope of the owner, for a platform with a single hint.

pub fn effective_content_type( &self, options: &TextInputOptions, ) -> TextInputContentType

The content type that best matches the first input scope of the owner, or options.content_type without one.

pub fn supports_composition(&self) -> bool

pub fn supports_exact_edits(&self) -> bool

pub fn edit_state(&self) -> Result<TextInputMethodState, TextInputMethodError>

pub fn apply_edit( self: &Rc<Self>, edit: &TextInputMethodEdit, timestamp: u64, ) -> Result<bool, TextInputMethodError>

Applies a committed exact edit through the same raw/routed interception path as ordinary text. The owner’s acknowledgement is authoritative.

pub fn select_exact( &self, selection: TextSelection, ) -> Result<(), TextInputMethodError>

pub fn begin_composition( self: &Rc<Self>, ) -> Result<TextInputMethodComposition, TextInputMethodError>

Starts a new immutable platform session without deleting the current selection. Any previous session on this connection is superseded.

pub fn commit_text( self: &Rc<Self>, text: &str, timestamp: u64, ) -> Result<bool, TextInputMethodError>

Sends ordinary committed input to a client with the atomic editing capability. A platform composing text should use its captured composition’s commit instead.