SetViewportExtEx 함수(wingdi.h)

아티클
03/08/2023

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

구문

BOOL SetViewportExtEx(
  [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입니다.

설명

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

다음 매핑 모드가 설정되면 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