共用方式為

IOleInPlaceUIWindow：：SetBorderSpace 方法 (oleidl.h)

  • 發行項

為 呼叫 IOleInPlaceUIWindow：：RequestBorderSpace 中要求的框線配置空間。

語法

HRESULT SetBorderSpace(
  [in] LPCBORDERWIDTHS pborderwidths
);

參數

[in] pborderwidths

BORDERWIDTHS 結構的指標，其中包含工具的要求寬度，以像素為單位。 它可以是 NULL，表示物件不需要任何空間。

傳回值

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

傳回碼 Description
OLE_E_INVALIDRECT
 矩形不位於 IOleInPlaceUIWindow：：GetBorder 所傳回的規格內。

備註

對象必須呼叫 IOleInPlaceUIWindow：：SetBorderSpace。 它可以執行下列任一項：

  • 使用自己的工具列，要求特定大小的框線空間。
  • 不使用任何工具列，但藉由傳遞 pborderwidths 參數中不含零的有效 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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 oleidl.h

另請參閱

IOleInPlaceUIWindow

IOleInPlaceUIWindow：：GetBorder

IOleInPlaceUIWindow：：RequestBorderSpace