Funzione ShellMessageBoxW (shellapi.h)

Articolo
11/20/2024

[ ShellMessageBox è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

ShellMessageBox è un'istanza speciale di MessageBox che consente di usare il titolo della finestra 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 denomina una risorsa stringa, questo parametro viene ignorato. Questo valore deve essere valido se pszMsg o pszTitle è un ID risorsa.

[in] hWnd

Tipo: HWND

Handle per la finestra proprietaria 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 contenente il messaggio da visualizzare o un ID risorsa che specifica la posizione da cui recuperare il messaggio.

[in] lpcTitle

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null contenente il titolo della finestra di dialogo o un ID risorsa che specifica dove recuperare 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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 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 Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shellapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll

Vedere anche

MAKEINTRESOURCE

MessageBox

Condividi tramite