Control.Capture Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

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

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

Attribute

BrowsableAttribute

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.

// 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 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.

Weitere Informationen

• Cursor