UIElement.CaptureMouse 메서드

2013-12-13

터치 캡처를 UIElement로 설정합니다.

Namespace:  System.Windows
어셈블리:  System.Windows(System.Windows.dll)

public bool CaptureMouse()

반환 값

형식: System.Boolean
개체에 터치 캡처가 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

터치 입력을 캡처 중인 개체는 사용자 손가락이 해당 경계 영역 내에 있는지 여부에 관계없이 터치 입력을 수신합니다. 터치 입력은 일반적으로 끌기 작업을 시뮬레이션하는 동안에만 캡처됩니다. 터치 캡처를 해제하려면 캡처를 보유한 개체에서 ReleaseMouseCapture 메서드를 호출합니다.

다음 조건을 모두 충족하는 경우 터치 입력을 캡처할 수 있습니다.

  • 터치 입력을 캡처 중인 다른 개체가 없습니다.

  • 사용자 손가락이 실제로 화면을 터치 중입니다.

이러한 조건 중 하나라도 충족되지 않을 경우 CaptureMousefalse를 반환합니다.

초기 CaptureMouse 호출에서 true를 반환하고 성공적으로 터치 입력을 캡처 중인 경우 다음부터 같은 개체에 대해 CaptureMouse를 호출하면 조건이 변경되지 않는 한 계속해서 true가 반환됩니다. 개체가 이미 캡처를 보유한 경우 CaptureMouse는 다른 어떤 것도 반환하지 않습니다. 응용프로그램의 요구 사항에 따라서는 개체의 캡처 보유 여부를 추적하는 변수를 설정하거나 현재 캡처가 있는 특정 개체에 대한 참조를 제공하는 것이 유용할 수도 있습니다. 이 방법을 사용할 경우 각 CaptureMouse 호출에서 변수를 설정하고 각 ReleaseMouseCapture 호출에서 변수를 삭제합니다.

UIElement 파생 개체만 터치 입력을 캡처할 수 있습니다. 시각적 특성이 있지만 터치 입력을 캡처할 수 없는 개체의 대표적인 예로는 Run(부모 TextBlock만 캡처 가능) 및 기하 도형(부모Path만 캡처 가능)이 있습니다.

CaptureMouse를 호출하는 UIElement는 UI에서 적중 테스트를 볼 수 있어야 합니다. 즉, IsHitTestVisiblefalse가 될 수 없습니다.

Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

표시:
© 2014 Microsoft