Control.Capture Control.Capture Control.Capture Control.Capture Property

Definição

Obtém ou define um valor que indica se o controle capturou o mouse.Gets or sets a value indicating whether the control has captured the mouse.

public:
 property bool Capture { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(false)]
public bool Capture { get; set; }
member this.Capture : bool with get, set
Public Property Capture As Boolean

Valor da propriedade

true se o controle tiver capturado o mouse; caso contrário, false.true if the control has captured the mouse; otherwise, false.

Exemplos

O exemplo de código a seguir Capture demonstra a propriedade.The following code example demonstrates the Capture property. Para executar este exemplo, Cole o código a seguir em um formulário Label que contém um denominado ListBox Label1 e dois controles chamados ListBox1 e listBox2.To run this example paste the following code in a form containing a Label named label1 and two ListBox controls named listbox1 and listbox2. Verifique se o MouseDown evento de formulário e controles está associado ao método neste exemplo.Ensure the form and controls' MouseDown event is associated with the method in this example.

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

Comentários

Quando um controle tiver capturado o mouse, ele receberá a entrada do mouse se o cursor estiver ou não dentro de suas bordas.When a control has captured the mouse, it receives mouse input whether or not the cursor is within its borders. O mouse normalmente é capturado apenas durante operações de arrastar.The mouse is typically only captured during drag operations.

Somente a janela em primeiro plano pode capturar o mouse.Only the foreground window can capture the mouse. Quando uma janela de plano de fundo tenta fazer isso, a janela recebe mensagens somente para eventos de mouse que ocorrem quando o cursor do mouse está dentro da parte visível da janela.When a background window attempts to do so, the window receives messages only for mouse events that occur when the mouse cursor is within the visible portion of the window. Além disso, mesmo que a janela em primeiro plano tenha capturado o mouse, o usuário ainda poderá clicar em outra janela, colocando-a em primeiro plano.Also, even if the foreground window has captured the mouse, the user can still click another window, bringing it to the foreground.

Quando o mouse é capturado, as teclas de atalho não funcionam.When the mouse is captured, shortcut keys should not work.

Segurança

UIPermission
para todas as janelas para definir esse valor de propriedade.for all windows to set this property value. Enumeração associada: AllWindowsAssociated enumeration: AllWindows

Aplica-se a

Veja também