FVSHOWINFO 構造体 (shlobj.h)

[アーティクル]
03/05/2024

ファイルビューアーがファイルを表示するために使用する情報が含まれます。

構文

typedef struct {
  DWORD    cbSize;
  HWND     hwndOwner;
  int      iShow;
  DWORD    dwFlags;
  RECT     rect;
  IUnknown *punkRel;
  OLECHAR  strNewFile[MAX_PATH];
} FVSHOWINFO, *LPFVSHOWINFO;

メンバー

cbSize

型: DWORD

この構造体のサイズ (バイト単位)。

hwndOwner

型: HWND

ファイルが表示されるウィンドウの所有者へのウィンドウハンドル。

iShow

型: int

ウィンドウの show コマンド。このパラメーターは、ShowWindow で詳しく説明されているSW_値の 1 つです。

dwFlags

型: DWORD

ファイルビューアーに表示される内容を決定するフラグ。このメンバーには、次の値の 1 つ以上を指定できます。

FVSIF_CANVIEWIT

ファイルビューアーは、ファイルを表示できます。

FVSIF_NEWFAILED

ファイルビューアーは、表示する新しいファイルを指定しましたが、ファイルを表示できませんでした。ファイルビューアーは、引き続き前のファイルを表示するか、終了する必要があります。

FVSIF_NEWFILE

ドラッグアンドドロップ操作によって、ファイルビューアーウィンドウにファイルがドロップされました。ファイルビューアーは、ファイルの名前を strNewFile メンバーにコピーしてシェルに渡します。シェルは、新しいファイルを表示できるファイルビューアーの読み込みを試みます。

FVSIF_PINNED

固定されたウィンドウが存在します。ファイルビューアーは、ピン留めされたウィンドウを使用してファイルを表示するか、新しい固定ウィンドウを設定してファイルを表示する必要があります。

FVSIF_RECT

rect メンバーには有効なデータが含まれています。

rect

種類: RECT

ファイルビューアーのウィンドウのサイズと位置を指定する RECT 構造体。このメンバーは、 dwFlags メンバーに FVSIF_RECT 値が含まれている場合にのみ有効です。

punkRel

種類: IUnknown*

前のファイルビューアーを解放するために新しいファイルビューアーによって呼び出される Release メソッドを持つインターフェイスのアドレス。このメンバーは、ドラッグアンドドロップ操作でファイルビューアーのウィンドウにファイルをドロップするときに使用されます。

strNewFile[MAX_PATH]

種類: OLECHAR[MAX_PATH]

表示する新しいファイルの名前を指定する文字列のアドレス。ファイルビューアーは、ドラッグアンドドロップ操作でファイルビューアーのウィンドウにファイルをドロップしたときに、このメンバーを設定します。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
Header	shlobj.h

次の方法で共有