IShellFolderView::GetArrangeParam-Methode (shlobj_core.h)

Ruft den Anordnungsparameter der Ansicht ab, so wie die Ansicht sortiert wurde.

Hinweis Diese Methode ist ab Windows Vista veraltet. Es kann in nachfolgenden Versionen von Windows geändert oder nicht verfügbar sein. Es wird empfohlen, stattdessen IFolderView2::GetSortColumns zu verwenden.

 

Syntax

HRESULT GetArrangeParam(
  [out] LPARAM *plParamSort
);

Parameter

[out] plParamSort

Typ: LPARAM*

Die unteren sechzehn Bits von plParamSort definieren die Sortierregel. Die meisten Anwendungen legen die Sortierregel auf den Standardwert 0 (null) fest, was angibt, dass die Elemente nach Namen sortiert werden sollen. Das System definiert keine anderen Sortierregeln. Einige Ordnerobjekte ermöglichen es möglicherweise, dass aufrufende Anwendungen die unteren sechzehn Bits von plParamSort verwenden, um ordnerspezifische Sortierregeln anzugeben. Die Regeln und die zugehörigen plParamSort-Werte werden vom Ordner definiert.

Wenn das Systemordneransichtsobjekt IShellFolderView::GetArrangeParam aufruft, werden die unteren sechzehn Bits von plParamSort verwendet, um die Spalte anzugeben, die zum Anordnen verwendet werden soll.

Die oberen sechzehn Bits von plParamSort werden für Flags verwendet, die die Sortierregel ändern. Das System definiert derzeit die folgenden Modifiziererflags.

SHCIDS_ALLFIELDS

Version 5.0. Ordnen Sie alle in der ITEMIDLIST-Struktur enthaltenen Informationen an, nicht nur die Anzeigenamen. Dieses Flag ist nur für Ordnerobjekte gültig, die die IShellFolder2-Schnittstelle unterstützen. Wenn es sich bei den beiden Elementen um Dateien handelt, ordnet der Ordner für instance ihre Namen, Größen, Dateizeiten, Attribute und alle anderen Informationen in den Strukturen an. Wenn dieses Flag festgelegt ist, müssen die unteren sechzehn Bits von plParamSort null sein.

SHCIDS_CANONICALONLY

Version 5.0. Wenn Sie nach Namen anordnen, ordnen Sie die Systemnamen an, aber nicht die Anzeigenamen. Wenn dieses Flag übergeben wird, werden die beiden Elemente nach den Kriterien angeordnet, die der Shellordner am effizientesten bestimmt, solange er eine konsistente Sortierfunktion implementiert. Dieses Flag kann nicht mit anderen Flags kombiniert werden.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h