AfxMessageBox
Wyświetla okno komunikatu na ekranie.
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
Wskazuje obiekt CString lub ciąg przerwany wartością null zawierający komunikat do wyświetlenia w oknie wiadomości.nType
Styl okna komunikatu.Zastosowania któregokolwiek z Style okno komunikatu do pola.nIDHelp
Identyfikator kontekstu pomocy dla wiadomości; 0 wskazuje, że domyślnie będzie użyta pomoc kontekstowa.nIDPrompt
Unikatowy identyfikator używany do odwoływania ciąg znaków w tabeli ciągów.
Wartość zwracana
Zero, jeśli nie ma wystarczająco dużo pamięci, aby wyświetlić okno komunikatu; w przeciwnym razie zwracana jest jedna z poniższych wartości:
IDABORT został wybrany przycisk Przerwij.
IDCANCEL został wybrany przycisk Anuluj.
IDIGNORE został wybrany przycisk Ignoruj.
IDNO został wybrany przycisk Nie.
IDOK został wybrany przycisk OK.
IDRETRY został wybrany przycisk Ponów próbę.
IDYES został wybrany przycisk Tak.
Jeśli okno komunikatu ma przycisk Anuluj, zostanie zwrócona wartość IDCANCEL, gdy użytkownik przytrzyma klawisz ESC lub wybierze przycisk Anuluj.Jeśli okno komunikatu nie posiada przycisku Anuluj, naciskanie klawisza ESC nie wywołuje żadnego efektu.
Funkcje AfxFormatString1 i AfxFormatString2 mogą być przydatne do formatowania tekstu, który pojawia się w oknie komunikatu.
Uwagi
Pierwszy formularz tej przeciążonej funkcji wyświetla ciąg tekstowy wskazywany przez lpszText w oknie komunikatu i wykorzystuje nIDHelp do opisania kontekstu pomocy.Pomoc kontekstowa jest używana do przechodzenia do powiązanego tematu pomocy, gdy użytkownik naciśnie klawisz pomocy (zwykle F1).
Druga forma funkcji wykorzystuje zasoby ciągu z ID nIDPrompt, aby wyświetlać komunikat w oknie komunikatu.Skojarzona strona pomocy zostanie znaleziona poprzez wartość nIDHelp.Jeśli używana wartość domyślna nIDHelp to (-1), identyfikator ciągu zasobu, nIDPrompt, będzie używany w kontekście pomocy.Aby uzyskać więcej informacji dotyczących definiowania kontekstów pomocy, zobacz Uwagi techniczne 28.
Przykład
// 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);
Wymagania
Nagłówek: afxwin.h