IFileDialog::SetFolder 方法 (shobjidl_core.h)
設定開啟對話框時一律選取的資料夾,不論先前的用戶動作為何。
語法
HRESULT SetFolder(
[in] IShellItem *psi
);
參數
[in] psi
類型: IShellItem*
表示資料夾之介面的指標。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
此資料夾會覆寫任何「最近使用」的資料夾。 如果在對話框顯示時呼叫這個方法,就會讓對話框巡覽至指定的資料夾。
一般而言,我們不建議使用此方法。 如果您在顯示對話方塊之前呼叫 SetFolder ,則不會顯示使用者儲存或開啟的最新位置。 除非此行為有非常明確的原因,否則這不是良好的或預期的用戶體驗,因此應該避免。 在幾乎所有實例中, IFileDialog::SetDefaultFolder 是更好的方法。
從 Windows 7 起,如果透過 psi 指定的資料夾路徑是已知資料夾的預設路徑,則會在對話方塊中使用 已知資料夾的目前路徑。 該路徑可能與 psi 中指定的路徑不同;例如,如果已知資料夾已重新導向。 如果已知資料夾是虛擬資料夾檔、音樂、圖片和影片) (文檔庫,則會在對話框中使用文檔庫的路徑。 如果指定的文檔庫預設為 Windows 8.1) 時隱藏 (,則會在對話框中使用文檔庫的預設儲存位置,例如文檔庫的 Microsoft OneDrive Documents資料夾。 由於這些對應,在對話框中使用的資料夾位置可能與您呼叫此方法時所指定的位置不完全一樣。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | shobjidl_core.h (包含 Shobjidl.h) |