IOleInPlaceUIWindow::SetBorderSpace メソッド (oleidl.h)
IOleInPlaceUIWindow::RequestBorderSpace の呼び出しで要求された罫線の領域を割り当てます。
構文
HRESULT SetBorderSpace(
[in] LPCBORDERWIDTHS pborderwidths
);
パラメーター
[in] pborderwidths
ツールの要求された幅をピクセル単位で含む BORDERWIDTHS 構造体へのポインター。 オブジェクトにスペースが必要ないことを示す NULL を指定できます。
戻り値
このメソッドは、成功したS_OKを返します。 その他の可能な戻り値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
四角形は 、IOleInPlaceUIWindow::GetBorder によって返される仕様内にありません。 |
注釈
オブジェクトは IOleInPlaceUIWindow::SetBorderSpace を呼び出す必要があります。 次のいずれかを実行できます。
- 独自のツール バーを使用して、特定のサイズの罫線領域を要求します。
- ツール バーは使用しませんが、pborderwidths パラメーターに 0 以外の値を含まない有効な BORDERWIDTHS 構造体を渡して、コンテナーでツールバーを強制的に削除します。
- ツール バーは使用しませんが、インプレース コンテナーでは pborderwidths パラメーターとして NULL を渡すことで、そのツールバーを上に残すことができます。
オブジェクトが境界線上の領域を再ネゴシエーションする必要がある場合は、新しい幅で 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 |