RadialGradientBrush 類別

定義

命名空間:

Microsoft.UI.Xaml.Media

RadialGradientBrush 繪製具有星形漸層的區域。 中心點會定義漸層的原點，而橢圓形則定義漸層的外部界限。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

/// [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

繼承

XamlCompositionBrushBase

RadialGradientBrush

屬性

MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

範例

提示

如需詳細資訊、設計指引和程式碼範例，請參閱 筆刷。

WinUI 3 資源庫和WinUI 2 資源庫應用程式包含大部分 WinUI 3 和 WinUI 2 控制項、特性和功能的互動式範例。

如果已安裝，請按一下下列連結加以開啟： WinUI 3 資源庫 或 WinUI 2 資源庫。

如果未安裝，您可以從 Microsoft Store 下載 WinUI 3 資源庫 和 WinUI 2 資源庫 。

您也可以從 GitHub 取得的原始程式碼 (使用 WinUI 3 的主要 分支和 WinUI 2) 的 winui2 分支。

下列範例會建立具有六個漸層停駐點的星形漸層，並使用它繪製 Rectangle。

<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>

此範例會建立星形漸層，其使用絕對對應模式搭配 、 RadiusXRadiusY 和 GradientOrigin 的 Center 自訂值：

<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會定義Center、RadiusX、RadiusY和GradientOrigin是否代表相對或絕對座標。

當 MappingMode 設定為 RelativeToBoundingBox 時，會將三個屬性的 X 和 Y 值視為相對於元素界限，其中 (0,0) 代表左 (1,1) 上方，並代表 Center、 RadiusX和 RadiusY 屬性之元素界限的右下角，並 (0,0) 代表 GradientOrigin 屬性的中心。

當 MappingMode 設定為 [Absolute] 時，這三個屬性的 X 和 Y 值會視為元素界限內的絕對座標。

Windows 10版本支援

Windows 10 1903 版 (v10.0.18362.0) 和更新版本支援漸層轉譯。 在舊版作業系統上，筆刷會轉譯 屬性所 FallbackColor 指定的純色。

XAML 資源形式的筆刷

您可以在 XAML (SolidColorBrush、LinearGradientBrush、ImageBrush) 中宣告的每個Brush類型都是要定義為資源，以便在整個應用程式中重複使用該筆刷作為資源。 針對 Brush類型顯示的 XAML 語法適用于將筆刷定義為資源。 當您將筆刷宣告為資源時，您也需要 x：Key 屬性 ，稍後您將用來從其他 UI 定義參考該資源。 如需 XAML 資源及如何使用 x：Key 屬性的詳細資訊，請參閱 ResourceDictionary 和 XAML 資源參考。

將筆刷宣告為資源的優點是可減少建構 UI 所需的執行時間物件數目：筆刷現在會共用為物件圖形的多個部分提供值的通用資源。

如果您查看Windows 執行階段 XAML 控制項的現有控制項範本定義，您會看到範本會廣泛地使用筆刷資源 (雖然這些通常是SolidColorBrush，而不是 LinearGradientBrush) 。 其中許多資源都是系統資源，而且會針對資源參考使用 {ThemeResource} 標記延伸 ，而不是 {StaticResource} 標記延伸。 如需如何在您自己的控制項範本 XAML 中使用系統資源筆刷的詳細資訊，請參閱 XAML 主題資源。

建構函式

RadialGradientBrush()

初始化 RadialGradientBrush 類別的新實例。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

屬性

Center	取得或設定包含漸層之橢圓形的中心。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
CenterProperty	識別 Center 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
GradientOrigin	取得或設定相對於左上角) 的漸層原點 (。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
GradientOriginProperty	識別 GradientOrigin 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
GradientStops	取得或設定筆刷的漸層停駐點。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
InterpolationSpace	取得或設定用來插補漸層色彩的色彩空間。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
InterpolationSpaceProperty	識別 InterpolationSpace 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
MappingMode	取得或設定漸層筆刷的位置座標是絕對或相對於輸出區域。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
MappingModeProperty	識別 MappingMode 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
RadiusX	取得或設定包含漸層之橢圓形的 X 軸半徑。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
RadiusXProperty	識別 RadiusX 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
RadiusY	取得或設定包含漸層之橢圓形的 Y 軸半徑。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
RadiusYProperty	識別 RadiusY 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
SpreadMethod	取得或設定展開方法的類型，該類型指定如何繪製在所要繪製物件之邊界內開始或結束的漸層。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
SpreadMethodProperty	識別 SpreadMethod 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

另請參閱

• Brush
• SolidColorBrush \(英文\)
• LinearGradientBrush \(英文\)
• GradientBrush
• GradientStop
• 使用筆刷
• ResourceDictionary 與 XAML 資源參考