INameSpaceTreeControl::AppendRoot 方法 (shobjidl_core.h)
將Shell專案附加至樹狀結構中的根目錄清單。
語法
HRESULT AppendRoot(
[in] IShellItem *psiRoot,
[in] SHCONTF grfEnumFlags,
[in] NSTCROOTSTYLE grfRootStyle,
[in] IShellItemFilter *pif
);
參數
[in] psiRoot
類型: IShellItem*
要附加之Shell專案的指標。
[in] grfEnumFlags
類型: SHCONTF
列舉根及其所有子系的品質。 SHCONTF 類型的一或多個值。 這些旗標可以使用位 OR 合併。
[in] grfRootStyle
類型: NSTCROOTSTYLE
指定要附加之根目錄的樣式。 下列一或多個值:
NSTCRS_VISIBLE (0x0000)
根目錄是可見的,以及專案。 與NSTCRS_HIDDEN互斥。
NSTCRS_HIDDEN (0x0001)
根目錄會隱藏,以便只顯示子系。 與NSTCRS_VISIBLE互斥。
NSTCRS_EXPANDED (0x0002)
初始化時會展開根目錄。
[in] pif
類型: IShellItemFilter*
IShellItemFilter 的指標,可讓您篩選樹狀結構中顯示的專案。 如果有提供,每個專案都可以使用 SHCONTF 旗標來自定義。 如果不需要任何篩選條件,這個值可以是 NULL 。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | shobjidl_core.h (包含 Shobjidl.h) |