AfxMessageBox
Okno se zprávou se zobrazí na obrazovce.
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 CString objektu nebo zakončený řetězec obsahující zprávu zobrazit v okně se zprávou.nType
Styl okna se zprávou.Použít některý z zpráva styly pole.nIDHelp
ID kontextové nápovědy pro zprávy. 0 znamená, že bude použit kontext nápovědy výchozí aplikace.nIDPrompt
Jedinečné ID odkazu řetězec v tabulce řetězců.
Vrácená hodnota
Nula, pokud není dostatek paměti pro zobrazení okna se zprávou; v opačném případě se jedna z následujících hodnot je vrácena:
IDABORT bylo vybráno tlačítko přerušení.
IDCANCEL byla vybrána Storno.
IDIGNORE bylo vybráno tlačítko Ignorovat.
IDNO bylo vybráno tlačítko Č.
IDOK bylo vybráno tlačítko OK.
IDRETRY bylo vybráno tlačítko Opakovat.
IDYES bylo vybráno tlačítko Ano.
Tlačítko Zrušit, pokud zprávou IDCANCEL -li po stisknutí klávesy ESC nebo je vybráno tlačítko Storno, bude vrácena hodnota.Pokud pole zpráva nemá žádné tlačítko Storno, stisknutím klávesy ESC nemá žádný vliv.
Funkce AfxFormatString1 a AfxFormatString2 může 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 odkazuje lpszText v okně se zprávou a používá nIDHelp k popisu kontextové nápovědy.Kontextové nápovědy lze přejít na související téma nápovědy, když uživatel stiskne klávesu nápovědy (obvykle F1).
Druhá funkce využívá zdroj řetězce s ID nIDPrompt zobrazení zprávy v okně zprávy.Přidružené stránce nápovědy se zjistí pomocí hodnoty nIDHelp.Pokud výchozí hodnotu nIDHelp se používá (– 1), číslo ID zdroje řetězec nIDPrompt, se používá pro kontextové nápovědy.Další informace o definování kontexty nápovědy naleznete v 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
Záhlaví: afxwin.h