AfxMessageBox
Na obrazovce se zobrazí okno se zprávou.
int AfxMessageBox(
LPCTSTR lpszText,
UINT nType = MB_OK,
UINT nIDHelp = 0
);
int AFXAPI AfxMessageBox(
UINT nIDPrompt,
UINT nType = MB_OK,
UINT nIDHelp = (UINT
) -1
);
Parametry
lpszText
Odkazuje na objekt CString nebo řetězec zakončený hodnotou null obsahující zprávu, kterou je třeba zobrazit v okně se zprávou.nType
Styl okna se zprávou.Použijte na okno libovolný styl okna se zprávou.nIDHelp
ID kontextové nápovědy pro zprávy. Hodnota 0 označuje, že bude použita výchozí kontextová nápověda aplikace.nIDPrompt
Jedinečný identifikátor, který odkazuje na řetězec v tabulce řetězců.
Vrácená hodnota
Nula, pokud není k dispozici dostatek paměti k zobrazení okna se zprávou, jinak je vrácena jedna z následujících hodnot:
IDABORT Bylo zvoleno tlačítko Přerušit.
IDCANCEL Bylo zvoleno tlačítko Zrušit.
IDIGNORE Bylo zvoleno tlačítko Ignorovat.
IDNO Bylo zvoleno tlačítko Ne.
IDOK Bylo zvoleno tlačítko OK.
IDRETRY Bylo zvoleno tlačítko Opakovat.
IDYES Bylo zvoleno tlačítko Ano.
Pokud je okno se zprávou s tlačítkem Storno po stisknutí klávesy ESC nebo volbě tlačítka Storno bude vrácena hodnota IDCANCEL.Pokud okno se zprávou nemá žádné tlačítko Storno, stisknutí klávesy ESC nemá žádný vliv.
Funkce AfxFormatString1 a AfxFormatString2 mohou být užitečné při formátování textu, který se zobrazí v okně se zprávou.
Poznámky
První formulář této přetížené funkce zobrazí textový řetězec s odkazem na parametr lpszText v okně se zprávou a využívá nIDHelp k popisu kontextové nápovědy.Kontextovou nápovědu lze použít pro přechod na související téma nápovědy, když uživatel stiskne klávesu pro nápovědu (obvykle F1).
Druhý tvar funkce používá řetězec prostředku s ID nIDPrompt pro zobrazení zprávy v okně se zprávou.Přidružená stránka nápovědy se vyhledá prostřednictvím hodnoty nIDHelp.Pokud se výchozí hodnota nIDHelp používá (-1), ID zdroje řetězce, nIDPrompt, se používá pro kontextové nápovědy.Další informace o definování kontextů nápovědy naleznete v části Technická poznámka 28.
Příklad
// A simple message box, with only the OK button.
AfxMessageBox(_T("Simple message box."));
// A message box that uses a string from a string table
// with yes and no buttons and the stop icon.
// NOTE: nStringID is an integer that contains a valid id of
// a string in the current resource.
AfxMessageBox(nStringID, MB_YESNO|MB_ICONSTOP);
Požadavky
Hlavička: afxwin.h