Allgemeine Dialogfeldtypen

Die Allgemeine Dialogfeldbibliothek stellt eine Erstellungsfunktion und eine Struktur für jeden Typ von allgemeinen Dialogfelder bereit. 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ückzugeben. Sie können auch ein allgemeines Dialogfeld an die Anforderungen Ihrer Anwendung anpassen.

Die folgende Tabelle enthält eine kurze Beschreibung der verschiedenen Typen von allgemeinen Dialogfeldern und zeigt die Funktion und Struktur, die für jeden Typ verwendet wird.

Dialogfeld	BESCHREIBUNG
Color	Zeigt verfügbare Farben an und ermöglicht es dem Benutzer, benutzerdefinierte Farben zu erstellen. Der Benutzer kann eine einfache oder eine 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 suchende Zeichenfolge eingeben kann. Der Benutzer kann auch Suchoptionen angeben, z. B. die Suchrichtung und ob bei der Suche die Groß-/Kleinschreibung 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 Schriftartfamilie und den zugehörigen Schriftschnitt, Punktgrößen und andere Schriftartattribute wie Schriftfarbe, Unterstrichen oder Durchstreichung auswählen kann. Verwenden Sie die ChooseFont-Funktion und die CHOOSEFONT-Struktur . Weitere Informationen finden Sie unter Dialogfeld "Schriftart".
Öffnen	Zeigt ein Dialogfeld an, in dem der Benutzer den Namen eines zu öffnenden Datei- oder Shell-Namensraumobjekts eingeben oder auswählen kann. Das Dialogfeld enthält Listen von Laufwerken, Verzeichnissen und Shell-Namensraumerweiterungen, die es dem Benutzer ermöglichen, den Shellnamenbereich zu durchsuchen. Es enthält auch eine Liste von Dateinamenerweiterungen, die es dem Benutzer ermöglicht, die angezeigten Dateinamen zu filtern. Verwenden Sie die GetOpenFileName-Funktion und die OPENFILENAME-Struktur . Weitere Informationen finden Sie unter Öffnen und Speichern unter Dialogfeldern.
Seiteneinrichtung	Zeigt die aktuelle Seitenkonfiguration an. Der Benutzer kann Seitenkonfigurationsoptionen auswählen, z. B. Papierausrichtung, Größe, Quelle und Ränder. Verwenden Sie die PageSetupDlg-Funktion und die PAGESETUPDLG-Struktur . Weitere Informationen finden Sie unter Dialogfeld "Seite einrichten".
Drucken	Zeigt Informationen zum installierten Drucker und seiner Konfiguration an. Der Benutzer kann Druckauftragsoptionen auswählen, z. B. den Bereich der zu druckbaren 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 zum Anzeigen eines Print-Eigenschaftenblatts anstelle eines Dialogfelds Drucken die PrintDlgEx-Funktion mit der PRINTDLGEX-Struktur. Die Seite Allgemein des Eigenschaftenblatts ähnelt dem Dialogfeld Drucken . Das Eigenschaftenblatt kann auf der Seite Allgemein über zusätzliche anwendungsspezifische und treiberspezifische Eigenschaftenseiten verfügen. Weitere Informationen finden Sie unter Eigenschaftenblatt drucken.
Replace	Zeigt ein Dialogfeld an, in dem der Benutzer die zu suchende Zeichenfolge und die Ersetzungszeichenfolge eingeben kann. Der Benutzer kann Suchoptionen angeben, z. B. ob bei der Suche die Groß-/Kleinschreibung beachtet wird, und Ersetzungsoptionen, z. B. den Ersetzungsbereich. 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 ein Datei- oder Shell-Namensraumobjekt gespeichert werden soll. Das Dialogfeld enthält Listen von Laufwerken, Verzeichnissen und Shell-Namensraumerweiterungen, die es dem Benutzer ermöglichen, den Shellnamenbereich zu durchsuchen. Es enthält auch eine Liste von Dateinamenerweiterungen, die es dem Benutzer ermöglicht, die angezeigten Dateinamen zu filtern. Verwenden Sie die GetSaveFileName-Funktion und die OPENFILENAME-Struktur . Weitere Informationen finden Sie unter Öffnen und Speichern unter Dialogfeldern.

Obwohl ein Dialogfeld Druckeinrichtung verfügbar ist, wurde es durch das Dialogfeld Seite einrichten abgelöst. Anwendungen sollten das Dialogfeld Seite einrichten 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 Zum Erstellen des Dialogfelds verwendete Funktion zurückgegeben werden kann. Die Dialogfelder Suchen und Ersetzen sind moduslos. Die Funktion gibt zurück, bevor das Dialogfeld geschlossen wird. Wenn Sie die Dialogfelder Suchen und Ersetzen verwenden, müssen Sie auch die IsDialogMessage-Funktion in der Standard-Nachrichtenschleife Ihrer Anwendung verwenden, um sicherzustellen, dass diese Dialogfelder Tastatureingaben ordnungsgemäß verarbeiten, z. B. die TAB- und ESC-Tasten.