Export (0) Print
Expand All

IKeyboardInputSink.TranslateAccelerator Method

Processes keyboard input at the keydown message level.

Namespace:  System.Windows.Interop
Assembly:  WindowsBase (in WindowsBase.dll)

'Declaration
<UIPermissionAttribute(SecurityAction.LinkDemand, Unrestricted := True)> _
Function TranslateAccelerator ( _
	ByRef msg As MSG, _
	modifiers As ModifierKeys _
) As Boolean

Parameters

msg
Type: System.Windows.Interop.MSG

The message and associated data. Do not modify this structure. It is passed by reference for performance reasons only.

modifiers
Type: System.Windows.Input.ModifierKeys

Modifier keys.

Return Value

Type: System.Boolean
true if the message was handled by the method implementation; otherwise, false.

The message must either be WM_KEYDOWN or WM_SYSKEYDOWN.

If the component is unable to handle the input translations and has child components that might have translations, it typically calls TranslateAccelerator method on the child component that holds the current focus before returning a result.

If the message cannot be handled immediately, you can re-dispatch it from within the TranslateAccelerator implementation if necessary, and then return false.

A primary scenario for translating accelerator keys is handling the VK_TAB keydown message and determining whether to set focus within the component, to call TabInto to a child component, or to call OnNoMoreTabStops on the parent site because the tab sequence has reached the beginning or end bounds. Certain components may choose to not handle the tab key in this fashion.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft