Allgemeine Dialogfeldtypen

Die Bibliothek für allgemeine Dialogfelder stellt eine Erstellungsfunktion und eine Struktur für jeden Allgemeinen Dialogfeldtyp zur Verfügung. Um ein allgemeines Dialogfeld in seiner einfachsten Form zu verwenden, rufen Sie dessen Erstellungsfunktion auf und geben einen Zeiger auf eine Struktur an, die Anfangswerte und Optionsflags enthält. Nach dem Initialisieren des Dialogfelds verwendet die Dialogfeldprozedur die -Struktur, um Informationen zur Benutzereingabe zurück zu geben. Sie können auch ein allgemeines Dialogfeld an die Anforderungen Ihrer Anwendung anpassen.

Die folgende Tabelle enthält eine kurze Beschreibung der verschiedenen Typen gängiger Dialogfelder und zeigt die Funktion und Struktur, die mit den einzelnen Typen verwendet werden.

Dialogfeld BESCHREIBUNG
Farbe
Zeigt verfügbare Farben an und ermöglicht dem Benutzer optional das Erstellen benutzerdefinierter Farben. Der Benutzer kann eine einfache oder benutzerdefinierte Farbe auswählen. Verwenden Sie die ChooseColor-Funktion und die CHOOSECOLOR-Struktur. Weitere Informationen finden Sie unter Farbdialogfeld.
Suchen
Zeigt ein Dialogfeld an, in dem der Benutzer die zu suchde Zeichenfolge eingeben kann. Der Benutzer kann auch Suchoptionen angeben, z. B. die Suchrichtung und ob bei der Suche die Schreibung beachtet wird. Verwenden Sie die FindText-Funktion und die FINDREPLACE-Struktur. Weitere Informationen finden Sie unter Suchen und Ersetzen von Dialogfeldern.
Schriftart
Zeigt ein Dialogfeld an, in dem der Benutzer eine Schriftfamilie und den zugeordneten Schriftschnitt, Punktgrößen und andere Schriftartattribute wie Schriftfarbe, Unterstrich oder Durchstrich auswählen kann. Verwenden Sie die ChooseFont-Funktion und die CHOOSEFONT-Struktur. Weitere Informationen finden Sie unter Schriftart (Dialogfeld).
Öffnen
Zeigt ein Dialogfeld an, in dem der Benutzer den Namen einer Zu öffnenden Datei oder eines Shell-Namensraumobjekts eingeben oder auswählen kann. Das Dialogfeld enthält Listen von Laufwerken, Verzeichnissen und Erweiterungen für den Shellnamenbereich, die es dem Benutzer ermöglichen, den Shellnamensraum zu durchsuchen. Sie enthält auch eine Liste der Dateierweiterungen, mit denen der Benutzer die angezeigten Dateinamen filtern kann. Verwenden Sie die GetOpenFileName-Funktion und die OPENFILENAME-Struktur. Weitere Informationen finden Sie unter Öffnen und Speichern unter Dialogfelder.
Seiteneinrichtung
Zeigt die aktuelle Seitenkonfiguration an. Der Benutzer kann Seitenkonfigurationsoptionen wie Papierausrichtung, Größe, Quelle und Ränder auswählen. Verwenden Sie die PageSetupDlg-Funktion und die PAGESETUPDLG-Struktur. Weitere Informationen finden Sie unter Dialogfeld "Seiteneinrichtung".
Drucken
Zeigt Informationen zum installierten Drucker und seiner Konfiguration an. Der Benutzer kann Druckauftragsoptionen auswählen, z. B. den Bereich der zu druckden Seiten und die Anzahl der Kopien, und den Druckvorgang starten. Verwenden Sie die PrintDlg-Funktion und die PRINTDLG-Struktur. Weitere Informationen finden Sie unter Dialogfeld "Drucken".
Verwenden Sie die PrintDlgEx-Funktion mit der PRINTDLGEX-Struktur, um ein Druckeigenschaftenblatt anstelle eines Dialogfelds Drucken anzuzeigen. Die Seite Allgemein des Eigenschaftenblatts ähnelt dem Dialogfeld Drucken. Das Eigenschaftenblatt kann zusätzliche anwendungsspezifische und treiberspezifische Eigenschaftenseiten nach der Seite Allgemein enthalten. Weitere Informationen finden Sie unter Drucken des Eigenschaftenblatts.
Replace
Zeigt ein Dialogfeld an, in dem der Benutzer die zu suchde Zeichenfolge und die Ersetzungszeichenfolge eingeben kann. Der Benutzer kann Suchoptionen angeben, z. B. ob bei der Suche die Schreibung beachtet wird, und Ersetzungsoptionen, z. B. den Bereich der Ersetzung. Verwenden Sie die ReplaceText-Funktion und die FINDREPLACE-Struktur. Weitere Informationen finden Sie unter Suchen und Ersetzen von Dialogfeldern.
Speichern unter
Zeigt ein Dialogfeld an, in dem der Benutzer den Namen eingeben oder auswählen kann, mit dem eine Datei oder ein Shell-Namensraumobjekt gespeichert werden soll. Das Dialogfeld enthält Listen von Laufwerken, Verzeichnissen und Erweiterungen für den Shellnamenbereich, die es dem Benutzer ermöglichen, den Shellnamensraum zu durchsuchen. Sie enthält auch eine Liste der Dateierweiterungen, mit denen der Benutzer die angezeigten Dateinamen filtern kann. Verwenden Sie die GetSaveFileName-Funktion und die OPENFILENAME-Struktur. Weitere Informationen finden Sie unter Öffnen und Speichern unter Dialogfelder.

Obwohl ein Dialogfeld Druckeinrichtung verfügbar ist, wurde es durch das Dialogfeld Seiteneinrichtung ersetzt. Anwendungen sollten das Dialogfeld Seiteneinrichtung anstelle des Dialogfelds Druckeinrichtung verwenden.

Alle gängigen Dialogfelder sind modal, mit Ausnahme der Dialogfelder Suchen und Ersetzen. Modale Dialogfelder müssen vom Benutzer geschlossen werden, bevor die Funktion, die zum Erstellen des Dialogfelds verwendet wurde, zurückgeben kann. Die Dialogfelder Suchen und Ersetzen sind moduslos. Die Funktion wird zurückgegeben, bevor das Dialogfeld geschlossen wird. Wenn Sie die Dialogfelder Suchen und Ersetzen verwenden, müssen Sie auch die IsDialogMessage-Funktion in der Hauptnachrichtenschleife Ihrer Anwendung verwenden, um sicherzustellen, dass diese Dialogfelder Tastatureingaben ordnungsgemäß verarbeiten, z. B. die TAB- und ESC-Tasten.