Shape.PreviewKeyDown イベント

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

この図形にフォーカスがあるときにキーが押された場合、KeyDown イベントの前に発生します。

名前空間 : Microsoft.VisualBasic.PowerPacks
アセンブリ : Microsoft.VisualBasic.PowerPacks.Vs (Microsoft.VisualBasic.PowerPacks.Vs.dll 内)

構文

'宣言
<BrowsableAttribute(True)> _
Public Event PreviewKeyDown As PreviewKeyDownEventHandler
'使用
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 では、イベントは使用できません。

解説

PreviewKeyDown イベントを使用すると、KeyDown イベントが発生する前に、キーを受け取ってアクションを実行できます。このイベントで処理されたキーは、KeyDown イベントに渡されません。

イベントの処理方法の詳細については、「イベントの利用」を参照してください。

例

イベントハンドラの中で PreviewKeyDown イベントに応答する方法を次の例に示します。この例では、OvalShape1 という名前の OvalShape コントロールがフォームに配置されている必要があります。

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)));
    }
}