CaptureMouse 메서드
문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

UIElement.CaptureMouse 메서드

마우스 캡처를 UIElement로 설정합니다.

네임스페이스:  System.Windows
어셈블리:  System.Windows(System.Windows.dll)

public bool CaptureMouse()

반환 값

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

마우스를 캡처한 개체는 마우스 포인터가 해당 경계 영역 내에 있는지 여부에 관계없이 마우스 입력을 받습니다. 마우스는 일반적으로 끌기 작업을 시뮬레이션하는 동안에만 캡처됩니다. 마우스 캡처를 해제하려면 캡처를 보유한 개체에서 ReleaseMouseCapture 메서드를 호출합니다.

다음 조건을 모두 만족하는 경우 마우스를 캡처할 수 있습니다.

  • 마우스 포인터가 Silverlight 플러그 인 콘텐츠 영역 위에 있습니다.

  • 다른 Silverlight 개체가 마우스를 캡처하지 않았습니다.

  • Silverlight 개체가 아닌 다른 개체가 네이티브 또는 스크립팅 수준에서 마우스를 캡처하지 않았습니다. 이러한 마우스 캡처는 브라우저에서 마우스 포인터가 Silverlight 영역이 아닌 다른 영역으로 나갈 경우 스크립팅에 의해 발생할 수 있습니다.

  • 마우스 왼쪽 단추를 누른 상태입니다.

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

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

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

CaptureMouse 를 호출하는 UIElement는 UI에서 적중 테스트를 볼 수 있어야 합니다. 즉, IsHitTestVisiblefalse이 될 수 없습니다. 자세한 내용은 적중 테스트 및 입력 이벤트을 참조하십시오.

Silverlight

5, 4, 3에서 지원

Windows Phone용 Silverlight

Windows Phone OS 7.1, Windows Phone OS 7.0에서 지원

Silverlight에서 지원되는 운영 체제 및 브라우저에 대한 자세한 내용은 지원되는 운영 체제 및 브라우저을 참조하십시오.

커뮤니티 추가 항목

추가
표시:
© 2016 Microsoft