enumerazione _SHCONTF (shobjidl_core.h)

  • Articolo

Determina i tipi di elementi inclusi in un'enumerazione. Questi valori vengono usati con il metodo IShellFolder::EnumObjects .

Sintassi

typedef enum _SHCONTF {
  SHCONTF_CHECKING_FOR_CHILDREN = 0x10,
  SHCONTF_FOLDERS = 0x20,
  SHCONTF_NONFOLDERS = 0x40,
  SHCONTF_INCLUDEHIDDEN = 0x80,
  SHCONTF_INIT_ON_FIRST_NEXT = 0x100,
  SHCONTF_NETPRINTERSRCH = 0x200,
  SHCONTF_SHAREABLE = 0x400,
  SHCONTF_STORAGE = 0x800,
  SHCONTF_NAVIGATION_ENUM = 0x1000,
  SHCONTF_FASTITEMS = 0x2000,
  SHCONTF_FLATLIST = 0x4000,
  SHCONTF_ENABLE_ASYNC = 0x8000,
  SHCONTF_INCLUDESUPERHIDDEN = 0x10000
} ;

Costanti

 
SHCONTF_CHECKING_FOR_CHILDREN
Valore: 0x10
0x00010. Windows 7 e versioni successive. L'applicazione chiamante verifica l'esistenza di elementi figlio nella cartella .
SHCONTF_FOLDERS
Valore: 0x20
0x00020. Includere elementi che sono cartelle nell'enumerazione .
SHCONTF_NONFOLDERS
Valore: 0x40
0x00040. Includere elementi che non sono cartelle nell'enumerazione .
SHCONTF_INCLUDEHIDDEN
Valore: 0x80
0x00080. Includere gli elementi nascosti nell'enumerazione . Questo non include elementi di sistema nascosti. Per includere elementi di sistema nascosti, usare SHCONTF_INCLUDESUPERHIDDEN.
SHCONTF_INIT_ON_FIRST_NEXT
Valore: 0x100
0x00100. Non più utilizzato; sempre assunto. IShellFolder::EnumObjects può restituire senza convalidare l'oggetto di enumerazione. La convalida può essere posticipata fino alla prima chiamata a IEnumIDList::Next. Usare questo flag quando potrebbe essere visualizzata un'interfaccia utente prima della prima chiamata IEnumIDList::Next . Affinché venga presentata un'interfaccia utente, hwnd deve essere impostato su un handle di finestra valido.
SHCONTF_NETPRINTERSRCH
Valore: 0x200
0x00200. L'applicazione chiamante sta cercando oggetti stampante.
SHCONTF_SHAREABLE
Valore: 0x400
0x00400. L'applicazione chiamante sta cercando risorse che possono essere condivise.
SHCONTF_STORAGE
Valore: 0x800
0x00800. Includere elementi con archiviazione accessibile e i relativi predecessori, inclusi gli elementi nascosti.
SHCONTF_NAVIGATION_ENUM
Valore: 0x1000
0x01000. Windows 7 e versioni successive. Le cartelle figlio devono fornire un'enumerazione di navigazione.
SHCONTF_FASTITEMS
Valore: 0x2000
0x02000. Windows Vista e versioni successive. L'applicazione chiamante sta cercando risorse che possono essere enumerate rapidamente.
SHCONTF_FLATLIST
Valore: 0x4000
0x04000. Windows Vista e versioni successive. Obsoleta. Non usare.
SHCONTF_ENABLE_ASYNC
Valore: 0x8000
0x08000. Windows Vista e versioni successive. L'applicazione chiamante sta monitorando le notifiche delle modifiche. Ciò significa che l'enumeratore non deve restituire tutti i risultati. Gli elementi possono essere segnalati tramite notifiche di modifica.
SHCONTF_INCLUDESUPERHIDDEN
Valore: 0x10000
0x10000. Windows 7 e versioni successive. Includere gli elementi di sistema nascosti nell'enumerazione . Questo valore non include elementi non di sistema nascosti. Per includere elementi non di sistema nascosti, usare SHCONTF_INCLUDEHIDDEN.

Commenti

Impostando il flag SHCONTF_INIT_ON_FIRST_NEXT , l'applicazione chiamante suggerisce che il metodo IShellFolder::EnumObjects può accelerare il processo di enumerazione restituendo un oggetto di enumerazione non inizializzato. L'inizializzazione può essere posticipata fino all'avvio del processo di enumerazione. Se l'inizializzazione dell'oggetto enumerazione è un processo lungo, l'implementazione del metodo deve restituire immediatamente un oggetto non inizializzato. Rinviare l'inizializzazione fino alla prima chiamata al metodo IEnumIDList::Next . Se l'inizializzazione richiede l'input dell'utente, l'implementazione del metodo deve usare hwnd come finestra padre per l'interfaccia utente. Per una spiegazione delle operazioni da eseguire quando hwnd è impostato su NULL, vedere le informazioni di riferimento su IShellFolder::EnumObjects .

Nota Il nome di questa enumerazione è stato modificato in _SHCONTF in Windows Vista. In precedenza, era denominato tagSHCONTF. Per la compatibilità con il codice legacy, il nome SHCONTF viene definito tramite un'istruzione typedef come sinonimo di DWORD.
 

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione shobjidl_core.h (include Shobjidl.h)