_SHCONTF列挙 (shobjidl_core.h)

  • [アーティクル]

列挙に含まれる項目の種類を決定します。 これらの値は 、IShellFolder::EnumObjects メソッドで使用されます。

構文

typedef enum _SHCONTF {
  SHCONTF_CHECKING_FOR_CHILDREN = 0x10,
  SHCONTF_FOLDERS = 0x20,
  SHCONTF_NONFOLDERS = 0x40,
  SHCONTF_INCLUDEHIDDEN = 0x80,
  SHCONTF_INIT_ON_FIRST_NEXT = 0x100,
  SHCONTF_NETPRINTERSRCH = 0x200,
  SHCONTF_SHAREABLE = 0x400,
  SHCONTF_STORAGE = 0x800,
  SHCONTF_NAVIGATION_ENUM = 0x1000,
  SHCONTF_FASTITEMS = 0x2000,
  SHCONTF_FLATLIST = 0x4000,
  SHCONTF_ENABLE_ASYNC = 0x8000,
  SHCONTF_INCLUDESUPERHIDDEN = 0x10000
} ;

定数

 
SHCONTF_CHECKING_FOR_CHILDREN
値: 0x10
0x00010。 Windows 7 以降。 呼び出し元のアプリケーションは、 フォルダー内に子項目が存在するかどうかを確認しています。
SHCONTF_FOLDERS
値: 0x20
0x00020。 列挙にフォルダーである項目を含めます。
SHCONTF_NONFOLDERS
値: 0x40
0x00040。 列挙体にフォルダーではない項目を含めます。
SHCONTF_INCLUDEHIDDEN
値: 0x80
0x00080。 列挙に非表示の項目を含めます。 これには、非表示のシステム項目は含まれません。 (非表示のシステム項目を含めるには、SHCONTF_INCLUDESUPERHIDDENを使用します)。
SHCONTF_INIT_ON_FIRST_NEXT
値: 0x100
0x00100。 使用されなくなりました。常に想定されます。 IShellFolder::EnumObjects は列挙 オブジェクトを検証せずに を返すことができます。 検証は、 IEnumIDList::Next の最初の呼び出しまで延期できます。 このフラグは、最初の IEnumIDList::Next 呼び出しの前にユーザー インターフェイスが表示される場合に使用します。 ユーザー インターフェイスを表示するには、 hwnd を有効なウィンドウ ハンドルに設定する必要があります。
SHCONTF_NETPRINTERSRCH
値: 0x200
0x00200。 呼び出し元のアプリケーションは、プリンター オブジェクトを探しています。
SHCONTF_SHAREABLE
値: 0x400
0x00400。 呼び出し元のアプリケーションは、共有できるリソースを探しています。
SHCONTF_STORAGE
値: 0x800
0x00800。 非表示のアイテムを含む、アクセス可能なストレージとその先祖を含むアイテムを含めます。
SHCONTF_NAVIGATION_ENUM
値: 0x1000
0x01000。 Windows 7 以降。 子フォルダーは、ナビゲーション列挙を提供する必要があります。
SHCONTF_FASTITEMS
値: 0x2000
0x02000。 Windows Vista 以降。 呼び出し元のアプリケーションは、すぐに列挙できるリソースを探しています。
SHCONTF_FLATLIST
値: 0x4000
0x04000。 Windows Vista 以降。 互換性のために残されています。 使用しないでください。
SHCONTF_ENABLE_ASYNC
値: 0x8000
0x08000。 Windows Vista 以降。 呼び出し元のアプリケーションは、変更通知を監視しています。 これは、列挙子がすべての結果を返す必要がないことを意味します。 アイテムは変更通知を通じて報告できます。
SHCONTF_INCLUDESUPERHIDDEN
値: 0x10000
0x10000。 Windows 7 以降。 列挙に非表示のシステム項目を含めます。 この値には、非表示のシステム以外の項目は含まれません。 (非表示のシステム以外の項目を含めるには、SHCONTF_INCLUDEHIDDENを使用します)。

注釈

SHCONTF_INIT_ON_FIRST_NEXT フラグを設定すると、呼び出し元のアプリケーションは、IShellFolder::EnumObjects メソッドが初期化されていない列挙オブジェクトを返すことによって列挙プロセスを高速化できることを提案します。 初期化は、列挙プロセスが開始されるまで延期できます。 列挙オブジェクトの初期化が時間の長いプロセスである場合、メソッドの実装は、初期化されていないオブジェクトを直ちに返す必要があります。 IEnumIDList::Next メソッドが初めて呼び出されるまで初期化を延期します。 初期化にユーザー入力が必要な場合、メソッドの実装では、ユーザー インターフェイスの親ウィンドウとして hwnd を使用する必要があります。 hwnd が NULL に設定されている場合の操作の詳細については、IShellFolder::EnumObjects のリファレンスを参照してください。

メモ この列挙体の名前は、Windows Vista で _SHCONTF に変更されました。 以前は、 tagSHCONTF という名前でした。 レガシ コードとの互換性を保つために、 SHCONTF という名前は typedef ステートメントを使用して DWORD のシノニムとして定義されます。
 

要件

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