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

Requisiti

Vedi anche

MAKEINTRESOURCE

MessageBox