Control.Capture 속성

정의

컨트롤이 마우스를 캡처했는지를 나타내는 값을 가져오거나 설정합니다.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

속성 값

컨트롤이 마우스를 캡처했으면 true이고, 그렇지 않으면 false입니다.true if the control has captured the mouse; otherwise, false.

특성

예제

다음 코드 예제는 Capture 속성입니다.The following code example demonstrates the Capture property. 이 예제를 실행 하려면 다음 코드를 label1 이라는 Label 및 listbox1 및 listbox2 라는 두 개의 ListBox 컨트롤을 포함 하는 형식으로 붙여넣습니다.To run this example paste the following code in a form containing a Label named label1 and two ListBox controls named listbox1 and listbox2. 이 예제의 폼 및 컨트롤 ' MouseDown ' 이벤트가 메서드와 연결 되어 있는지 확인 하세요.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

설명

컨트롤은 마우스를 캡처 했을 때 커서가 테두리 내에 있는지 여부에 관계 없이 마우스 입력을 수신 합니다.When a control has captured the mouse, it receives mouse input whether or not the cursor is within its borders. 마우스는 일반적으로 끌기 작업 중에만 캡처됩니다.The mouse is typically only captured during drag operations.

전경 창만 마우스를 캡처할 수 있습니다.Only the foreground window can capture the mouse. 백그라운드 창에서이 작업을 수행 하려고 하면 창이 창의 표시 되는 부분 내에 있을 때 발생 하는 마우스 이벤트에 대 한 메시지만 수신 합니다.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. 또한 전경 창에서 마우스를 캡처한 경우에도 사용자는 다른 창을 클릭 하 여 전경으로 가져올 수 있습니다.Also, even if the foreground window has captured the mouse, the user can still click another window, bringing it to the foreground.

마우스를 캡처하면 바로 가기 키가 작동 하지 않습니다.When the mouse is captured, shortcut keys should not work.

보안

UIPermission
모든 창에서이 속성 값을 설정 합니다.for all windows to set this property value. 연결 된 열거형: AllWindowsAssociated enumeration: AllWindows

적용 대상

추가 정보