PointerPointProperties 類別

定義

命名空間:

Windows.UI.Input

提供 PointerPoint 物件的擴充屬性。

在大部分情況下，建議您透過所選 Windows 8 語言架構的指標事件處理程式取得指標資訊， (使用 JavaScript、使用 C++、C# 或 Visual Basic 的 UWP 應用程式，或使用 DirectX 搭配 C++) 的 UWP 應用程式。

如果事件自變數未公開應用程式所需的指標詳細數據，您可以透過 getCurrentPoint 和 getIntermediatePoints 方法或 currentPoint 和 intermediatePoints 屬性，從事件自變數存取擴充指標數據。 建議您使用 getCurrentPoint 和 getIntermediatePoints 方法，因為您可以指定指標數據的內容。

靜態 PointerPoint 方法 GetCurrentPoint 和 GetIntermediatePoints 一律使用應用程式的內容。

public ref class PointerPointProperties sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
class PointerPointProperties final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
public sealed class PointerPointProperties

Public NotInheritable Class PointerPointProperties

繼承

Object Platform::Object IInspectable PointerPointProperties

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

在下列範例中，我們會使用 PointerPoint 對象查詢各種擴充指標屬性。

String queryPointer(PointerPoint ptrPt)
{
    String details = "";

    switch (ptrPt.PointerDevice.PointerDeviceType)
    {
        case Windows.Devices.Input.PointerDeviceType.Mouse:
            details += "\nPointer type: mouse";
            break;
        case Windows.Devices.Input.PointerDeviceType.Pen:
            details += "\nPointer type: pen";
            if (ptrPt.IsInContact)
            {
                details += "\nPressure: " + ptrPt.Properties.Pressure;
                details += "\nrotation: " + ptrPt.Properties.Orientation;
                details += "\nTilt X: " + ptrPt.Properties.XTilt;
                details += "\nTilt Y: " + ptrPt.Properties.YTilt;
                details += "\nBarrel button pressed: " + ptrPt.Properties.IsBarrelButtonPressed;
            }
            break;
        case Windows.Devices.Input.PointerDeviceType.Touch:
            details += "\nPointer type: touch";
            details += "\nrotation: " + ptrPt.Properties.Orientation;
            details += "\nTilt X: " + ptrPt.Properties.XTilt;
            details += "\nTilt Y: " + ptrPt.Properties.YTilt;
            break;
        default:
            details += "\nPointer type: n/a";
            break;
    }

    GeneralTransform gt = Target.TransformToVisual(page);
    Point screenPoint;

    screenPoint = gt.TransformPoint(new Point(ptrPt.Position.X, ptrPt.Position.Y));
    details += "\nPointer Id: " + ptrPt.PointerId.ToString() +
        "\nPointer location (parent): " + ptrPt.Position.X + ", " + ptrPt.Position.Y +
        "\nPointer location (screen): " + screenPoint.X + ", " + screenPoint.Y;
    return details;
}

String queryPointer(PointerPoint ptrPt)
{
    String details = "";

    switch (ptrPt.PointerDevice.PointerDeviceType)
    {
        case Windows.Devices.Input.PointerDeviceType.Mouse:
            details += "\nPointer type: mouse";
            break;
        case Windows.Devices.Input.PointerDeviceType.Pen:
            details += "\nPointer type: pen";
            if (ptrPt.IsInContact)
            {
                details += "\nPressure: " + ptrPt.Properties.Pressure;
                details += "\nrotation: " + ptrPt.Properties.Orientation;
                details += "\nTilt X: " + ptrPt.Properties.XTilt;
                details += "\nTilt Y: " + ptrPt.Properties.YTilt;
                details += "\nBarrel button pressed: " + ptrPt.Properties.IsBarrelButtonPressed;
            }
            break;
        case Windows.Devices.Input.PointerDeviceType.Touch:
            details += "\nPointer type: touch";
            details += "\nrotation: " + ptrPt.Properties.Orientation;
            details += "\nTilt X: " + ptrPt.Properties.XTilt;
            details += "\nTilt Y: " + ptrPt.Properties.YTilt;
            break;
        default:
            details += "\nPointer type: n/a";
            break;
    }

    GeneralTransform gt = Target.TransformToVisual(page);
    Point screenPoint;

    screenPoint = gt.TransformPoint(new Point(ptrPt.Position.X, ptrPt.Position.Y));
    details += "\nPointer Id: " + ptrPt.PointerId.ToString() +
        "\nPointer location (parent): " + ptrPt.Position.X + ", " + ptrPt.Position.Y +
        "\nPointer location (screen): " + screenPoint.X + ", " + screenPoint.Y;
    return details;
}

備註

PointerPointProperties 類別會實作 IPointerPointProperties。

注意

這個類別不是敏捷的，這表示您必須考慮其線程模型和封送處理行為。 如需詳細資訊，請參閱線程和封送處理 (C++/CX) 和在多線程環境中使用 Windows 執行階段 物件 (.NET) 。

Microsoft 互動式輸入設備架構的核心是以通用序列總線 (USB) 人類介面裝置的標準裝置類別定義 (HID) 為基礎，由 Implementers Forum， Inc. 定義。

通用序列總線 (USB) Human Interface Device (HID) 標準會定義 Human Interface Device (HID) 的設定和通訊協定，例如鍵盤、滑鼠裝置、遊戲桿和虛擬實境裝置，人類會用來直接將數據輸入計算機。 (如需 USB HID 標準的詳細資訊，請參閱 USB 實作者論壇 網站。)

雖然 Windows 輸入架構的核心是以通用序列總線 (USB) Human Interface Device (HID) 標準為基礎，但架構不限於通用序列總線 (USB) 裝置。 輸入架構也支援序列埠裝置、i8042 埠裝置和專屬輸入設備。

屬性

ContactRect	取得聯繫人區域的周框 (通常是從觸控輸入) 。
ContactRectRaw	取得原始輸入 (的周框，通常是從觸控輸入) 。
IsBarrelButtonPressed	取得值，這個值表示是否按下手寫筆/手寫筆裝置的滾筒按鈕。
IsCanceled	取得值，這個值表示指標裝置是否已取消輸入。
IsEraser	取得值，這個值表示輸入是否來自畫筆橡皮擦。
IsHorizontalMouseWheel	取得值，這個值表示輸入是否來自滑鼠傾斜滾輪。
IsInRange	取得值，指出指標裝置是否在感測器或數位板的偵測範圍內， (指標繼續存在) 。
IsInverted	取得值，這個值表示數位板畫筆是否反轉。
IsLeftButtonPressed	取得值，這個值表示指標輸入是否由輸入設備的主要動作模式觸發。
IsMiddleButtonPressed	取得值，這個值表示指標輸入是否由輸入裝置的第三個動作模式觸發。
IsPrimary	取得值，這個值表示當註冊多個指標時，輸入是否來自主要指標。
IsRightButtonPressed	取得值，這個值表示是否由次要動作模式觸發指標輸入， (是否支援輸入裝置的) 。
IsXButton1Pressed	取得值，指出指標輸入是否由第一個擴充滑鼠按鈕觸發， (XButton1) 。
IsXButton2Pressed	取得值，這個值表示指標輸入是否由第二個擴充滑鼠按鈕觸發， (XButton2) 。
MouseWheelDelta	取得值 (裝置所報告的原始值) ，指出從最後一個指標事件變更滾輪按鈕輸入。
Orientation	取得繞著指標裝置主要軸旋轉的逆時針角度， (z 軸，垂直於數位板表面) 。 值為 0.0 度表示裝置導向數位板頂端。
PointerUpdateKind	取得指標狀態變更的種類。
Pressure	取得值，這個值表示指標裝置 (通常是手寫筆/手寫筆，) 數位板介面上的手寫筆/手寫筆。
TouchConfidence	取得值，這個值表示指標裝置是否拒絕觸控接觸。
Twist	取得畫筆裝置繞著自己的主軸的順時針旋轉角度 (，例如當使用者在手指) 旋轉手寫筆時。
XTilt	取得 Y-Z 平面與平面之間的平面角度，其中包含 Y 軸和輸入設備座標軸 (通常是畫筆/手寫筆) 。
YTilt	取得 X-Z 平面與包含 X 軸的平面與輸入設備座標軸之間的平面角度， (通常是畫筆/手寫筆) 。
ZDistance	取得與裝置無關圖元之指標的 z 座標 (或距離) 。

方法

GetUsageValue(UInt32, UInt32)	取得原始輸入的 Human Interface Device (HID) 使用量值。
HasUsage(UInt32, UInt32)	取得值，指出指標裝置中的輸入數據是否包含指定的 Human Interface Device (HID) 使用資訊。

另請參閱

• Windows.UI.Input
• Properties
• Windows.Devices.Input
• Windows.UI.Core
• Windows.UI.Input.Inking
• Windows.UI.Xaml.Input
• TypedEventHandler<TSender,TResult>
• 自訂使用者互動
• 自定義用戶互動的UX指導方針
• 觸控設計指導方針
• 使用者互動模式範例
• 焦點視覺效果範例 \(英文\)
• 輸入：裝置功能範例
• 輸入：簡化的筆跡範例
• 輸入：Windows 8 手勢範例
• 輸入：XAML 使用者輸入事件範例
• XAML 捲動、移動瀏覽和縮放範例
• DirectX 觸控輸入範例
• 輸入：操作和手勢 (C++) 範例
• 輸入：觸控點擊測試範例
• 輸入來源識別範例
• 觸控插入範例
• Win32 觸控點擊測試範例