Méthode IShellFolderView ::Rearrange (shlobj_core.h)

Article
08/26/2023

[La réorganisation est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt GetSortColumns.]

Réorganise les éléments d’une vue en fonction d’une règle de tri.

Syntaxe

HRESULT Rearrange(
  [in] LPARAM lParamSort
);

Paramètres

[in] lParamSort

Type : LPARAM

Spécifie la façon dont le réarrangement doit être effectué.

Les seize bits inférieurs de lParamSort définissent la règle de tri. La plupart des applications définissent la règle de tri sur la valeur par défaut zéro, ce qui indique que les éléments doivent être triés par nom. Le système ne définit aucune autre règle de tri. Certains objets de dossier peuvent permettre aux applications appelantes d’utiliser les seize bits inférieurs de lParamSort pour spécifier des règles de tri spécifiques au dossier. Les règles et leurs valeurs lParamSort associées sont définies par le dossier .

Lorsque l’objet d’affichage de dossier système appelle IShellFolderView ::Rearrange, les seize bits inférieurs de lParamSort sont utilisés pour spécifier la colonne à utiliser pour l’organisation.

Les seize bits supérieurs de lParamSort sont utilisés pour les indicateurs qui modifient la règle de tri. Le système définit actuellement les indicateurs de modification suivants.

SHCIDS_ALLFIELDS

Version 5.0. Organisez toutes les informations contenues dans la structure ITEMIDLIST , pas seulement les noms d’affichage. Cet indicateur est valide uniquement pour les objets de dossier qui prennent en charge l’interface IShellFolder2 . Par instance, si les deux éléments sont des fichiers, le dossier doit organiser leurs noms, tailles, heures de fichier, attributs et toute autre information dans les structures. Si cet indicateur est défini, les seize bits inférieurs de lParamSort doivent être zéro.

SHCIDS_CANONICALONLY

Version 5.0. Lors de l’organisation par nom, organisez les noms système, mais pas les noms d’affichage. Lorsque cet indicateur est passé, les deux éléments sont organisés selon les critères que le dossier Shell détermine le plus efficace, tant qu’il implémente une fonction de tri cohérente. Cet indicateur ne peut pas être combiné avec d’autres indicateurs.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Remarque concernant l’appel d’applications

Ne définissez pas l’indicateur SHCIDS_ALLFIELDS dans lParamSort si l’objet folder ne prend pas en charge IShellFolder2. Cela peut avoir des résultats imprévisibles. Si vous utilisez l’indicateur SHCIDS_ALLFIELDS , les seize bits inférieurs de lParamSort doivent être définis sur zéro.

Remarque à l’attention des implémenteurs

Pour extraire la règle de tri, utilisez un opérateur AND au niveau du bit (&) pour combiner lParamSort avec SHCIDS_COLUMNMASK (0X0000FFFF). Cette opération masque les seize bits supérieurs de lParamSort, y compris la valeur SHCIDS_ALLFIELDS .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h

Partager via