Metodo IShellFolder2::GetDefaultColumn (shobjidl_core.h)

Articolo
03/13/2024

Ottiene l'ordinamento predefinito e le colonne di visualizzazione.

Sintassi

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

Parametri

[in] dwRes

Tipo: DWORD

Riservato. Imposta su zero.

[out] pSort

Tipo: ULONG*

Puntatore a un valore che riceve l'indice della colonna ordinata predefinita.

[out] pDisplay

Tipo: ULONG*

Puntatore a un valore che riceve l'indice della colonna di visualizzazione predefinita.

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo o un valore di errore COM in caso contrario.

Commenti

Note per gli utenti

Entrambi gli indici di colonna restituiti da questo metodo sono destinati all'uso da parte di un'applicazione che presenta una visualizzazione cartelle di questa cartella.

La colonna specificata da pSort è quella che deve essere utilizzata per ordinare gli elementi nella cartella. Per determinare l'ordinamento di qualsiasi coppia di elementi, passare i RELATIVI PIDL a CompareIDD. Specificare la colonna impostando il parametro lParam di CompareIDs sul valore a cui punta pSort.

Se una visualizzazione visualizzerà una sola stringa per rappresentare un elemento, deve essere ricavata dalla colonna specificata da pDisplay. Passare l'indice di colonna e il PIDL dell'elemento a IShellFolder2::GetDetailsOf per recuperare la stringa.

Note per gli implementatori

Questo metodo fa parte dell'implementazione dell'oggetto cartella di un'estensione dello spazio dei nomi. Viene in genere chiamato da un oggetto visualizzazione cartelle per chiedere all'oggetto cartella quale colonna nella visualizzazione Dettagli di Esplora risorse di Microsoft Windows deve essere utilizzata per ordinare gli elementi nella cartella. Ad esempio, un oggetto cartella che rappresenta un log delle transazioni potrebbe impostare pSort sulla colonna che visualizza l'ora della transazione. Gli elementi verranno quindi ordinati in base all'ora in cui è stata eseguita la transazione, anziché in base al nome.

Alcuni client potrebbero chiamare questo metodo per richiedere l'indice della colonna con i nomi che devono essere visualizzati nella visualizzazione albero. Impostare pDisplay sull'indice di colonna appropriato. Il client otterrà quindi i nomi visualizzati chiamando IShellFolder2::GetDetailsOf.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (versione 5.0 o successiva)

Condividi tramite