SetWindowOrgEx 함수(wingdi.h)

아티클
03/04/2024

SetWindowOrgEx 함수는 뷰포트 원본(0,0)에 매핑되는 창 지점을 지정합니다.

구문

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

설명

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


//map the logical point (xWinOrg, yWinOrg) to the device point (0,0) 
SetWindowOrgEx (hdc, xWinOrg, yWinOrg, NULL)

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

요구 사항

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