Shape.PreviewKeyDown-Ereignis

Článek
08/23/2008

Aktualisiert: November 2007

Wird vor dem KeyDown-Ereignis ausgelöst, wenn eine Taste gedrückt wird und die Form den Fokus besitzt.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
<BrowsableAttribute(True)> _
Public Event PreviewKeyDown As PreviewKeyDownEventHandler
'Usage
Dim instance As Shape
Dim handler As PreviewKeyDownEventHandler

AddHandler instance.PreviewKeyDown, handler

[BrowsableAttribute(true)]
public event PreviewKeyDownEventHandler PreviewKeyDown

[BrowsableAttribute(true)]
public:
 event PreviewKeyDownEventHandler^ PreviewKeyDown {
    void add (PreviewKeyDownEventHandler^ value);
    void remove (PreviewKeyDownEventHandler^ value);
}

JScript unterstützt keine Ereignisse.

Hinweise

Das PreviewKeyDown-Ereignis ermöglicht Ihnen, Tasten abzufangen und Aktionen auszuführen, bevor das KeyDown-Ereignis ausgelöst wird. Alle in diesem Ereignis verarbeiteten Tasten werden nicht an das KeyDown-Ereignis übergeben.

Weitere Informationen zur Ereignisbehandlung finden Sie unter Behandeln von Ereignissen.

Beispiele

Im folgenden Beispiel wird die Reaktion auf das PreviewKeyDown-Ereignis in einem Ereignishandler veranschaulicht. Für dieses Beispiel müssen Sie über ein OvalShape-Steuerelement mit dem Namen OvalShape1 auf einem Formular verfügen.

Private Sub OvalShape1_PreviewKeyDown(ByVal sender As Object, _
 ByVal e As System.Windows.Forms.PreviewKeyDownEventArgs) _
 Handles OvalShape1.PreviewKeyDown
    If e.KeyCode = Keys.F1 Then
        ' Display a pop-up Help window to assist the user.
        Help.ShowPopup(OvalShape1.Parent, _
          "This shape represents a network node.", _
          PointToScreen(New Point(OvalShape1.Width, _
          OvalShape1.Height)))
    End If
End Sub

private void ovalShape1_PreviewKeyDown(object sender, 
    System.Windows.Forms.PreviewKeyDownEventArgs e)
{
    if (e.KeyCode == Keys.F1)
    // Display a pop-up Help window to assist the user.
    {
        Help.ShowPopup(ovalShape1.Parent, 
            "This shape represents a network node.", 
            PointToScreen(new Point(ovalShape1.Width, ovalShape1.Height)));
    }
}

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.