Structure MSGBOXPARAMSW (winuser.h)

Article
11/20/2024

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

Syntaxe

typedef struct tagMSGBOXPARAMSW {
  UINT           cbSize;
  HWND           hwndOwner;
  HINSTANCE      hInstance;
  LPCWSTR        lpszText;
  LPCWSTR        lpszCaption;
  DWORD          dwStyle;
  LPCWSTR        lpszIcon;
  DWORD_PTR      dwContextHelpId;
  MSGBOXCALLBACK lpfnMsgBoxCallback;
  DWORD          dwLanguageId;
} MSGBOXPARAMSW, *PMSGBOXPARAMSW, *LPMSGBOXPARAMSW;

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 d’icône identifiée par le membre lpszIcon et la ressource de chaîne identifiée par le membre lpszText ou lpszCaption membre.

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 est NULL, le titre par défaut Erreur 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 de MB_USERICON (0x00000080080L) 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 null ou un identificateur de ressource entier transmis à la macro MAKEINTRESOURCE.

Pour charger l’une des icônes définies par le système standard, 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 de 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 a la forme suivante :

VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);

Si ce membre est 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 push prédéfinis. Cette valeur doit être dans le formulaire retourné 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çaise offre LANG_FRENCH, la version allemande offre LANG_GERMAN, et la version japonaise offre LANG_JAPANESE. Chaque version offre LANG_NEUTRAL. Cela limite l’ensemble de 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

Note

L’en-tête winuser.h définit MSGBOXPARAMS comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	winuser.h (include Windows.h)