Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

KeyEventArgs.Modifiers-Eigenschaft

Aktualisiert: November 2007

Ruft die Modifiziererflags für ein KeyDown-Ereignis oder ein KeyUp-Ereignis ab. Die Flags geben an, welche Kombination aus STRG, UMSCHALTTASTE und ALT gedrückt wurde.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
public Keys Modifiers { get; }
/** @property */
public Keys get_Modifiers()

public function get Modifiers () : Keys

Eigenschaftenwert

Typ: System.Windows.Forms.Keys
Ein Keys-Wert, der mindestens ein Modifiziererflag darstellt.

Verwenden Sie die Control-Eigenschaft, die Shift-Eigenschaft und die Alt-Eigenschaft, um festzustellen, ob eine bestimmte Modifizierertaste gedrückt wurde. Modifiziererflags können mit dem bitweisen OR-Operator kombiniert werden.

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der Modifiers-Eigenschaft bestimmt werden kann, welche Modifizierertasten zusammen mit dem Primärtaste gedrückt wurden.

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


    // 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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile für Smartphone, Windows Mobile für Pocket PC

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 3.5, 2.0, 1.0
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN
© 2013 Microsoft. Alle Rechte vorbehalten.