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 構造体を渡して、コンテナーでツールバーを強制的に削除します。
  • ツール バーは使用しませんが、インプレース コンテナーでは pborderwidths パラメーターとして NULL を渡すことで、そのツールバーを上に残すことができます。
この呼び出しで使用される 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