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

Три свойства объекта KeyEventArgs являются свойствами типа Keys. Keys — это большое перечисление, второе по величине из всех перечислений .NET Framework. В нем есть клавиши, точно отсутствующие на моей клавиатуре (скорее всего и на вашей). Ветераны программирования для Windows могут заметить, что значения этого перечисления соответствуют виртуальным кодам клавиш, определенным в заголовочных файлах Windows.

Давайте разберем перечисление Keys, разделив его на логические группы. Во-первых, 26 членов этого перечисления независимо от состояния модификаторов идентифицируют клавиши букв:

Перечисление Keys (буквы)

Заметьте: значения перечисления для букв в верхнем регистре совпадают со значениями ASCII-кодов для этих символов (которые также совпадают с кодами Unicode). Коды символов, генерируемые этими клавишами, зависят и от состояния клавиш Ctrl, Shift и Caps Lock.

Чтобы не отходить слишком далеко от практики, рассмотрим программу, использующую одно из значений перечисления Keys.

  //----------------------------------------
  // ExitOnX.cs (C) 2001 by Charles Petzold
  //----------------------------------------
  using System;
  using System.Drawing;
  using System.Windows.Forms;

  class ExitOnX: Form
  {
      public static void Main()
      {
          Application.Run(new ExitOnX());
      }
      public ExitOnX()
      {
          Text = "Exit on X";
          BackColor = SystemColors.Window;
          ForeColor = SystemColors.WindowText;
      }
      protected override void OnKeyDown(KeyEventArgs kea)
      {
          if (kea.KeyCode == Keys.X)
              Close();
      }
  }

Эта программа закрывает сама себя при нажатии клавиши X. При этом клавиша X может быть нажата одновременно с любыми комбинациями клавиш Shift, Ctrl и Alt. Из-за совпадения значений перечисления с некоторыми кодами Unicode инструкцию if можно изменить:

  if (kea.KeyCode == (Keys)(int)'X')

Следующая группа значений Keys независимо от состояния модификаторов соответствует цифровым клавишам, расположенным в виде горизонтального ряда над клавишами букв:

Перечисление Keys (цифровые клавиши)

И вновь обратите внимание на связь между значениями Keys и ASCII-кодами для цифровых клавиш. Коды символов, генерируемые этими клавишами, также зависят от состояния модификаторов.

В общей сложности перечисление Keys включает значения для 24 функциональных клавиш:

Перечисление Keys (функциональные клавиши)

Знаю, что на моей клавиатуре (да и на вашей) не найдется 24 функциональных клавиш, и это меня вполне устраивает.

Цифровая клавиатура впервые появилась в оригинальной IBM PC. Следующие клавиши, расположенные на цифровой клавиатуре, независимо от состояния Num Lock генерируют одни и те же коды:

Перечисление Keys (знаки действий на цифровой клавиатуре)

Остальные клавиши цифровой клавиатуры генерируют различные коды в зависимости от состояния клавиши Num Lock. Вот коды, генерируемые при включенной клавише Num Lock (я построил эту таблицу в соответствии с расположением клавиш на цифровой клавиатуре):

Перечисление Keys (клавиши цифр на цифровой клавиатуре)

Эти клавиши генерируют коды 10 цифр и символа-разделителя десятичных разрядов. В раскладке клавиатуры одних стран разделителем является точка, в других — запятая. Независимо от раскладки, значение KeyCode для этой клавиши будет равно Keys.Decimal. А следующее значение перечисления, похоже, не используется:

Перечисление Keys (неиспользуемое значение цифровой клавиатуры)

А вот коды, генерируемые при выключенной клавише Num Lock:

Перечисление Keys (клавиши цифровой клавиатуры, управляющие курсором)

Заметьте, что значения Keys.Prior и Keys.Next дублируют Keys.PageUp и Keys.PageDown. На многих клавиатурах 10 цифровых клавиш (кроме Clear) дублируют клавиши управления курсором, генерируя те же самые коды.

Следующие 6 клавиш я поместил в отдельную группу, так как они тоже генерируют коды символов. Значение перечисления Keys для них совпадают с названиями генерируемых ими символов:

Перечисление Keys (управляющие клавиши ASCII)

Back — это клавиша Backspace. В настоящее время в цифровой клавиатуре есть вторая клавиша Enter (или Return), независимо от состояния Num Lock генерирующая тот же код, что и обычная клавиша Enter (Return).

Следующая таблица содержит значения перечисления Keys для клавиш Shift, Ctrl и Alt (которая здесь называется клавишей Menu, поскольку обычно она активизирует меню). В нижнем ряду на современной клавиатуре располагается по паре клавиш Shift, Ctrl и Alt. Из таблицы следует, что правые и левые версии этих клавиш генерируют разные коды:

Перечисление Keys (клавиши-модификаторы)

Однако в реальных объектах KeyEventArgs я никогда не видел членов перечисления с именами, начинающимися с буквы L или R.

А вот клавиши, встречающиеся на клавиатуре Microsoft Natural Keyboard и ее клонах:

Перечисление Keys (клавиши Microsoft)

В этом случае левая и правая клавиши действительно генерируют разные коды.

В следующей таблице описана подборка клавиш и их комбинаций, выполняющих различные функции:

Перечисление Keys (прочее)

Пять значений перечисления Keys на самом деле соответствуют кнопкам мыши:

Перечисление Keys (кнопки мыши)

Но вы не увидите эти значения в событиях KeyDown и KeyUp. А вот группа особых клавиш:

Перечисление Keys (специальные клавиши)

Понятия не имею, что делать с этими клавишами, если мне придется сесть за клавиатуру, на которой все они будут.

Следующие 12 значений Keys применяются лишь в Windows 2000 и выше. Эти клавиши также генерируют коды символов:

Перечисление Keys (символы)

Например, когда пользователь нажимает и отпускает клавишу, на которой нарисованы двоеточие и точка с запятой, генерируется код клавиши OemSemicolon.

Следующие коды клавиш предназначены для специальных клавиатур (например, Microsoft Natural Keyboard Pro или Microsoft Internet Keyboard Pro), поддерживающих браузер и проигрыватель в Windows 2000 и выше:

Перечисление Keys (коды управления браузером и проигрывателем)

Очевидно, что многие приложения просто игнорируют эти коды.

Следующие коды клавиш генерируются в связи с работой IME (Input Method Editor), используемого для ввода иероглифов китайского, японского и корейского языков:

Перечисление Keys (IME)

Обычно приложениям интересны лишь коды символов Unicode, которые являются результатами использования IME.

Все перечисленные до сих пор члены Keys были кодами клавиш, т.е. каждый из них идентифицировал нажимаемую или отпускаемую клавишу и заносился в свойство KeyCode объекта KeyEventArgs, предоставляемого с событием KeyDown или KeyUp.

Перечисление Keys также включает следующие коды модификаторов:

Перечисление Keys (клавиши-модификаторы)

Заметьте: это битовые значения. Коды модификаторов показывают, были ли нажаты клавиши Shift, Ctrl и Alt во время события нажатия или отпускания клавиши. Вспомните, что раньше уже приводились коды ShiftKey, ControlKey и Menu, отражающие состояние реальных клавиш Shift, Ctrl или Alt.

Каждая нажатая или отпущенная клавиша генерирует одно событие. Все три неизменяемых свойства объекта KeyEventArg — KeyCode, Modifiers и KeyData — относятся к типу Keys:

• KeyCode — идентифицирует нажатую иди отпущенную клавишу, в числе которых могут быть Shift (Keys.ShiftKey), Ctrl (Keys.ControlKey) или Alt (Keys.Menu);

• Modifiers — указывает состояние клавиш Shift, Ctrl и Alt во время нажатия или отпускания данной клавиши; значением свойства Modifiers может быть любая комбинация Keys.Shift, Keys.Control или Keys.Alt, или, если не нажата ни одна из клавиш-модификаторов, у Modifier будет значение Keys.None, определяемое просто как 0;

• KeyData — это комбинация KeyCode и Modifiers.

Пусть, например, вы нажали клавишу Shift, потом D, после чего отпустили D, а затем — Shift. Ниже в таблице показаны четыре события и свойства объекта KeyEventArgs, связанного с этими манипуляциями:

Перечисление Keys (клавиши-модификаторы)

Перечисление Keys также определяет две маски для работы со свойством KeyData, позволяющие различать коды клавиш и коды модификаторов:

Перечисление Keys (битовые маски)

Имена этих членов перечисления совпадают с именами соответствующих свойств класса KeyEventArgs. Если объект KeyEventArgs назван kea, то выражение:

  kea.KeyData & Keys.KeyCode

эквивалентно kea.KeyCode, а выражение:

  key.KeyData & Keys.Modifiers

тождественно kea.Modifiers.