IShellFolder 介面 (shobjidl_core.h)
由所有Shell命名空間資料夾物件公開,其方法會用來管理資料夾。
繼承
IShellFolder 介面繼承自 IUnknown 介面。 IShellFolder 也有下列類型的成員:
方法
IShellFolder 介面具有這些方法。
IShellFolder::BindToObject 擷取處理程式,通常是實作特定專案的 IShellFolder 的 Shell 資料夾物件。 控制處理程式建構的選擇性參數會在系結內容中傳遞。 |
IShellFolder::BindToStorage 要求對象的儲存介面指標。 |
IShellFolder::CompareIDs 決定兩個檔案物件或資料夾的相對順序,指定其專案識別符清單。 |
IShellFolder::CreateViewObject 要求物件,該物件可用來取得或與資料夾物件互動的資訊。 |
IShellFolder::EnumObjects 可讓客戶端藉由建立專案標識碼列舉物件並傳回其 IEnumIDList 介面,來判斷資料夾的內容。 然後,該介面所支援的方法可用來列舉資料夾的內容。 |
IShellFolder::GetAttributesOf 取得 IShellFolder 所表示之 物件中包含的一或多個檔案或資料夾物件的屬性。 |
IShellFolder::GetDisplayNameOf 擷取指定之檔案物件或子資料夾的顯示名稱。 |
IShellFolder::GetUIObjectOf 取得 對象,這個物件可用來對指定的檔案物件或資料夾執行動作。 |
IShellFolder::P arseDisplayName 將檔案對象的顯示名稱或資料夾轉譯成專案識別碼清單。 |
IShellFolder::SetNameOf 設定檔案物件或子資料夾的顯示名稱,變更程式中的項目識別元。 |
備註
針對擴充Shell命名空間的物件實作這個介面。 例如,實作此介面來建立需要根 Windows 檔案總管的個別命名空間,或直接在系統命名空間階層中安裝新的命名空間。 您最熟悉命名空間的內容,因此您必須負責實作存取數據所需的一切。
當您需要在Shell命名空間的內容上顯示或執行作業時,請使用這個介面。 支援 IShellFolder 的物件通常是由其他 Shell 資料夾物件所建立。 若要擷取資料夾的 IShellFolder 介面,您通常會從呼叫 SHGetDesktopFolder 開始。 此函式會傳回桌面 IShellFolder 介面的指標。 然後,您可以使用其方法來擷取特定命名空間資料夾的 IShellFolder 介面。
注意IShellFolder 方法只接受相對於資料夾的PIDL。 某些 IShellFolder 方法,例如 IShellFolder::GetAttributesOf,只接受單一層級的 PIDL。 換句話說,PIDL 必須只包含單一 SHITEMID 結構,加上終止 的 NULL。 當您使用 IEnumIDList 列舉資料夾的內容時,您會收到此表單的 PIDL。 其他方法,例如 IShellFolder::CompareID,接受多層級的 PID。 這些 PIDL 可以有多個 SHITEMID 結構,並識別父資料夾下方一或多個層級的物件。 請檢查參考以確定特定方法可以接受何種類型的 PIDL。
例子
您可以在總管數據提供者範例範例中看到 IShellFolder 的範例實作。 您可以在數個範例中找到各種 IShellFolder 方法的使用方式,包括 檔案作業範例。規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | shobjidl_core.h |