ID2D1RadialGradientBrush 介面 (d2d1.h)

使用放射狀漸層繪製區域。

繼承

ID2D1RadialGradientBrush 介面繼承自ID2D1Brush。 ID2D1RadialGradientBrush 也有下列類型的成員：

• 方法

方法

ID2D1RadialGradientBrush 介面具有這些方法。

ID2D1RadialGradientBrush：：GetCenter 擷取漸層橢圓形的中心。
ID2D1RadialGradientBrush：：GetGradientOriginOffset 擷取相對於漸層橢圓中心之漸層原點的位移。
ID2D1RadialGradientBrush：：GetGradientStopCollection 擷取與此星形漸層筆刷對象相關聯的ID2D1GradientStopCollection。
ID2D1RadialGradientBrush：：GetRadiusX 擷取漸層橢圓形的 x 半徑。
ID2D1RadialGradientBrush：：GetRadiusY 擷取漸層橢圓形的 Y 半徑。
ID2D1RadialGradientBrush：：SetCenter 指定筆刷座標空間中漸層橢圓形的中心。
ID2D1RadialGradientBrush：：SetGradientOriginOffset 指定相對於漸層橢圓中心之漸層原點的位移。
ID2D1RadialGradientBrush：：SetRadiusX 指定筆刷座標空間中漸層橢圓形的 x 半徑。
ID2D1RadialGradientBrush：：SetRadiusY 指定筆刷座標空間中漸層橢圓形的 Y 半徑。

備註

ID2D1RadialGradientBrush 類似於ID2D1LinearGradientBrush，兩者都會將漸層停駐點集合對應至漸層。 不過，線性漸層的起點和終點可定義漸層向量，而星形漸層則使用橢圓形和漸層原點來定義其漸層行為。 若要定義橢圓形的位置和大小，請使用SetCenter、SetRadiusX 和 SetRadiusY 方法來指定橢圓形的中心、x 半徑和 y 半徑。 除非使用 SetGradientOriginOffset 方法來指定漸層位移，否則漸層原點是橢圓形的中心。

筆刷會對應漸層原點的漸層停駐點位置 0.0f，而位置 1.0f 則對應至橢圓形界限。 當漸層原點位於橢圓形內時，橢圓形的內容會括住筆刷漸層停駐點的整個 [0， 1] 範圍。 如果漸層原點超出橢圓形的界限，筆刷仍可運作，但其漸層未妥善定義。

開始點和終點會在筆刷空間中描述，並在使用筆刷時對應至轉譯目標。 請注意，開始和結束座標是絕對的，而不是相對於轉譯目標大小。 值 (0,0) 對應至轉譯目標的左上角，而值 (1， 1) 只會對應一個 (圖元，而 0， 0) 。 如果有非標識符筆刷轉換或轉譯目標轉換，筆刷省略號和漸層原點也會轉換。

您可以指定未完全填滿區域繪製的省略號。 發生這種情況時，筆刷ID2D1GradientStopCollection所指定的D2D1_EXTEND_MODE和設定) (會決定剩餘區域的繪製方式。

建立 ID2D1RadialGradientBrush 物件

若要建立星形漸層筆刷，請使用將使用筆刷之轉譯目標的 ID2D1RenderTarget：：CreateRadialGradientBrush 方法。 筆刷只能與建立該筆刷的轉譯目標搭配使用，或與該轉譯目標的相容目標搭配使用。

星形漸層筆刷是裝置相依的資源：您的應用程式應該在初始化使用筆刷的轉譯目標之後建立星形漸層筆刷，並在轉譯目標需要重新建立時重新建立筆刷。 (如需資源的詳細資訊，請參閱 資源概觀.)

範例

如需如何建立星形漸層筆刷的範例，請參閱 如何建立星形漸層筆刷 主題。

規格需求

需求	值
最低支援的用戶端	適用於 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	d2d1.h

另請參閱

筆刷概觀

如何建立星形漸層筆刷

ID2D1Brush