ExtFloodFill 함수(wingdi.h)

아티클
03/04/2024

ExtFloodFill 함수는 디스플레이 표면의 영역을 현재 브러시로 채웁니다.

구문

BOOL ExtFloodFill(
  [in] HDC      hdc,
  [in] int      x,
  [in] int      y,
  [in] COLORREF color,
  [in] UINT     type
);

매개 변수

[in] hdc

디바이스 컨텍스트에 대한 핸들입니다.

[in] x

채우기가 시작되는 지점의 x 좌표(논리 단위)입니다.

[in] y

채우기가 시작되는 지점의 y 좌표(논리 단위)입니다.

[in] color

채울 경계 또는 영역의 색입니다. 색 해석은 fuFillType 매개 변수의 값에 따라 달라집니다. COLORREF 색 값을 만들려면 RGB 매크로를 사용합니다.

[in] type

수행할 채우기 작업의 형식입니다. 이 매개 변수는 다음 값 중 하나여야 합니다.

값	의미
FLOODFILLBORDER	채우기 영역은 색 매개 변수로 지정된 색으로 제한됩니다. 이 스타일은 FloodFill 함수에서 수행하는 채우기와 동일합니다.
FLOODFILLSURFACE	채우기 영역은 색으로 지정된 색으로 정의됩니다. 색이 발견되는 한 채우기는 모든 방향으로 바깥쪽으로 계속됩니다. 이 스타일은 여러 가지 색의 경계로 영역을 채우는 데 유용합니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다.

설명

다음은 이 함수가 실패할 수 있는 몇 가지 이유입니다.

충전을 완료할 수 없습니다.
지정된 지점에는 color 매개 변수로 지정된 경계 색이 있습니다(FLOODFILLBORDER가 요청된 경우).
지정된 지점에 색으로 지정된 색이 없습니다(FLOODFILLSURFACE가 요청된 경우).
점이 클리핑 영역 외부에 있습니다. 즉, 디바이스에 표시되지 않습니다.

fuFillType 매개 변수가 FLOODFILLBORDER인 경우 시스템은 채울 영역이 색 매개 변수로 지정된 색으로 완전히 제한된다고 가정합니다. 함수는 nXStart 및 nYStart 매개 변수로 지정된 지점에서 채우기 시작하고 경계에 도달할 때까지 모든 방향으로 계속됩니다.

fuFillType이 FLOODFILLSURFACE인 경우 시스템은 채울 영역이 단일 색이라고 가정합니다. 함수는 nXStart 및 nYStart 로 지정된 지점에서 영역을 채우기 시작하고 모든 방향으로 계속되어 색으로 지정된 색을 포함하는 인접한 모든 영역을 채웁니다.

래스터 표시 작업을 지원하는 메모리 디바이스 컨텍스트 및 디바이스만 ExtFloodFill 함수를 지원합니다. 디바이스가 이 기술을 지원하는지 여부를 확인하려면 GetDeviceCaps 함수를 사용합니다.

예제

예를 들어 메뉴 사용의 "메뉴에 선 및 그래프 추가"를 참조 하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wingdi.h(Windows.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll