IOleInPlaceUIWindow::SetBorderSpace 메서드(oleidl.h)

IOleInPlaceUIWindow::RequestBorderSpace 호출에서 요청된 테두리의 공간을 할당합니다.

구문

HRESULT SetBorderSpace(
  [in] LPCBORDERWIDTHS pborderwidths
);

매개 변수

[in] pborderwidths

도구의 요청된 너비를 픽셀 단위로 포함하는 BORDERWIDTHS 구조체에 대한 포인터입니다. 개체에 공간이 필요하지 않음을 나타내는 NULL일 수 있습니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다. 가능한 다른 반환 값은 다음과 같습니다.

반환 코드	설명
OLE_E_INVALIDRECT	사각형은 IOleInPlaceUIWindow::GetBorder에서 반환된 사양 내에 있지 않습니다.

설명

개체는 IOleInPlaceUIWindow::SetBorderSpace를 호출해야 합니다. 다음 중 하나를 수행할 수 있습니다.

• 고유한 도구 모음을 사용하여 특정 크기의 테두리 공간을 요청합니다.
• 도구 모음은 사용하지 않지만 pborderwidths 매개 변수에 0만 포함하는 유효한 BORDERWIDTHS 구조를 전달하여 컨테이너가 해당 도구 모음을 제거하도록 합니다.
• 도구 모음은 사용하지 않지만, NULL 을 pborderwidths 매개 변수로 전달하여 현재 위치 컨테이너가 해당 도구 모음을 위로 유지하도록 허용합니다.

이 호출에 사용된 BORDERWIDTHS 구조체는 일반적으로 IOleInPlaceUIWindow::RequestBorderSpace에 대한 이전 호출에서 전달되었으므로 S_OK 반환해야 합니다.

개체가 테두리의 공간을 재협상해야 하는 경우 새 너비로 IOleInPlaceUIWindow::SetBorderSpace 를 다시 호출할 수 있습니다. IOleInPlaceUIWindow::SetBorderSpace에 대한 호출이 실패하면 개체는 IOleInPlaceUIWindow::GetBorder,IOleInPlaceUIWindow::RequestBorderSpace 및 IOleInPlaceUIWindow::SetBorderSpace를 호출하여 테두리 공간에 대한 전체 협상을 수행할 수 있습니다.

참고IOleInPlaceUIWindow::SetBorderSpace를 실행하는 동안 PeekMessage 또는 GetMessage 함수 또는 대화 상자를 호출하지 마세요. 이렇게 하면 시스템이 교착 상태에 빠질 수 있습니다. IOleInPlaceUIWindow::SetBorderSpace 내에서 OLE 인터페이스 메서드 및 함수를 호출할 수 있는 추가 제한 사항이 있습니다.

 

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	oleidl.h

추가 정보

IOleInPlaceUIWindow

IOleInPlaceUIWindow::GetBorder

IOleInPlaceUIWindow::RequestBorderSpace