Geometry クラス

リファレンス

定義

名前空間:: Windows.UI.Xaml.Media

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

幾何学図形を定義するオブジェクトの基本クラスを提供します。 Geometry オブジェクトは、クリッピング領域に使用でき、2 次元グラフィカルデータを Path としてレンダリングするためのジオメトリ定義として使用できます。

public ref class Geometry : DependencyObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Geometry : DependencyObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Geometry : DependencyObject

Public Class Geometry
Inherits DependencyObject

継承: Object Platform::Object IInspectable DependencyObject Geometry

派生: Windows.UI.Xaml.Media.EllipseGeometry

Windows.UI.Xaml.Media.GeometryGroup

Windows.UI.Xaml.Media.LineGeometry

Windows.UI.Xaml.Media.PathGeometry

Windows.UI.Xaml.Media.RectangleGeometry

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイスファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

Geometry を受け取るプロパティの場合は、非abstract 派生型の Geometry を XAML のオブジェクト要素として指定するか、コードの定義済みインスタンスとして指定する必要があります。詳細については、「EllipseGeometry、GeometryGroup、LineGeometry、PathGeometry、RectangleGeometry のリファレンスページ」を参照してください。

ジオメトリは、"単純" または "複雑" として概念化できます。 EllipseGeometry、 LineGeometry、 RectangleGeometry は単純なジオメトリであり、基本的な座標または寸法プロパティを持つ 1 つの要素として幾何学的図形を指定します。 GeometryGroup と PathGeometry は複雑なジオメトリです。 GeometryGroup は、子オブジェクトとして保持されている他のジオメトリを結合します。 PathGeometry では、入れ子になった図形/セグメントパス定義要素のセット、またはデザイナーによって通常出力されるコンパクトな文字列構文を使用して、ジオメトリの複雑なパスを記述します。

Geometry は、 UIElement 自体ではなく、レンダリング効果を引き起こすために UIElement のプロパティ値として指定する必要がある点で、独自のレンダリングを完全に定義するわけではありません。通常、Geometry はパス ( Shape の一種) のデータとして提供されます。

PathIcon.Data プロパティは Geometry を受け取ります。実際には、パスに対して PathGeometry を指定し、その Figures プロパティ値をパスのコンパクト文字列構文で表します。

GeometryCollection は、Geometry アイテムの厳密に型指定されたコレクションです。 GeometryGroup.Children プロパティは GeometryCollection を使用します。

Geometry と Shape

Shape クラスには、Geometry とその派生クラスに欠けている Fill、Stroke、およびその他のレンダリングプロパティがあります。 Shape クラスは FrameworkElement であるため、レイアウトシステムに参加します。その派生クラスは、UIElement 子をサポートする任意の要素のコンテンツとして使用できます。一方、Geometry クラスは、ジオメトリをグラフィックスプリミティブとして定義するだけで、それ自体をレンダリングすることはできません。 Geometry で有効になっている基本的なグラフィックスプリミティブ式が定義として役立つカスタム UI 要素プロパティのプロパティ型として Geometry を使用することも考えられます。

UIElement.Clip の Geometry

Windows ランタイムの UIElement.Clip プロパティの値を指定するには、Geometry 派生型ではなく RectangleGeometry を特に使用する必要があります。他の XAML フレームワークから XAML またはコードを移植する場合は、RectangleGeometry を使用するように UIElement.Clip を変更できるかどうかを確認します。それ以外の場合は、Z オーダーリレーションシップを変更し、"クリッピング" 部分のアルファ透過性を持つ変更された RenderTargetBitmap ソースを使用した ImageBrush のオーバーレイなどの手法を使用する必要がある場合があります。

Geometry 派生クラス

Geometry は、実用的なジオメトリのさまざまなカテゴリを定義するいくつかの派生クラスの親クラスです。

EllipseGeometry
GeometryGroup - 複数のジオメトリを子として指定するために使用できます
LineGeometry
PathGeometry - この型は、他の "単純な" ジオメトリ型で表現できない任意のジオメトリに使用します
RectangleGeometry

プロパティ

Bounds	Geometry の軸揃え境界ボックスを指定する Rect を取得します。
Dispatcher	このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の DependencyObject にアクセスできる機能を表します。 (継承元 DependencyObject)
Empty	空の geometry オブジェクトを取得します。
StandardFlatteningTolerance	多角形近似に使用する標準の許容範囲を取得します。
Transform	Geometry に適用される Transform オブジェクトを取得または設定します。
TransformProperty	Transform 依存関係プロパティを識別します。

メソッド

ClearValue(DependencyProperty)	依存関係プロパティのローカル値をクリアします。 (継承元 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	依存関係プロパティに対して確立された基本値を返します。これは、アニメーションがアクティブでない場合に適用されます。 (継承元 DependencyObject)
GetValue(DependencyProperty)	DependencyObject から依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject)
ReadLocalValue(DependencyProperty)	ローカル値が設定されている場合は、依存関係プロパティのローカル値を返します。 (継承元 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	この DependencyObject インスタンスの特定の DependencyProperty に対する変更をリッスンするための通知関数を登録します。 (継承元 DependencyObject)
SetValue(DependencyProperty, Object)	DependencyObject の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	RegisterPropertyChangedCallback を呼び出して以前に登録した変更通知を取り消します。 (継承元 DependencyObject)

適用対象

次の方法で共有