Auf Englisch lesen

Teilen über


Control.Capture Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob die Maus vom Steuerelement erfasst wurde, oder legt diesen fest.

C#
[System.ComponentModel.Browsable(false)]
public bool Capture { get; set; }

Eigenschaftswert

true, wenn die Maus vom Steuerelement erfasst wurde, andernfalls false.

Attribute

Beispiele

Im folgenden Codebeispiel wird die Capture -Eigenschaft veranschaulicht. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Formular ein, das eine Label benannte Bezeichnung1 und die beiden ListBox Steuerelemente listbox1 und listbox2 enthält. Stellen Sie sicher, dass das Formular- und das Steuerelementereignis MouseDown der -Methode in diesem Beispiel zugeordnet ist.

C#
// This method handles the mouse down event for all the controls on the form.  
// When a control has captured the mouse
// the control's name will be output on label1.
private void Control_MouseDown(System.Object sender, 
    System.Windows.Forms.MouseEventArgs e)
{
    Control control = (Control) sender;
    if (control.Capture)
    {
        label1.Text = control.Name+" has captured the mouse";
    }
}

Hinweise

Wenn ein Steuerelement die Maus erfasst hat, empfängt es mauseingaben, unabhängig davon, ob sich der Cursor innerhalb seiner Rahmen befindet oder nicht. Die Maus wird in der Regel nur bei Ziehvorgängen erfasst.

Die Maus kann nur im Vordergrundfenster erfasst werden. Wenn ein Hintergrundfenster dies versucht, empfängt das Fenster nur Meldungen für Mausereignisse, die auftreten, wenn sich der Mauscursor innerhalb des sichtbaren Teils des Fensters befindet. Außerdem gilt: Der Benutzer kann weiterhin auf ein anderes Fenster klicken und es so in den Vordergrund holen, auch wenn das Vordergrundfenster die Maus erfasst hat.

Wenn die Maus erfasst wird, sollten Tastenkombinationen nicht funktionieren.

Gilt für:

Produkt Versionen
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Weitere Informationen