PointerPoint 類別

定義

命名空間:

Windows.UI.Input

提供與單一滑鼠、畫筆/手寫筆或觸控接觸點相關聯的輸入指標基本屬性。

public ref class PointerPoint sealed

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

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

Public NotInheritable Class PointerPoint

繼承

Object Platform::Object IInspectable PointerPoint

屬性

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;
}

備註

PointerPoint 類別會實作 IPointerPoint。

如需可透過 Properties 存取的擴充屬性，請參閱 PointerPointProperties。

在大部分情況下，建議您透過所選語言架構中指標事件處理程式的事件自變數取得指標資訊。

如果事件自變數未以內部方式公開應用程式所需的指標詳細數據，您可以透過 PointerRoutedEventArgs 的 GetCurrentPoint 和 GetIntermediatePoints 方法來存取擴充指標數據。 使用這些方法來指定指標數據的內容。

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

注意

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

屬性

FrameId	取得輸入框架的識別碼。
IsInContact	取得值，這個值表示輸入設備 (觸控、手寫筆/手寫筆) 觸碰數位板表面，還是按下滑鼠按鈕。
PointerDevice	取得與輸入指標相關聯之裝置的相關信息。
PointerId	取得輸入指標的唯一標識碼。
Position	取得用戶端座標中指標輸入的位置。
Properties	取得有關輸入指標的擴充資訊。
RawPosition	取得輸入指標的用戶端座標，如輸入設備所報告。
Timestamp	取得輸入發生的時間。

方法

GetCurrentPoint(UInt32)	擷取指定指標的位置和狀態資訊。 在大部分情況下，建議您透過所選語言架構中指標事件處理程式的事件自變數取得指標資訊， (使用 JavaScript、使用 C++、C# 或 Visual Basic 的 UWP 應用程式，或使用 DirectX 搭配 C++ 的 UWP 應用程式) 。 如果事件自變數未以內部方式公開應用程式所需的指標詳細數據，您可以透過 PointerRoutedEventArgs 的 GetCurrentPoint 和 GetIntermediatePoints 方法來存取擴充指標數據。 使用這些方法來指定指標數據的內容。 靜態 PointerPoint 方法 GetCurrentPoint 和 GetIntermediatePoints 一律使用應用程式內容。
GetCurrentPoint(UInt32, IPointerPointTransform)	擷取指定指標的轉換資訊。 在大部分情況下，建議您透過所選語言架構中指標事件處理程式的事件自變數取得指標資訊， (使用 JavaScript、使用 C++、C# 或 Visual Basic 的 UWP 應用程式，或使用 DirectX 搭配 C++ 的 UWP 應用程式) 。 如果事件自變數未以內部方式公開應用程式所需的指標詳細數據，您可以透過 PointerRoutedEventArgs 的 GetCurrentPoint 和 GetIntermediatePoints 方法來存取擴充指標數據。 使用這些方法來指定指標數據的內容。 靜態 PointerPoint 方法 GetCurrentPoint 和 GetIntermediatePoints 一律使用應用程式內容。
GetIntermediatePoints(UInt32)	擷取指定指標的位置和狀態資訊，從最後一個指標事件到 目前指標事件為止。 在大部分情況下，建議您透過所選語言架構中指標事件處理程式的事件自變數取得指標資訊， (使用 JavaScript、使用 C++、C# 或 Visual Basic 的 UWP 應用程式，或使用 DirectX 搭配 C++ 的 UWP 應用程式) 。 如果事件自變數未以內部方式公開應用程式所需的指標詳細數據，您可以透過 PointerRoutedEventArgs 的 GetCurrentPoint 和 GetIntermediatePoints 方法來存取擴充指標數據。 使用這些方法來指定指標數據的內容。 靜態 PointerPoint 方法 GetCurrentPoint 和 GetIntermediatePoints 一律使用應用程式內容。
GetIntermediatePoints(UInt32, IPointerPointTransform)	擷取指定指標的轉換位置和狀態資訊，從最後一個指標事件到 目前指標事件為止。 在大部分情況下，建議您透過所選語言架構中指標事件處理程式的事件自變數取得指標資訊， (使用 JavaScript、使用 C++、C# 或 Visual Basic 的 UWP 應用程式，或使用 DirectX 搭配 C++ 的 UWP 應用程式) 。 如果事件自變數未以內部方式公開應用程式所需的指標詳細數據，您可以透過 PointerRoutedEventArgs 的 GetCurrentPoint 和 GetIntermediatePoints 方法來存取擴充指標數據。 使用這些方法來指定指標數據的內容。 靜態 PointerPoint 方法 GetCurrentPoint 和 GetIntermediatePoints 一律使用應用程式內容。

另請參閱

• Windows.UI.Input
• 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 觸控點擊測試範例
• 基本輸入範例 (Windows 10)