Form. Key Preview Свойство

Определение

Возвращает или задает значение, указывающее, получит ли форма события клавиш перед передачей событий элементу управления, на который установлен фокус. Gets or sets a value indicating whether the form will receive key events before the event is passed to the control that has focus.

Значение свойства

Значение true , если форма получит все события клавиш; значение false , если выбранный в настоящее время элемент управления в форме получает события клавиш. true if the form will receive all key events; false if the currently selected control on the form receives key events. Значение по умолчанию — false . The default is false .

Примеры

В следующем примере демонстрируется установка свойства формы KeyPreview в значение true и обработка ключевых событий на уровне формы. The following example demonstrates setting a form’s KeyPreview property to true and handling the key events at the form level. Чтобы выполнить пример, вставьте следующий код в пустую форму. To run the example, paste the following code in a blank form.

Комментарии

Если для этого свойства задано значение true , форма будет принимать все KeyPress KeyDown события, и KeyUp . When this property is set to true , the form will receive all KeyPress, KeyDown, and KeyUp events. После того как обработчики событий формы завершили обработку нажатия клавиши, нажатие клавиши будет назначено элементу управления с фокусом. After the form’s event handlers have completed processing the keystroke, the keystroke is then assigned to the control with focus. Например, если KeyPreview свойство имеет значение, true а текущий выбранный элемент управления — TextBox , после того, как нажатие клавиши будет обработано обработчиками событий формы, TextBox элемент управления получит нажатую клавишу. For example, if the KeyPreview property is set to true and the currently selected control is a TextBox, after the keystroke is handled by the event handlers of the form the TextBox control will receive the key that was pressed. Чтобы обработчики событий клавиатуры обрабатывались только на уровне формы и не позволяли элементам управления принимать события клавиатуры, задайте KeyPressEventArgs.Handled для свойства в KeyPress обработчике событий формы значение true . To handle keyboard events only at the form level and not allow controls to receive keyboard events, set the KeyPressEventArgs.Handled property in your form’s KeyPress event handler to true .

Это свойство можно использовать для обработки большинства нажатий клавиш в приложении и либо для обработки нажатия клавиши, либо для вызова соответствующего элемента управления для обработки нажатия клавиши. You can use this property to process most keystrokes in your application and either handle the keystroke or call the appropriate control to handle the keystroke. Например, если приложение использует ключи функций, может потребоваться обработать нажатия клавиш на уровне формы, а не писать код для каждого элемента управления, который может принимать события нажатия. For example, when an application uses function keys, you might want to process the keystrokes at the form level rather than writing code for each control that might receive keystroke events.

Если форма не имеет видимых или включенных элементов управления, она автоматически получает все события клавиатуры. If a form has no visible or enabled controls, it automatically receives all keyboard events.

Элемент управления в форме может быть запрограммирован на отмену принимаемых им нажатий клавиш. A control on a form may be programmed to cancel any keystrokes it receives. Поскольку элемент управления никогда не отправляет эти нажатия клавиш в форму, форма никогда не будет видеть их независимо от значения параметра KeyPreview . Since the control never sends these keystrokes to the form, the form will never see them regardless of the setting of KeyPreview.

Keys Перечисление

Определение

Задает коды и модификаторы клавиш. Specifies key codes and modifiers.

Это перечисление имеет атрибут FlagsAttribute, который разрешает побитовое сочетание значений его элементов.

Клавиша A. The A key.

Клавиша сложения. The add key.

Клавиша ALT. The ALT modifier key.

Клавиша контекстного меню (клавиатура Microsoft Natural). The application key (Microsoft Natural Keyboard).

Клавиша ATTN. The ATTN key.

Клавиша B. The B key.

Клавиша BACKSPACE. The BACKSPACE key.

Клавиша браузера «Назад». The browser back key.

Клавиша браузера «Избранное». The browser favorites key.

Клавиша браузера «Вперед». The browser forward key.

Клавиша браузера «Главная». The browser home key.

Клавиша браузера «Обновить». The browser refresh key.

Клавиша браузера «Поиск». The browser search key.

Клавиша браузера «Остановить». The browser stop key.

Клавиша C. The C key.

Клавиша отмены. The CANCEL key.

Клавиша CAPS LOCK. The CAPS LOCK key.

Клавиша CAPS LOCK. The CAPS LOCK key.

Клавиша CLEAR. The CLEAR key.

Клавиша CTRL. The CTRL modifier key.

Клавиша CTRL. The CTRL key.

Клавиша CRSEL. The CRSEL key.

Клавиша D. The D key.

Клавиша 0. The 0 key.

Клавиша 1. The 1 key.

Клавиша 2. The 2 key.

Клавиша 3. The 3 key.

Клавиша 4. The 4 key.

Клавиша 5. The 5 key.

Клавиша 6. The 6 key.

Клавиша 7. The 7 key.

Клавиша 8. The 8 key.

Клавиша 9. The 9 key.

Клавиша десятичного разделителя. The decimal key.

Клавиша DEL. The DEL key.

Клавиша деления. The divide key.

Клавиша СТРЕЛКА ВНИЗ. The DOWN ARROW key.

Клавиша E. The E key.

Клавиша END. The END key.

Клавиша ВВОД. The ENTER key.

Клавиша ERASE EOF. The ERASE EOF key.

Клавиша ESC. The ESC key.

Клавиша EXECUTE. The EXECUTE key.

Клавиша EXSEL. The EXSEL key.

Клавиша F. The F key.

Клавиша F1. The F1 key.

Клавиша F10. The F10 key.

Клавиша F11. The F11 key.

Клавиша F12. The F12 key.

Клавиша F13. The F13 key.

Клавиша F14. The F14 key.

Клавиша F15. The F15 key.

Клавиша F16. The F16 key.

Клавиша F17. The F17 key.

Клавиша F18. The F18 key.

Клавиша F19. The F19 key.

Клавиша F2. The F2 key.

Клавиша F20. The F20 key.

Клавиша F21. The F21 key.

Клавиша F22. The F22 key.

Клавиша F23. The F23 key.

Клавиша F24. The F24 key.

Клавиша F3. The F3 key.

Клавиша F4. The F4 key.

Клавиша F5. The F5 key.

Клавиша F6. The F6 key.

Клавиша F7. The F7 key.

Клавиша F8. The F8 key.

Клавиша F9. The F9 key.

Клавиша окончательного режима IME. The IME final mode key.

Клавиша G. The G key.

Клавиша H. The H key.

Клавиша режима IME Hanguel The IME Hanguel mode key. (поддерживается для обеспечения совместимости; используйте клавишу HangulMode ). (maintained for compatibility; use HangulMode )

Клавиша режима «Хангыль» редактора метода ввода. The IME Hangul mode key.

Клавиша режима «Ханджа» редактора метода ввода. The IME Hanja mode key.

Клавиша HELP. The HELP key.

Клавиша HOME. The HOME key.

Клавиша I. The I key.

Клавиша принятия IME, заменяет клавишу IMEAceept. The IME accept key, replaces IMEAceept.

Клавиша принятия IME. The IME accept key. Является устаревшей, вместо нее используется клавиша IMEAccept. Obsolete, use IMEAccept instead.

Клавиша преобразования IME. The IME convert key.

Клавиша изменения режима IME. The IME mode change key.

Клавиша без преобразования IME. The IME nonconvert key.

Клавиша INS. The INS key.

Клавиша J. The J key.

Клавиша режима «Джунджа» редактора метода ввода. The IME Junja mode key.

Клавиша K. The K key.

Клавиша режима «Кана» редактора метода ввода. The IME Kana mode key.

Клавиша режима «Кандзи» редактора метода ввода. The IME Kanji mode key.

Битовая маска для извлечения кода клавиши из значения клавиши. The bitmask to extract a key code from a key value.

Клавиша L. The L key.

Клавиша запуска первого приложения. The start application one key.

Клавиша запуска второго приложения. The start application two key.

Клавиша запуска приложения почты. The launch mail key.

Левая кнопка мыши. The left mouse button.

Левая клавиша CTRL. The left CTRL key.

Клавиша СТРЕЛКА ВЛЕВО. The LEFT ARROW key.

Клавиша LINEFEED. The LINEFEED key.

Левая клавиша ALT. The left ALT key.

Левая клавиша SHIFT. The left SHIFT key.

Левая клавиша с логотипом Windows (клавиатура Microsoft Natural Keyboard). The left Windows logo key (Microsoft Natural Keyboard).

Клавиша M. The M key.

Средняя кнопка мыши (трехкнопочная мышь). The middle mouse button (three-button mouse).

Клавиша «Следующая запись». The media next track key.

Клавиша приостановки воспроизведения. The media play pause key.

Клавиша «Предыдущая запись». The media previous track key.

Клавиша остановки воспроизведения. The media Stop key.

Клавиша ALT. The ALT key.

Битовая маска для извлечения модификаторов из значения клавиши. The bitmask to extract modifiers from a key value.

Клавиша умножения. The multiply key.

Клавиша N. The N key.

Клавиша PAGE DOWN. The PAGE DOWN key.

Константа, зарезервированная для будущего использования. A constant reserved for future use.

Нет нажатых клавиш. No key pressed.

Клавиша NUM LOCK. The NUM LOCK key.

Клавиша 0 на цифровой клавиатуре. The 0 key on the numeric keypad.

Клавиша 1 на цифровой клавиатуре. The 1 key on the numeric keypad.

Клавиша 2 на цифровой клавиатуре. The 2 key on the numeric keypad.

Клавиша 3 на цифровой клавиатуре. The 3 key on the numeric keypad.

Клавиша 4 на цифровой клавиатуре. The 4 key on the numeric keypad.

Клавиша 5 на цифровой клавиатуре. The 5 key on the numeric keypad.

Клавиша 6 на цифровой клавиатуре. The 6 key on the numeric keypad.

Клавиша 7 на цифровой клавиатуре. The 7 key on the numeric keypad.

Клавиша 8 на цифровой клавиатуре. The 8 key on the numeric keypad.

Клавиша 9 на цифровой клавиатуре. The 9 key on the numeric keypad.

Клавиша O. The O key.

Клавиша OEM 1. The OEM 1 key.

Клавиша OEM 102. The OEM 102 key.

Клавиша OEM 2. The OEM 2 key.

Клавиша OEM 3. The OEM 3 key.

Клавиша OEM 4. The OEM 4 key.

Клавиша OEM 5. The OEM 5 key.

Клавиша OEM 6. The OEM 6 key.

Клавиша OEM 7. The OEM 7 key.

Клавиша OEM 8. The OEM 8 key.

Клавиша OEM с угловой скобкой или обратной косой чертой на клавиатуре RT со 102 клавишами. The OEM angle bracket or backslash key on the RT 102 key keyboard.

Клавиша CLEAR. The CLEAR key.

Клавиша OEM с закрывающей квадратной скобкой на клавиатуре со стандартной раскладкой «США». The OEM close bracket key on a US standard keyboard.

Клавиша OEM с запятой на клавиатуре для любой страны или региона. The OEM comma key on any country/region keyboard.

Клавиша OEM со знаком минус на клавиатуре для любой страны или региона. The OEM minus key on any country/region keyboard.

Клавиша OEM с открывающей квадратной скобкой на клавиатуре со стандартной раскладкой «США». The OEM open bracket key on a US standard keyboard.

Клавиша OEM с точкой на клавиатуре для любой страны или региона. The OEM period key on any country/region keyboard.

Клавиша OEM с вертикальной чертой на клавиатуре со стандартной раскладкой «США». The OEM pipe key on a US standard keyboard.

Клавиша OEM со знаком плюс на клавиатуре для любой страны или региона. The OEM plus key on any country/region keyboard.

Клавиша OEM со знаком вопроса на клавиатуре со стандартной раскладкой «США». The OEM question mark key on a US standard keyboard.

Клавиша OEM с одинарной/двойной кавычкой на клавиатуре со стандартной раскладкой «США». The OEM singled/double quote key on a US standard keyboard.

Клавиша OEM с двоеточием на клавиатуре со стандартной раскладкой «США». The OEM Semicolon key on a US standard keyboard.

Клавиша OEM со знаком тильды на клавиатуре со стандартной раскладкой «США». The OEM tilde key on a US standard keyboard.

Клавиша P. The P key.

Клавиша PA1. The PA1 key.

Используется для передачи символов в Юникоде в виде нажатия клавиш. Used to pass Unicode characters as if they were keystrokes. Значение клавиши пакета является младшим словом 32-разрядного виртуального значения клавиши, используемого для бесклавиатурных методов ввода. The Packet key value is the low word of a 32-bit virtual-key value used for non-keyboard input methods.

Клавиша PAGE DOWN. The PAGE DOWN key.

Клавиша PAGE UP. The PAGE UP key.

Клавиша PAUSE. The PAUSE key.

Клавиша ВОСПРОИЗВЕСТИ. The PLAY key.

Клавиша PRINT. The PRINT key.

Клавиша PRINT SCREEN. The PRINT SCREEN key.

Клавиша PAGE UP. The PAGE UP key.

Клавиша PROCESS KEY. The PROCESS KEY key.

Клавиша Q. The Q key.

Клавиша R. The R key.

Правая кнопка мыши. The right mouse button.

Правая клавиша CTRL. The right CTRL key.

Клавиша RETURN. The RETURN key.

Клавиша СТРЕЛКА ВПРАВО. The RIGHT ARROW key.

Правая клавиша ALT. The right ALT key.

Правая клавиша SHIFT. The right SHIFT key.

Правая клавиша с логотипом Windows (клавиатура Microsoft Natural Keyboard). The right Windows logo key (Microsoft Natural Keyboard).

Клавиша S. The S key.

Клавиша SCROLL LOCK. The SCROLL LOCK key.

Клавиша SELECT. The SELECT key.

Клавиша выбора файла мультимедиа. The select media key.

Клавиша разделителя. The separator key.

Клавиша SHIFT. The SHIFT modifier key.

Клавиша SHIFT. The SHIFT key.

Клавиша перевода компьютера в спящий режим. The computer sleep key.

Клавиша PRINT SCREEN. The PRINT SCREEN key.

Клавиша ПРОБЕЛ. The SPACEBAR key.

Клавиша вычитания. The subtract key.

Клавиша T. The T key.

Клавиша TAB. The TAB key.

Клавиша U. The U key.

Клавиша СТРЕЛКА ВВЕРХ. The UP ARROW key.

Клавиша V. The V key.

Клавиша уменьшения громкости. The volume down key.

Клавиша выключения звука. The volume mute key.

Клавиша увеличения громкости. The volume up key.

Клавиша W. The W key.

Клавиша X. The X key.

Первая кнопка мыши (пятикнопочная мышь). The first x mouse button (five-button mouse).

Вторая кнопка мыши (пятикнопочная мышь). The second x mouse button (five-button mouse).

Клавиша Y. The Y key.

Клавиша Z. The Z key.

Клавиша МАСШТАБ. The ZOOM key.

Примеры

В следующем примере кода событие используется KeyDown для определения типа символа, введенного в элемент управления. The following code example uses the KeyDown event to determine the type of character entered into the control.

Комментарии

KeysКласс содержит константы для обработки ввода с клавиатуры. The Keys class contains constants for processing keyboard input. Члены перечисления Keys состоят из кода ключа и набора модификаторов, Объединенных в одно целое значение. The members of the Keys enumeration consist of a key code and a set of modifiers combined into a single integer value. В интерфейсе прикладного программирования (API) Win32 значение ключа имеет две половины, а старшие биты содержат код ключа (то же, что и код виртуального ключа Windows), а младшие биты, представляющие модификаторы ключа, такие как SHIFT, CONTROL и ALT. In the Win32 application programming interface (API) a key value has two halves, with the high-order bits containing the key code (which is the same as a Windows virtual key code), and the low-order bits representing key modifiers such as the SHIFT, CONTROL, and ALT keys.

Не используйте значения из этого перечисления для Объединенных побитовых операций. Do not use the values in this enumeration for combined bitwise operations. Значения в перечислении не являются взаимоисключающими. The values in the enumeration are not mutually exclusive.

Это перечисление не дает возможности проверить, активированы ли в настоящее время клавиши CAPS LOCK или NUM LOCK. This enumeration provides no way to test whether the CAPS LOCK or NUM LOCK keys are currently activated. Чтобы определить, активированы ли эти ключи, можно использовать один из следующих методов. You can use one of the following techniques to determine if these keys are activated:

Вызовите метод IsKeyLocked класса Control . Call the IsKeyLocked method of the Control class.

Для более точного управления используйте функции Windows API GetKeyState , GetAsyncKeyState или GetKeyboardState определенные в user32.dll, для этого. For finer control, use the Windows API functions GetKeyState , GetAsyncKeyState , or GetKeyboardState defined in user32.dll, to do this. Дополнительные сведения о вызове собственных функций см. в разделе Использование неуправляемых функций DLL. For more information about calling native functions, see Consuming Unmanaged DLL Functions.

В следующей таблице показаны ключевые значения кода, представленные двумя перечисляемыми значениями, представляющими общие ключи изготовителя оборудования (OEM) и более конкретные связи с клавиатурой США. The following table shows the key code values represented by two enumerated values, representing both the general original equipment manufacturer (OEM) keys and the more specific U.S.-keyboard associations.

Шестнадцатеричное значение Hexadecimal value	Клавиатура США U.S. keyboard	Общий изготовитель оборудования General OEM
BA BA	оемсемиколон OemSemicolon	OEM1 Oem1
BF BF	оемкуестион OemQuestion	Oem2 Oem2
C0 C0	оемтилде Oemtilde	Oem3 Oem3
DB DB	оемопенбраккетс OemOpenBrackets	Oem4 Oem4
DC DC	оемпипе OemPipe	Oem5 Oem5
DD DD	оемклосебраккетс OemCloseBrackets	Oem6 Oem6
DE DE	оемкуотес OemQuotes	Oem7 Oem7
E2 E2	оембаккслаш OemBackslash	Oem102 Oem102

Для платформа .NET Framework 2,0 был добавлен член Имеакцепт, заменяющий предыдущую запись Имеацеепт, которая была написана неправильно. For the .NET Framework 2.0, a member IMEAccept was added that supersedes the previous entry, IMEAceept, which was spelled incorrectly. Старая версия сохранена для обеспечения обратной совместимости, но может быть удалена в будущих версиях платформа .NET Framework The older version has been retained for backward compatibility, but it may be deleted in future versions of the .NET Framework