다음을 통해 공유


SetViewportExtEx 함수(wingdi.h)

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

구문

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

매개 변수

[in] hdc

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

[in] x

뷰포트의 가로 익스텐트(디바이스 단위)입니다.

[in] y

뷰포트의 세로 익스텐트(디바이스 단위)입니다.

[out] lpsz

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

반환 값

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

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

설명

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

다음 매핑 모드가 설정되면 SetWindowExtExSetViewportExtEx 함수에 대한 호출은 무시됩니다.

  • 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

추가 정보

좌표 공간 및 변환 함수

좌표 공간 및 변환 개요

GetViewportExtEx

SIZE

SetWindowExtEx