LinearGradientBrush::GetBlend メソッド (gdiplusbrush.h)

[アーティクル]
08/23/2023

LinearGradientBrush::GetBlend メソッドは、LinearGradientBrush オブジェクトからブレンド係数とそれに対応するブレンド位置を取得します。

構文

Status GetBlend(
  [out] REAL *blendFactors,
  [out] REAL *blendPositions,
  [in]  INT  count
);

パラメーター

[out] blendFactors

種類: REAL*

ブレンド係数を受け取る配列へのポインター。配列内の各数値は、終了色のパーセンテージを示し、0.0 から 1.0 の範囲です。

[out] blendPositions

種類: REAL*

ブレンド位置を受け取る配列へのポインター。配列内の各数値は、開始境界と終了境界の間の距離のパーセンテージを示し、0.0 から 1.0 の範囲です。0.0 はグラデーションの開始境界を示し、1.0 は終了境界を示します。 0.0 ~ 1.0 のブレンド位置は、境界線と平行な線を示します。これは、開始境界から終了境界までの距離の一定の割合です。たとえば、ブレンド位置が 0.7 の場合、開始境界から終了境界までの距離の 70% の線が示されます。境界線に平行な線の色は一定です。

[in] count

型: INT

取得するブレンド係数の数を指定する整数。 LinearGradientBrush オブジェクトの LinearGradientBrush::GetBlend メソッドを呼び出す前に、同じ LinearGradientBrush オブジェクトの LinearGradientBrush::GetBlendCount メソッドを呼び出して、ブレンド係数の現在の数を確認します。取得されるブレンド位置の数は、取得されたブレンド係数の数と同じです。

戻り値

種類: 状態

メソッドが成功した場合は、 Status 列挙体の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

解説

LinearGradientBrush オブジェクトには、開始境界と終了境界の 2 つの並列境界があります。色は、これら 2 つの境界のそれぞれに関連付けられます。各境界は、指定した点を通過する直線です。開始境界は開始点を通過します。終了境界は終了点を通過し、線形グラデーションブラシの方向に垂直です。線形グラデーションブラシの方向は、始点と終点で定義される線に従います。この線 ("方向線" は、水平、垂直、または対角線である場合があります。境界に平行な線上にあるすべての点は同じ色になります。線状のグラデーションブラシで領域を塗りつぶすと、開始境界から終了境界に向けて方向線に沿って移動すると、色が徐々に 1 つの線から次の線に変わります。既定では、色の変化は距離の変化に比例します。つまり、開始境界と終了境界の間の距離の 30% の線には、開始境界の色と終了境界の色との間の距離の 30% の色があります。色パターンは、開始境界と終了境界の外側で繰り返されます。

LinearGradientBrush オブジェクトの LinearGradientBrush::SetBlend メソッドを呼び出して、色と距離の関係をカスタマイズできます。たとえば、ブレンド位置を {0, 0.5, 1} に設定し、ブレンド係数を {0, 0.3, 1} に設定するとします。次に、開始境界と終了境界の間の距離の 50% の線は、開始境界の色と終了境界の色の間の距離の 30% の色になります。

例

次の例では、線形グラデーションブラシを作成し、そのブレンドを設定し、ブラシを使用して四角形を塗りつぶします。その後、コードはブレンドを取得します。その後、ブレンド係数と位置を検査したり、何らかの方法で使用することができます。

VOID Example_GetBlend(HDC hdc)
{
   Graphics myGraphics(hdc);

   // Create a linear gradient brush, and set its blend.
   REAL fac[] = {0.0f, 0.4f, 0.6f, 1.0f};
   REAL pos[] = {0.0f, 0.2f, 0.8f, 1.0f};

   LinearGradientBrush linGrBrush(
      Point(0, 0), 
      Point(100, 0),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255));  // blue

   linGrBrush.SetBlend(fac, pos, 4);

   // Use the linear gradient brush to fill a rectangle.
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 100, 50);

   // Obtain information about the linear gradient brush.
   INT   blendCount;
   REAL* factors = NULL;
   REAL* positions = NULL;

   blendCount = linGrBrush.GetBlendCount();
   factors = new REAL[blendCount];
   positions = new REAL[blendCount];

   linGrBrush.GetBlend(factors, positions, blendCount);

   for(INT j = 0; j < blendCount; ++j)
   {
      // Inspect or use the value in factors[j].
      // Inspect or use the value in positions[j].
   }
}

要件


サポートされている最小のクライアント	Windows XP、Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	gdiplusbrush.h (Gdiplus.h を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll

LinearGradientBrush::GetBlend メソッド (gdiplusbrush.h)

構文

パラメーター

戻り値

解説

例

要件

関連項目

フィードバック

フィードバック

その他のリソース