Control.Capture Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

Control.cs

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement die Maus erfasst hat.

public:
 property bool Capture { bool get(); void set(bool value); };

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

[<System.ComponentModel.Browsable(false)>]
member this.Capture : bool with get, set

Public Property Capture As Boolean

Eigenschaftswert

Boolean

truewenn das Steuerelement die Maus erfasst hat; andernfalls . false

Attribute

BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird die Capture Eigenschaft veranschaulicht. Zum Ausführen dieses Beispiels fügen Sie den folgenden Code in ein Formular ein, das eine Label benannte Bezeichnung1 und zwei ListBox Steuerelemente mit dem Namen Listbox1 und Listbox2 enthält. Stellen Sie sicher, dass das Formular- und Steuerelementereignis MouseDown der Methode in diesem Beispiel zugeordnet ist.

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

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

'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 Sub Control_MouseDown(ByVal sender As System.Object, _
    ByVal e As System.Windows.Forms.MouseEventArgs) Handles MyBase.MouseDown, _
    label1.MouseDown, listbox1.MouseDown, listbox2.MouseDown
    Dim control As Control = CType(sender, Control)
    If (control.Capture) Then
        label1.Text = control.Name & " has captured the mouse"
    End If
End Sub

Hinweise

Wenn ein Steuerelement die Maus erfasst hat, empfängt es Mauseingaben, unabhängig davon, ob sich der Cursor innerhalb des Rahmens befindet. Die Maus wird in der Regel nur während Ziehvorgängen erfasst.

Nur das Vordergrundfenster kann die Maus erfassen. Wenn ein Hintergrundfenster versucht, dies zu tun, empfängt das Fenster nur Nachrichten für Mausereignisse, die auftreten, wenn sich der Mauscursor innerhalb des sichtbaren Teils des Fensters befindet. Auch wenn das Vordergrundfenster die Maus erfasst hat, kann der Benutzer weiterhin auf ein anderes Fenster klicken und es in den Vordergrund bringen.

Wenn die Maus erfasst wird, sollten Tastenkombinationen nicht funktionieren.

Weitere Informationen

• Cursor