Mouse.Capture 메서드

정의

네임스페이스:

System.Windows.Input

어셈블리:

PresentationCore.dll

지정한 요소로 마우스 입력을 캡처합니다.

오버로드

Capture(IInputElement)	지정한 요소로 마우스 입력을 캡처합니다.
Capture(IInputElement, CaptureMode)	지정한 CaptureMode를 사용하여 지정한 요소로 마우스 입력을 캡처합니다.

설명

요소가 마우스를 캡처하면 커서가 테두리 내에 있는지 여부에 관계없이 마우스 입력을 받습니다.

를 CaptureMode 지정하지 않으면 기본값 CaptureMode 은 입니다 Element.

마우스 캡처를 해제하려면 캡처할 요소로 전달 null 을 호출 Capture 합니다.

또는 MouseUp 이벤트가 발생할 때 MouseDown 마우스가 캡처되고 입력이 마우스 PreviewMouseDownOutsideCapturedElement 아래의 요소로 가지 않는 경우 먼저 PreviewMouseUpOutsideCapturedElement 발생합니다. 이렇게 하면 캡처된 요소가 및 MouseUp 이벤트가 라우팅되기 전에 캡처를 MouseDown 해제할 수 있습니다.

Capture(IInputElement)

지정한 요소로 마우스 입력을 캡처합니다.

public:
 static bool Capture(System::Windows::IInputElement ^ element);

public static bool Capture (System.Windows.IInputElement element);

static member Capture : System.Windows.IInputElement -> bool

Public Shared Function Capture (element As IInputElement) As Boolean

매개 변수

element

IInputElement

마우스를 캡처할 요소입니다.

반환

Boolean

요소에 마우스가 캡처되었으면 true이고, 그렇지 않으면 false입니다.

예제

다음 예제에서는 메서드를 사용하여 특정 요소에 마우스를 캡처하는 Capture 방법을 보여 있습니다.

private void OnCaptureMouseRequest(object sender, RoutedEventArgs e)
{
    Mouse.Capture(_elementToCapture);
}

Private Sub OnCaptureMouseRequest(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Mouse.Capture(_elementToCapture)
End Sub

설명

요소가 마우스를 캡처하면 커서가 테두리 내에 있는지 여부에 관계없이 마우스 입력을 받습니다.

를 CaptureMode 지정하지 않으면 기본값 CaptureMode 은 입니다 Element.

마우스 캡처를 해제하려면 캡처할 요소로 전달 null 을 호출 Capture 합니다.

또는 MouseUp 이벤트가 발생할 때 MouseDown 마우스가 캡처되고 입력이 마우스 PreviewMouseDownOutsideCapturedElement 아래의 요소로 가지 않는 경우 먼저 PreviewMouseUpOutsideCapturedElement 발생합니다. 이렇게 하면 캡처된 요소가 및 MouseUp 이벤트가 라우팅되기 전에 캡처를 MouseDown 해제할 수 있습니다.

Capture(IInputElement, CaptureMode)

지정한 CaptureMode를 사용하여 지정한 요소로 마우스 입력을 캡처합니다.

public:
 static bool Capture(System::Windows::IInputElement ^ element, System::Windows::Input::CaptureMode captureMode);

public static bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);

static member Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool

Public Shared Function Capture (element As IInputElement, captureMode As CaptureMode) As Boolean

매개 변수

element

IInputElement

마우스를 캡처할 요소입니다.

captureMode

CaptureMode

사용할 캡처 정책입니다.

반환

Boolean

요소에 마우스가 캡처되었으면 true이고, 그렇지 않으면 false입니다.

예제

다음 예제에서는 메서드를 사용하여 특정 요소에 마우스를 캡처하는 Capture 방법을 보여 있습니다.

private void OnCaptureMouseRequest(object sender, RoutedEventArgs e)
{
    Mouse.Capture(_elementToCapture);
}

Private Sub OnCaptureMouseRequest(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Mouse.Capture(_elementToCapture)
End Sub

설명

요소가 마우스를 캡처하면 커서가 테두리 내에 있는지 여부에 관계없이 마우스 입력을 받습니다.

마우스 캡처를 해제하려면 캡처할 요소로 전달 null 을 호출 Capture 합니다.

또는 MouseUp 이벤트가 발생할 때 MouseDown 마우스가 캡처되고 입력이 마우스 PreviewMouseDownOutsideCapturedElement 아래의 요소로 가지 않는 경우 먼저 PreviewMouseUpOutsideCapturedElement 발생합니다. 이렇게 하면 캡처된 요소가 및 MouseUp 이벤트가 라우팅되기 전에 캡처를 MouseDown 해제할 수 있습니다.