Control.Capture-Eigenschaft

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property Capture As Boolean
'Usage
Dim instance As Control
Dim value As Boolean

value = instance.Capture

instance.Capture = value

public bool Capture { get; set; }

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

/** @property */
public boolean get_Capture ()

/** @property */
public void set_Capture (boolean value)

public function get Capture () : boolean

public function set Capture (value : boolean)

Eigenschaftenwert

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

Hinweise

Wenn die Maus vom Steuerelement erfasst wurde, erhält dieses eine Mauseingabe, unabhängig davon, ob der Cursor sich innerhalb der Begrenzungen des Steuerelements befindet. Die Maus wird i. d. R. nur während eines Ziehvorgangs erfasst.

Nur das Vordergrundfenster kann die Maus erfassen. Wenn ein Hintergrundfenster dies versucht, erhält das Fenster nur Meldungen für Mausereignisse, die eintreten, wenn der Mauszeiger sich im sichtbaren Bereich des Fensters befindet. Außerdem kann der Benutzer auf ein anderes Fenster klicken und es so zum Vordergrundfenster machen, selbst wenn das Vordergrundfenster die Maus erfasst hat,

Wenn die Maus erfasst wurde, funktionieren die Tastenkombinationen nicht.

Beispiel

Im folgenden Codebeispiel wird die Capture-Eigenschaft veranschaulicht. Damit Sie dieses Beispiel ausführen können, fügen Sie den folgenden Code in ein Formular ein, das ein Label mit der Bezeichnung label1 und zwei Listbox-Steuerelemente mit den Bezeichnungen listbox1 und listbox2 enthält. Stellen Sie sicher, dass der Methode in diesem Beispiel das MouseDown-Ereignis des Formulars und der Steuerelemente 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.
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

// 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.
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(Object sender, 
    System.Windows.Forms.MouseEventArgs e)
{
    Control control = (Control)sender;
    if (control.get_Capture()) {
        label1.set_Text(control.get_Name() + " has captured the mouse");
    }
} //Control_MouseDown

.NET Framework-Sicherheit

• UIPermission  für alle Fenster, um diesen Eigenschaftenwert festzulegen. Zugeordnete Enumeration: UIPermissionWindow.AllWindows

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
Cursor