Struttura MSGBOXPARAMSA (winuser.h)

Articolo
11/20/2024

Contiene informazioni utilizzate per visualizzare una finestra di messaggio. La funzione MessageBoxIndirect usa questa struttura.

Sintassi

typedef struct tagMSGBOXPARAMSA {
  UINT           cbSize;
  HWND           hwndOwner;
  HINSTANCE      hInstance;
  LPCSTR         lpszText;
  LPCSTR         lpszCaption;
  DWORD          dwStyle;
  LPCSTR         lpszIcon;
  DWORD_PTR      dwContextHelpId;
  MSGBOXCALLBACK lpfnMsgBoxCallback;
  DWORD          dwLanguageId;
} MSGBOXPARAMSA, *PMSGBOXPARAMSA, *LPMSGBOXPARAMSA;

Membri

cbSize

Tipo: UINT

Dimensione della struttura, in byte.

hwndOwner

Tipo: HWND

Handle per la finestra del proprietario. Questo membro può essere NULL.

hInstance

Tipo: HINSTANCE

Handle per il modulo che contiene la risorsa icona identificata dal membro lpszIcon e la risorsa stringa identificata dal lpszText o lpszCaption membro.

lpszText

Tipo: LPCTSTR

Stringa con terminazione Null o identificatore di una risorsa stringa contenente il messaggio da visualizzare.

lpszCaption

Tipo: LPCTSTR

Stringa con terminazione Null o identificatore di una risorsa stringa contenente il titolo della finestra di messaggio. Se questo membro è NULL, viene utilizzato il titolo predefinito Errore.

dwStyle

Tipo: DWORD

Contenuto e comportamento della finestra di dialogo. Questo membro può essere una combinazione di flag descritti per il parametro uType della funzione MessageBoxEx .

Inoltre, è possibile specificare il flag di MB_USERICON (0x00000080L) se si desidera che la finestra di messaggio visualizzi l'icona specificata dal membro lpszIcon.

lpszIcon

Tipo: LPCTSTR

Identifica una risorsa icona. Questo parametro può essere una stringa con terminazione Null o un identificatore di risorsa integer passato alla macro MAKEINTRESOURCE.

Per caricare una delle icone standard definite dal sistema, impostare il membro hInstance su NULL e impostare lpszIcon su uno dei valori elencati con la funzione LoadIcon .

Questo membro viene ignorato se il membro dwStyle non specifica il flag di MB_USERICON.

dwContextHelpId

Tipo: DWORD_PTR

Identifica un contesto della Guida. Se si verifica un evento della Guida, questo valore viene specificato nella struttura HELPINFO che la finestra di messaggio invia alla finestra del proprietario o alla funzione di callback.

lpfnMsgBoxCallback

Tipo: MSGBOXCALLBACK

Puntatore alla funzione di callback che elabora gli eventi della Guida per la finestra di messaggio. La funzione di callback ha il formato seguente:

VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);

Se questo membro è NULL, la finestra di messaggio invia WM_HELP messaggi alla finestra del proprietario quando si verificano eventi della Guida.

dwLanguageId

Tipo: DWORD

Lingua in cui visualizzare il testo contenuto nei pulsanti di pressione predefiniti. Questo valore deve essere nel formato restituito dalla macro MAKELANGID .

Per un elenco degli identificatori di lingua supportati, vedere identificatori di lingua . Si noti che ogni versione localizzata di Windows in genere contiene risorse solo per un set limitato di lingue. Pertanto, ad esempio, la versione statunitense offre LANG_ENGLISH, la versione francese offre LANG_FRENCH, la versione tedesca offre LANG_GERMANe la versione giapponese offre LANG_JAPANESE. Ogni versione offre LANG_NEUTRAL. Questo limita il set di valori che possono essere usati con il parametro dwLanguageId. Prima di specificare un identificatore di lingua, è necessario enumerare le impostazioni locali installate in un sistema.

Osservazioni

Nota

L'intestazione winuser.h definisce MSGBOXPARAMS 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 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	winuser.h (include Windows.h)