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. |