Funzione ShellMessageBoxW (shellapi.h)
[ShellMessageBox è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.
ShellMessageBox è un'istanza speciale di MessageBox che offre l'opzione di usare il titolo della finestra del proprietario come titolo della finestra di messaggio.
Sintassi
int ShellMessageBoxW(
[in] HINSTANCE hAppInst,
[in] HWND hWnd,
[in] LPCWSTR lpcText,
[in] LPCWSTR lpcTitle,
[in] UINT fuStyle,
...
);
Parametri
[in] hAppInst
Tipo: HINSTANCE
Handle del modulo da cui caricare una risorsa stringa denominata in pszTitle. Se pszTitle non assegna un nome a una risorsa stringa, questo parametro viene ignorato. Questo valore deve essere valido se pszMsg o pszTitle è un ID risorsa.
[in] hWnd
Tipo: HWND
Handle alla finestra proprietario della finestra di messaggio da creare. Se questa variabile non è NULL, il titolo della finestra del proprietario viene usato come titolo della finestra di messaggio.
[in] lpcText
Tipo: LPCTSTR
Puntatore a una stringa con terminazione null che contiene il messaggio da visualizzare o un ID risorsa che specifica dove recuperare il messaggio.
[in] lpcTitle
Tipo: LPCTSTR
Puntatore a una stringa con terminazione null che contiene il titolo della finestra di dialogo o un ID risorsa che specifica dove deve essere recuperato il titolo. Se sia questo parametro che hWnd sono NULL, non viene visualizzato alcun titolo. Se questo parametro punta a una risorsa caricabile formata con la macro MAKEINTRESOURCE , esegue l'override di hWnd come titolo.
[in] fuStyle
Tipo: UINT
Specifica il contenuto e il comportamento della finestra di dialogo. Per i valori possibili, vedere MessageBox.
...
Elenco di argomenti variabile combinato con pszMsg per formare il testo completo visualizzato nella finestra di messaggio.
Valore restituito
Tipo: int
Valore intero che indica un pulsante premuto nella finestra di messaggio. Per valori specifici, vedere MessageBox.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Nota
L'intestazione shellapi.h definisce ShellMessageBox 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
Requisito | Valore |
---|---|
Client minimo supportato | Windows XP [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | shellapi.h |
Libreria | Shlwapi.lib |
DLL | Shlwapi.dll |