DIALOG-Ressource
Definiert ein Dialogfeld. Die -Anweisung definiert die Position und Die Abmessungen des Dialogfelds auf dem Bildschirm sowie den Stil des Dialogfelds.
Hinweis
DIALOG ist eine veraltete Ressourcen-ID. Neue Anwendungen sollten DIALOGEXverwenden.
nameID DIALOG x, y, width, height [optional-statements] {control-statement . . . }
Parameter
-
nameID
-
Eindeutiger Name oder ein eindeutiger 16-Bit-Ganzzahlwert ohne Vorzeichen, der das Dialogfeld identifiziert.
-
optionale -Anweisungen
-
Optionen für das Dialogfeld. Dies kann null oder mehr der folgenden Anweisungen sein.
-Anweisung. BESCHREIBUNG CAPTION "text" Beschriftung des Dialogfelds, wenn es über eine Titelleiste verfügt. Weitere Informationen finden Sie unter CAPTION. CHARACTERISTICS dword Benutzerdefinierter DWORD-Wert zur Verwendung durch Ressourcentools. Dieser Wert wird vom System nicht verwendet. Weitere Informationen finden Sie unter CHARACTERISTICS. CLASS-Klasse Eine 16-Bit-Ganzzahl ohne Vorzeichen oder eine Zeichenfolge, die in doppelte Anführungszeichen () eingeschlossen ist und die Klasse des Dialogfelds identifiziert. Weitere Informationen finden Sie unter CLASS. EXSTYLE= erweiterte Stile Erweiterter Fensterstil des Dialogfelds. Weitere Informationen finden Sie unter EXSTYLE. SCHRIFTART zeigt auf, Schriftart Punktgröße und Schriftart für die Schriftart. Weitere Informationen finden Sie unter FONT. LANGUAGE language, sublanguage Sprache des Dialogfelds. Weitere Informationen finden Sie unter LANGUAGE. MENU menuname Zu verwendende Menü. Dieser Wert ist entweder der Name des Menüs oder sein ganzzahliger Bezeichner. STYLE-Stile Stile des Dialogfelds. Weitere Informationen finden Sie unter STYLE. VERSION dword Benutzerdefinierter DWORD-Wert. Diese Anweisung ist für die Verwendung durch zusätzliche Ressourcentools vorgesehen und wird nicht vom System verwendet. Weitere Informationen finden Sie unter VERSION.
Bestimmte Attribute werden auch aus Gründen der Abwärtskompatibilität unterstützt. Weitere Informationen finden Sie unter Allgemeine Ressourcenattribute.
Hinweise
Die GetDialogBaseUnits-Funktion gibt die Basiseinheiten des Dialogs in Pixel zurück. Die genaue Bedeutung der Koordinaten hängt vom Stil ab, der durch die STYLE-Optionsaufstellung definiert wird. Bei Dialogfeldern im untergeordneten Stil sind die Koordinaten relativ zum Ursprung des übergeordneten Fensters, es sei denn, das Dialogfeld weist den Stil DS _ ABSALIGN auf. In diesem Fall sind die Koordinaten relativ zum Ursprung des Anzeigebildschirms.
Verwenden Sie nicht den WS _ CHILD-Stil mit einem modalen Dialogfeld. Die DialogBox-Funktion deaktiviert immer das übergeordnete Element bzw. den Besitzer des neu erstellten Dialogfelds. Wenn ein übergeordnetes Fenster deaktiviert ist, werden seine untergeordneten Fenster implizit deaktiviert. Da das übergeordnete Fenster des Dialogfelds im untergeordneten Stil deaktiviert ist, ist auch das Dialogfeld im untergeordneten Stil deaktiviert.
Wenn ein Dialogfeld über die DS _ ABSALIGN-Formatvorlage verfügt, sind die Dialogkoordinaten für die obere linke Ecke relativ zum Ursprung des Bildschirms und nicht zur linken oberen Ecke des übergeordneten Fensters. In der Regel verwenden Sie diesen Stil, wenn das Dialogfeld in einem bestimmten Teil der Anzeige gestartet werden soll, unabhängig davon, wo sich das übergeordnete Fenster auf dem Bildschirm befindet.
Der Name DIALOG kann auch als Klassennamenparameter für die CreateWindow-Funktion verwendet werden, um ein Fenster mit Dialogfeldattributen zu erstellen.
Beispiele
Im Folgenden wird die Verwendung der DIALOG-Anweisung veranschaulicht:
#include <windows.h>
ErrorDialog DIALOG 10, 10, 300, 110
STYLE WS_POPUP | WS_BORDER
CAPTION "Error!"
{
CTEXT "Select One:", 1, 10, 10, 280, 12
PUSHBUTTON "&Retry", 2, 75, 30, 60, 12
PUSHBUTTON "&Abort", 3, 75, 50, 60, 12
PUSHBUTTON "&Ignore", 4, 75, 80, 60, 12
}