Dialogfeldformatvorlagen

In der folgenden Tabelle sind die Dialogfeldstile aufgeführt, die Sie beim Erstellen eines Dialogfelds angeben können. Sie können diese Stile in Aufrufen der Funktionen CreateWindow und CreateWindowEx , im Stilmember der Strukturen DLGTEMPLATE und DLGTEMPLATEEX und in der Anweisung einer Dialogfelddefinition in einer Ressourcendatei verwenden.

Konstante	BESCHREIBUNG
DS_3DLOOK	Veraltet. Das System wendet das dreidimensionale Erscheinungsbild automatisch auf von Anwendungen erstellte Dialogfelder an.
DS_ABSALIGN	Gibt an, dass die Koordinaten des Dialogfelds Bildschirmkoordinaten sind. Wenn dieser Stil nicht angegeben wird, sind die Koordinaten Clientkoordinaten.
DS_CENTER	Zentriert das Dialogfeld im Arbeitsbereich des Monitors, der das Besitzerfenster enthält. Wenn kein Besitzerfenster angegeben ist, befindet sich das Dialogfeld in der Mitte des Arbeitsbereichs eines vom System festgelegten Monitors. Der Arbeitsbereich ist der Bereich, der nicht durch die Taskleiste oder appbars verdeckt wird.
DS_CENTERMOUSE	Zentriert das Dialogfeld auf dem Mauscursor.
DS_CONTEXTHELP	Enthält ein Fragezeichen in der Titelleiste des Dialogfelds. Wenn der Benutzer auf das Fragezeichen klickt, wird der Cursor zu einem Fragezeichen geändert. Wenn der Benutzer dann im Dialogfeld auf ein Steuerelement klickt, erhält das Steuerelement eine WM_HELP Meldung. Das -Steuerelement sollte die Meldung an die Dialogfeldprozedur übergeben, die die Funktion mit dem Befehl HELP_WM_HELP aufrufen sollte. Die Hilfeanwendung zeigt ein Popupfenster an, das in der Regel Hilfe für das Steuerelement enthält. Beachten Sie, dass DS_CONTEXTHELP nur ein Platzhalter ist. Wenn das Dialogfeld erstellt wird, überprüft das System DS_CONTEXTHELP und fügt dem erweiterten Stil des Dialogfelds WS_EX_CONTEXTHELP hinzu, wenn es vorhanden ist. WS_EX_CONTEXTHELP können nicht mit dem WS_MAXIMIZEBOX - oder WS_MINIMIZEBOX-Format verwendet werden.
DS_CONTROL	Erstellt ein Dialogfeld, das gut als untergeordnetes Fenster eines anderen Dialogfelds funktioniert, ähnlich wie eine Seite in einem Eigenschaftenblatt. Dieser Stil ermöglicht es dem Benutzer, zwischen den Steuerelementfenstern eines untergeordneten Dialogfelds zu wechseln, die zugehörigen Tastenkombinationen zu verwenden usw.
DS_FIXEDSYS	Bewirkt, dass das Dialogfeld die SYSTEM_FIXED_FONT anstelle der Standard-SYSTEM_FONT verwendet. Dies ist eine Monospace-Schriftart, die mit der Schriftart System in 16-Bit-Versionen von Windows vor 3.0 kompatibel ist.
DS_LOCALEDIT	Gilt nur für 16-Bit-Anwendungen. Diese Formatvorlage weist Bearbeitungssteuerelemente im Dialogfeld an, Arbeitsspeicher aus dem Datensegment der Anwendung zuzuweisen. Andernfalls weisen Bearbeitungssteuerelemente Speicher aus einem globalen Speicherobjekt zu.
DS_MODALFRAME	Erstellt ein Dialogfeld mit einem modalem Dialogfeldrahmen, der mit einer Titelleiste und einem Fenstermenü kombiniert werden kann, indem die WS_CAPTION und WS_SYSMENU Stile angegeben werden.
DS_NOFAILCREATE	Erstellt das Dialogfeld auch dann, wenn Fehler auftreten, z. B. wenn ein untergeordnetes Fenster nicht erstellt werden kann oder wenn das System kein spezielles Datensegment für ein Bearbeitungssteuerelement erstellen kann.
DS_NOIDLEMSG	Unterdrückt WM_ENTERIDLE Nachrichten, die das System andernfalls an den Besitzer des Dialogfelds sendet, während das Dialogfeld angezeigt wird.
DS_SETFONT	Gibt an, dass die Kopfzeile der Dialogfeldvorlage (standard oder erweitert) zusätzliche Daten enthält, die die Schriftart angeben, die für Text im Clientbereich und steuerelemente des Dialogfelds verwendet werden soll. Wenn möglich, wählt das System eine Schriftart entsprechend den angegebenen Schriftartdaten aus. Das System übergibt ein Handle an die Schriftart an das Dialogfeld und jedes Steuerelement, indem es ihnen die WM_SETFONT Nachricht sendet. Beschreibungen des Formats dieser Schriftartdaten finden Sie unter DLGTEMPLATE und DLGTEMPLATEEX. Wenn weder DS_SETFONT noch DS_SHELLFONT angegeben wird, enthält die Dialogfeldvorlage die Schriftartdaten nicht.
DS_SETFOREGROUND	Bewirkt, dass das System die SetForegroundWindow-Funktion verwendet, um das Dialogfeld in den Vordergrund zu bringen. Dieser Stil ist nützlich für modale Dialogfelder, die sofortige Aufmerksamkeit des Benutzers erfordern, unabhängig davon, ob das Besitzerfenster das Vordergrundfenster ist. Das System schränkt ein, welche Prozesse das Vordergrundfenster festlegen können. Weitere Informationen finden Sie unter Vordergrund- und Hintergrundfenster.
DS_SHELLFONT	Gibt an, dass das Dialogfeld die Systemschriftart verwenden soll. Der Schriftartmember der erweiterten Dialogfeldervorlage muss auf MS Shell Dlg festgelegt werden. Andernfalls hat dieser Stil keine Auswirkungen. Es wird auch empfohlen, die DIALOGEX-Ressource anstelle der DIALOG-Ressource zu verwenden. Weitere Informationen finden Sie unter Dialogfeldschriftarten. Das System wählt eine Schriftart mithilfe der Schriftartdaten aus, die in den Elementen "Punktgröße", "Gewichtung" und "Kursiv " angegeben sind. Das System übergibt ein Handle an die Schriftart an das Dialogfeld und jedes Steuerelement, indem es ihnen die WM_SETFONT Nachricht sendet. Beschreibungen des Formats dieser Schriftartdaten finden Sie unter DLGTEMPLATEEX. Wenn weder DS_SHELLFONT noch DS_SETFONT angegeben ist, enthält die Vorlage für das erweiterte Dialogfeld die Schriftartdaten nicht.
DS_SYSMODAL	Dieser Stil ist veraltet und aus Gründen der Kompatibilität mit 16-Bit-Versionen von Windows enthalten. Wenn Sie diese Formatvorlage angeben, erstellt das System das Dialogfeld mit der WS_EX_TOPMOST Formatvorlage. Dieser Stil verhindert nicht, dass der Benutzer auf andere Fenster auf dem Desktop zugreifen kann. Kombinieren Sie diesen Stil nicht mit dem DS_CONTROL Stil.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Winuser.h (windows.h einschließen)