4. Message-Box (MessageBox)
Message-Funktion erstellt, Displays, und betreibt eine Message-Box oder Schachtel. Das Meldungsfeld enthält eine Nachricht und der Titel von der Anwendung definiert und eine beliebige Kombination von vordefinierten Icons und Schaltflächen.
int __fastcall MessageBox (char * text, char * Caption, int flags);
Parameter
Text (Text)
Zeigt auf einen Null-terminierten String, der die Nachricht angezeigt werden soll enthält.
Bildunterschrift (Legende)
Zeigt auf einen Null-terminierten String für den Titel der Dialogbox verwendet. Wenn dieser Parameter NULL ist, verwenden Sie den Standardtitel für Fehler.
Flags (Flaggen)
Gibt einen Satz von Bit-Flags, die den Inhalt und das Verhalten des Dialogfelds bestimmen. Dieser Parameter kann eine Kombination von Fahnen aus den folgenden Gruppen sein.
1 .- Geben Sie eine der folgenden Flags, um anzuzeigen, die Tasten in der Meldung enthalten:
| Fahnen | Bedeutung |
| MB_ABORTRETRYIGNORE | Das Meldungsfeld enthält drei Schaltflächen: Abbrechen, Wiederholen und Ignorieren. |
| MB_OK | Das Meldungsfeld enthält eine Schaltfläche: OK. Dies ist die Standardeinstellung. |
| MB_OKCANCEL | Das Meldungsfeld enthält zwei Schaltflächen: OK und Abbrechen. |
| MB_RETRYCANCEL | Das Meldungsfeld enthält zwei Schaltflächen: Wiederholen und Abbrechen. |
| MB_YESNO | Das Meldungsfeld enthält zwei Schaltflächen: Ja und Nein |
| MB_YESNOCANCEL | Das Meldungsfeld enthält drei Schaltflächen: Ja, Nein und Abbrechen. |
2 .- Geben Sie eine der folgenden Flags zur Anzeige ein Symbol in der Message-Box:
| Fahnen | Bedeutung |
| MB_ICONEXCLAMATION | ein Ausrufezeichen-Symbol in der Message-Box. |
| MB_ICONWARNING | |
| MB_ICONINFORMATION | ein Symbol, das einem Kleinbuchstaben i in einem Kreis erscheint in der Meldung. |
| MB_ICONASTERISK | |
| MB_ICONQUESTION | Ein Fragezeichen-Symbol in der Message-Box. |
| MB_ICONSTOP | ein Stoppschild erscheint in der Meldung. |
| MB_ICONERROR | |
| MB_ICONHAND | |
3 Geben Sie eine der folgenden Flags an die Standard-Schaltfläche angeben:
| Fahnen | Bedeutung |
| MB_DEFBUTTON1 | Die erste Schaltfläche ist die Standard-Schaltfläche. |
| MB_DEFBUTTON2 | Die zweite Taste ist die Standard-Schaltfläche. |
| MB_DEFBUTTON3 | Die dritte Taste ist die Standard-Schaltfläche. |
| MB_DEFBUTTON4 | Die vierte Taste ist die Standard-Schaltfläche. |
MB_DEFBUTTON1 ist die Standardeinstellung sofern nicht anders angegeben MB_DEFBUTTON2, MB_DEFBUTTON3 oder MB_DEFBUTTON4.
Rückgabewert
Der Rückgabewert ist Null, wenn nicht genügend Speicher, um das Meldungsfeld zu erstellen.
Wenn die Funktion erfolgreich, ist der Rückgabewert eine der folgenden Menüpunkte der Werte durch den Dialog wieder:
| Preis | Numerischer Wert | Bedeutung |
| IDABORT | 3 | Der Benutzer wählt die Schaltfläche Abbrechen. |
| IDCANCEL | 2 | Der Benutzer wählt die Schaltfläche Abbrechen. |
| IDIGNORE | 5 | Der Benutzer wählt die Schaltfläche Ignorieren. |
| IDNO | 7 | Der Benutzer wählt die Schaltfläche "Nein" |
| IDOK | 1 | Der Benutzer wählt die Taste OK. |
| IDRETRY | 4 | Der Benutzer wählt die Schaltfläche Wiederholen. |
| IDYES | 6 | Der Benutzer wählte die Schaltfläche Ja |
Wenn eine Meldung hat eine Schaltfläche "Abbrechen", gibt die Funktion den Wert IDCANCEL wenn die ESC-Taste gedrückt oder die Schaltfläche "Abbrechen" ausgewählt ist. Wenn der Message-Box hat keine Schaltfläche "Abbrechen", ESC hat keine Wirkung.
4.1. Beispiel für die Benutzung der MessageBox
Im folgenden Beispiel geben Sie den Anruf an MessageBox innerhalb einer if-Anweisung. Das Meldungsfeld wird angezeigt, wenn die Entscheidungsfindung und wartet auf die Benutzer auf diese zu reagieren. Wenn Sie die MessageBox Rückgabewert schließen wird erfasst und ausgewertet von der herrschenden. In diesem Fall wenn Sie drückte auf den Knopf akzeptieren IDOK laufen im Körper des Satzes, ansonsten verworfen.
void __fastcall TForm1:: Button1Click (TObject * Sender)
{
if (Application-> MessageBox ("Speichern Sie die Datei?", MB_OKCANCEL "Speichern unter") == IDOK)
{
/ / Speichern Sie die Datei
}
} 
MessageBox Beispiel
Das folgende Beispiel zeigt die Kombination mehrerer Indikatoren, um die Tasten an, um mit einem Symbol angezeigt.
void __fastcall TForm1:: Button1Click (TObject * Sender)
{
if (Application-> MessageBox ("Speichern Sie die Datei?", MB_OKCANCEL + MB_ICONQUESTION) == IDOK "Speichern unter")
{
/ / Speichern Sie die Datei
}
} 
Beispiel für Kombination von mehreren Fahnen in MessageBox
