IShellFolderView ::GetArrangeParam, méthode (shlobj_core.h)

Obtient le paramètre de disposition de la vue, qui est la façon dont la vue a été triée.

Syntaxe

HRESULT GetArrangeParam(
  [out] LPARAM *plParamSort
);

Paramètres

[out] plParamSort

Type : LPARAM*

Les seize bits inférieurs de plParamSort 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 plParamSort pour spécifier des règles de tri spécifiques aux dossiers. Les règles et leurs valeurs plParamSort associées sont définies par le dossier .

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

Les seize bits supérieurs de plParamSort 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 complets. 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 organise 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 plParamSort 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.

Spécifications