Allgemeine Dialogfeldbibliothek

Die Common Dialog Box Library enthält eine Reihe von Dialogfeldern zum Ausführen allgemeiner Anwendungsaufgaben, z. B. öffnen von Dateien, Auswählen von Farbwerten und Drucken von Dokumenten. Mit den allgemeinen Dialogfeldern können Sie einen konsistenten Ansatz für die Benutzeroberfläche Ihrer Anwendung implementieren. Dies reduziert den Aufwand, den Benutzer für das Erlernen des Verhaltens der Benutzeroberfläche für Ihre Anwendung aufwenden müssen.

In diesem Abschnitt werden die allgemeinen Dialogfelder beschrieben, die die Dialogfelder Öffnen und Speichern als Datei enthalten. die Bearbeitungsdialogfelder Suchen und Ersetzen; die Dialogfelder Drucken, Druckeinrichtung, Eigenschaftenblatt drucken und Seiteneinrichtung drucken; und die Dialogfelder Farbe und Schriftart.

Hinweis

Ab Windows Vista wurden die Dialogfelder Öffnen und Speichern unter durch das Dialogfeld "Allgemeines Element"ersetzt. Es wird empfohlen, die Dialogfeld-API für allgemeine Elemente anstelle dieser Dialogfelder aus der Common Dialog Box Library zu verwenden.

In diesem Abschnitt

Name BESCHREIBUNG
Allgemeine Dialogfeldtypen Erläutert die verschiedenen Dialogfelder.
Allgemeine Dialogfeld-Initialisierungsflags Erläutert, wie Flags verwendet werden, um das Verhalten und die Darstellung eines allgemeinen Dialogfelds zu ändern.
Anpassen allgemeiner Dialogfelder Erläutert die Verwendung gängiger Dialogfelder.
Verwenden von allgemeinen Dialogfeldern Behandelt Aufgaben, die allgemeine Dialogfelder aufrufen.
Allgemeine Dialogfeldreferenz Enthält den API-Verweis.

Functions

Name BESCHREIBUNG
CCHookProc Empfängt Nachrichten oder Benachrichtigungen, die für die Standarddialogfeldprozedur des Dialogfelds Farbe vorgesehen sind. Dies ist eine anwendungs- oder bibliotheksdefinierte Rückruffunktion, die mit der ChooseColor-Funktion verwendet wird.
CFHookProc Empfängt Nachrichten oder Benachrichtigungen, die für die Standarddialogfeldprozedur des Dialogfelds Schriftart vorgesehen sind. Dies ist eine anwendungs- oder bibliotheksdefinierte Rückrufprozedur, die mit der ChooseFont-Funktion verwendet wird.
ChooseColor Erstellt ein Dialogfeld Farbe, in dem der Benutzer eine Farbe auswählen kann.
ChooseFont Erstellt ein Dialogfeld Schriftart, in dem der Benutzer Attribute für eine logische Schriftart auswählen kann. Zu diesen Attributen gehören eine Schriftfamilie und der zugehörige Schriftschnitt, eine Punktgröße, Effekte (Unterstreichung, Ausstrich und Textfarbe) und ein Skript (oder ein Zeichensatz).
CommDlgExtendedError Gibt einen allgemeinen Dialogfeldfehlercode zurück. Dieser Code gibt den letzten Fehler an, der während der Ausführung einer der allgemeinen Dialogfeldfunktionen auftritt.
Findtext Erstellt ein systemdefiniertes, modusloses Suchdialogfeld, in dem der Benutzer eine Zeichenfolge für die Suche nach den Optionen und angeben kann, die beim Suchen nach Text in einem Dokument verwendet werden sollen.
FRHookProc Empfängt Nachrichten oder Benachrichtigungen, die für die Standarddialogfeldprozedur des Dialogfelds Suchen oder Ersetzen vorgesehen sind. Dies ist eine anwendungs- oder bibliotheksdefinierte Rückruffunktion, die mit der FindText- oder ReplaceText-Funktion verwendet wird.
GetFileTitle Ruft den Namen der angegebenen Datei ab.
GetOpenFileName Erstellt ein Dialogfeld Öffnen, in dem der Benutzer das Laufwerk, das Verzeichnis und den Namen einer Datei oder eines Dateisatzes angeben kann, die geöffnet werden sollen.
GetSaveFileName Erstellt ein Dialogfeld Speichern, in dem der Benutzer das Laufwerk, das Verzeichnis und den Namen einer zu speichernde Datei angeben kann.
OFNHookProc Empfängt Benachrichtigungsmeldungen, die vom Dialogfeld gesendet werden. Die Funktion empfängt auch Nachrichten für alle zusätzlichen Steuerelemente, die Sie durch Angeben einer vorlage für untergeordnete Dialoge definiert haben. Dies ist eine anwendungs- oder bibliotheksdefinierte Rückruffunktion, die mit den Dialogfeldern Öffnen und Speichern unter im Explorer-Stil verwendet wird.
OFNHookProcOldStyle Empfängt Nachrichten oder Benachrichtigungen, die für die Dialogfeldprozedur vorgesehen sind. Dies ist eine anwendungs- oder bibliotheksdefinierte Rückruffunktion, die mit den Dialogfeldern Öffnen und Speichern unter verwendet wird.
PagePaintHook Empfängt Nachrichten, mit denen Sie das Zeichnen der Beispielseite im Dialogfeld Seiteneinrichtung anpassen können. Dies ist eine anwendungs- oder bibliotheksdefinierte Rückruffunktion, die mit der PageSetupDlg-Funktion verwendet wird.
PageSetupDlg Erstellt ein Dialogfeld "Seiteneinrichtung", in dem der Benutzer die Attribute einer gedruckten Seite angeben kann. Diese Attribute umfassen die Papiergröße und -quelle, die Seitenausrichtung (Hochformat oder Querformat) und die Breite der Seitenränder.
PageSetupHook Empfängt Nachrichten oder Benachrichtigungen, die für die Standarddialogfeldprozedur des Dialogfelds Seiteneinrichtung vorgesehen sind. Dies ist eine anwendungs- oder bibliotheksdefinierte Rückruffunktion, die mit der PageSetupDlg-Funktionverwendet wird.
PrintDlg Zeigt einDruckdialogfeld an. Im Dialogfeld Drucken kann der Benutzer die Eigenschaften eines bestimmten Druckauftrags angeben.
PrintDlgEx Zeigt ein Druckeigenschaftenblatt an, mit dem der Benutzer die Eigenschaften eines bestimmten Druckauftrags angeben kann. Ein Druckeigenschaftenblatt verfügt über eine Seite Allgemein, die Steuerelemente enthält, die dem Dialogfeld Drucken ähneln. Das Eigenschaftenblatt kann auch zusätzliche anwendungsspezifische und treiberspezifische Eigenschaftenseiten sowie die Seite Allgemein enthalten.
PrintHookProc Empfängt Nachrichten oder Benachrichtigungen, die für die Standarddialogfeldprozedur des Dialogfelds Drucken vorgesehen sind. Dies ist eine anwendungs- oder bibliotheksdefinierte Rückruffunktion, die mit der PrintDlg-Funktion verwendet wird.
ReplaceText Erstellt ein systemdefiniertes, modusloses Dialogfeld, in dem der Benutzer eine Zeichenfolge für die Suche und eine Ersetzungszeichenfolge sowie Optionen zum Steuern der Such- und Ersetzungsvorgänge angeben kann.
SetupHookProc Eine anwendungs- oder bibliotheksdefinierte Rückruffunktion, die mit der PrintDlg-Funktion verwendet wird. Die Hookprozedur empfängt Nachrichten oder Benachrichtigungen, die für die Standarddialogfeldprozedur des Dialogfelds Setup drucken vorgesehen sind.

Schnittstellen

Name BESCHREIBUNG
IPrintDialogCallback Stellt Methoden bereit, mit denen eine Anwendung Benachrichtigungen und Nachrichten von der PrintDlgEx-Funktion empfangen kann, während das Druckeigenschaftenblatt angezeigt wird.
IPrintDialogServices Stellt Methoden bereit, mit denen eine Anwendung mithilfe der PrintDlgEx-Funktion Informationen zum aktuell ausgewählten Drucker abrufen kann.

Nachrichten

Name BESCHREIBUNG
CDM _ GETFILEPATH Ruft den Pfad und den Dateinamen der ausgewählten Datei im Explorer-Stil im Dialogfeld Öffnen oder Speichern unter ab. Das Dialogfeld muss mit dem OFN-EXPLORER-Flag erstellt worden _ sein. Andernfalls schlägt die Meldung fehl.
CDM _ GETFOLDERIDLIST Ruft die Adresse der Elementbezeichnerliste ab, die dem Ordner entspricht, in dem derzeit ein Dialogfeld im Explorer-Stil Geöffnet oder Speichern unter geöffnet ist. Das Dialogfeld muss mit dem _ OFN-EXPLORER-Flag erstellt worden sein. Andernfalls schlägt die Meldung fehl.
CDM _ GETFOLDERPATH Ruft den Pfad des derzeit geöffneten Ordners oder Verzeichnisses für das Dialogfeld Öffnen oder Speichern unter im Explorer-Stil ab. Das Dialogfeld muss mit dem _ OFN-EXPLORER-Flag erstellt worden sein. Andernfalls schlägt die Meldung fehl.
CDM _ GETSPEC Ruft den Dateinamen (ohne den Pfad) der aktuell ausgewählten Datei in einem Dialogfeld im Explorer-Stil open or Save As (Öffnen oder Speichern unter) ab. Das Dialogfeld muss mit dem _ OFN-EXPLORER-Flag erstellt worden sein. Andernfalls schlägt die Meldung fehl.
CDM _ HIDECONTROL Blendet das angegebene Steuerelement im Explorer-Stil im Dialogfeld Öffnen oder Speichern unter aus. Das Dialogfeld muss mit dem _ OFN-EXPLORER-Flag erstellt worden sein. Andernfalls schlägt die Meldung fehl.
CDM _ SETCONTROLTEXT Legt den Text für das angegebene Steuerelement im Explorer-Stil im Dialogfeld Öffnen oder Speichern unter fest. Das Dialogfeld muss mit dem _ OFN-EXPLORER-Flag erstellt worden sein. Andernfalls schlägt die Meldung fehl.
CDM _ SETDEFEXT Legt die Standarddateinamenerweiterung für ein Dialogfeld im Explorer-Stil "Öffnen" oder "Speichern unter" fest. Das Dialogfeld muss mit dem _ OFN-EXPLORER-Flag erstellt worden sein. Andernfalls schlägt die Meldung fehl.
SETRGBSTRING Die Hookprozedur eines Farbdialogfelds, CCHookProc,kann die registrierte SETRGBSTRING-Nachricht an das Dialogfeld senden, um die aktuelle Farbauswahl festzulegen.
WM _ CHOOSEFONT _ GETLOGFONT Eine Anwendung sendet die WM _ CHOOSEFONT _ GETLOGFONT-Nachricht an ein Dialogfeld Schriftart, um Informationen zur aktuellen Schriftartauswahl des Benutzers abzurufen.
WM _ CHOOSEFONT _ SETFLAGS Eine Anwendung sendet die _ WM-Nachricht CHOOSEFONT _ SETFLAGS an ein Dialogfeld Schriftart, um die Anzeigeoptionen für das Dialogfeld festzulegen.
WM _ CHOOSEFONT _ SETLOGFONT Eine Anwendung sendet die _ WM-Nachricht CHOOSEFONT _ SETLOGFONT an ein Dialogfeld Schriftart, um die aktuellen logischen Schriftartinformationen festzulegen.

Benachrichtigungen

Name BESCHREIBUNG
_CDN FILEOK Wird von einem Dialogfeld im Explorer-Stil geöffnet oder speichern unter gesendet, wenn der Benutzer einen Dateinamen angibt und auf die Schaltfläche OK klickt.
_CDN FOLDERCHANGE Wird von einem Dialogfeld im Explorer-Stil geöffnet oder speichern unter gesendet, wenn ein neuer Ordner geöffnet wird.
_CDN HILFE Wird von einem Dialogfeld im Explorer-Stil geöffnet oder speichern unter gesendet, wenn der Benutzer auf die Schaltfläche Hilfe klickt.
_CDN INCLUDEITEM Wird von einem Dialogfeld Öffnen oder Speichern unter gesendet, um zu bestimmen, ob im Dialogfeld ein Element in der Elementliste eines Shellordners angezeigt werden soll. Wenn der Benutzer einen Ordner öffnet, sendet das Dialogfeld eine CDN _ INCLUDEITEM-Benachrichtigung für jedes Element im Ordner. Das Dialogfeld sendet diese Benachrichtigung nur, wenn das OFN _ ENABLEINCLUDENOTIFY-Flag beim Erstellen des Dialogfelds festgelegt wurde.
_CDN INITDONE Wird von einem Dialogfeld im Explorer-Stil geöffnet oder speichern unter gesendet, wenn das System die Anordnung der Steuerelemente im Dialogfeld abgeschlossen hat. Das System verschiebt die Standardsteuerelemente, um Platz für die Steuerelemente des untergeordneten Dialogfelds zu schaffen.
_CDN SELCHANGE Wird von einem Dialogfeld im Explorer-Stil geöffnet oder speichern unter gesendet, wenn sich die Auswahl im Listenfeld ändert, in dem der Inhalt des aktuell geöffneten Ordners oder Verzeichnisses angezeigt wird.
_CDN SHAREVIOLATION Wird von einem Dialogfeld im Explorer-Stil geöffnet oder speichern unter gesendet, wenn der Benutzer auf die Schaltfläche OK klickt und eine Netzwerkfreigabeverletzung für die ausgewählte Datei auftritt.
_CDN TYPECHANGE Wird von einem Dialogfeld im Explorer-Stil geöffnet oder speichern unter gesendet, wenn der Benutzer einen neuen Dateityp aus dem Kombinationsfeld "Dateitypen" auswählt.
COLOROKSTRING Ein Dialogfeld Farbe sendet die registrierte COLOROKSTRING-Nachricht an Die Hookprozedur CCHookProc,wenn der Benutzer eine Farbe auswählt und auf die Schaltfläche OK klickt. Die Hookprozedur kann die Farbe akzeptieren und zulassen, dass das Dialogfeld geschlossen wird, oder die Farbe ablehnen und erzwingen, dass das Dialogfeld geöffnet bleibt.
FILEOKSTRING Ein Dialogfeld Öffnen oder Speichern unter sendet die registrierte FILEOKSTRING-Nachricht an Die Hookprozedur OFNHookProc,wenn der Benutzer einen Dateinamen angibt und auf die Schaltfläche OK klickt. Die Hookprozedur kann den Dateinamen akzeptieren und zulassen, dass das Dialogfeld geschlossen wird, oder den Dateinamen ablehnen und erzwingen, dass das Dialogfeld geöffnet bleibt.
FINDMSGSTRING Ein Dialogfeld Suchen oder Ersetzen sendet die registrierte MELDUNG FINDMSGSTRING an die Fensterprozedur des Besitzerfensters, wenn der Benutzer auf die Schaltfläche Weiter suchen, Ersetzen oder Alle ersetzen klickt oder das Dialogfeld schließt.
HELPMSGSTRING Ein allgemeines Dialogfeld sendet die bei HELPMSGSTRING registrierte Meldung an die Fensterprozedur des Besitzerfensters, wenn der Benutzer auf die Schaltfläche Hilfe klickt.
LBSELCHSTRING Ein Dialogfeld Öffnen oder Speichern unter sendet die registrierte LBSELCHSTRING-Nachricht an Ihre Hookprozedur, wenn sich die Auswahl in einem der Listenfelder oder Kombinationsfelder des Dialogfelds ändert.
SHAREVISTRING Ein Dialogfeld Öffnen oder Speichern unter sendet die registrierte SHAREVISTRING-Nachricht an Die Hookprozedur OFNHookProc,wenn eine Freigabeverletzung für die ausgewählte Datei auftritt, wenn der Benutzer auf die Schaltfläche OK klickt.
WM _ PSD _ ENVSTAMPRECT Benachrichtigt die Hookprozedur eines Dialogfelds "Seiteneinrichtung", PagePaintHook,dass das Dialogfeld das Umschlagstempelrechteck der Beispielseite zeichnen soll.
WM _ PSD _ FULLPAGERECT Benachrichtigt eine PagePaintHook-Hookprozedur über die Koordinaten des Beispielseitenrechtecks im Dialogfeld Seiteneinrichtung. Das Dialogfeld sendet diese Meldung, wenn der Inhalt der Beispielseite gezeichnet werden soll.
WM _ PSD _ GREEKTEXTRECT Benachrichtigt die Hookprozedur eines Dialogfelds "Seiteneinrichtung", PagePaintHook,darüber, dass im Dialogfeld griechischer Text innerhalb des Randrechtecks der Beispielseite gezeichnet werden soll.
WM _ PSD _ MARGINRECT Benachrichtigt die Hookprozedur eines Dialogfelds "Seiteneinrichtung", PagePaintHook,dass das Dialogfeld das Randrechteck der Beispielseite zeichnen soll.
WM _ PSD _ MINMARGINRECT Benachrichtigt eine PagePaintHook-Hookprozedur über die Koordinaten des Randrechtecks auf der Beispielseite. Ein Dialogfeld "Seiteneinrichtung" sendet diese Meldung, wenn der Inhalt der Beispielseite gezeichnet werden soll.
WM _ PSD _ PAGESETUPDLG Benachrichtigt eine PagePaintHook-Hookprozedur, dass das Dialogfeld Seiteneinrichtung den Inhalt der Beispielseite zeichnen soll. Die Hookprozedur kann diese Meldung verwenden, um Initialisierungsaufgaben im Zusammenhang mit dem Zeichnen des Inhalts der Beispielseite auszuführen.
WM _ PSD _ YAFULLPAGERECT Benachrichtigt die Hookprozedur eines Page Setup-Dialogfelds,PagePaintHook, dass das Dialogfeld den Rückgabeadressenteil einer Umschlagbeispielseite zeichnen soll.

Strukturen

Name BESCHREIBUNG
CHOOSECOLOR Enthält Informationen, die die ChooseColor-Funktion zum Initialisieren des Dialogfelds Farbe verwendet. Nachdem der Benutzer das Dialogfeld geschlossen hat, gibt das System Informationen zur Auswahl des Benutzers in dieser Struktur zurück.
CHOOSEFONT Enthält Informationen, die die ChooseFont-Funktion verwendet, um das Dialogfeld Schriftart zu initialisieren. Nachdem der Benutzer das Dialogfeld geschlossen hat, gibt das System Informationen zur Auswahl des Benutzers in dieser Struktur zurück.
DEVNAMES Enthält Zeichenfolgen, die die Treiber-, Geräte- und Ausgabeportnamen für einen Drucker identifizieren. Die Funktionen PrintDlgEx und PrintDlg verwenden diese Zeichenfolgen, um das systemdefinierte Druckeigenschaftenblatt oder das Druckdialogfeldzu initialisieren. Wenn der Benutzer das Eigenschaftenblatt oder Dialogfeld schließt, werden Informationen zum ausgewählten Drucker in dieser Struktur zurückgegeben.
FINDREPLACE Enthält Informationen, die die Funktionen FindText und ReplaceText verwenden, um die Dialogfelder Suchen und Ersetzen zu initialisieren. Die registrierte FINDMSGSTRING-Nachricht verwendet diese Struktur, um die Such- oder Ersetzungseingabe des Benutzers an das Besitzerfenster eines Dialogfelds Suchen oder Ersetzen zu übergeben.
OFNOTIFY Enthält Informationen zu einer WM _ NOTIFY-Nachricht, die an eine OFNHookProc-Hookprozedur für ein Dialogfeld Öffnen oder Speichern unter gesendet wird. Der lParam-Parameter der WM _ NOTIFY-Nachricht ist ein Zeiger auf eine OFNOTIFY-Struktur.
OFNOTIFYEX Enthält Informationen zu einer CDN INCLUDEITEM-Benachrichtigungsmeldung. _
OPENFILENAME Enthält Informationen, die die Funktionen GetOpenFileName und GetSaveFileName verwenden, um ein Dialogfeld Öffnen oder Speichern unter zu initialisieren. Nachdem der Benutzer das Dialogfeld geschlossen hat, gibt das System Informationen zur Auswahl des Benutzers in dieser Struktur zurück.
OPENFILENAME _ NT4 Identisch mit OPENFILENAME, wobei _ WIN32 _ WINNT auf 0x0400 festgelegt ist.
PAGESETUPDLG Enthält Informationen, die die PageSetupDlg-Funktion zum Initialisieren des Dialogfelds Seiteneinrichtung verwendet. Nachdem der Benutzer das Dialogfeld geschlossen hat, gibt das System Informationen zu den benutzerdefinierten Seitenparametern in dieser Struktur zurück.
PRINTDLG Enthält Informationen, die die PrintDlg-Funktion verwendet, um das Dialogfeld Druckenzu initialisieren. Nachdem der Benutzer das Dialogfeld geschlossen hat, verwendet das System diese Struktur, um Informationen zur Auswahl des Benutzers zurückzugeben.
PRINTDLGEX Enthält Informationen, die die PrintDlgEx-Funktion verwendet, um das Print-Eigenschaftenblattzu initialisieren. Nachdem der Benutzer das Eigenschaftenblatt geschlossen hat, verwendet das System diese Struktur, um Informationen zur Auswahl des Benutzers zurückzugeben.
PRINTPAGERANGE Gibt einen Seitenbereich in einem Druckauftrag an. Ein Druckauftrag kann mehrere Seitenbereiche aufweisen. Diese Informationen werden in der PRINTDLGEX-Struktur beim Aufrufen der PrintDlgEx-Funktion bereitgestellt.