내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

PointerPointProperties Class

PointerPoint 개체에 대한 다양한 속성을 제공합니다.

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

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

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

구문


var pointerPointProperties = Windows.UI.Input.PointerPoint.properties;

특성

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

멤버

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

메서드

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

메서드Description
GetUsageValue Gets the Human Interface Device (HID) usage value of the raw input.
HasUsage Gets a value that indicates whether the input data from the pointer device contains the specified Human Interface Device (HID) usage information.

 

속성

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

속성사용 권한Description

ContactRect

읽기 전용Gets the bounding rectangle of the contact area (typically from touch input).

ContactRectRaw

읽기 전용Gets the bounding rectangle of the raw input (typically from touch input).

IsBarrelButtonPressed

읽기 전용Gets a value that indicates whether the barrel button of the pen/stylus device is pressed.

IsCanceled

읽기 전용Gets a value that indicates whether the input was canceled by the pointer device.

IsEraser

읽기 전용Gets a value that indicates whether the input is from a digitizer eraser.

IsHorizontalMouseWheel

읽기 전용Gets a value that indicates whether the input is from a mouse tilt wheel.

IsInRange

읽기 전용Gets a value that indicates whether the pointer device is within detection range of a sensor or digitizer.

IsInverted

읽기 전용Gets a value that indicates whether the digitizer pen is inverted.

IsLeftButtonPressed

읽기 전용Gets a value that indicates whether the input is from the left button of a mouse or other input method.

IsMiddleButtonPressed

읽기 전용Gets a value that indicates whether the input is from the middle button of a mouse or other input method.

IsPrimary

읽기 전용Gets a value that indicates whether the input is from the primary pointer when multiple pointers are registered.

IsRightButtonPressed

읽기 전용Gets a value that indicates whether the input is from the right button of a mouse or other input method.

IsXButton1Pressed

읽기 전용Gets the pressed state of the first extended mouse button.

IsXButton2Pressed

읽기 전용Gets the pressed state of the second extended mouse button.

MouseWheelDelta

읽기 전용Gets a value (the raw value reported by the device) that indicates the change in wheel button input from the last pointer event.

Orientation

읽기 전용Gets the counter-clockwise angle of rotation around the major axis of the pointer device (the z-axis, perpendicular to the surface of the digitizer).

PointerUpdateKind

읽기 전용Gets the kind of pointer state change.

Pressure

읽기 전용Gets a value that indicates the force that the pointer device (typically a pen/stylus) exerts on the surface of the digitizer.

TouchConfidence

읽기 전용Gets a value that indicates whether the pointer device rejected the touch contact.

Twist

읽기 전용Gets the clockwise rotation in degrees of a pen device around its own major axis (such as when the user spins the pen in their fingers).

XTilt

읽기 전용Gets the plane angle between the Y-Z plane and the plane that contains the Y axis and the axis of the input device (typically a pen/stylus).

YTilt

읽기 전용Gets the plane angle between the X-Z plane and the plane that contains the X axis and the axis of the input device (typically a pen/stylus).

 

설명

PointerPointProperties 클래스는 IPointerPointProperties를 구현합니다.

참고  : 이 클래스는 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.UI.Input.PointerPoint.properties
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 터치 적중 테스트 샘플

 

 

Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2014 Microsoft