SetWindowPlacement 함수(winuser.h)
표시 상태와 지정된 창의 복원, 최소화 및 최대화된 위치를 설정합니다.
구문
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에 도입됨) |
추가 정보
개념
참조