Metodo IShellFolderView::Rearrange (shlobj_core.h)

Articolo
03/15/2023

[Ridisporre è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece GetSortColumns.]

Riorganizzare gli elementi in una visualizzazione in base a una regola di ordinamento.

Sintassi

HRESULT Rearrange(
  [in] LPARAM lParamSort
);

Parametri

[in] lParamSort

Tipo: LPARAM

Specifica la modalità di esecuzione della ridisponimento.

I sedici bit inferiori di lParamSort definiscono la regola di ordinamento. La maggior parte delle applicazioni imposta la regola di ordinamento sul valore predefinito zero, a indicare che gli elementi devono essere ordinati in base al nome. Il sistema non definisce altre regole di ordinamento. Alcuni oggetti cartella potrebbero consentire alle applicazioni di chiamare di usare i sedici bit inferiori di lParamSort per specificare le regole di ordinamento specifiche della cartella. Le regole e i relativi valori lParamSort associati vengono definiti dalla cartella .

Quando l'oggetto visualizzazione cartelle di sistema chiama IShellFolderView::Rearrange, vengono usati i sedici bit inferiori di lParamSort per specificare la colonna da utilizzare per la disposizione.

I sedici bit superiori di lParamSort vengono usati per i flag che modificano la regola di ordinamento. Il sistema definisce attualmente i flag di modificatore seguenti.

SHCIDS_ALLFIELDS

Versione 5.0. Disporre tutte le informazioni contenute nella struttura ITEMIDLIST , non solo i nomi visualizzati. Questo flag è valido solo per gli oggetti cartella che supportano l'interfaccia IShellFolder2 . Ad esempio, se i due elementi sono file, la cartella deve disporre i relativi nomi, dimensioni, tempi di file, attributi e altre informazioni nelle strutture. Se questo flag è impostato, i sedici bit inferiori di lParamSort devono essere zero.

SHCIDS_CANONICALONLY

Versione 5.0. Quando si dispone in base al nome, disporre i nomi di sistema ma non i nomi visualizzati. Quando questo flag viene passato, i due elementi vengono disposti in base a qualsiasi criterio determinato dalla cartella Shell, purché implementi una funzione di ordinamento coerente. Questo flag non può essere combinato con altri flag.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Nota per la chiamata di applicazioni

Non impostare il flag SHCIDS_ALLFIELDS in lParamSort se l'oggetto cartella non supporta IShellFolder2. In questo modo potrebbero verificarsi risultati imprevedibili. Se si usa il flag SHCIDS_ALLFIELDS , i sedici bit inferiori di lParamSort devono essere impostati su zero.

Nota per gli implementatori

Per estrarre la regola di ordinamento, usare un operatore AND bit per bit (&) per combinare lParamSort con SHCIDS_COLUMNMASK (0X0000FFFF). Questa operazione nasconde i sedici bit superiori di lParamSort, incluso il valore SHCIDS_ALLFIELDS .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj_core.h

Condividi tramite