Geometry クラス

リファレンス

定義

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

重要

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

編集

幾何学図形を定義するオブジェクトの基本クラスを提供します。 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

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

Microsoft.UI.Xaml.Media.GeometryGroup

Microsoft.UI.Xaml.Media.LineGeometry

Microsoft.UI.Xaml.Media.PathGeometry

Microsoft.UI.Xaml.Media.RectangleGeometry

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

注釈

Geometry を受け取るプロパティの場合は、XAML のオブジェクト要素として、またはコードの定義済みインスタンスとして、Geometry の非派生型を指定する必要があります。詳細については、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	常に 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)

適用対象