Graphics::SetCompositingMode メソッド (gdiplusgraphics.h)

Graphics::SetCompositingMode メソッドは、この Graphics オブジェクトの合成モードを設定します。

構文

Status SetCompositingMode(
  [in] CompositingMode compositingMode
);

パラメーター

[in] compositingMode

種類: CompositingMode

合成モードを指定する CompositingMode 列挙体の要素。

戻り値

種類: 状態

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

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

解説

アルファ成分が 192 の色 (255 の約 75%) に基づいて SolidBrush オブジェクトを作成するとします。 Graphics オブジェクトの合成モードが CompositingModeSourceOver に設定されている場合、ソリッド ブラシで塗りつぶされた領域は、ブラシの色が 75%、背景色が 25% のブレンドになります。 Graphics オブジェクトの合成モードが CompositingModeSourceCopy に設定されている場合、背景色はブラシの色とブレンドされません。 ただし、ブラシによってレンダリングされる色の強度は、アルファ 成分が 255 の場合の強度の 75% です。

TextRenderingHintClearTypeGridFit と共に CompositingModeSourceCopy を使用することはできません。

例

次の例では 、Graphics オブジェクトを作成し、その合成モードを CompositingModeSourceOver に設定します。 このコードでは、アルファ成分が 128 の色に基づいて SolidBrush オブジェクトを作成します。 このコードは、そのブラシのアドレスを Graphics オブジェクトの Graphics::FillRectangle メソッドに渡して、ブラシの色と背景色の半分と半分のブレンド色で四角形を塗りつぶします。 次に、 Graphics オブジェクトの合成モードを CompositingModeSourceCopy に設定し、同じブラシで 2 番目の四角形を塗りつぶします。 その 2 番目の四角形では、ブラシの色は背景色とブレンドされません。

VOID Example_SetCompositingMode(HDC hdc)
{
   Graphics graphics(hdc);
   
   // Create a SolidBrush object with an alpha-blended color.
   SolidBrush alphaBrush(Color(180, 255, 0, 0));

   // Set the compositing mode to CompositingModeSourceOver,
   // and fill a rectangle.
   graphics.SetCompositingMode(CompositingModeSourceOver);
   graphics.FillRectangle(&alphaBrush, 0, 0, 100, 100);

   // Set the compositing mode to CompositingModeSourceCopy,
   // and fill a rectangle.
   graphics.SetCompositingMode(CompositingModeSourceCopy);
   graphics.FillRectangle(&alphaBrush, 100, 0, 100, 100);
}

要件

関連項目

アルファ ブレンドの直線と塗りつぶし

CompositingMode

グラフィックス

Graphics::GetCompositingMode

Graphics::GetCompositingQuality

Graphics::SetCompositingQuality

Graphics::SetTextRenderingHint

HatchBrush

新機能

Solidbrush

TextRenderingHint