Structure MSGBOXPARAMSA (winuser.h)

Article
08/28/2023

Contient les informations utilisées pour afficher une boîte de message. La fonction MessageBoxIndirect utilise cette structure.

Syntaxe

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;

Membres

cbSize

Type : UINT

Taille de la structure, en octets.

hwndOwner

Type : HWND

Handle de la fenêtre propriétaire. Ce membre peut être NULL.

hInstance

Type : HINSTANCE

Handle du module qui contient la ressource icon identifiée par le membre lpszIcon et la ressource de chaîne identifiée par le membre lpszText ou lpszCaption .

lpszText

Type : LPCTSTR

Chaîne terminée par null, ou identificateur d’une ressource de chaîne, qui contient le message à afficher.

lpszCaption

Type : LPCTSTR

Chaîne terminée par null, ou identificateur d’une ressource de chaîne, qui contient le titre de la zone de message. Si ce membre a la valeur NULL, le titre par défaut Error est utilisé.

dwStyle

Type : DWORD

Contenu et comportement de la boîte de dialogue. Ce membre peut être une combinaison d’indicateurs décrits pour le paramètre uType de la fonction MessageBoxEx .

En outre, vous pouvez spécifier l’indicateur MB_USERICON (0x00000080L) si vous souhaitez que la boîte de message affiche l’icône spécifiée par le membre lpszIcon .

lpszIcon

Type : LPCTSTR

Identifie une ressource d’icône. Ce paramètre peut être une chaîne terminée par une valeur Null ou un identificateur de ressource entier passé à la macro MAKEINTRESOURCE .

Pour charger l’une des icônes standard définies par le système, définissez le membre hInstance sur NULL et définissez lpszIcon sur l’une des valeurs répertoriées avec la fonction LoadIcon .

Ce membre est ignoré si le membre dwStyle ne spécifie pas l’indicateur MB_USERICON .

dwContextHelpId

Type : DWORD_PTR

Identifie un contexte d’aide. Si un événement d’aide se produit, cette valeur est spécifiée dans la structure HELPINFO que la boîte de message envoie à la fenêtre propriétaire ou à la fonction de rappel.

lpfnMsgBoxCallback

Type : MSGBOXCALLBACK

Pointeur vers la fonction de rappel qui traite les événements d’aide pour la boîte de message. La fonction de rappel se présente sous la forme suivante :

VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);

Si ce membre a la valeur NULL, la boîte de message envoie WM_HELP messages à la fenêtre propriétaire lorsque des événements d’aide se produisent.

dwLanguageId

Type : DWORD

Langue dans laquelle afficher le texte contenu dans les boutons poussoir prédéfinis. Cette valeur doit être sous la forme retournée par la macro MAKELANGID .

Pour obtenir la liste des identificateurs de langue pris en charge, consultez Identificateurs de langue. Notez que chaque version localisée de Windows contient généralement des ressources uniquement pour un ensemble limité de langues. Ainsi, par exemple, la version américaine offre LANG_ENGLISH, la version Français offre LANG_FRENCH, la version allemande offre des LANG_GERMAN et la version japonaise offre des LANG_JAPANESE. Chaque version offre LANG_NEUTRAL. Cela limite l’ensemble des valeurs qui peuvent être utilisées avec le paramètre dwLanguageId . Avant de spécifier un identificateur de langue, vous devez énumérer les paramètres régionaux installés sur un système.

Remarques

Notes

L’en-tête winuser.h définit MSGBOXPARAMS en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	winuser.h (inclure Windows.h)