IShellFolderView::GetArrangeParam 方法 (shlobj_core.h)
取得檢視的排列參數,也就是檢視的排序方式。
語法
HRESULT GetArrangeParam(
[out] LPARAM *plParamSort
);
參數
[out] plParamSort
類型: LPARAM*
plParamSort 的下十六位會定義排序規則。 大部分的應用程式會將排序規則設定為預設值零,表示專案應該依名稱排序。 系統不會定義任何其他排序規則。 某些資料夾物件可能會允許呼叫應用程式使用 plParamSort 的下十六位來指定資料夾特定的排序規則。 規則及其相關聯的 plParamSort 值是由資料夾所定義。
當系統資料夾檢視物件呼叫 IShellFolderView::GetArrangeParam 時, plParamSort 的下十六位會用來指定要用於排列的數據行。
plParamSort 的上十六位會用於修改排序規則的旗標。 系統目前定義下列修飾詞旗標。
SHCIDS_ALLFIELDS
5.0 版。 排列 ITEMIDLIST 結構中包含的所有資訊,而不只是顯示名稱。 這個旗標只適用於支援 IShellFolder2 介面的資料夾物件。 例如,如果這兩個專案是檔案,資料夾會排列其名稱、大小、檔案時間、屬性,以及結構中的任何其他資訊。 如果設定此旗標, plParamSort 的下十六位必須是零。
SHCIDS_CANONICALONLY
5.0 版。 依名稱排列時,請排列系統名稱,但不會排列顯示名稱。 傳遞此旗標時,只要Shell資料夾實作一致的排序函式,Shell 資料夾會決定最有效率的任何準則來排列這兩個專案。 此旗標無法與其他旗標結合。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | shlobj_core.h |