KeyEventArgs.Modifiers プロパティ

.NET Framework クラス ライブラリ リファレンス

KeyEventArgs.Modifiers プロパティ

KeyDown イベントまたは KeyUp イベントの修飾フラグを取得します。このフラグは、Ctrl キー、Shift キー、および Alt キーのどの組み合わせが押されたのかを示します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Modifiers As Keys

Visual Basic (使用法)

Dim instance As KeyEventArgs
Dim value As Keys

value = instance.Modifiers

C#

public Keys Modifiers { get; }

C++

public:
property Keys Modifiers {
    Keys get ();
}

J#

/** @property */
public Keys get_Modifiers ()

JScript

public function get Modifiers
 () : Keys

プロパティ値
1 つ以上の修飾フラグを表す Keys の値。

解説

特定の修飾子キーが押されたかどうかを判断するには、Control プロパティ、Shift プロパティ、および Alt プロパティを使用します。修飾フラグは、ビットごとの OR と結合される可能性があります。

使用例

Modifiers プロパティを使用して、主キーと共に押された修飾子キーを確認する方法を、次のコード例に示します。

Visual Basic

' 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-handler 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 TextBox control, named textBox1, has been added to the form
 and its KeyDown
' event has been contected to this event-handler method.
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 'textBox1_KeyDown

C#

// 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-handler 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-handler 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.", 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));
    }
}

C++

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

J#

    // 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.get_KeyCode().Equals(Keys.F1) && (e.get_Alt()
 || e.get_Control() 
            || e.get_Shift())) {
            // Display a pop-up Help topic to assist the user.
            Help.ShowPopup(textBox1, "Enter your name.", new
 Point(textBox1.
                get_Bottom(), textBox1.get_Right()));
        }
        else {
            if (e.get_KeyCode().Equals(Keys.F2) && e.get_Modifiers().
                Equals(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.get_Top(), this.textBox1.get_Left()));
            }
        }
    } //textBox1_KeyDown
} //Form1

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
KeyEventArgs クラス
KeyEventArgs メンバ
System.Windows.Forms 名前空間
KeyEventArgs.Alt プロパティ
KeyEventArgs.Control プロパティ
Shift
Control.ModifierKeys プロパティ