Control.Capture Eigenschap

Definitie

Naamruimte:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement de muis heeft vastgelegd.

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

Waarde van eigenschap

Boolean

true als het besturingselement de muis heeft vastgelegd; anders, false.

Kenmerken

BrowsableAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u de Capture eigenschap. Als u dit voorbeeld wilt uitvoeren, plakt u de volgende code in een formulier met een Label benoemd label1 en twee ListBox besturingselementen met de naam keuzelijst1 en keuzelijst2. Zorg ervoor dat de gebeurtenis van het formulier en de besturingselementen MouseDown is gekoppeld aan de methode in dit voorbeeld.

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

Opmerkingen

Wanneer een besturingselement de muis heeft vastgelegd, ontvangt het muisinvoer, ongeacht of de cursor binnen de randen valt. De muis wordt doorgaans alleen vastgelegd tijdens slepen.

Alleen het voorgrondvenster kan de muis vastleggen. Wanneer een achtergrondvenster dit probeert te doen, ontvangt het venster alleen berichten voor muis-gebeurtenissen die optreden wanneer de muiscursor zich in het zichtbare gedeelte van het venster bevindt. Zelfs als het voorgrondvenster de muis heeft vastgelegd, kan de gebruiker nog steeds op een ander venster klikken, waardoor het op de voorgrond wordt geplaatst.

Wanneer de muis wordt vastgelegd, werken sneltoetsen niet.

Zie ook

• Cursor