int AfxMessageBox ( LPCTSTR lpszText, UINT nType = MB_OK, UINT nIDHelp = 0 );
int AFXAPI AfxMessageBox ( UINT nIDPrompt, UINT nType = MB_OK, UINT nIDHelp = (UINT) -1 );
Wartość zwracany
Wartość zero, jeśli nie jest wystarczająco dużo pamięci, aby wyświetlić okno komunikatu; w przeciwnym wypadku zwracana jest jedna z następujących wartości:
Jeśli w oknie komunikatu przycisk Anuluj, wartość IDCANCEL będzie zwracany jeśli albo naciśnięcia klawisza ESC, albo zaznaczono przycisk Anuluj. Jeśli w oknie komunikatu nie przycisk Anuluj, naciskając klawisz ESC ma wpływu.
Funkcje AfxFormatString1 i AfxFormatString2 może być przydatne w formatowanie tekstu, który pojawia się w oknie komunikatu.
Parametry
lpszText
Punkty do obiektu CString lub ciąg zakończony zerem, zawierające wiadomości mają być wyświetlane w oknie komunikatu.
nType
Styl w ok&nie komunikatu. Zastosować dowolny ze stylów okno komunikatu do box.nbsp;
nIDHelp
Identyfikator kontekstu Pomoc dla wiadomości; 0 wskazuje, że będzie można użyć aplikacji domyślnej pomocy kontekstu.
nIDPrompt
Unikatowy identyfikator używany do ciąg w tabeli ciągów.
Uwagi
Wyświetla okno komunikatu na ekranie. W pierwszym formularzu tej funkcji zastąpionej wyświetla ciąg tekstowy wskazywanego przez lpszText w oknie komunikatu i używa nIDHelp do opisania w kontekście pomocy. Kontekstu Pomoc jest użyte do wykonania skoku do skojarzonego tematu pomocy, gdy użytkownik naciśnie klawisz Help (zazwyczaj F1).
Druga forma fu&nkcji korzysta z zasobu ciągu z ID nIDPrompt , aby wyświetlić komunikat w polu komunikat. Skojarzona strona pomocy znajduje się za pomocą wartości nIDHelp. Jeśli używany jest wartość domyślna, nIDHelp (-1), identyfikator zasobu ciągu, nIDPrompt, jest używany w kontekście pomocy. Aby uzyskać więcej informacji na temat definiowania pomocy kontekstach, zobacz artykuł Tematy pomocy w Visual C++ Programmer's Guide i techniczne Uwaga 28.nbsp;
Zobacz też CWnd::MessageBox