Share via

InjectedInputButtonChangeKind Enum

Definition

Namespace:
Windows.UI.Input.Preview.Injection
Edit

Specifies the changes in state of a button associated with a pointer.

public enum class InjectedInputButtonChangeKind
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
enum class InjectedInputButtonChangeKind
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
public enum InjectedInputButtonChangeKind
var value = Windows.UI.Input.Preview.Injection.InjectedInputButtonChangeKind.none
Public Enum InjectedInputButtonChangeKind
Inheritance
Enum
InjectedInputButtonChangeKind
Attributes
ContractVersionAttribute

Windows requirements

Requirements Description
Device family
Windows 10 Anniversary Edition (introduced in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v3.0)

Fields

Name Value Description
None 0

No change in button state. Default.
FirstButtonDown 1

Indicates a primary action is initiated.

A touch pointer has this flag set when it is in contact with the digitizer surface.

A pen pointer has this flag set when it is in contact with the digitizer surface with no buttons pressed.

A mouse pointer sets this flag when the left mouse button is down.
FirstButtonUp 2

Indicates a primary action is complete.
SecondButtonDown 3

Indicates a secondary action is initiated.

A touch pointer does not use this flag.

A pen pointer has this flag set when it is in contact with the digitizer surface with the pen barrel button pressed.

A mouse pointer sets this flag when the right mouse button is down.
SecondButtonUp 4

Indicates a secondary action is complete.
ThirdButtonDown 5

Indicates a third action is initiated.A touch pointer does not use this flag.

A pen pointer does not use this flag.

A mouse pointer sets this flag when the mouse wheel button is down.
ThirdButtonUp 6

Indicates a third action is complete.
FourthButtonDown 7

Indicates a fourth action is initiated.

A touch pointer does not use this flag.

A pen pointer does not use this flag.

A mouse pointer has this flag set when the first extended mouse (XBUTTON1) button is down.
FourthButtonUp 8

Indicates a fourth action is complete.
FifthButtonDown 9

Indicates a fifth action is initiated.

A touch pointer does not use this flag.

A pen pointer does not use this flag.

A mouse pointer has this flag set when the second extended mouse (XBUTTON2) button is down.
FifthButtonUp 10

Indicates a fifth action is complete.

Examples

Here are some downloadable samples demonstrating basic input and input injection:

Remarks

Important

The APIs in this namespace require the inputInjectionBrokered restricted capability.

Using input injection requires the following be added to the Package.appxmanifest:

  • To <Package>
    • xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
    • IgnorableNamespaces="rescap"
  • To <Capabilities>
    • <rescap:Capability Name="inputInjectionBrokered" />

Applies to

See also