Dela via


KeyboardDeliveryInterceptor Class

Definition

Enables an app to override the system processing of raw keyboard input, including key combinations such as shortcut keys, access keys (or hot keys), accelerator keys, and application keys.

The raw keyboard input is intercepted, suppressed, and routed to the app (when in the foreground) for processing.

Note

Secure attention sequence (SAS) key combinations, including Ctrl-Alt-Del and Windows-L, continue to be processed by the system.

public ref class KeyboardDeliveryInterceptor sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class KeyboardDeliveryInterceptor final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class KeyboardDeliveryInterceptor
Public NotInheritable Class KeyboardDeliveryInterceptor
Inheritance
Object Platform::Object IInspectable KeyboardDeliveryInterceptor
Attributes

Windows requirements

Device family
Windows 10 (introduced in 10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v2.0)
App capabilities
inputForegroundObservation

Remarks

The value of the RepeatCount property returned by KeyEventArgs.KeyStatus is always 0.

The value of the WasKeyDown property returned by KeyEventArgs.KeyStatus is always false.

If Handled is set to false, an error occurs.

Properties

IsInterceptionEnabledWhenInForeground

Gets or sets whether the app overrides the system processing of raw keyboard input, including key combinations such as shortcut keys, access keys (or hot keys), accelerator keys, and application keys.

The raw keyboard input is intercepted, suppressed, and routed to the app (when in the foreground) for processing.

Note

Secure attention sequence (SAS) key combinations, including Ctrl-Alt-Del and Windows-L, continue to be processed by the system.

Methods

GetForCurrentView()

Retrieves a KeyboardDeliveryInterceptor object associated with the current app view.

Events

KeyDown

Occurs when a keyboard key is pressed. State info and event data is routed through this event instead of CoreWindow.KeyDown.

KeyUp

Occurs when a pressed keyboard key is released. State info and event data is routed through this event instead of CoreWindow.KeyUp.

Applies to

See also