KeyEventArgs.Modifiers プロパティ

定義

KeyDown イベントまたは KeyUp イベントの修飾フラグを取得します。Gets the modifier flags for a KeyDown or KeyUp event. このフラグは、Ctrl キー、Shift キー、および Alt キーのどの組み合わせが押されたのかを示します。The flags indicate which combination of CTRL, SHIFT, and ALT keys was pressed.

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

プロパティ値

Keys

1 つ以上の修飾フラグを表す Keys の値。A Keys value representing one or more modifier flags.

次のコード例では、Modifiers プロパティを使用して、主キーと共にどの修飾子キーが押されたかを確認する方法を示します。The following code example shows how to use the Modifiers property to determine which modifier keys were pressed along with the primary key.

   // This example demonstrates how to use the KeyDown event with the Help class to display
   // pop-up style help to the user of the application. The example filters for all variations
   // of pressing the F1 key with a modifier key by using the KeyEventArgs properties passed
   // to the event handling method.
   // When the user presses any variation of F1 that includes any keyboard modifier, the Help
   // class displays a pop-up window, similar to a ToolTip, near the control. If the user presses
   // ALT + F2, a different Help pop-up is displayed with additional information. This example assumes
   // that a tTextBox control, named textBox1, has been added to the form and its KeyDown
   // event has been contected to this event handling method.
private:
   void textBox1_KeyDown( Object^ /*sender*/, System::Windows::Forms::KeyEventArgs^ e )
   {
      // Determine whether the key entered is the F1 key. If it is, display Help.
      if ( e->KeyCode == Keys::F1 && (e->Alt || e->Control || e->Shift) )
      {
         
         // Display a pop-up Help topic to assist the user.
         Help::ShowPopup( textBox1, "Enter your name.", Point(textBox1->Bottom,textBox1->Right) );
      }
      else
      if ( e->KeyCode == Keys::F2 && e->Modifiers == Keys::Alt )
      {
         // Display a pop-up Help topic to provide additional assistance to the user.
         Help::ShowPopup( textBox1, "Enter your first name followed by your last name. Middle name is optional.",
            Point(textBox1->Top,this->textBox1->Left) );
      }
   }
private void textBox1_KeyDown(object sender, System.Windows.Forms.KeyEventArgs e)
{
    // Determine whether the key entered is the F1 key. If it is, display Help.
    if(e.KeyCode == Keys.F1 && (e.Alt || e.Control || e.Shift))
    {
        // Display a pop-up Help topic to assist the user.
        Help.ShowPopup(textBox1, "Enter your name.", new Point(textBox1.Bottom, textBox1.Right));
    }
    else if(e.KeyCode == Keys.F2 && e.Modifiers == Keys.Alt)
    {
        // Display a pop-up Help topic to provide additional assistance to the user.
        Help.ShowPopup(textBox1, "Enter your first name followed by your last name. Middle name is optional.",
            new Point(textBox1.Top, this.textBox1.Left));
    }
}
Private Sub textBox1_KeyDown(ByVal sender As Object, ByVal e As System.Windows.Forms.KeyEventArgs) Handles textBox1.KeyDown
    ' Determine whether the key entered is the F1 key. If it is, display Help.
    If e.KeyCode = Keys.F1 AndAlso (e.Alt OrElse e.Control OrElse e.Shift) Then
        ' Display a pop-up Help topic to assist the user.
        Help.ShowPopup(textBox1, "Enter your name.", New Point(textBox1.Bottom, textBox1.Right))
    ElseIf e.KeyCode = Keys.F2 AndAlso e.Modifiers = Keys.Alt Then
        ' Display a pop-up Help topic to provide additional assistance to the user.
        Help.ShowPopup(textBox1, "Enter your first name followed by your last name. Middle name is optional.", _
             New Point(textBox1.Top, Me.textBox1.Left))
    End If
End Sub

注釈

特定の修飾子キーが押されたかどうかを確認するには、ControlShift、および Alt の各プロパティを使用します。To determine whether a specific modifier key was pressed, use the Control, Shift, and Alt properties. 修飾子フラグは、ビットごとの OR と組み合わせることができます。Modifier flags can be combined with bitwise OR.

適用対象

こちらもご覧ください