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

  • Artigo

[A reorganização está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use GetSortColumns.]

Reorganiza os itens em uma exibição de acordo com uma regra de classificação.

Sintaxe

HRESULT Rearrange(
  [in] LPARAM lParamSort
);

Parâmetros

[in] lParamSort

Tipo: LPARAM

Especifica como a reorganização deve ser executada.

Os dezesseis bits inferiores de lParamSort definem a regra de classificação. A maioria dos aplicativos define a regra de classificação como o valor padrão de zero, indicando que os itens devem ser classificados por nome. O sistema não define nenhuma outra regra de classificação. Alguns objetos de pasta podem permitir que aplicativos de chamada usem os dezesseis bits inferiores de lParamSort para especificar regras de classificação específicas de pasta. As regras e seus valores lParamSort associados são definidos pela pasta .

Quando o objeto de exibição de pasta do sistema chama IShellFolderView::Rearrange, os dezesseis bits inferiores de lParamSort são usados para especificar a coluna a ser usada para a organização.

Os dezesseis bits superiores de lParamSort são usados para sinalizadores que modificam a regra de classificação. Atualmente, o sistema define os sinalizadores de modificador a seguir.

SHCIDS_ALLFIELDS

Versão 5.0. Organize todas as informações contidas na estrutura ITEMIDLIST , não apenas nos nomes de exibição. Esse sinalizador é válido apenas para objetos de pasta que dão suporte à interface IShellFolder2 . Por exemplo, se os dois itens forem arquivos, a pasta deverá organizar seus nomes, tamanhos, tempos de arquivo, atributos e qualquer outra informação nas estruturas. Se esse sinalizador estiver definido, os dezesseis bits inferiores de lParamSort deverão ser zero.

SHCIDS_CANONICALONLY

Versão 5.0. Ao organizar por nome, organize os nomes do sistema, mas não os nomes de exibição. Quando esse sinalizador é passado, os dois itens são organizados por qualquer critério que a pasta Shell determine mais eficiente, desde que implemente uma função de classificação consistente. Esse sinalizador não pode ser combinado com outros sinalizadores.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Observação aos aplicativos de chamada

Não defina o sinalizador SHCIDS_ALLFIELDS em lParamSort se o objeto folder não der suporte a IShellFolder2. Fazer isso pode ter resultados imprevisíveis. Se você usar o sinalizador SHCIDS_ALLFIELDS , os dezesseis bits inferiores de lParamSort deverão ser definidos como zero.

Observação aos implementadores

Para extrair a regra de classificação, use um operador AND bit a bit (&) para combinar lParamSort com SHCIDS_COLUMNMASK (0X0000FFFF). Essa operação mascara os dezesseis bits superiores de lParamSort, incluindo o valor SHCIDS_ALLFIELDS .

Requisitos

Requisito Valor
Cliente mínimo com suporte 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 shlobj_core.h