Graphics::SetCompositingMode 메서드(gdiplusgraphics.h)

아티클
08/24/2023

Graphics::SetCompositingMode 메서드는 이 Graphics 개체의 작성 모드를 설정합니다.

구문

Status SetCompositingMode(
  [in] CompositingMode compositingMode
);

매개 변수

[in] compositingMode

형식: CompositingMode

작성 모드를 지정하는 CompositingMode 열거형의 요소입니다.

반환 값

형식: 상태

메서드가 성공하면 Status 열거형의 요소인 확인을 반환합니다.

메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.

설명

알파 구성 요소가 192인 색(255의 약 75%)을 기반으로 SolidBrush 개체를 만든다고 가정해 보겠습니다. Graphics 개체의 작성 모드가 CompositingModeSourceOver로 설정된 경우 단색 브러시로 채워진 영역은 브러시 색 75%와 배경색 25%인 혼합입니다. Graphics 개체의 작성 모드가 CompositingModeSourceCopy로 설정된 경우 배경색이 브러시 색과 혼합되지 않습니다. 그러나 브러시로 렌더링되는 색의 강도는 알파 구성 요소가 255인 경우의 75%입니다.

TextRenderingHintClearTypeGridFit과 함께 CompositingModeSourceCopy를 사용할 수 없습니다.

예제

다음 예제에서는 Graphics 개체를 만들고 해당 작성 모드를 CompositingModeSourceOver로 설정합니다. 이 코드는 알파 구성 요소가 128인 색을 기반으로 SolidBrush 개체를 만듭니다. 코드는 해당 브러시의 주소를 Graphics 개체의 Graphics::FillRectangle 메서드에 전달하여 브러시 색과 배경색의 반반 혼합 색으로 사각형을 채웁니다. 그런 다음, 이 코드는 Graphics 개체의 작성 모드를 CompositingModeSourceCopy로 설정하고 두 번째 사각형을 동일한 브러시로 채웁니다. 두 번째 사각형에서 브러시 색은 배경색과 혼합되지 않습니다.

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);
}

요구 사항


지원되는 최소 클라이언트	Windows XP, Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	gdiplusgraphics.h(Gdiplus.h 포함)
라이브러리	Gdiplus.lib
DLL	Gdiplus.dll