Geometry クラス

定義

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

public ref class Geometry : DependencyObject
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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
派生
属性

注釈

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

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

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

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

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

GeometryShape

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 は、実用的なジオメトリのさまざまなカテゴリを定義するいくつかの派生クラスの親クラスです。

プロパティ

Bounds

Geometry の軸揃え境界ボックスを指定する Rect を取得します。

Dispatcher

常に Windows アプリ SDK アプリで を返しますnull。 代わりに DispatcherQueue を使用してください。

(継承元 DependencyObject)
DispatcherQueue

このオブジェクトが DispatcherQueue 関連付けられている を取得します。 は DispatcherQueue 、コードが 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)

適用対象

こちらもご覧ください