정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

PointerPoint Class

단일 마우스, 펜/스타일러스 또는 터치점과 관련된 입력 포인터의 기본 속성을 제공합니다.

대부분의 경우, 선택한 Windows 8 언어 프레임워크(JavaScript로 작성된 Windows 스토어 앱, C++, C# 또는 Visual Basic으로 작성된 Windows 스토어 앱 또는 DirectX with C++로 작성된 Windows 스토어 앱)의 포인터 이벤트 처리기를 통해 포인터 정보를 얻는 것이 좋습니다.

이벤트 인수에서 해당 앱에 필요한 포인터 세부 정보를 노출하지 않는 경우 사용자는 getCurrentPointgetIntermediatePoints 메서드 또는 currentPointintermediatePoints 속성을 통해 이벤트 인수에서 확장 포인터 데이터에 대한 액세스 권한을 가져올 수 있습니다. 포인터 데이터의 컨텍스트를 지정할 수 있으므로 getCurrentPointgetIntermediatePoints 메서드를 사용하는 것이 좋습니다.

정적 PointerPoint 메서드인 GetCurrentPointGetIntermediatePoints는 항상 앱의 컨텍스트를 사용합니다.

구문


var pointerPoint = Windows.UI.Input.PointerPoint;

특성

[MarshalingBehavior(None)]
[Version(0x06020000)]

멤버

PointerPoint클래스에는 다음과 같은 형식의 멤버가 있습니다.

메서드

The PointerPoint 클래스 - 이러한 메서드가 있습니다. C#, Visual Basic 및 C++에서는 다음 위치의 메서드도 상속합니다. Object 클래스.

메서드Description
GetCurrentPoint(UInt32) Retrieves position and state information for the specified pointer.
GetCurrentPoint(UInt32, IPointerPointTransform) Retrieves the transformed information for the specified pointer.
GetIntermediatePoints(UInt32) Retrieves position and state information for the specified pointer, from the last pointer event up to and including the current pointer event.
GetIntermediatePoints(UInt32, IPointerPointTransform) Retrieves the transformed position and state information for the specified pointer, from the last pointer event up to and including the current pointer event.

 

속성

PointerPoint클래스 - 이러한 속성이 있습니다.

속성사용 권한Description

FrameId

읽기 전용Gets the ID of an input frame.

IsInContact

읽기 전용Gets a value that indicates whether the physical entity (touch, pen/stylus, or mouse button) is pressed down.

PointerDevice

읽기 전용Gets information about the device associated with the input pointer.

PointerId

읽기 전용Gets a unique identifier for the input pointer.

Position

읽기 전용Gets the location of the pointer input in client coordinates.

Properties

읽기 전용Gets extended information about the input pointer.

RawPosition

읽기 전용Gets the raw location of the pointer input in client coordinates.

Timestamp

읽기 전용Gets the time when the input occurred.

 

설명

PointerPoint 클래스는 IPointerPoint를 구현합니다.

Properties를 통해 액세스할 수 있는 확장 속성은 PointerPointProperties를 참조하십시오.

참고  : 이 클래스는 Agile 클래스가 아닙니다. 즉, 이 클래스의 스레딩 모델 및 마샬링 동작을 고려해야 합니다. 자세한 내용은 스레딩 및 마샬링(C++/CX)다중 스레드 환경에서 Windows 런타임 개체 사용(.NET)을 참조하십시오.

예제

다음 예제에서 PointerPoint 개체를 사용하여 다양한 포인터 속성을 쿼리합니다.


// Get extended pointer data.
function queryPointer(e) {
    // We get the extended pointer info through the getCurrentPoint method
    // of the event argument. (We recommend using getCurrentPoint 
    // to ensure the coordinate space is in relation to the target.)
    // Note: getCurrentPoint and currentPoint are only available in the 
    // local compartment, they are not available in the web compartment.
    var pt = e.getCurrentPoint(e.currentTarget);
    var ptTargetProperties = pt.properties;

    var details = "Pointer Id: " + e.pointerId;
    switch (e.pointerType) {
        case "mouse":
            details += "\nPointer type: mouse";
            details += "\nLeft button: " + ptTargetProperties.isLeftButtonPressed;
            details += "\nRight button: " + ptTargetProperties.isRightButtonPressed;
            details += "\nWheel button: " + ptTargetProperties.isMiddleButtonPressed;
            details += "\nX1 button: " + ptTargetProperties.isXButton1Pressed;
            details += "\nX2 button: " + ptTargetProperties.isXButton2Pressed;
            break;
        case "pen":
            details += "\nPointer type: pen";
            if (pt.isInContact) {
                details += "\nPressure: " + ptTargetProperties.pressure;
                details += "\nrotation: " + ptTargetProperties.rotation;
                details += "\nTilt X: " + ptTargetProperties.tiltX;
                details += "\nTilt Y: " + ptTargetProperties.tiltY;
                details += "\nBarrel button pressed: " + ptTargetProperties.isBarrelButtonPressed;
            }
            break;
        case "touch":
            details += "\nPointer type: touch";
            details += "\nPressure: " + ptTargetProperties.pressure;
            details += "\nrotation: " + ptTargetProperties.rotation;
            details += "\nTilt X: " + ptTargetProperties.tiltX;
            details += "\nTilt Y: " + ptTargetProperties.tiltY;
            break;
        default:
            details += "\nPointer type: " + "n/a";
            break;
    }
    details += "\nPointer location (target): " + e.offsetX + ", " + e.offsetY;
    details += "\nPointer location (screen): " + e.screenX + ", " + e.screenY;

    return details;
}


요구 사항

지원되는 최소 클라이언트

Windows 8 [Windows 스토어 앱만]

지원되는 최소 서버

Windows Server 2012 [Windows 스토어 앱만]

지원되는 최소 전화

Windows Phone 8

Namespace

Windows.UI.Input
Windows::UI::Input [C++]

Metadata

Windows.winmd

참고 항목

참조
Windows.UI.Input 클래스
Windows.Devices.Input
Windows.UI.Core
Windows.UI.Input
Windows.UI.Input.Inking
Windows.UI.Xaml.Input
TypedEventHandler
개념
사용자 상호 작용에 응답
일반적인 사용자 조작에 대한 지침
Windows 스토어 앱 개발(JavaScript 및 HTML)
JavaScript에서 Windows 런타임 사용
터치 조작 방식 디자인
샘플(DOM)
HTML 스크롤, 이동 및 확대/축소 샘플
입력: DOM 포인터 이벤트 처리 샘플
입력: 인스턴스화할 수 있는 제스처 샘플
샘플(Windows 스토어 앱 API)
입력: 장치 기능 샘플
입력: 잉크 샘플
입력: 조작 및 제스처(JavaScript) 샘플
입력: 간단한 잉크 샘플
입력: Windows 8 제스처 샘플
입력: XAML 사용자 입력 이벤트 샘플
XAML 스크롤, 이동 및 확대/축소 샘플
샘플(DirectX)
DirectX 터치 입력 샘플
입력: 조작 및 제스처(C++) 샘플
입력: 터치 적중 테스트 샘플
샘플(Win32/데스크톱)
입력 소스 식별 샘플
터치 주입 샘플
Win32 터치 적중 테스트 샘플

 

 

표시:
© 2014 Microsoft. All rights reserved.