LinearGradientBrush クラス

定義

名前空間:

Windows.UI.Xaml.Media

線形グラデーションを使用して領域を塗りつぶします。

public ref class LinearGradientBrush sealed : GradientBrush

/// [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)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Xaml.Media.ILinearGradientBrushFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class LinearGradientBrush final : GradientBrush

[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)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Xaml.Media.ILinearGradientBrushFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LinearGradientBrush : GradientBrush

Public NotInheritable Class LinearGradientBrush
Inherits GradientBrush

<LinearGradientBrush ...>
  oneOrMoreGradientStops
</LinearGradientBrush

継承

Object Platform::Object IInspectable DependencyObject Brush GradientBrush LinearGradientBrush

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

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

例

次の例では、4 色の線状グラデーションを作成し、それを使って Rectangle を塗りつぶします。

<StackPanel>
  <!-- This rectangle is painted with a vertical linear gradient. -->
  <Rectangle Width="200" Height="100">
    <Rectangle.Fill>
      <LinearGradientBrush StartPoint="0.5,0" EndPoint="0.5,1">
        <GradientStop Color="Yellow" Offset="0.0" />
        <GradientStop Color="Red" Offset="0.25" />
        <GradientStop Color="Blue" Offset="0.75" />
        <GradientStop Color="LimeGreen" Offset="1.0" />
      </LinearGradientBrush>
    </Rectangle.Fill>
  </Rectangle>
</StackPanel>

注釈

LinearGradientBrush は Brush の一種であり、Brush を 使用してアプリ UI のオブジェクトのビジュアル領域の一部またはすべてを塗りつぶす可能性のある多くの UI プロパティに使用されます。 Brush 値を使用する最も一般的に使用されるプロパティの例としては、Control.Background、Control.Foreground、Shape.Fill、Control.BorderBrush、Panel.Background、TextBlock.Foreground などがあります。 LinearGradientBrush は、より一般的に使用される SolidColorBrush 型の代替手段です。

LinearGradientBrush の StartPoint プロパティと EndPoint プロパティは、相対座標空間内の 2 つのポイントを表します。 これにより、グラデーションの向きが作成され、通常は水平方向のグラデーションまたは垂直方向のグラデーションが指定されます。 斜めのグラデーションを使用することもできます。 LinearGradientBrush には、通常、 GradientStops プロパティ (順序付きコレクション) に対して 2 つ以上 の GradientStop 値があります。 各 GradientStop は 、色 とオフセットを指定 します。 オフセット は、グラデーションに沿って 0 ( StartPoint) と 1 ( EndPoint) の間の位置を表し、ブラシとそのグラデーションの実際のピクセル長は、値として LinearGradientBrush を適用する UI に基づいて調整されます。 Offset 値の定義方法と、Offset、StartPoint、EndPoint の関連方法の詳細については、「ブラシを使用する」を参照してください。 を使用するのが一般的です

GradientStop 色の 1 つに Transparent 値を使用できます。 これは UI に変更を視覚的に適用しませんが (透過的です)、そのポイントはヒット テストの目的で検出できます。 ヒット テストの詳細については、「 マウス操作」の「ヒット テスト」セクションを参照してください。

LinearGradientBrush の GradientStop 値は、画面切り替えや装飾アニメーションの一部としてアニメーション化できます。 Color 値をアニメーション化できる専用のアニメーションの種類のいずれかを使用します。 これには通常、.(GradientStop.Color)Storyboard.TargetProperty 値の長いプロパティ パスの一部が含まれます。 プロパティのターゲット設定と 、Brush 値を使用するプロパティをアニメーション化する方法の詳細については、「 ストーリーボード化されたアニメーション」を参照してください。

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 テーマ リソース」を参照してください。

コンストラクター

LinearGradientBrush()	LinearGradientBrush クラスの新しいインスタンスを初期化します。
LinearGradientBrush(GradientStopCollection, Double)	指定した GradientStopCollection と angle を持つ LinearGradientBrush クラスの新しいインスタンスを初期化します。

プロパティ

ColorInterpolationMode	グラデーションの色の補間方法を指定する ColorInterpolationMode 列挙値を取得または設定します。 (継承元 GradientBrush)
Dispatcher	このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の DependencyObject にアクセスできる機能を表します。 (継承元 DependencyObject)
EndPoint	線状グラデーションの終点の 2 次元座標を取得または設定します。
EndPointProperty	EndPoint 依存関係プロパティを識別します。
GradientStops	ブラシのグラデーションの分岐点を取得または設定します。 (継承元 GradientBrush)
MappingMode	グラデーション ブラシの配置座標が絶対であるか、出力領域を基準にするかを指定する BrushMappingMode 列挙値を取得または設定します。 (継承元 GradientBrush)
Opacity	Brush の不透明度を取得または設定 します。 (継承元 Brush)
RelativeTransform	相対座標を使用して、ブラシに適用される変換を取得または設定します。 (継承元 Brush)
SpreadMethod	オブジェクトの境界の内側で開始または終了するグラデーションの描画方法を指定するスプレッド メソッドの種類を取得または設定します。 (継承元 GradientBrush)
StartPoint	線形グラデーションの起点の 2 次元座標を取得または設定します。
StartPointProperty	StartPoint 依存関係プロパティを識別します。
Transform	ブラシに適用される変換を取得または設定します。 (継承元 Brush)

メソッド

ClearValue(DependencyProperty)	依存関係プロパティのローカル値をクリアします。 (継承元 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	依存関係プロパティに対して確立された基本値を返します。これは、アニメーションがアクティブでない場合に適用されます。 (継承元 DependencyObject)
GetValue(DependencyProperty)	DependencyObject から依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject)
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)

こちらもご覧ください

• GradientBrush
• SolidColorBrush
• RadialGradientBrush
• ブラシの使用
• ResourceDictionary と XAML リソースの参照