Dialogfelder (Dialogfelder)

Ein Dialogfeld ist ein temporäres Fenster, das eine Anwendung zum Abrufen von Benutzereingaben erstellt. Eine Anwendung verwendet in der Regel Dialogfelder, um den Benutzer zur Eingabe zusätzlicher Informationen für Menüelemente aufzufordern. Ein Dialogfeld enthält normalerweise ein oder mehrere Steuerelemente (untergeordnete Fenster), mit denen der Benutzer Text eingibt, Optionen wählt oder die Aktion leitet.

Windows bietet auch vordefinierte Dialogfelder, die allgemeine Menüelemente wie Öffnen und Drucken unterstützen. Anwendungen, die diese Menüelemente verwenden, sollten die allgemeinen Dialogfelder verwenden, um diese Benutzereingabe unabhängig vom Anwendungstyp aufzufordern.

In diesem Abschnitt

Name	BESCHREIBUNG
Informationen zu Dialogfeldern	Erläutert die Verwendung von Dialogfeldern in der Benutzeroberfläche für Ihre Anwendungen.
Erwägungen zur Dialogfeldprogrammierung	In dieser Übersicht werden einige Programmierüberlegungen in Bezug auf Dialogfelder erläutert.
Verwenden von Dialogfeldern	Sie verwenden Dialogfelder, um Informationen anzuzeigen und vom Benutzer zur Eingabe aufzufordern.
Dialogfeldreferenz	Api-Referenz
Allgemeine Dialogfeldbibliothek	Erläutert die Verwendung der allgemeinen Dialogfelder in der Benutzeroberfläche für Ihre Anwendungen.

Dialogfeldfunktionen

Name	BESCHREIBUNG
CreateDialog	Erstellt ein modusloses Dialogfeld aus einer Dialogfeldvorlagenressource.
CreateDialogIndirect	Erstellt ein modusloses Dialogfeld aus einer Dialogfeldvorlage im Arbeitsspeicher.
CreateDialogIndirectParam	Erstellt ein modusloses Dialogfeld aus einer Dialogfeldvorlage im Arbeitsspeicher. Vor dem Anzeigen des Dialogfelds übergibt die Funktion einen von der Anwendung definierten Wert als lParam-Parameter der WM_INITDIALOG-Nachricht an die Dialogfeldprozedur. Eine Anwendung kann diesen Wert verwenden, um Dialogfeldsteuerelemente zu initialisieren.
CreateDialogParam	Erstellt ein modusloses Dialogfeld aus einer Dialogfeldvorlagenressource. Vor dem Anzeigen des Dialogfelds übergibt die Funktion einen von der Anwendung definierten Wert als lParam-Parameter der WM_INITDIALOG-Nachricht an die Dialogfeldprozedur. Eine Anwendung kann diesen Wert verwenden, um Dialogfeldsteuerelemente zu initialisieren.
DefDlgProc	Ruft die Standardprozedur des Dialogfeldfensters auf, um die Standardverarbeitung für alle Fenstermeldungen bereitzustellen, die von einem Dialogfeld mit einer klasse eines privaten Fensters nicht verarbeitet werden.
DialogBox	Erstellt ein modales Dialogfeld aus einer Dialogfeldvorlagenressource. DialogBox gibt die Steuerung erst zurück, wenn die angegebene Rückruffunktion das modale Dialogfeld durch Aufrufen der EndDialog-Funktion beendet.
DialogBoxIndirect	Erstellt ein modales Dialogfeld aus einer Dialogfeldvorlage im Arbeitsspeicher. DialogBoxIndirect gibt die Steuerung erst zurück, wenn die angegebene Rückruffunktion das modale Dialogfeld durch Aufrufen der EndDialog-Funktion beendet.
DialogBoxIndirectParam	Erstellt ein modales Dialogfeld aus einer Dialogfeldvorlage im Arbeitsspeicher. Vor dem Anzeigen des Dialogfelds übergibt die Funktion einen von der Anwendung definierten Wert als lParam-Parameter der WM_INITDIALOG-Nachricht an die Dialogfeldprozedur. Eine Anwendung kann diesen Wert verwenden, um Dialogfeldsteuerelemente zu initialisieren.
DialogBoxParam	Erstellt ein modales Dialogfeld aus einer Dialogfeldvorlagenressource. Vor dem Anzeigen des Dialogfelds übergibt die Funktion einen von der Anwendung definierten Wert als lParam-Parameter der WM_INITDIALOG-Nachricht an die Dialogfeldprozedur. Eine Anwendung kann diesen Wert verwenden, um Dialogfeldsteuerelemente zu initialisieren.
DialogProc	Eine anwendungsdefinierte Rückruffunktion, die mit den Funktionsfamilien CreateDialog und DialogBox verwendet wird. Es verarbeitet Nachrichten, die an ein modales oder modusloses Dialogfeld gesendet werden. Der DLGPROC-Typ definiert einen Zeiger auf diese Rückruffunktion. DialogProc ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.
EndDialog	Zerstört ein modales Dialogfeld, sodass das System die Verarbeitung des Dialogfelds beendet.
GetDialogBaseUnits	Ruft die Dialogbasiseinheiten des Systems ab, d. h. die durchschnittliche Breite und Höhe der Zeichen in der Systemschriftart. Für Dialogfelder, die die Systemschriftart verwenden, können Sie diese Werte verwenden, um zwischen Einheiten für Dialogvorlagen, wie in Dialogfeldvorlagen angegeben, und Pixeln zu konvertieren. Bei Dialogfeldern, die die Systemschriftart nicht verwenden, hängt die Konvertierung von Einheiten für Dialogvorlagen in Pixel von der schriftart ab, die vom Dialogfeld verwendet wird.
GetDlgCtrlID	Ruft den Bezeichner des angegebenen Steuerelements ab.
GetDlgItem	Ruft ein Handle für ein Steuerelement im angegebenen Dialogfeld ab.
GetDlgItemInt	Übersetzt den Text eines angegebenen Steuerelements in einem Dialogfeld in einen ganzzahligen Wert.
GetDlgItemText	Ruft den Titel oder Text ab, der mit einem Steuerelement in einem Dialogfeld verknüpft ist.
GetNextDlgGroupItem	Ruft ein Handle für das erste Steuerelement in einer Gruppe von Steuerelementen ab, die dem angegebenen Steuerelement in einem Dialogfeld vorangestellt (oder folgt).
GetNextDlgTabItem	Ruft ein Handle für das erste Steuerelement ab, das über die WS_TABSTOP-Formatvorlage verfügt, die dem angegebenen Steuerelement vorangeht (oder folgt).
IsDialogMessage	Bestimmt, ob eine Nachricht für das angegebene Dialogfeld vorgesehen ist, und verarbeitet die Nachricht, falls dies der Grund ist.
MapDialogRect	Konvertiert die angegebenen Dialogfeldeinheiten in Bildschirmeinheiten (Pixel). Die Funktion ersetzt die Koordinaten in der angegebenen RECT-Struktur durch die konvertierten Koordinaten, wodurch die Struktur zum Erstellen eines Dialogfelds oder zum Positionieren eines Steuerelements in einem Dialogfeld verwendet werden kann.
Messagebox	Zeigt ein modales Dialogfeld an, das ein Systemsymbol, eine Reihe von Schaltflächen und eine kurze anwendungsspezifische Meldung enthält, z. B. status- oder Fehlerinformationen. Das Meldungsfeld gibt einen ganzzahligen Wert zurück, der angibt, auf welche Schaltfläche der Benutzer geklickt hat.
MessageBoxEx	Erstellt, zeigt ein Meldungsfeld an und betreibt es. Das Meldungsfeld enthält eine anwendungsdefinierte Nachricht und einen Titel sowie eine beliebige Kombination aus vordefinierten Symbolen und Drucktasten. Die Schaltflächen befinden sich in der Sprache der System-Benutzeroberfläche.
MessageBoxIndirect	Erstellt, zeigt ein Meldungsfeld an und betreibt es. Das Meldungsfeld enthält anwendungsdefinierten Nachrichtentext und -titel, ein beliebiges Symbol und eine beliebige Kombination vordefinierter Drucktasten.
SendDlgItemMessage	Sendet eine Nachricht an das angegebene Steuerelement in einem Dialogfeld.
SetDlgItemInt	Legt den Text eines Steuerelements in einem Dialogfeld auf die Zeichenfolgendarstellung eines angegebenen ganzzahligen Werts fest.
SetDlgItemText	Legt den Titel oder text eines Steuerelements in einem Dialogfeld fest.

Dialogfeldnachrichten

Name	BESCHREIBUNG
DM_GETDEFID	Ruft den Bezeichner des standardmäßigen Drucktasten-Steuerelements für ein Dialogfeld ab.
DM_REPOSITION	Positioniert ein Dialogfeld auf oberster Ebene neu, sodass es in den Desktopbereich passt. Eine Anwendung kann diese Nachricht an ein Dialogfeld senden, nachdem sie die Größe geändert hat, um sicherzustellen, dass das gesamte Dialogfeld sichtbar bleibt.
DM_SETDEFID	Ändert den Bezeichner der Standard-Drucktaste für ein Dialogfeld.

Dialogfeldbenachrichtigungen

Name	BESCHREIBUNG
WM_CTLCOLORDLG	Wird an ein Dialogfeld gesendet, bevor das System das Dialogfeld zeichnet. Durch Reaktion auf diese Meldung kann das Dialogfeld seine Text- und Hintergrundfarben mithilfe des angegebenen Anzeigegerätekontexthandles festlegen.
WM_ENTERIDLE	Wird an das Besitzerfenster eines modalen Dialogfelds oder Menüs gesendet, das in einen Leerlaufzustand wechselt. Ein modales Dialogfeld oder Menü wechselt in einen Leerlaufzustand, wenn keine Nachrichten in der Warteschlange warten, nachdem eine oder mehrere vorherige Nachrichten verarbeitet wurden.
WM_GETDLGCODE	Wird an die Fensterprozedur gesendet, die einem Steuerelement zugeordnet ist. Standardmäßig verarbeitet das System alle Tastatureingaben für das Steuerelement. das System interpretiert bestimmte Arten von Tastatureingaben als Navigationstasten für Dialogfelder. Um dieses Standardverhalten zu überschreiben, kann das Steuerelement auf die WM_GETDLGCODE Meldung reagieren, um die Eingabetypen anzugeben, die es selbst verarbeiten möchte.
WM_INITDIALOG	Wird unmittelbar vor der Anzeige eines Dialogfelds an die Dialogfeldprozedur gesendet. Dialogfeldprozeduren verwenden diese Meldung in der Regel, um Steuerelemente zu initialisieren und andere Initialisierungsaufgaben auszuführen, die sich auf die Darstellung des Dialogfelds auswirken.
WM_NEXTDLGCTL	Wird an eine Dialogfeldprozedur gesendet, um den Tastaturfokus auf ein anderes Steuerelement im Dialogfeld festzulegen.

Dialogfeldstrukturen

Name	BESCHREIBUNG
DLGITEMTEMPLATE	Definiert die Dimensionen und den Stil eines Steuerelements in einem Dialogfeld. Eine oder mehrere dieser Strukturen werden mit einer DLGTEMPLATE-Struktur kombiniert, um eine Standardvorlage für ein Dialogfeld zu bilden.
DLGITEMTEMPLATEEX	Beschreibt ein erweitertes Dialogfeld. Eine Beschreibung des Formats einer Vorlage für erweiterte Dialogfelder finden Sie unter DLGTEMPLATEEX.
DLGTEMPLATE	Definiert die Dimensionen und den Stil eines Dialogfelds. Diese Struktur, immer die erste in einer Standardvorlage für ein Dialogfeld, gibt auch die Anzahl der Steuerelemente im Dialogfeld an und gibt daher die Anzahl der nachfolgenden DLGITEMTEMPLATE-Strukturen in der Vorlage an.
DLGTEMPLATEEX	Eine erweiterte Dialogfeldvorlage beginnt mit einem DLGTEMPLATEEX-Header , der das Dialogfeld beschreibt und die Anzahl der Steuerelemente im Dialogfeld angibt. Für jedes Steuerelement in einem Dialogfeld enthält eine vorlage für erweiterte Dialogfelder einen Datenblock, der das DLGITEMTEMPLATEEX-Format verwendet, um das Steuerelement zu beschreiben.
MSGBOXPARAMS	Enthält Informationen, die zum Anzeigen eines Meldungsfelds verwendet werden. Die MessageBoxIndirect-Funktion verwendet diese Struktur.