WINDOWPLACEMENT 구조체(winuser.h)

아티클
08/28/2023

화면에 창의 배치에 대한 정보를 포함합니다.

구문

typedef struct tagWINDOWPLACEMENT {
  UINT  length;
  UINT  flags;
  UINT  showCmd;
  POINT ptMinPosition;
  POINT ptMaxPosition;
  RECT  rcNormalPosition;
  RECT  rcDevice;
} WINDOWPLACEMENT;

멤버

length

형식: UINT

구조체의 길이(바이트)입니다. GetWindowPlacement 또는 SetWindowPlacement 함수를 호출하기 전에 이 멤버를 로 sizeof(WINDOWPLACEMENT)설정합니다.

이 멤버가 올바르게 설정되지 않은 경우 GetWindowPlacement 및 SetWindowPlacement가 실패합니다.

flags

형식: UINT

최소화된 창의 위치와 창이 복원되는 메서드를 제어하는 플래그입니다. 이 멤버는 다음 값 중 하나 이상일 수 있습니다.

값	의미
WPF_ASYNCWINDOWPLACEMENT 0x0004	호출 스레드와 창을 소유하는 스레드가 다른 입력 큐에 연결된 경우 시스템은 창을 소유한 스레드에 요청을 게시합니다. 이렇게 하면 다른 스레드가 요청을 처리하는 동안 호출 스레드가 실행을 차단하지 않습니다.
WPF_RESTORETOMAXIMIZED 0x0002	복원된 창은 최소화되기 전에 최대화되었는지 여부에 관계없이 최대화됩니다. 이 설정은 다음에 창이 복원될 때만 유효합니다. 기본 복원 동작은 변경되지 않습니다. 이 플래그는 showCmd 멤버에 대해 SW_SHOWMINIMIZED 값을 지정한 경우에만 유효합니다.
WPF_SETMINPOSITION 0x0001	최소화된 창의 좌표를 지정할 수 있습니다. 좌표가 ptMinPosition 멤버에 설정된 경우 이 플래그를 지정해야 합니다.

showCmd

형식: UINT

창의 현재 표시 상태입니다. ShowWindow 함수에 대한 nCmdShow 매개 변수에 지정할 수 있는 값이라면 무엇이든 가능합니다.

ptMinPosition

형식: POINT

창이 최소화된 경우 창의 왼쪽 위 모서리 좌표입니다.

ptMaxPosition

형식: POINT

창이 최대화되면 창의 왼쪽 위 모서리 좌표입니다.

rcNormalPosition

형식: RECT

창이 복원된 위치에 있을 때 창의 좌표입니다.

rcDevice

설명

창이 WS_EX_TOOLWINDOW 창 스타일이 없는 최상위 창인 경우 다음 멤버가 나타내는 좌표는 ptMinPosition, ptMaxPosition 및 rcNormalPosition 작업 영역 좌표에 있습니다. 그렇지 않으면 이러한 멤버는 화면 좌표에 있습니다.

작업 영역 좌표는 애플리케이션 도구 모음(작업 표시줄 포함)의 위치와 크기를 고려한다는 점에서 화면 좌표와 다릅니다. 작업 영역 좌표(0,0)는 작업 영역 영역의 왼쪽 위 모서리이며, 애플리케이션 도구 모음에서 사용하지 않는 화면 영역입니다.

WINDOWPLACEMENT 구조에 사용되는 좌표는 GetWindowPlacement 및 SetWindowPlacement 함수에서만 사용해야 합니다. 화면 좌표(예: SetWindowPos)가 필요한 함수에 작업 영역 좌표를 전달하면 창이 잘못된 위치에 표시됩니다. 예를 들어 작업 표시줄이 화면 맨 위에 있는 경우 GetWindowPlacement 를 사용하여 창 좌표를 저장하고 SetWindowPos 를 사용하여 복원하면 창이 화면을 "크리프"하는 것처럼 보입니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	winuser.h(Windows.h 포함)