Funzione ShellAboutW (shellapi.h)

Articolo
01/27/2024

Visualizza una finestra di dialogo ShellAbout .

Sintassi

INT ShellAboutW(
  [in, optional] HWND    hWnd,
  [in]           LPCWSTR szApp,
  [in, optional] LPCWSTR szOtherStuff,
  [in, optional] HICON   hIcon
);

Parametri

[in, optional] hWnd

Tipo: HWND

Handle di finestra in una finestra padre. Questo parametro può essere NULL.

[in] szApp

Tipo: LPCTSTR

Puntatore a una stringa con terminazione null che contiene testo da visualizzare nella barra del titolo della finestra di dialogo ShellAbout e nella prima riga della finestra di dialogo dopo il testo "Microsoft". Se il testo contiene un separatore (#) che lo divide in due parti, la funzione visualizza la prima parte nella barra del titolo e la seconda parte della prima riga dopo il testo "Microsoft".

Windows 2000, Windows XP, Windows Server 2003: se la stringa puntata da questo parametro contiene un separatore (#), la stringa deve essere scrivibile.

Windows Vista, Windows Server 2008: questa stringa non può superare i 200 caratteri di lunghezza. Il contenuto di szApp non verrà più visualizzato dopo "Microsoft", a meno che non esista un separatore #, in cui la parte dopo il # sostituirà completamente la prima riga.

[in, optional] szOtherStuff

Tipo: LPCTSTR

Puntatore a una stringa con terminazione null che contiene testo da visualizzare nella finestra di dialogo dopo la versione e le informazioni sul copyright. Questo parametro può essere NULL.

[in, optional] hIcon

Tipo: HICON

Handle di un'icona visualizzata dalla funzione nella finestra di dialogo. Questo parametro può essere NULL, nel qual caso la funzione visualizza l'icona di Windows.

Valore restituito

Tipo: int

TRUE se ha esito positivo; in caso contrario, FALSE.

Commenti

Si noti che la finestra di dialogo Della funzione ShellAbout usa il testo e un'icona predefinita specifica per Windows.

Per visualizzare un esempio di finestra di dialogo ShellAbout , scegliere Informazioni su Windows dall'elenco a discesa menu Guida in Esplora risorse.

Nota

L'intestazione shellapi.h definisce ShellAbout come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shellapi.h
Libreria	Shell32.lib
DLL	Shell32.dll (versione 3.51 o successiva)
Set di API	ext-ms-win-shell32-l1-2-2 (introdotta in Windows 10 versione 10.0.14393)

Condividi tramite