SetViewportOrgEx 함수(wingdi.h)

아티클
03/08/2023

SetViewportOrgEx 함수는 창 원본(0,0)에 매핑되는 디바이스 지점을 지정합니다.

구문

BOOL SetViewportOrgEx(
  [in]  HDC     hdc,
  [in]  int     x,
  [in]  int     y,
  [out] LPPOINT lppt
);

매개 변수

[in] hdc

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

[in] x

새 뷰포트 원본의 x 좌표(디바이스 단위)입니다.

[in] y

새 뷰포트 원본의 y 좌표(디바이스 단위)입니다.

[out] lppt

디바이스 좌표에서 이전 뷰포트 원본을 수신하는 POINT 구조체에 대한 포인터입니다. lpPoint가 NULL인 경우 이 매개 변수는 사용되지 않습니다.

반환 값

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

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

설명

이 함수는 SetViewportExtEx 및 SetWindowExtEx와 함께 논리 좌표 공간( 창이라고도 함)에서 디바이스 좌표 공간( 뷰포트)으로의 매핑을 정의하는 데 도움이 됩니다. SetViewportOrgEx 는 논리 지점(0,0)에 매핑되는 디바이스 지점을 지정합니다. 논리 지점(0,0)이 더 이상 왼쪽 위 모서리를 참조하지 않도록 축을 이동하는 효과가 있습니다.


//map the logical point (0,0) to the device point (xViewOrg, yViewOrg) 
SetViewportOrgEx ( hdc, xViewOrg, yViewOrg, NULL)

이는 SetWindowOrgEx 함수와 관련이 있습니다. 일반적으로 한 함수 또는 다른 함수를 사용하지만 둘 다 사용하지는 않습니다. SetWindowOrgEx 및 SetViewportOrgEx 사용에 관계없이 디바이스 지점(0,0)은 항상 왼쪽 위 모서리입니다.

예제

예를 들어 업데이트 지역에서 다시 그리기를 참조하세요.

요구 사항


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