Control.Capture Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

Control.cs

Získá nebo nastaví hodnotu určující, zda ovládací prvek zachytil myš.

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

Hodnota vlastnosti

Boolean

truepokud ovládací prvek zachytil myš; v opačném případě . false

Atributy

BrowsableAttribute

Příklady

Následující příklad kódu ukazuje Capture vlastnost. Chcete-li spustit tento příklad, vložte do formuláře následující kód obsahující pojmenovaný Label popisek1 a dva ListBox ovládací prvky s názvem listbox1 a listbox2. Ujistěte se, že MouseDown je událost formuláře a ovládacích prvků přidružená k metodě v tomto příkladu.

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

Poznámky

Když ovládací prvek zachytil myš, obdrží vstup myši bez ohledu na to, jestli je kurzor uvnitř jeho ohraničení. Myš je obvykle zachycena pouze během operací přetažení.

Myš může zachytit pouze okno popředí. Když se okno pozadí pokusí provést, okno obdrží zprávy pouze pro události myši, ke kterým dochází, když je kurzor myši v viditelné části okna. I když okno popředí zachytilo myš, uživatel může stále kliknout na jiné okno a převést ho do popředí.

Při zachycení myši by klávesové zkratky neměly fungovat.

Viz také

• Cursor