Condividi tramite

Funzione PickIconDlg (shlobj_core.h)

  • Articolo

[PickIconDlg è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

Visualizza una finestra di dialogo che consente all'utente di scegliere un'icona dalla selezione disponibile incorporato in una risorsa, ad esempio un file eseguibile o dll.

Sintassi

int PickIconDlg(
  [in, optional]      HWND  hwnd,
  [in, out]           PWSTR pszIconPath,
                      UINT  cchIconPath,
  [in, out, optional] int   *piIconIndex
);

Parametri

[in, optional] hwnd

Tipo: HWND

Handle della finestra padre. Questo valore può essere NULL.

[in, out] pszIconPath

Tipo: PWSTR

Puntatore a una stringa contenente il percorso terminata da Null, completo della risorsa predefinita che contiene le icone. Se l'utente sceglie una risorsa diversa nella finestra di dialogo, questo buffer contiene il percorso del file quando la funzione restituisce. Questo buffer deve essere almeno MAX_PATH caratteri in lunghezza oppure il percorso restituito può essere troncato. È necessario verificare che il percorso sia valido prima di usarlo.

cchIconPath

Tipo: UINT

Numero di caratteri in pszIconPath, incluso il carattere NULL terminante.

[in, out, optional] piIconIndex

Tipo: int*

Puntatore a un intero che nella voce specifica l'indice della selezione iniziale e, quando questa funzione restituisce correttamente, riceve l'indice dell'icona selezionata.

Valore restituito

Tipo: int

Restituisce 1 se ha esito positivo; in caso contrario, 0.

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 (include Shlobj.h)
Libreria Shell32.lib
DLL Shell32.dll (versione 6.0 o successiva)
Set di API ext-ms-win-shell-shell32-l1-2-1 (introdotta in Windows 10, versione 10.0.10240)