다음을 통해 공유

IDockingWindow::ResizeBorderDW 메서드(shobjidl_core.h)

  • 아티클

도킹 창 개체에 프레임의 테두리 공간이 변경되었음을 알립니다. 이 메서드에 대한 응답으로 IDockingWindow 구현은 테두리 공간이 필요하지 않거나 변경이 필요하지 않은 경우에도 SetBorderSpaceDW를 호출해야 합니다.

구문

HRESULT ResizeBorderDW(
  LPCRECT  prcBorder,
  IUnknown *punkToolbarSite,
  BOOL     fReserved
);

매개 변수

prcBorder

형식: LPCRECT

프레임의 사용 가능한 테두리 공간을 포함하는 RECT 구조체에 대한 포인터입니다.

punkToolbarSite

형식: IUnknown*

사이트의 IUnknown 인터페이스에 대한 포인터입니다. 도킹 창 개체는 이 인터페이스에 대해 QueryInterface 메서드를 호출하고 IID_IDockingWindowSite 요청해야 합니다. 그런 다음 도킹 창 개체는 해당 인터페이스를 사용하여 테두리 공간을 협상합니다. 더 이상 필요하지 않은 경우 이 인터페이스를 해제하는 것은 도킹 창 개체의 책임입니다.

fReserved

형식: BOOL

예약되어 있습니다. 이 매개 변수는 항상 0이어야 합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

prcBorder 매개 변수에는 프레임의 사용 가능한 전체 테두리 공간이 포함됩니다. 도킹 창 개체는 테두리 공간을 협상한 다음 이 정보를 사용하여 위치를 지정해야 합니다.

예를 들어 도킹 창 개체에 테두리 공간 맨 위에 25픽셀이 필요한 경우 다음 단계를 통해 이를 위해 협상해야 합니다.

  1. BORDERWIDTHS 구조를 할당하고 상위 멤버를 25로 설정합니다.
  2. RequestBorderSpaceDW를 호출하여 공간을 요청합니다.
  3. 요청이 RequestBorderSpaceDW에 의해 승인된 경우 SetBorderSpaceDW를 호출하여 공간을 할당합니다.
그러면 도킹 창 개체가 창을 prcBorder-left 및 prcBorder-top>>에 배치할 수 있습니다. 도킹 창 개체의 창 너비는 prcBorder-right>에서 prcBorder-left>를 빼서 결정됩니다. 높이가 BORDERWIDTHS 구조체의 위쪽 멤버에 포함됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 shobjidl_core.h(Shlobj.h 포함)
DLL Shell32.dll(버전 4.71 이상)

추가 정보

IDeskBand

IDockingWindow

IDockingWindowFrame

IDockingWindowSite