Control.Capture Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol telah menangkap mouse.

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

Nilai Properti

Boolean

true jika kontrol telah menangkap mouse; jika tidak, false.

Atribut

BrowsableAttribute

Contoh

Contoh kode berikut menunjukkan Capture properti . Untuk menjalankan contoh ini tempelkan kode berikut dalam formulir yang berisi Label label1 bernama dan dua ListBox kontrol bernama listbox1 dan listbox2. Pastikan peristiwa formulir dan kontrol MouseDown dikaitkan dengan metode dalam contoh ini.

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

Keterangan

Ketika kontrol telah menangkap mouse, kontrol menerima input mouse apakah kursor berada di dalam batasnya atau tidak. Mouse biasanya hanya diambil selama operasi seret.

Hanya jendela latar depan yang dapat menangkap mouse. Ketika jendela latar belakang mencoba melakukannya, jendela hanya menerima pesan untuk peristiwa mouse yang terjadi ketika kursor mouse berada di dalam bagian jendela yang terlihat. Selain itu, bahkan jika jendela latar depan telah menangkap mouse, pengguna masih dapat mengklik jendela lain, membawanya ke latar depan.

Ketika mouse ditangkap, tombol pintasan tidak boleh berfungsi.

Lihat juga

• Cursor