Přehled používání klávesnice (model Windows Forms .NET)

Článek
11/05/2024

V model Windows Forms se uživatelský vstup odesílá do aplikací ve formě zpráv systému Windows. Řada přepisovatelných metod zpracovává tyto zprávy na úrovni aplikace, formuláře a řízení. Když tyto metody přijímají zprávy klávesnice, vyvolávají události, které lze zpracovat, aby získaly informace o vstupu klávesnice. V mnoha případech budou model Windows Forms aplikace moci zpracovávat všechny vstupy uživatelů jednoduše zpracováním těchto událostí. V jiných případech může aplikace potřebovat přepsat jednu z metod, které zpracovávají zprávy, aby bylo možné zachytit určitou zprávu před tím, než ji aplikace, formulář nebo ovládací prvek přijme.

Události klávesnice

Všechny ovládací prvky model Windows Forms dědí sadu událostí souvisejících se vstupem myši a klávesnice. Ovládací prvek může například zpracovat KeyPress událost a určit kód znaku stisknuté klávesy. Další informace najdete v tématu Použití událostí klávesnice.

Metody, které zpracovávají zprávy uživatelského vstupu

Formuláře a ovládací prvky mají přístup k IMessageFilter rozhraní a sadě přepisovatelných metod, které zpracovávají zprávy systému Windows v různých bodech fronty zpráv. Všechny tyto metody mají Message parametr, který zapouzdřuje podrobnosti nízké úrovně zpráv systému Windows. Tyto metody můžete implementovat nebo přepsat, abyste zprávu prozkoumali a pak ji buď spotřebovali, nebo ji předali dalšímu příjemci ve frontě zpráv. Následující tabulka obsahuje metody, které zpracovávají všechny zprávy systému Windows v model Windows Forms.

metoda	Notes
PreFilterMessage	Tato metoda zachytí zprávy windows zařazené do fronty (označované také jako publikované) na úrovni aplikace.
PreProcessMessage	Tato metoda zachycuje zprávy systému Windows na úrovni formuláře a ovládacího prvku před jejich zpracováním.
WndProc	Tato metoda zpracovává zprávy systému Windows na úrovni formuláře a ovládacího prvku.
DefWndProc	Tato metoda provádí výchozí zpracování zpráv systému Windows na úrovni formuláře a ovládacího prvku. To poskytuje minimální funkčnost okna.
OnNotifyMessage	Tato metoda zachycuje zprávy na úrovni formuláře a ovládacího prvku po jejich zpracování. Bit EnableNotifyMessage stylu musí být nastaven pro tuto metodu, která má být volána.

Zprávy klávesnice a myši jsou také zpracovány další sadou přepisovatelných metod, které jsou specifické pro tyto typy zpráv. Další informace najdete v části Klíče předběžného zpracování. .

Typy klíčů

model Windows Forms identifikuje vstup klávesnice jako kódy virtuálních kláves, které jsou reprezentovány bitovým Keys výčtem. Pomocí výčtu Keys můžete zkombinovat řadu stisknutých kláves, aby vznikla jedna hodnota. Tyto hodnoty odpovídají hodnotám, které doprovázejí zprávy WM_KEYDOWN a WM_SYSKEYDOWN Windows. Většinu fyzických stisknutí kláves můžete zjistit zpracováním KeyDown událostí nebo KeyUp událostí. Znakové klíče jsou podmnožinou výčtu Keys a odpovídají hodnotám, které doprovázejí WM_CHAR a WM_SYSCHAR zprávy systému Windows. Pokud kombinace stisknutých kláves vede ke znaku, můžete ho KeyPress zjistit zpracováním události.

Pořadí událostí klávesnice

Jak je uvedeno výše, na ovládacím prvku můžou nastat 3 události související s klávesnicí. Následující posloupnost ukazuje obecné pořadí událostí:

Uživatel nasdílí klíč "a", klíč je předem zpracován, odeslán a KeyDown nastane událost.
Uživatel obsahuje klíč "a", klíč je předzpracován, odeslán a dojde k KeyPress události. K této události dochází několikrát, protože uživatel uchovává klíč.
Uživatel uvolní klíč "a", klíč je předzpracován, odeslán a KeyUp nastane událost.

Klíče předběžného zpracování

Stejně jako jiné zprávy se zprávy klávesnice zpracovávají v WndProc metodě formuláře nebo ovládacího prvku. Před zpracováním PreProcessMessage zpráv klávesnice však metoda volá jednu nebo více metod, které lze přepsat, aby zpracovávaly speciální znakové klávesy a fyzické klávesy. Tyto metody můžete přepsat, abyste před zpracováním zpráv detekovali a vyfiltrovali určité klíče. Následující tabulka ukazuje akci, která se provádí, a související metodu, která nastane v pořadí, v jakém se metoda vyskytuje.

Předběžné zpracování události KeyDown

Akce	Související metoda	Notes
Zkontrolujte příkazový klíč, jako je akcelerátor nebo zástupce nabídky.	ProcessCmdKey	Tato metoda zpracovává příkazový klíč, který má přednost před běžnými klíči. Pokud tato metoda vrátí `true`, zpráva klíče není odeslána a k události klíče nedojde. Pokud se vrátí `false`, IsInputKey je volána`.`
Zkontrolujte speciální klíč, který vyžaduje předběžné zpracování nebo normální znakový klíč, který by měl vyvolat KeyDown událost a být odeslán do ovládacího prvku.	IsInputKey	Pokud metoda vrátí `true`, znamená to, že ovládací prvek je běžný znak a KeyDown je vyvolána událost. Pokud `false`se ProcessDialogKey volá , je volána. Poznámka: Chcete-li zajistit, aby ovládací prvek získal klíč nebo kombinaci kláves, můžete zpracovat PreviewKeyDown událost a nastavit IsInputKey PreviewKeyDownEventArgs pro klíč nebo klíče, které `true` chcete použít.
Zkontrolujte navigační klávesu (ESC, TAB, Return nebo šipkové klávesy).	ProcessDialogKey	Tato metoda zpracovává fyzický klíč, který využívá speciální funkce v rámci ovládacího prvku, například přepínání fokusu mezi ovládacím prvku a jeho nadřazeným objektem. Pokud okamžitý ovládací prvek nezpracuje klíč, ProcessDialogKey volá se nadřazený ovládací prvek a tak dále na nejvyšší ovládací prvek v hierarchii. Pokud tato metoda vrátí `true`, předběžné zpracování je dokončeno a klíč událost není generována. Pokud se vrátí `false`, dojde k KeyDown události.

Předběžné zpracování události KeyPress

Akce	Související metoda	Notes
Zkontrolujte, jestli je klíč normálním znakem, který by měl ovládací prvek zpracovat.	IsInputChar	Pokud je znak normální znak, tato metoda vrátí `true`, KeyPress událost je vyvolána a nedojde k žádnému dalšímu předběžnému zpracování. Jinak ProcessDialogChar bude volána.
Zkontrolujte, jestli je znak mnemonic (například &OK na tlačítku).	ProcessDialogChar	Tato metoda, podobně jako ProcessDialogKey, bude volána řídicí hierarchie. Pokud je ovládací prvek kontejneru, kontroluje měmonics voláním ProcessMnemonic sebe sama a jeho podřízených ovládacích prvků. Pokud ProcessDialogChar se vrátí `true`, nedojde k KeyPress události.

Zpracování zpráv klávesnice

Jakmile se zprávy klávesnice dostanou k WndProc metodě formuláře nebo ovládacího prvku, zpracuje je sada metod, které je možné přepsat. Každá z těchto metod vrátí Boolean hodnotu určující, zda byla zpráva klávesnice zpracována a spotřebována ovládacím prvku. Pokud jedna z metod vrátí true, zpráva je považována za zpracována a není předána do základu ovládacího prvku nebo nadřazeného prvku pro další zpracování. Jinak zpráva zůstane ve frontě zpráv a může být zpracována v jiné metodě v základu nebo nadřazené ovládacího prvku. Následující tabulka obsahuje metody, které zpracovávají zprávy klávesnice.

metoda	Notes
ProcessKeyMessage	Tato metoda zpracovává všechny zprávy klávesnice přijaté metodou WndProc ovládacího prvku.
ProcessKeyPreview	Tato metoda odešle zprávu klávesnice nadřazené ovládacího prvku. Pokud ProcessKeyPreview se vrátí `true`, negeneruje se žádná událost klíče, jinak ProcessKeyEventArgs se volá.
ProcessKeyEventArgs	Tato metoda podle potřeby vyvolá KeyDown, KeyPressa KeyUp události.

Přepsání klávesových metod

Při předběžném zpracování a zpracování zprávy pomocí klávesnice je k dispozici mnoho metod přepsání; některé metody jsou ale mnohem lepší než jiné. V následující tabulce najdete úkoly, které můžete chtít provést, a nejlepší způsob, jak přepsat metody klávesnice. Další informace o přepsání metod naleznete v tématu Dědičnost (Průvodce programováním v C#) nebo dědičnost (Visual Basic)

Úloha	metoda
Zachytí navigační klíč a vyvolá KeyDown událost. Například chcete, aby se klávesa TAB a Return zpracovávala v textovém poli.	Přepsat IsInputKey. Poznámka: Případně můžete zpracovat PreviewKeyDown událost a nastavit IsInputKey PreviewKeyDownEventArgs klíč nebo klíče, které `true` chcete použít.
Provádění speciálního vstupu nebo zpracování navigace u ovládacího prvku Chcete například, aby se vybraná položka změnila pomocí kláves se šipkami v ovládacím prvku seznamu.	Schvátit ProcessDialogKey
Zachytí navigační klíč a vyvolá KeyPress událost. Například v ovládacím prvku číselníku chcete, aby více kláves se šipkami urychlilo procházení položek.	Přepsat IsInputChar.
Během události můžete provádět speciální vstup nebo zpracování KeyPress navigace. Například v ovládacím prvku seznamu podržení klávesy "r" přeskočí mezi položkami, které začínají písmenem r.	Schvátit ProcessDialogChar
Provádět vlastní měmónní zpracování; Chcete například zpracovat mnemonics na tlačítkách nakreslených vlastníkem obsažených na panelu nástrojů.	Přepsat ProcessMnemonic.

Sdílet prostřednictvím