Control.Capture Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit une valeur indiquant si le contrôle a capturé la souris.

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

Valeur de propriété

Boolean

true si le contrôle a capturé la souris ; sinon, false.

Attributs

BrowsableAttribute

Exemples

L’exemple de code suivant illustre la Capture propriété . Pour exécuter cet exemple, collez le code suivant dans un formulaire contenant une Label étiquette nommée1 et deux ListBox contrôles nommés listbox1 et listbox2. Vérifiez que le formulaire et l’événement des MouseDown contrôles sont associés à la méthode dans cet exemple.

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

Remarques

Lorsqu’un contrôle a capturé la souris, il reçoit l’entrée de la souris, que le curseur se trouve ou non à l’intérieur de ses bordures. La souris est généralement capturée uniquement pendant les opérations de glissement.

Seule la fenêtre de premier plan peut capturer la souris. Lorsqu’une fenêtre d’arrière-plan tente de le faire, la fenêtre reçoit des messages uniquement pour les événements de souris qui se produisent lorsque le curseur de la souris se trouve dans la partie visible de la fenêtre. En outre, même si la fenêtre de premier plan a capturé la souris, l’utilisateur peut toujours cliquer sur une autre fenêtre, la ramenant au premier plan.

Lorsque la souris est capturée, les touches de raccourci ne doivent pas fonctionner.

Voir aussi

• Cursor