決定列舉中包含的項目類型。 這些值會搭配 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
} ;
Constants
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 必須設定為有效的視窗 handle。 |
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 的同義詞。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| Header | shobjidl_core.h(包括 Shobjidl.h) |