Shape.PreviewKeyDown イベント

[アーティクル]
10/28/2012

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

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

構文

'宣言
<BrowsableAttribute(True)> _
Public Event PreviewKeyDown As PreviewKeyDownEventHandler

[BrowsableAttribute(true)]
public event PreviewKeyDownEventHandler PreviewKeyDown

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

[<BrowsableAttribute(true)>]
member PreviewKeyDown : IEvent<PreviewKeyDownEventHandler,
    PreviewKeyDownEventArgs>

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