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

  • Artigo

Obtém as colunas de classificação e exibição padrão.

Sintaxe

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

Parâmetros

[in] dwRes

Tipo: DWORD

Reservado. Defina como zero.

[out] pSort

Tipo: ULONG*

Um ponteiro para um valor que recebe o índice da coluna classificada padrão.

[out] pDisplay

Tipo: ULONG*

Um ponteiro para um valor que recebe o índice da coluna de exibição padrão.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro COM caso contrário.

Comentários

Observações aos usuários

Ambos os índices de coluna retornados por esse método destinam-se ao uso por um aplicativo que está apresentando uma exibição de pasta dessa pasta.

A coluna especificada pelo pSort é aquela que deve ser usada para classificar os itens na pasta. Para determinar a ordem de classificação de qualquer par de itens, passe suas PIDLs para CompareIDs. Especifique a coluna definindo o parâmetro lParam de CompareIDs para o valor apontado por pSort.

Se um modo de exibição exibir apenas uma cadeia de caracteres para representar um item, ele deverá ser retirado da coluna especificada pelo pDisplay. Passe o índice de coluna e o PIDL do item para IShellFolder2::GetDetailsOf para recuperar a cadeia de caracteres.

Observações aos implementadores

Esse método faz parte da implementação de objeto de pasta de uma extensão de namespace. Normalmente, ele é chamado por um objeto de exibição de pasta para perguntar ao objeto de pasta qual coluna no Microsoft Windows Explorer exibição Detalhes deve ser usada para classificar os itens na pasta. Por exemplo, um objeto de pasta que representa um log de transações pode definir pSort como a coluna que exibe o tempo de transação. Em seguida, os itens serão classificados pelo momento em que a transação ocorreu, em vez de pelo nome.

Alguns clientes podem chamar esse método para solicitar o índice da coluna com os nomes que devem ser exibidos no modo de exibição de árvore. Defina pDisplay como o índice de coluna apropriado. Em seguida, o cliente obterá os nomes de exibição chamando IShellFolder2::GetDetailsOf.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)
DLL Shell32.dll (versão 5.0 ou posterior)