SetWindowPlacement 함수(winuser.h)

아티클
08/28/2023

표시 상태와 지정된 창의 복원, 최소화 및 최대화된 위치를 설정합니다.

구문

BOOL SetWindowPlacement(
  [in] HWND                  hWnd,
  [in] const WINDOWPLACEMENT *lpwndpl
);

매개 변수

[in] hWnd

형식: HWND

창에 대한 핸들입니다.

[in] lpwndpl

형식: const WINDOWPLACEMENT*

새 표시 상태 및 창 위치를 지정하는 WINDOWPLACEMENT 구조체에 대한 포인터입니다.

SetWindowPlacement를 호출하기 전에 WINDOWPLACEMENT 구조체의 길이 멤버를 sizeof(WINDOWPLACEMENT)로 설정합니다. 길이 멤버가 올바르게 설정되지 않은 경우 SetWindowPlacement가 실패합니다.

반환 값

형식: BOOL

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

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

WINDOWPLACEMENT에 지정된 정보로 인해 화면이 완전히 꺼진 창이 발생하는 경우 시스템은 화면 해상도 및 여러 모니터 구성의 변경 사항을 고려하여 창이 표시되도록 좌표를 자동으로 조정합니다.

WINDOWPLACEMENT의 길이 멤버를 로 설정sizeof(WINDOWPLACEMENT)해야 합니다. 이 멤버가 올바르게 설정되지 않은 경우 함수는 FALSE를 반환합니다. 창 배치 좌표의 적절한 사용에 대한 추가 설명은 WINDOWPLACEMENT를 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-window-l1-1-3(Windows 10 버전 10.0.10240에 도입됨)