SetWindowExtEx 함수(wingdi.h)

아티클
03/04/2024

SetWindowExtEx 함수는 지정된 값을 사용하여 디바이스 컨텍스트에 대한 창의 가로 및 세로 익스텐트를 설정합니다.

구문

BOOL SetWindowExtEx(
  [in]  HDC    hdc,
  [in]  int    x,
  [in]  int    y,
  [out] LPSIZE lpsz
);

매개 변수

[in] hdc

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

[in] x

창의 가로 익스텐트(논리 단위)입니다.

[in] y

창의 세로 익스텐트(논리 단위)입니다.

[out] lpsz

이전 창 익스텐트(논리 단위)를 수신하는 SIZE 구조체에 대한 포인터입니다. lpSize가 NULL인 경우 이 매개 변수는 사용되지 않습니다.

반환 값

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

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

설명

창은 페이지 공간의 논리적 좌표계를 나타냅니다. 범위는 축의 최대값입니다. 이 함수는 창의 가로 축과 세로 축의 최대값을 논리 좌표로 설정합니다. 페이지 공간과 디바이스 공간 간에 매핑할 때 SetViewportExtEx 및 SetWindowExtEx 는 창과 뷰포트 간의 배율 인수를 결정합니다. 자세한 내용은 좌표 공간 변환을 참조하세요.

다음 매핑 모드가 설정되면 SetWindowExtEx 및 SetViewportExtEx 함수에 대한 호출이 무시됩니다.

MM_HIENGLISH
MM_HIMETRIC
MM_LOENGLISH
MM_LOMETRIC
Mm_text
MM_TWIPS

MM_ISOTROPIC 모드가 설정되면 애플리케이션은 SetViewportExtEx를 호출하기 전에 SetWindowExtEx 함수를 호출해야 합니다. MM_ISOTROPIC 모드의 경우 두 축의 논리 단위가 동일한 물리적 거리를 나타내므로 비평도 화면의 특정 부분을 표시하지 못할 수 있습니다.

예제

예제는 클라이언트 영역 무효화를 참조하세요.

요구 사항

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