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 na CString obiektu lub ciąg zakończony zerem, zawierający wiadomości mają być wyświetlane w oknie komunikatu.nType
Styl okna komunikatu.Żadnego z style w oknie komunikatu do pola.nIDHelp
Identyfikator kontekstu pomocy dla wiadomości; 0 wskazuje, że w kontekście pomocy domyślnej aplikacji, które będą używane.nIDPrompt
Unikatowy identyfikator używany do ciągu w tabeli ciągów.
Wartość zwracana
Zero, jeśli jest za mało pamięci, aby wyświetlić okno komunikatu; w przeciwnym razie jedną z następujących wartości zwrócone:
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 w oknie komunikatu przycisk Anuluj, IDCANCEL wartości będą zwracane, jeżeli zostanie naciśnięty klawisz ESC albo zaznaczono przycisk Anuluj.Jeśli okno komunikatu nie przycisk Anuluj, naciskając klawisz ESC nie ma wpływu.
Funkcje AfxFormatString1 i AfxFormatString2 może być przydatne w formatowaniu tekstu wyświetlanego w oknie komunikatu.
Uwagi
Pierwszym formularzu przeciążony funkcja wyświetla ciąg tekstowy wskazywanej przez lpszText w oknie komunikatu i zastosowań nIDHelp do opisania kontekstu pomocy.Aby przeskoczyć do skojarzonego tematu pomocy, gdy użytkownik naciśnie klawisz Pomocy (zazwyczaj F1) używany jest kontekst pomocy.
Druga forma funkcji używa zasobu ciągu o identyfikatorze nIDPrompt , aby wyświetlić komunikat w polu komunikat.Odnaleźć skojarzona strona pomocy poprzez wartość nIDHelp.Jeśli wartość domyślna, nIDHelp jest używany (– 1), identyfikator zasobów ciągu nIDPrompt, jest używana w kontekście pomocy.Aby uzyskać więcej informacji o definiowaniu kontekstów pomocy, zobacz technicznej Uwaga 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