IShellFolderView::Rearrange-Methode (shlobj_core.h)

Artikel
03/02/2024

[Neu anordnen ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen GetSortColumns.]

Ordnet die Elemente in einer Ansicht gemäß einer Sortierregel neu an.

Syntax

HRESULT Rearrange(
  [in] LPARAM lParamSort
);

Parameter

[in] lParamSort

Typ: LPARAM

Gibt an, wie die Neuanordnung durchgeführt werden soll.

Die unteren sechzehn Bits von lParamSort 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 lParamSort verwenden, um ordnerspezifische Sortierregeln anzugeben. Die Regeln und die zugehörigen lParamSort-Werte werden vom Ordner definiert.

Wenn das Systemordneransichtsobjekt IShellFolderView::Rearrange aufruft, werden die unteren sechzehn Bits von lParamSort verwendet, um die Spalte anzugeben, die für die Anordnung verwendet werden soll.

Die oberen sechzehn Bits von lParamSort 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, sollte der Ordner für instance die Namen, Größen, Dateizeiten, Attribute und alle anderen Informationen in den Strukturen anordnen. Wenn dieses Flag festgelegt ist, müssen die unteren sechzehn Bits von lParamSort 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.

Hinweise

Hinweis zum Aufrufen von Anwendungen

Legen Sie das SHCIDS_ALLFIELDS-Flag in lParamSort nicht fest, wenn das Ordnerobjekt IShellFolder2 nicht unterstützt. Dies kann zu unvorhersehbaren Ergebnissen kommen. Wenn Sie das flag SHCIDS_ALLFIELDS verwenden, müssen die unteren sechzehn Bits von lParamSort auf Null festgelegt werden.

Hinweis zu Implementern

Verwenden Sie zum Extrahieren der Sortierregel einen bitweisen AND-Operator (&), um lParamSort mit SHCIDS_COLUMNMASK (0X0000FFFF) zu kombinieren. Dieser Vorgang maskiert die oberen sechzehn Bits von lParamSort, einschließlich des SHCIDS_ALLFIELDS-Werts .

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

Freigeben über