情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

ポイント Structure

2 次元平面内で点を定義する、x 座標と y 座標の順序付きペアを表します。

構文


var point = {
    x : /* 独自の値 */,
    y : /* 独自の値 */
}


<object property="X,Y"/>
-or
<object property="X Y"/>

XAML Values

X

Point 値の x 座標コンポーネント。

Y

Point 値の y 座標コンポーネント。

属性

[Version(0x06020000)]

メンバー

Point構造体 には次の種類のメンバーがあります。

コンストラクター

Point構造体 にはこれらのコンストラクターがあります。

コンストラクター説明
Point [C#, VB]Initializes a Point structure that contains the specified values.
Point [C++, JavaScript]Initializes a Point structure that contains the specified values.

 

フィールド

Point構造体 にはこれらのフィールドがあります。

フィールドデータ型説明
X | x [C++, JavaScript]

Number [JavaScript] | System.Single [.NET] | float32 [C++]

点の水平位置。

Y | y [C++, JavaScript]

Number [JavaScript] | System.Single [.NET] | float32 [C++]

点の垂直位置。

 

メソッド

The Point 構造体 には次のメソッドがあります。 With C#、Visual Basic、および C++ では、以下からもメソッドが継承されます。Object クラス.

メソッド説明
Equals(Object) [C#, VB]Determines whether the specified object is equal to a Point.
Equals(Point) [C#, VB]Compares two Point structures for equality.
GetHashCode [C#, VB]Gets a hash code for this object.
ToString [C#, VB]Converts a Point to a String representation.
ToString(IFormatProvider) [C#, VB]Creates a String representation of this Point.

 

演算子

Point構造体 にはこれらの演算子があります。

演算子説明
Equality Compares two Point structures for equality.
Inequality Compares two Point structures for inequality.

 

プロパティ

Point構造体 には次のプロパティがあります。

プロパティアクセスの種類説明

X

読み取り/書き込みGets or sets the X-coordinate value of this Point.

Y

読み取り/書き込みGets or sets the Y-coordinate value of this Point.

 

解説

Point の値は、アプリのメイン ウィンドウの平面上の座標空間を表すこともありますが、Point の値を使用するプロパティに応じて、Point の値をさまざまな他の意味に解釈できる可能性があります。

JavaScript:  JavaScript では、Point は、xy の 2 つのデータ プロパティを持つオブジェクトです。xy 以外では、Point のメンバーの一覧に記載された残りの API は JavaScript プログラミングには適用されません。

XAML 構文についてのメモ

Point 値は、Windows のランタイムの UI 要素の XAML ボキャブラリ内で、グラフィックス プロパティおよび類似の UI プロパティに幅広く使用されます。

XY の間の区切り記号としてスペースまたはコンマを使用できます。座標点では、通常コンマが区切り記号として使用されます。

Point 構造体は、ResourceDictionary 内のリソースとして宣言することはできません。

一部の XAML 使用には、論理点を表すために Point 型を使用します。「解説」の「論理点」を参照してください。

Point のプロジェクションとメンバー

Microsoft .NET 言語 (C# または Microsoft Visual Basic) または Visual C++ コンポーネント拡張機能 (C++/CX) を使用する場合、Point では非データ メンバーを使用でき、そのデータ メンバーはフィールドではなく、読み取り/書き込みプロパティとして公開されます。

Windows テンプレート ランタイム ライブラリ (WRL) を使用し、C++ でプログラミングする場合、データ メンバー フィールドのみが Point のメンバーとして存在し、メンバーの表に示されたユーティリティ メソッドやプロパティを使用することはできません。WRL コードは、PointHelper 静的クラスから使用できる類似のユーティリティ メソッドにアクセスできます。

ポイント値とプロパティによるその解釈の方法

Point 型の一部の使用方法は、座標空間内の位置を指定することです。コンテキストに応じて、場所はコンテンツ領域の座標系内か、特定のレイアウト要素の座標系内である場合があります。

場合によっては、PointXY が整数以外の値になる可能性があります。

場合によっては、PointXY は負の値に設定できます。通常、他に変換が行われない限り、意図的に参照フレームの外にある座標を指定する Point になります。ただし、一部の XAML プロパティにより、負の X または YPoint が無効な値として拒否されます。値の制約については、通常、プロパティのリファレンス ページで説明されています。

論理点

Windows ストア アプリで C++、C#、または Visual Basic API を使用する場合、座標系とは直接関係のない用途で Point 型が使用される場合があります。このような用途で使用される Point は論理点と呼ばれ、XY の値にはそれぞれ 0 から 1 の間 (0 と 1 を含む) を設定できます。XY の値が整数値に制限されずに、浮動小数点値にも設定できるようになっているのは、このためです。論理ポイントの値は、プレゼンテーションまたは動作の実行時の座標が別のプロパティまたは設定で指定された、または変更されたとして解釈されます。または、これらのポイントは、座標空間にまったく関連していない情報を表すこともあります。論理点の概念の例は、Animation.KeySpline (アニメーションの速度の制御)、UIElementRenderTransformOrigin、および LinearGradientBrushGradientStop.Offset 値です。

論理点の使用を表す Point 値プロパティでは、0 未満の値、または 1 を超える値が無効になる場合がありますが、この動作は実際のプロパティによって異なります。値の制約については、通常、値ではなく個々のプロパティのリファレンス ページで説明されています。

ポイント値と XAML のグラフィックス API

XAML UI の定義に使用されるグラフィックス要素は、通常、Point-value プロパティを使用してその特性を宣言します。たとえば、EllipseGeometry では、Point 値を使用して Center プロパティを設定します。

グラフィックス要素は 2 つのモデルのうちの 1 つを使用します。グラフィックス要素の一部は FrameworkElement から派生します。これらの要素には、UI に設定されて要素プロパティが割り当てられると、レンダリング動作が定義されます。このような種類の要素の例として、Rectangle および Windows.UI.Xaml.Shapes 名前空間にある他のすべての型が当てはまります。その他のグラフィックス要素は FrameworkElement から派生せず、独自のレンダリング動作はありません。代わりに、これらの要素は、レンダリング動作を持つ他の要素でプロパティの値を提供するように構成されています。たとえば、Path.Data を構成するために使用する LineSegment などのグラフィックス要素には、多くの場合 Point 値のプロパティがあります。

一部のグラフィックの要素は、単一のプロパティで表される複数の点の値を使用します。これらのプロパティは、PointCollection 型を使用します。これらのプロパティは、複数の点の X および Y 値を取得する属性文字列を解析する XAML 構文もサポートします。PointCollection を使用するグラフィックス要素プロパティの例として、Polygon.Points があります。

XAML 入力 イベントからの、ヒット テストのためのポイント値

Point 値は、特定の入力イベントのイベント データによって返されます。たとえば、GetCurrentPoint は、Pointer イベントがアプリケーションの UI で発生した場所の座標値を提供します。一般に、これらの Point 値は、座標参照の特定のフレームを参照します。参照のこの特定のフレームを確認しておく必要があります。入力イベントの場合、参照の座標系は、画面全体ではなく、アプリケーションのメイン ウィンドウです。これによって、スナップ ビュー内にアプリケーションがある場合に一貫した参照フレームが使用できるようになります。GetCurrentPointGetPosition などの一部の API は、個々のコントロールでの入力に役立つ、要素固有の座標系に変換する方法を提供します。詳細については、「クイック スタート: ポインター」を参照してください。

XAML UI にはヒット テストと呼ばれる概念があります。ここでは、ユーティリティ メソッドを使用して、ユーザーが UI の特定の座標位置でポインター操作を実行する場合に、入力イベントがどのように供給されるかをテストできます。たとえば、FindElementsInHostCoordinates の 2 つのシグネチャは、FindSubElementsForTouchTargeting と同様に、Point 入力パラメーターを使用します。詳細については、「マウス入力への反応」を参照してください。

ポイント値のアニメーション化

Windows ランタイムは、任意のプロパティが Point を値として使用する場合に、そのプロパティの値をアニメーション化する方法を提供し、そのプロパティは依存関係プロパティとして実装されます。Point の x と y の値を個別にアニメーション化することができないため、Point には独自のアニメーション サポートが含まれます。これは構造体は依存関係プロパティをサポートできないためです。From-To アニメーションには PointAnimation 型を使用し、キー フレーム アニメーションの動作には PointAnimationUsingKeyFrames 派生型を使用します。Point 値をアニメーション化する方法およびアニメーションの動作の詳細については、「ストーリーボード アニメーション」を参照してください。

要件

最小限サポートされるクライアント

Windows 8

最小限サポートされるサーバー

Windows Server 2012

最小限サポートされる携帯電話

Windows Phone 8

名前空間

Windows.Foundation
Windows::Foundation [C++]

メタデータ

Windows.winmd
Platform.winmd

アセンブリ

System.Runtime.WindowsRuntime.dll

参照

PointAnimation
PointCollection
クイックスタート: ポインター
クイック スタート: 図形の描画

 

 

表示: