Método IShellFolderView::GetArrangeParam (shlobj_core.h)

Obtiene el parámetro de organización de la vista, que es cómo se ha ordenado la vista.

Sintaxis

HRESULT GetArrangeParam(
  [out] LPARAM *plParamSort
);

Parámetros

[out] plParamSort

Tipo: LPARAM*

Los dieciséis bits inferiores de plParamSort definen la regla de ordenación. La mayoría de las aplicaciones establecen la regla de ordenación en el valor predeterminado de cero, lo que indica que los elementos deben ordenarse por nombre. El sistema no define ninguna otra regla de ordenación. Algunos objetos de carpeta pueden permitir que las aplicaciones que llaman usen los dieciséis bits inferiores de plParamSort para especificar reglas de ordenación específicas de carpetas. Las reglas y sus valores plParamSort asociados se definen mediante la carpeta .

Cuando el objeto de vista de carpetas del sistema llama a IShellFolderView::GetArrangeParam, se usan los dieciséis bits inferiores de plParamSort para especificar la columna que se usará para la organización.

Los dieciséis bits superiores de plParamSort se usan para marcas que modifican la regla de ordenación. Actualmente, el sistema define las marcas modificadores siguientes.

SHCIDS_ALLFIELDS

Versión 5.0. Organice toda la información contenida en la estructura ITEMIDLIST , no solo los nombres para mostrar. Esta marca solo es válida para los objetos de carpeta que admiten la interfaz IShellFolder2 . Por ejemplo, si los dos elementos son archivos, la carpeta organiza sus nombres, tamaños, tiempos de archivo, atributos y cualquier otra información de las estructuras. Si se establece esta marca, los dieciséis bits inferiores de plParamSort deben ser cero.

SHCIDS_CANONICALONLY

Versión 5.0. Al organizar por nombre, organice los nombres del sistema, pero no los nombres para mostrar. Cuando se pasa esta marca, los dos elementos se organizan según los criterios que determine la carpeta shell más eficaz, siempre y cuando implemente una función de ordenación coherente. Esta marca no se puede combinar con otras marcas.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos