PointerPoint 類別

定義

命名空間:

Microsoft.UI.Input

提供與單一滑鼠、觸控筆或觸控觸控筆相關的輸入指標基本屬性。

public ref class PointerPoint sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PointerPoint final

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PointerPoint

Public NotInheritable Class PointerPoint

繼承

Object Platform::Object IInspectable PointerPoint

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

範例

在以下範例中，我們使用 PointerPoint 物件查詢各種指標屬性。

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

    switch (ptrPt.PointerDeviceType)
    {
        case PointerDeviceType.Mouse:
            details += "\nPointer type: mouse";
            break;
        case 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 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;
    }

    details += "\nPointer Id: " + ptrPt.PointerId.ToString() +
        "\nPointer location: " + ptrPt.Position.X + ", " + ptrPt.Position.Y;

    return details;
}

備註

請參閱 PointerPointProperties 以了解透過 Properties 可存取的擴展屬性。

PointerPoint 座標空間依賴於其擷取的上下文。 從 PointerRoutedEventArgs.GetCurrent Point 檢索時，指標的座標會相對於提供的 UIElement （單位為裝置無關像素）。

屬性

名稱	Description
FrameId	取得輸入幀的 ID。
IsInContact	會得到一個數值，表示輸入裝置（觸控、觸控筆/觸控筆）是在按下（觸摸）觸控面板，還是滑鼠按鍵被按下。
PointerDeviceType	取得與輸入指標相關的輸入裝置類型。
PointerId	會獲得輸入指標的唯一識別碼。
Position	取得輸入指標的位置。
Properties	會獲得關於輸入指標的延伸資訊。
Timestamp	讀取輸入發生的時間。

方法

名稱	Description
GetTransformedPoint(IPointerPointTransform)	透過應用程式定義的轉換轉換當前的 PointerPoint 物件，取得新的 PointerPoint 物件。

另請參閱

• PointerPointProperties
• PointerRoutedEventArgs