TypingHandler Element

  • Article

An event handler that provides editbox-like input behavior to a UI object.

Syntax

<TypingHandler
    Candidates="IList"
    Confirmed="{true | false}"
    DisplayValue="string"
    EditableText="EditableText object"
    HandlerStage="{Bubbled | Direct | Routed}"
    KeyInfos="IList"
    MaxLength="int"
    PasswordMasked="{true | false}"
    SelectCandidate="int"
    SupportsCandidates="{true | false}"
    TypingPolicy="{Default | TripleTap}"
    Value="string"
/>

Attributes

Candidates

List of candidates for the current input. This attribute is only applicable when TypingPolicy is set to TripleTap.

Confirmed

Indicates whether the current state is confirmed. This value is read-only.

DisplayValue

Returns the confirmed value if the text is confirmed, or the unconfirmed value if the text is not confirmed. This value is read-only.

EditableText

EditableText object associated with the typing handler. The typing handler uses an EditableText object for configuration and storage.

HandlerStage

A member of the InputHandlerStage enumeration indicating the stage in the event handling process when the event will be handled.

KeyInfos

Lists TripleTapKeyInfo elements for the current mode.

MaxLength

Specifies the maximum number of characters.

PasswordMasked

Specifies whether user input should be hidden.

SelectCandidate

Specifies the index of the selected item from the candidate list.

SupportsCandidates

Indicates whether the current triple-tap handler supports the candidate list. This value is false when TypingPolicy is not set to TripleTap. This value is read-only.

TypingPolicy

A member of the TypingPolicy enumeration indicating whether triple-tap support is enabled.

Value

The value of the edit control, which is the confirmed value if TypingPolicy is TripleTap. When PasswordMasked is true, this value is the actual string that is entered.

Public Instance Events

Event Description
TypingInputRejected Notification that is sent when the typing input is rejected.

Requirements

Platform: Windows Vista Ultimate, Windows Vista Home Premium, and later

See Also