IDockingWindow::ResizeBorderDW メソッド (shobjidl_core.h)

  • [アーティクル]

フレームの境界線スペースが変更されたことをドッキング ウィンドウ オブジェクトに通知します。 このメソッドに応答して、境界スペースが不要な場合や変更が必要ない場合でも、 IDockingWindow 実装は SetBorderSpaceDW を呼び出す必要があります。

構文

HRESULT ResizeBorderDW(
  LPCRECT  prcBorder,
  IUnknown *punkToolbarSite,
  BOOL     fReserved
);

パラメーター

prcBorder

種類: LPCRECT

フレームの使用可能な罫線スペースを含む RECT 構造体へのポインター。

punkToolbarSite

種類: IUnknown*

サイトの IUnknown インターフェイスへのポインター。 ドッキング ウィンドウ オブジェクトは、このインターフェイスの QueryInterface メソッドを呼び出して、IID_IDockingWindowSiteを要求する必要があります。 その後、ドッキング ウィンドウ オブジェクトは、そのインターフェイスを使用してその境界領域をネゴシエートします。 このインターフェイスが不要になったら、このインターフェイスを解放するのはドッキング ウィンドウ オブジェクトの責任です。

fReserved

種類: BOOL

予約済み。 このパラメーターは常に 0 である必要があります。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

prcBorder パラメーターには、フレームの使用可能な境界領域全体が含まれます。 ドッキング ウィンドウ オブジェクトは、境界領域をネゴシエートしてから、この情報を使用して自身を配置する必要があります。

たとえば、ドッキング ウィンドウ オブジェクトの境界領域の上部に 25 ピクセルが必要な場合は、次の手順を使用してこれをネゴシエートする必要があります。

  1. BORDERWIDTHS 構造体を割り当て、その最上位メンバーを 25 に設定します。
  2. RequestBorderSpaceDW を呼び出して領域を要求します。
  3. RequestBorderSpaceDW によって要求が承認された場合は、SetBorderSpaceDW を呼び出して領域を割り当てます。
ドッキング ウィンドウ オブジェクトは、そのウィンドウを prcBorder-left> および prcBorder-top> に配置できます。 ドッキング ウィンドウ オブジェクトのウィンドウの幅は、prcBorder-right> から prcBorder-left> を減算することによって決定されます。 その高さは BORDERWIDTHS 構造体の最上位メンバーに含まれています。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Shlobj.h を含む)
[DLL] Shell32.dll (バージョン 4.71 以降)

こちらもご覧ください

IDeskBand

IDockingWindow

IDockingWindowFrame

IDockingWindowSite