IOleInPlaceActiveObject::ResizeBorder 方法 (oleidl.h)

警示物件需要調整其框線空間的大小。

語法

HRESULT ResizeBorder(
  [in] LPCRECT             prcBorder,
  [in] IOleInPlaceUIWindow *pUIWindow,
  [in] BOOL                fFrameWindow
);

參數

[in] prcBorder

RECT 結構的指標,其中包含新的外部矩形,物件可以在其中要求其工具的框線空間。

[in] pUIWindow

框線已變更之框架或文檔窗口物件的 IOleInPlaceUIWindow 介面指標指標。

[in] fFrameWindow

如果框架窗口物件呼叫 IOleInPlaceActiveObject::ResizeBorder,則此參數為 TRUE;否則為 FALSE

傳回值

此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。

傳回碼 Description
E_INVALIDARG
指定的參數值無效。
E_OUTOFMEMORY
作業的記憶體不足。
E_UNEXPECTED
發生意外錯誤。

備註

來電者附註

當配置給物件的框線空間應該變更時,最上層容器的檔或框架窗口物件會呼叫 IOleInPlaceActiveObject::ResizeBorder。 因為作用中的就地物件不會通知哪些視窗已變更, (框架或檔層級視窗) , 所以 IOleInPlaceActiveObject::ResizeBorder 必須傳遞視窗 IOleInPlaceUIWindow 介面的指標。

實作者的注意事項

在大部分情況下,重設大小只需要您成長、縮小或調整物件的框架裝飾。 不過,針對更複雜的裝飾,您可能需要重新交涉邊界空間,並呼叫 IOleInPlaceUIWindow::SetBorderSpaceIOleInPlaceUIWindow::SetBorderSpace
注意 在執行 IOleInPlaceActiveObject::ResizeBorder 時,請勿呼叫 PeekMessageGetMessage 函式或對話框。 這樣做可能會導致系統死結。 有進一步限制可從 IOleInPlaceActiveObject::ResizeBorder 內呼叫 OLE 介面方法和函式。
 

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 oleidl.h

另請參閱

GetMessage

IOleInPlaceActiveObject

IOleInPlaceUIWindow::GetBorder

PeekMessage