Funzione ShellAboutA (shellapi.h)
Visualizza una finestra di dialogo shell
Sintassi
INT ShellAboutA(
[in, optional] HWND hWnd,
[in] LPCSTR szApp,
[in, optional] LPCSTR 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 contenente testo da visualizzare nella barra del titolo della ShellInformazioni finestra di dialogo 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 a cui punta 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 sia presente un separatore #, nel qual caso la parte dopo # sostituirà completamente la prima riga.
[in, optional] szOtherStuff
Tipo: LPCTSTR
Puntatore a una stringa con terminazione Null contenente 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.
Osservazioni
Si noti che la finestra di dialogo shell Informazioni funzione usa testo e un'icona predefinita specifica di Windows.
Per visualizzare un esempio di
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 indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
Requisito | Valore |
---|---|
client minimo supportato | Windows XP [solo app desktop] |
server minimo supportato | Windows 2000 Server [solo app desktop] |
piattaforma di destinazione | Finestre |
intestazione |
shellapi.h |
libreria |
Shell32.lib |
dll | Shell32.dll (versione 3.51 o successiva) |
set di API | ext-ms-win-shell-shell32-l1-2-2 (introdotto in Windows 10, versione 10.0.14393) |