Metodo IShellFolderView::GetArrangeParam (shlobj_core.h)

Ottiene il parametro di disposizione della vista, ovvero la modalità di ordinamento della visualizzazione.

Nota Questo metodo è deprecato a partire da Windows Vista. Potrebbe essere modificata o non disponibile nelle versioni successive di Windows. È consigliabile usare invece IFolderView2::GetSortColumns .

 

Sintassi

HRESULT GetArrangeParam(
  [out] LPARAM *plParamSort
);

Parametri

[out] plParamSort

Tipo: LPARAM*

I sedici bit inferiori di plParamSort 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 plParamSort per specificare regole di ordinamento specifiche della cartella. Le regole e i relativi valori plParamSort associati vengono definiti dalla cartella .

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

I sedici bit superiori di plParamSort 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 dispone i relativi nomi, dimensioni, tempi di file, attributi e altre informazioni nelle strutture. Se questo flag è impostato, i sedici bit inferiori di plParamSort 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 .

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