Výčet klíčů () | Microsoft Learn

Některé informace pocházejí z testovací verze produktu, která může před vydáním podléhat významným změnám. Společnost Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, s ohledem na informace obsažené v tomto dokumentu.

Určuje kódy kláves a modifikátory.

Tento výčet podporuje bitovou kombinaci hodnot svých členů.

public enum class Keys

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.KeysConverter))] [System.Flags] [System.Runtime.InteropServices.ComVisible(true)] public enum Keys

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.KeysConverter))] [System.Flags] public enum Keys

[] [] [] type Keys = 

[] [] type Keys = 

Public Enum Keys

pole

Klávesa kontextové nabídky (klávesnice Microsoft Natural).

Tlačítko zpět prohlížeče.

Tlačítko Oblíbené v prohlížeči.

Tlačítko Browser Forward.

Tlačítko Domů prohlížeče.

Tlačítko Obnovení prohlížeče.

Tlačítko vyhledávání v prohlížeči.

Tlačítko Stop prohlížeče.

klávesa CAPS LOCK.

klávesa CAPS LOCK.

Klíč oddělovače desetinných míst.

klávesa ŠIPKA DOLŮ.

Klávesa ERASE EOF.

Klávesa konečného režimu IME.

Klíč režimu IME Hanguel (podporováno z důvodu kompatibility; použijte klíč HangulMode).

Klávesa editoru vstupní metody Hangul.

Editor vstupních metod Klávesa režimu Hanja.

Klíč IME Accept, nahrazuje klíč IMEAceept.

IME Accept Key. Je zastaralý a je nahrazen klíčem IMEAccept.

Konverzní klíč IME.

Tlačítko změny režimu IME.

Klíč bez konverze IME.

Klávesa režimu „Jungle“ editoru vstupní metody.

Editor vstupní metody Tlačítko režimu Kana.

Editor vstupní metody Tlačítko režimu Kanji.

Bitová maska ​​pro extrahování kódu klíče z hodnoty klíče.

Klíč ke spuštění první aplikace.

Klíč pro spuštění druhé aplikace.

Klíč pro spuštění poštovní aplikace.

Levé tlačítko myši.

Levá klávesa CTRL.

klávesa ŠIPKA VLEVO.

Levá klávesa ALT.

Levá klávesa SHIFT.

Levá klávesa s logem Windows (Microsoft Natural Keyboard).

Střední tlačítko myši (třítlačítková myš).

Klíč dalšího vstupu.

Tlačítko pozastavení přehrávání.

Klíč předchozího vstupu.

Tlačítko zastavení přehrávání.

Bitmask pro extrahování modifikátorů z hodnoty klíče.

klávesa PAGE DOWN.

Konstanta vyhrazená pro budoucí použití.

Nebyly stisknuty žádné klávesy.

klávesa NUM LOCK.

Klávesa 0 na numerické klávesnici.

Klávesa 1 na numerické klávesnici.

Klávesa 2 na numerické klávesnici.

Klávesa 3 na numerické klávesnici.

Klávesa 4 na numerické klávesnici.

Klávesa 5 na numerické klávesnici.

Klávesa 6 na numerické klávesnici.

Klávesa 7 na numerické klávesnici.

Klávesa 8 na numerické klávesnici.

Klávesa 9 na numerické klávesnici.

OEM klíč s úhlovou závorkou nebo zpětným lomítkem na 102klávesové RT klávesnici.

Klávesa OEM s uzavírací hranatou závorkou na klávesnici se standardním rozložením v USA.

Klávesa OEM čárka na klávesnici pro jakoukoli zemi nebo oblast.

Klíč OEM se znaménkem mínus na klávesnici pro jakoukoli zemi nebo oblast.

OEM klíč s otevírací hranatou závorkou na klávesnici se standardním americkým rozložením.

OEM tečka na klávesnici pro jakoukoli zemi nebo oblast.

Klávesa OEM se svislým pruhem na klávesnici se standardním rozložením v USA.

OEM klíč se znaménkem plus na klávesnici pro jakoukoli zemi nebo oblast.

OEM klíč s otazníkem na americké standardní klávesnici.

Klávesa OEM s jednoduchou/dvojitou uvozovkou na klávesnici se standardním rozložením v USA.

OEM dvojtečka na klávesnici se standardním rozložením v USA.

Klávesa OEM se znakem vlnovky na klávesnici se standardním rozložením v USA.

Používá se k přenosu znaků Unicode jako stisknutí kláves. Hodnota klíče balíčku je slovo nízkého řádu 32bitové hodnoty virtuálního klíče používaného pro metody zadávání bez klávesnice.

klávesa PAGE DOWN.

klávesa PAGE UP.

Tlačítko PRINT SCREEN.

klávesa PAGE UP.

Pravé tlačítko myši.

Pravá klávesa CTRL.

klávesa ŠIPKA VPRAVO.

Pravá klávesa ALT.

Pravá klávesa SHIFT.

Pravá klávesa s logem Windows (Microsoft Natural Keyboard).

Klávesa SCROLL LOCK.

Tlačítko výběru mediálního souboru.

Klíč pro přepnutí počítače do režimu spánku.

Tlačítko PRINT SCREEN.

klávesa ŠIPKA NAHORU.

Tlačítko snížení hlasitosti.

Tlačítko pro zvýšení hlasitosti.

První tlačítko myši (pětitlačítková myš).

Druhé tlačítko myši (pětitlačítková myš).

Příklady

Následující příklad kódu používá událost KeyDown k určení typu znaku zadaného do ovládacího prvku.

// Boolean flag used to determine when a character other than a number is entered. private: bool nonNumberEntered; // Handle the KeyDown event to determine the type of character entered into the control. void textBox1_KeyDown( Object^ /*sender*/, System::Windows::Forms::KeyEventArgs^ e ) < // Initialize the flag to false. nonNumberEntered = false; // Determine whether the keystroke is a number from the top of the keyboard. if ( e->KeyCode < Keys::D0 || e->KeyCode > Keys::D9 ) < // Determine whether the keystroke is a number from the keypad. if ( e->KeyCode < Keys::NumPad0 || e->KeyCode > Keys::NumPad9 ) < // Determine whether the keystroke is a backspace. if ( e->KeyCode != Keys::Back ) < // A non-numerical keystroke was pressed. // Set the flag to true and evaluate in KeyPress event. nonNumberEntered = true; >> > //If shift key was pressed, it's not a number. if (Control::ModifierKeys == Keys::Shift) < nonNumberEntered = true; >> // This event occurs after the KeyDown event and can be used to prevent // characters from entering the control. void textBox1_KeyPress( Object^ /*sender*/, System::Windows::Forms::KeyPressEventArgs^ e ) < // Check for the flag being set in the KeyDown event. if ( nonNumberEntered == true ) < // Stop the character from being entered into the control since it is non-numerical. e->Handled = true; > > 

// Boolean flag used to determine when a character other than a number is entered. private bool nonNumberEntered = false; // Handle the KeyDown event to determine the type of character entered into the control. private void textBox1_KeyDown(object sender, System.Windows.Forms.KeyEventArgs e) < // Initialize the flag to false. nonNumberEntered = false; // Determine whether the keystroke is a number from the top of the keyboard. if (e.KeyCode < Keys.D0 || e.KeyCode >Keys.D9) < // Determine whether the keystroke is a number from the keypad. if (e.KeyCode < Keys.NumPad0 || e.KeyCode >Keys.NumPad9) < // Determine whether the keystroke is a backspace. if(e.KeyCode != Keys.Back) < // A non-numerical keystroke was pressed. // Set the flag to true and evaluate in KeyPress event. nonNumberEntered = true; >> > //If shift key was pressed, it's not a number. if (Control.ModifierKeys == Keys.Shift) < nonNumberEntered = true; >> // This event occurs after the KeyDown event and can be used to prevent // characters from entering the control. private void textBox1_KeyPress(object sender, System.Windows.Forms.KeyPressEventArgs e) < // Check for the flag being set in the KeyDown event. if (nonNumberEntered == true) < // Stop the character from being entered into the control since it is non-numerical. e.Handled = true; >> 

' Boolean flag used to determine when a character other than a number is entered. Private nonNumberEntered As Boolean = False ' Handle the KeyDown event to determine the type of character entered into the control. Private Sub textBox1_KeyDown(sender As Object, e As System.Windows.Forms.KeyEventArgs) _ Handles textBox1.KeyDown ' Initialize the flag to false. nonNumberEntered = False ' Determine whether the keystroke is a number from the top of the keyboard. If e.KeyCode < Keys.D0 OrElse e.KeyCode >Keys.D9 Then ' Determine whether the keystroke is a number from the keypad. If e.KeyCode < Keys.NumPad0 OrElse e.KeyCode >Keys.NumPad9 Then ' Determine whether the keystroke is a backspace. If e.KeyCode <> Keys.Back Then ' A non-numerical keystroke was pressed. ' Set the flag to true and evaluate in KeyPress event. nonNumberEntered = True End If End If End If 'If shift key was pressed, it's not a number. If Control.ModifierKeys = Keys.Shift Then nonNumberEntered = true End If End Sub ' This event occurs after the KeyDown event and can be used ' to prevent characters from entering the control. Private Sub textBox1_KeyPress(sender As Object, e As System.Windows.Forms.KeyPressEventArgs) _ Handles textBox1.KeyPress ' Check for the flag being set in the KeyDown event. If nonNumberEntered = True Then ' Stop the character from being entered into the control since it is non-numerical. e.Handled = True End If End Sub 

Komentáře

Třída Keys obsahuje konstanty pro zpracování vstupu z klávesnice. Členové výčtu klíčů se skládají z kódu klíče a sady modifikátorů spojených do jediné celočíselné hodnoty. V aplikačním programovacím rozhraní (API) Win32 má hodnota klíče dvě poloviny: bity vyššího řádu obsahující kód klíče (který je stejný jako kód virtuálního klíče Windows) a bity nižšího řádu představující modifikátory klíče, jako jsou klávesy SHIFT, CONTROL a ALT.

Nepoužívejte hodnoty v tomto výčtu pro kombinované bitové operace. Hodnoty ve výčtu se vzájemně nevylučují.

Tento výčet nekontroluje, zda jsou aktuálně povoleny klávesy CAPS LOCK nebo NUM LOCK. Chcete-li zjistit, zda jsou tyto klíče aktivovány, můžete použít jednu z následujících metod:

• Zavolejte metodu IsKeyLocked třídy Control.
• Pro přesnější ovládání použijte k tomu funkce Windows API GetKeyState , GetAsyncKeyState nebo GetKeyboardState definované v user32.dll. Další informace o volání nativních funkcí najdete v tématu Použití nespravovaných funkcí DLL.

Následující tabulka ukazuje hodnoty kódu klíče reprezentované dvěma uvedenými hodnotami, které představují jak generické klíče výrobce originálního vybavení (OEM), tak specifičtější americké asociace klávesnic.

Pro rozhraní .NET Framework 2.0 byl přidán prvek IMEAccept, který nahrazuje předchozí položku IMEAceept, která byla nesprávně napsána. Starší verze byla zachována z důvodu zpětné kompatibility, ale v budoucích verzích rozhraní .NET Framework může být odstraněna.