Compartir a través de

Método IShellFolder2::GetDefaultColumn (shobjidl_core.h)

  • Artículo

Obtiene las columnas de ordenación y visualización predeterminadas.

Sintaxis

HRESULT GetDefaultColumn(
  [in]  DWORD dwRes,
  [out] ULONG *pSort,
  [out] ULONG *pDisplay
);

Parámetros

[in] dwRes

Tipo: DWORD

Reservado. Establecer en cero.

[out] pSort

Tipo: ULONG*

Puntero a un valor que recibe el índice de la columna ordenada predeterminada.

[out] pDisplay

Tipo: ULONG*

Puntero a un valor que recibe el índice de la columna de presentación predeterminada.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error COM en caso contrario.

Comentarios

Notas a los usuarios

Ambos índices de columna devueltos por este método están diseñados para su uso por una aplicación que presenta una vista de carpeta de esta carpeta.

La columna especificada por pSort es la que se debe usar para ordenar los elementos de la carpeta. Para determinar el criterio de ordenación de cualquier par de elementos, pase sus PIN a CompareIDs. Especifique la columna estableciendo el parámetro lParam de CompareIDs en el valor al que apunta pSort.

Si una vista mostrará solo una cadena para representar un elemento, se debe tomar de la columna especificada por pDisplay. Pase el índice de columna y el PIDL del elemento a IShellFolder2::GetDetailsOf para recuperar la cadena.

Notas para los implementadores

Este método forma parte de la implementación de objetos de carpeta de una extensión de espacio de nombres. Normalmente, un objeto de vista de carpeta llama a él para preguntar al objeto de carpeta qué columna de la vista Detalles del Explorador de Microsoft Windows se debe usar para ordenar los elementos de la carpeta. Por ejemplo, un objeto de carpeta que representa un registro de transacciones podría establecer pSort en la columna que muestra el tiempo de transacción. Los elementos se ordenarán por el momento en que tuvo lugar la transacción, en lugar de por nombre.

Algunos clientes pueden llamar a este método para solicitar el índice de la columna con los nombres que se deben mostrar en la vista de árbol. Establezca pDisplay en el índice de columna adecuado. A continuación, el cliente obtendrá los nombres para mostrar llamando a IShellFolder2::GetDetailsOf.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)
Archivo DLL Shell32.dll (versión 5.0 o posterior)