RadialGradientBrush クラス

定義

名前空間:

Microsoft.UI.Xaml.Media

RadialGradientBrush は、放射状グラデーションで領域を塗りつぶします。 中心点はグラデーションの原点を定義し、楕円はグラデーションの外側の境界を定義します。

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="GradientStops")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class RadialGradientBrush : XamlCompositionBrushBase

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="GradientStops")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class RadialGradientBrush : XamlCompositionBrushBase

Public Class RadialGradientBrush
Inherits XamlCompositionBrushBase

継承

Object IInspectable DependencyObject Brush XamlCompositionBrushBase RadialGradientBrush

属性

MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

例

ヒント

詳細、設計ガイダンス、およびコード例については、「 XAML ブラシ」を参照してください。

WinUI 3 ギャラリー アプリを開き、RadialGradientBrush の動作を確認します。

WinUI 3 ギャラリー アプリには、ほとんどの WinUI 3 コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを入手するか、GitHub でソース コードを取得します。

次の例では、6 つのグラデーション位置を持つ放射状グラデーションを作成し、それを使用して四角形を描画します。

<Page
  xmlns:media="using:Microsoft.UI.Xaml.Media">

  <Rectangle Width="200" Height="200">
      <Rectangle.Fill>
          <media:RadialGradientBrush>
              <GradientStop Color="Blue" Offset="0.0" />
              <GradientStop Color="Yellow" Offset="0.2" />
              <GradientStop Color="LimeGreen" Offset="0.4" />
              <GradientStop Color="LightBlue" Offset="0.6" />
              <GradientStop Color="Blue" Offset="0.8" />
              <GradientStop Color="LightGray" Offset="1" />
          </media:RadialGradientBrush>
      </Rectangle.Fill>
  </Rectangle>

</Page>

次の使用例は、、、 のカスタム値を持つ絶対マッピング モードを使用する放射状グラデーションをCenterRadiusXRadiusY作成します。GradientOrigin

<Page
  xmlns:media="using:Microsoft.UI.Xaml.Media">

  <Rectangle Width="200" Height="200">
      <Rectangle.Fill>
          <media:RadialGradientBrush
            MappingMode="Absolute"
            Center="50,50"
            RadiusX="100"
            RadiusY="100"
            GradientOrigin="100,50"
            >
              <GradientStop Color="Yellow" Offset="0.0" />
              <GradientStop Color="Blue" Offset="1" />
          </media:RadialGradientBrush>
      </Rectangle.Fill>
  </Rectangle>

</Page>

注釈

グラデーションレイアウト

グラデーションは、 Center、 RadiusX、 RadiusY の各プロパティによって定義される楕円内に描画されます。 グラデーションの色は楕円の中心から始まり、半径の位置で終了します。

放射状グラデーションの色は、GradientStops コレクション プロパティに追加された色の境界によって定義されます。 それぞれのグラデーション境界により、グラデーションの色とオフセットが決まります。

グラデーションの原点は既定では中央ですが、GradientOrigin プロパティを使用して指定することができます。

MappingMode は、 中心座標、 RadiusX 座標、 RadiusY 座標、 GradientOrigin 座標を相対座標と絶対座標のどちらで表すかを定義します。

MappingMode が にRelativeToBoundingBox設定されている場合、3 つのプロパティの X と Y の値は要素の境界を基準として扱われます。ここで(0,0)、左上を表し(1,1)、Center、RadiusX、RadiusY プロパティの要素境界の右下を表し(0,0)、GradientOrigin プロパティの中心を表します。

MappingMode が Absolute に設定されている場合、3 つのプロパティの X および Y 値は要素境界内の絶対座標として扱われます。

Windows 10 バージョンのサポート

グラデーション レンダリングは、Windows 10 バージョン 1903 (v10.0.18362.0) 以降でサポートされています。 以前の OS バージョンでは、 プロパティで指定された純色がブラシによって FallbackColor レンダリングされます。

XAML リソースとしてのブラシ

XAML で宣言できる 各 Brush 型 (SolidColorBrush、LinearGradientBrush、 ImageBrush) は、アプリ全体でそのブラシをリソースとして再利用できるように、リソースとして定義することを目的としています。 Brush 型に表示される XAML 構文は、 ブラシ をリソースとして定義する場合に適しています。 ブラシをリソースとして宣言する場合は、後で他の UI 定義からそのリソースを参照するために使用する x:Key 属性 も必要です。 XAML リソースの詳細と x:Key 属性の使用方法については、「 ResourceDictionary および XAML リソース参照」を参照してください。

ブラシをリソースとして宣言する利点は、UI を構築するために必要なランタイム オブジェクトの数を減らすことです。ブラシは、オブジェクト グラフの複数の部分に値を提供する共通リソースとして共有されるようになりました。

Windows ランタイム XAML コントロールの既存のコントロール テンプレート定義を見ると、テンプレートでブラシ リソースが広範囲に使用されていることがわかります (ただし、これらは通常、LinearGradientBrush ではなく SolidColorBrush です)。 これらのリソースの多くはシステム リソースであり、 {StaticResource} マークアップ拡張機能 ではなく、リソース参照に {ThemeResource} マークアップ拡張機能を使用します。 独自のコントロール テンプレート XAML でシステム リソース ブラシを使用する方法の詳細については、「 XAML テーマ リソース」を参照してください。

コンストラクター

RadialGradientBrush()

RadialGradientBrush クラスの新しいインスタンスを初期化します。

プロパティ

Center	グラデーションを含む楕円の中心を取得または設定します。
CenterProperty	Center 依存関係プロパティを識別します。
CompositionBrush	この XAML ブラシで使用される CompositionBrush を取得または設定します。 (継承元 XamlCompositionBrushBase)
Dispatcher	常に Windows アプリ SDK アプリで を返しますnull。 代わりに DispatcherQueue を使用してください。 (継承元 DependencyObject)
DispatcherQueue	このオブジェクトが DispatcherQueue 関連付けられている を取得します。 は DispatcherQueue 、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の にアクセス DependencyObject できる機能を表します。 (継承元 DependencyObject)
FallbackColor	CompositionBrush をレンダリングできない場合にレンダリングに使用する色。 (継承元 XamlCompositionBrushBase)
GradientOrigin	グラデーションの原点 (左上隅からの相対位置) を取得または設定します。
GradientOriginProperty	GradientOrigin 依存関係プロパティを識別します。
GradientStops	ブラシのグラデーションの分岐点を取得または設定します。
InterpolationSpace	グラデーションの色の補間に使用する色空間を取得または設定します。
InterpolationSpaceProperty	InterpolationSpace 依存関係プロパティを識別します。
MappingMode	グラデーション ブラシの配置座標が出力領域に対して絶対座標か相対座標かを取得または設定します。
MappingModeProperty	MappingMode 依存関係プロパティを識別します。
Opacity	ブラシの不透明度を取得または設定 します。 (継承元 Brush)
RadiusX	グラデーションを含む楕円の X 軸の半径を取得または設定します。
RadiusXProperty	RadiusX 依存関係プロパティを識別します。
RadiusY	グラデーションを含む楕円の Y 軸の半径を取得または設定します。
RadiusYProperty	RadiusY 依存関係プロパティを識別します。
RelativeTransform	相対座標を使用して、ブラシに適用される変換を取得または設定します。 (継承元 Brush)
SpreadMethod	オブジェクトの境界の内側で開始または終了するグラデーションの描画方法を指定するスプレッド メソッドの種類を取得または設定します。
SpreadMethodProperty	SpreadMethod 依存関係プロパティを識別します。
Transform	ブラシに適用される変換を取得または設定します。 (継承元 Brush)

メソッド

ClearValue(DependencyProperty)	依存関係プロパティのローカル値をクリアします。 (継承元 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	依存関係プロパティに対して確立された基本値を返します。これは、アニメーションがアクティブでない場合に適用されます。 (継承元 DependencyObject)
GetValue(DependencyProperty)	DependencyObject から依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject)
OnConnected()	ブラシを画面上で初めて使用して要素を描画するときに呼び出されます。 派生クラスで実装する場合は、 CompositionBrush インスタンスを作成し、 CompositionBrush プロパティを設定してフレームワークに提供できます。 OnDisconnected は、ブラシが要素の描画に使用されなくなったときに呼び出されます。 (継承元 XamlCompositionBrushBase)
OnDisconnected()	ブラシが要素の描画に使用されなくなったときに呼び出されます。 派生クラスで実装すると、コンポスト ブラシやその他のコンポジション リソースを安全に破棄できます。 接続解除後に ブラシを使用して要素をペイントすると、OnConnected が再び呼び出されます。 (継承元 XamlCompositionBrushBase)
PopulatePropertyInfo(String, AnimationPropertyInfo)	アニメーション化できるプロパティを定義します。 (継承元 Brush)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	派生クラスでオーバーライドされると、アニメーション化できるプロパティを定義します。 (継承元 Brush)
ReadLocalValue(DependencyProperty)	ローカル値が設定されている場合は、依存関係プロパティのローカル値を返します。 (継承元 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	この DependencyObject インスタンスの特定の DependencyProperty に対する変更をリッスンするための通知関数を登録します。 (継承元 DependencyObject)
SetValue(DependencyProperty, Object)	DependencyObject の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	RegisterPropertyChangedCallback を呼び出して以前に登録した変更通知を取り消します。 (継承元 DependencyObject)

こちらもご覧ください

• Brush
• SolidColorBrush
• LinearGradientBrush
• GradientBrush
• GradientStop
• XAML ブラシ
• ResourceDictionary と XAML リソースの参照