Control.ProcessCmdKey(Message, Keys) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een opdrachtsleutel verwerkt.
protected:
virtual bool ProcessCmdKey(System::Windows::Forms::Message % msg, System::Windows::Forms::Keys keyData);
protected virtual bool ProcessCmdKey(ref System.Windows.Forms.Message msg, System.Windows.Forms.Keys keyData);
abstract member ProcessCmdKey : Message * System.Windows.Forms.Keys -> bool
override this.ProcessCmdKey : Message * System.Windows.Forms.Keys -> bool
Protected Overridable Function ProcessCmdKey (ByRef msg As Message, keyData As Keys) As Boolean
Parameters
- msg
- Message
Een Message, doorgegeven door verwijzing, die het vensterbericht vertegenwoordigt dat moet worden verwerkt.
Retouren
true indien het teken door het besturingselement is verwerkt; anders, false.
Opmerkingen
Deze methode wordt aangeroepen tijdens het vooraf verwerken van berichten om opdrachtsleutels te verwerken. Opdrachtsleutels zijn sleutels die altijd voorrang hebben op reguliere invoersleutels. Voorbeelden van opdrachttoetsen zijn accelerators en menusneltoetsen. De methode moet terugkeren true om aan te geven dat de opdrachtsleutel is verwerkt of false om aan te geven dat de sleutel geen opdrachtsleutel is. Deze methode wordt alleen aangeroepen wanneer het besturingselement wordt gehost in een Windows Forms toepassing of als een ActiveX-besturingselement.
De ProcessCmdKey methode bepaalt eerst of het besturingselement een ContextMenu, en zo ja, de opdrachtsleutel kan ContextMenu verwerken. Als de opdrachttoets geen menusneltoets is en het besturingselement een bovenliggend element heeft, wordt de sleutel doorgegeven aan de methode van ProcessCmdKey het bovenliggende item. Het netto-effect is dat opdrachtsleutels 'gebeld' zijn in de besturingshiërarchie. Naast de toets die de gebruiker heeft ingedrukt, geven de sleutelgegevens ook aan welke, indien van toepassing, wijzigingstoetsen op hetzelfde moment als de toets zijn ingedrukt. Modifier-toetsen zijn de toetsen Shift, Ctrl en Alt.
Notities voor overnemers
Bij het overschrijven van de ProcessCmdKey(Message, Keys) methode in een afgeleide klasse moet een besturingselement terugkeren true om aan te geven dat deze de sleutel heeft verwerkt. Voor sleutels die niet door het besturingselement worden verwerkt, moet het resultaat van het aanroepen van de methode van ProcessCmdKey(Message, Keys) de basisklasse worden geretourneerd. Besturingselementen zullen zelden, indien ooit, deze methode moeten overschrijven.