Input Element

  • Article

Used to access input-related state and events within a UI.

Syntax

<Input
    AllowDoubleClicks="{true | false}"
    CreateInterestOnFocus="{true | false}"
    CreateInterestTarget="string"
    DeepKeyFocus="{true | false}"
    DeepMouseFocus="{true | false}"
    Enabled="{true | false}"
    FullyEnabled="{true | false}"
    KeyFocus="{true | false}"
    KeyFocusOnMouseDown="{true | false}"
    KeyFocusOnMouseEnter="{true | false}"
    KeyInteractive="{true | false}"
    KeyRepeatThreshold="uint"
    MakeTopmostOnFocus="{true | false}"
    MouseFocus="{true | false}"
/>

Attributes

AllowDoubleClicks

Specifies whether double-clicks should be tracked.

CreateInterestOnFocus

Specifies whether this is an "area of interest" when focused.

CreateInterestTarget

Specifies the UI to apply interest to when CreateInterestOnFocus is enabled.

DeepKeyFocus

Indicates whether the current view item has deep key focus (this object or any of its children has key focus). This value is read-only.

DeepMouseFocus

Indicates whether the current view item has deep mouse focus (this object or any of its children has mouse focus). This value is read-only.

Enabled

Specifies whether the UI is enabled for mouse and keyboard input.

FullyEnabled

Indicates whether the current UI is fully enabled (this and all parents are enabled). This value is read-only.

KeyFocus

Indicates whether the current view item has key focus. This value is read-only.

KeyFocusOnMouseDown

Determines whether the current view item should try to automatically take key focus whenever a mouse button is pressed.

KeyFocusOnMouseEnter

Determines whether the current view item should try to automatically take key focus whenever mouse focus is gained.

KeyInteractive

Specifies whether this view item can accept key focus.

KeyRepeatThreshold

Specifies the threshold for the minimum number of milliseconds allowed to occur between repeated key events. Repeats occurring before the threshold has passed are ignored.

MakeTopmostOnFocus

Specifies whether, when the keyboard is focused, the focused item will be painted on top of all others on the top-most layer.

Note This setting is only applied to view items for which KeyFocus is true; that is, when the view item has focus but not when any of its children gain focus.

MouseFocus

Indicates whether the current view item has mouse focus. This value is read-only.

Remarks

If a view item has key focus, it also has deep key focus. If a child of the view item has focus, it has deep key focus but not key focus.

Input is a reserved word and the Input element tag is not used directly. The Input element is always used as a source or a target in a rule, and you must use object paths to access its properties. For an example of how the Input element is used, see Working with Input Handlers and the Sample Explorer.

Requirements

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

See Also