KeyEventArgs.KeyData プロパティ

定義

KeyDown イベントまたは KeyUp イベントのキー データを取得します。Gets the key data for a KeyDown or KeyUp event.

public:
 property System::Windows::Forms::Keys KeyData { System::Windows::Forms::Keys get(); };
public System.Windows.Forms.Keys KeyData { get; }
member this.KeyData : System.Windows.Forms.Keys
Public ReadOnly Property KeyData As Keys

プロパティ値

Keys

押されたキーのキー コードを表す Keys。これには、同時に押されたキーが Ctrl キー、Shift キー、および Alt キーのどの組み合わせであるのかを示す修飾フラグが組み合わされます。A Keys representing the key code for the key that was pressed, combined with modifier flags that indicate which combination of CTRL, SHIFT, and ALT keys was pressed at the same time.

このメンバーの使用例を次のコード例に示します。The following code example demonstrates the use of this member. この例では、イベントハンドラーがイベントの発生を報告し Control.KeyDown ます。In the example, an event handler reports on the occurrence of the Control.KeyDown event. このレポートは、イベントがいつ発生し、デバッグに役立つかを理解するのに役立ちます。This report helps you to learn when the event occurs and can assist you in debugging. 複数のイベントまたは頻繁に発生するイベントについてレポートするには、メッセージをに置き換えるか、または複数 MessageBox.Show Console.WriteLine 行に追加することを検討してください TextBoxTo report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

コード例を実行するには、やなど、から継承された型のインスタンスを含むプロジェクトに貼り付け Control Button ComboBox ます。To run the example code, paste it into a project that contains an instance of a type that inherits from Control, such as a Button or ComboBox. 次に、インスタンスにという名前 Control1 を付け、イベントハンドラーがイベントに関連付けられていることを確認し Control.KeyDown ます。Then name the instance Control1 and ensure that the event handler is associated with the Control.KeyDown event.

private void Control1_KeyDown(Object sender, KeyEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Alt", e.Alt );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Control", e.Control );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Handled", e.Handled );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "KeyCode", e.KeyCode );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "KeyValue", e.KeyValue );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "KeyData", e.KeyData );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Modifiers", e.Modifiers );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Shift", e.Shift );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "SuppressKeyPress", e.SuppressKeyPress );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "KeyDown Event" );
}
Private Sub Control1_KeyDown(sender as Object, e as KeyEventArgs) _ 
     Handles Control1.KeyDown

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Alt", e.Alt)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Control", e.Control)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Handled", e.Handled)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "KeyCode", e.KeyCode)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "KeyValue", e.KeyValue)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "KeyData", e.KeyData)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Modifiers", e.Modifiers)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Shift", e.Shift)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "SuppressKeyPress", e.SuppressKeyPress)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"KeyDown Event")

End Sub

注釈

の定数を使用すると Keys 、プロパティから情報を抽出でき KeyData ます。You can use constants from Keys to extract information from the KeyData property. によって返されたデータをの定数と比較して、 KeyData Keys ユーザーが押したキーに関する情報を取得するには、ビットごとの and 演算子を使用します。Use the bitwise AND operator to compare data returned by KeyData with constants in Keys to obtain information about which keys the user pressed. 特定の修飾子キーが押されたかどうかを確認するには、、、およびの各プロパティを使用し Control Shift Alt ます。To determine whether a specific modifier key was pressed, use the Control, Shift, and Alt properties.

適用対象

こちらもご覧ください