Allgemeine Dialogfeldbibliothek
Die allgemeine Dialogfeldbibliothek enthält eine Reihe von Dialogfeldern zum Ausführen gängiger Anwendungsaufgaben, z. B. zum Öffnen von Dateien, Auswählen von Farbwerten und Drucken von Dokumenten. Mit den gängigen Dialogfeldern können Sie einen konsistenten Ansatz für die Benutzeroberfläche Ihrer Anwendung implementieren. Dies reduziert den Aufwand, den Benutzer beim Lernen des Benutzeroberflächenverhaltens für Ihre Anwendung aufwenden.
In diesem Abschnitt werden die allgemeinen Dialogfelder beschrieben, in denen die Dialogfelder Öffnen und Speichern unter, die Bearbeitungsdialogfelder Suchen und Ersetzen, die Druckdialogfelder Drucken, Druckeinrichtung, Druckeigenschaftenblatt und Seiteneinrichtung und die Dialogfelder Farbe und Schriftart enthalten sind.
Hinweis
Ab Windows Vista wurden die gängigen Dialogfelder Öffnen und Speichern unter durch das Dialogfeld „Allgemeine Elemente“ ersetzt. Es wird empfohlen, anstelle dieser Dialogfelder aus der allgemeinen Dialogfeldbibliothek die API für das allgemeine Elementdialogfeld zu verwenden.
In diesem Abschnitt
| Name | Beschreibung |
|---|---|
| Allgemeine Dialogfeldtypen | Erläutert die verschiedenen Dialogfelder. |
| Allgemeine Initialisierungskennzeichnungen im Dialogfeld | Erläutert, wie Flags verwendet werden, um das Verhalten und die Darstellung eines allgemeinen Dialogfelds zu ändern. |
| Anpassen allgemeiner Dialogfelder | Erläutert, wie allgemeine Dialogfelder verwendet werden. |
| Verwenden allgemeiner Dialogfelder | Behandelt Aufgaben, die allgemeine Dialogfelder aufrufen. |
| Referenz zu allgemeinen Dialogfeldern | Enthält die API-Referenz. |
Funktionen
| Name | Beschreibung |
|---|---|
| CCHookProc | Empfängt Nachrichten oder Benachrichtigungen, die für das Standarddialogfeld des Dialogfelds Farbe vorgesehen sind. Dies ist eine anwendungsdefinierte oder bibliotheksdefinierte Rückruffunktion, die mit der ChooseColor-Funktion verwendet wird. |
| CFHookProc | Empfängt Nachrichten oder Benachrichtigungen, die für das Standarddialogfeld des Dialogfelds Schriftart vorgesehen sind. Dies ist ein anwendungsdefinierter oder bibliotheksdefinierter Rückrufvorgang, der 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 ein zugehöriger Schriftschnitt, eine Punktgröße, Effekte (Unterstreichung, Durchstreichung und Textfarbe) und ein Skript (oder 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, nicht modales Dialogfeld Suchen, in dem der Benutzer eine zu suchende Zeichenfolge und die bei der Suche nach Text in einem Dokument zu verwendenden Optionen angeben kann. |
| FRHookProc | Empfängt Nachrichten oder Benachrichtigungen, die für das Standarddialogfeld des Dialogfelds Suchen oder Ersetzen vorgesehen sind. Dies ist eine anwendungsdefinierte oder bibliotheksdefinierte Rückruffunktion, die mit der Funktion FindText oder ReplaceText verwendet wird. |
| GetFileTitle | Ruft den Namen der angegebenen Datei ab. |
| GetOpenFileName | Erstellt ein Dialogfeld Öffnen, damit der Benutzer das Laufwerk, das Verzeichnis und den Namen einer Datei oder eines Dateisatzes angeben kann, der geöffnet werden soll. |
| GetSaveFileName | Erstellt ein Dialogfeld Speichern, damit der Benutzer das Laufwerk, das Verzeichnis und den Namen einer zu speichernden Datei angeben kann. |
| OFNHookProc | Empfängt Benachrichtigungen, die aus dem Dialogfeld gesendet werden. Die Funktion empfängt auch Meldungen für alle zusätzlichen Steuerelemente, die Sie durch Angeben einer untergeordneten Dialogfeldvorlage definiert haben. Dies ist eine anwendungsdefinierte 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 Prozedur des Dialogfelds vorgesehen sind. Dies ist eine anwendungsdefinierte oder bibliotheksdefinierte Rückruffunktion, die mit den Dialogfeldern Öffnen und Speichern unter verwendet wird. |
| PagePaintHook | Empfängt Nachrichten, mit denen Sie die Zeichnung der Beispielseite im Dialogfeld Seite einrichten anpassen können. Dies ist eine anwendungsdefinierte oder bibliotheksdefinierte Rückruffunktion, die mit der PageSetupDlg-Funktion verwendet wird. |
| PageSetupDlg | Erstellt ein Dialogfeld Seite einrichten, in dem der Benutzer die Attribute einer gedruckten Seite angeben kann. Zu diesen Attributen gehören das Papierformat und die Quelle, die Seitenausrichtung (Hoch- oder Querformat) und die Breite der Seitenränder. |
| PageSetupHook | Empfängt Nachrichten oder Benachrichtigungen, die für das Standarddialogfeld des Dialogfelds Seite einrichten vorgesehen sind. Dies ist eine anwendungsdefinierte oder bibliotheksdefinierte Rückruffunktion, die mit der PageSetupDlg-Funktion verwendet wird. |
| PrintDlg | Zeigt das Dialogfeld Drucken an. Im Dialogfeld Drucken kann der Benutzer die Eigenschaften eines bestimmten Druckauftrags angeben. |
| PrintDlgEx | Zeigt das Eigenschaftenblatt Drucken an, mit dem der Benutzer die Eigenschaften eines bestimmten Druckauftrags angeben kann. Das Eigenschaftenblatt Drucken verfügt über die Seite Allgemein, die Steuerelemente enthält, die dem Dialogfeld Drucken ähneln. Das Eigenschaftenblatt kann auch über zusätzliche anwendungsspezifische und treiberspezifische Eigenschaftenseiten sowie die Seite Allgemein verfügen. |
| PrintHookProc | Empfängt Nachrichten oder Benachrichtigungen, die für das Standarddialogfeld des Dialogfelds Drucken vorgesehen sind. Dies ist eine anwendungsdefinierte oder bibliotheksdefinierte Rückruffunktion, die mit der PrintDlg-Funktion verwendet wird. |
| ReplaceText | Erstellt ein systemdefiniertes, nicht modales Dialogfeld, in dem der Benutzer eine zu suchende Zeichenfolge und eine Ersetzungszeichenfolge sowie Optionen zum Steuern der Such- und Ersetzungsvorgänge angeben kann. |
| SetupHookProc | Eine anwendungsdefinierte oder bibliotheksdefinierte Rückruffunktion, die mit der PrintDlg-Funktion verwendet wird. Die Hook-Prozedur empfängt Nachrichten oder Benachrichtigungen, die für das Standarddialogfeld des Dialogfelds Druckeinrichtung 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 Dateinamen der ausgewählten Datei in einem Dialogfeld Öffnen oder Speichern unter im Explorer-Stil ab. Das Dialogfeld muss mit der OFN_EXPLORER-Kennzeichnung erstellt worden sein. Andernfalls schlägt die Nachricht fehl. |
| CDM_GETFOLDERIDLIST | Ruft die Adresse der Elementbezeichnerliste ab, die dem Ordner entspricht, den ein Dialogfeld Öffnen oder Speichern unter im Explorer-Stil derzeit geöffnet hat. Das Dialogfeld muss mit der OFN_EXPLORER-Kennzeichnung erstellt worden sein. Andernfalls schlägt die Nachricht fehl. |
| CDM_GETFOLDERPATH | Ruft den Pfad des aktuell geöffneten Ordners oder Verzeichnisses für ein Dialogfeld Öffnen oder Speichern unter im Explorer-Stil ab. Das Dialogfeld muss mit der OFN_EXPLORER-Kennzeichnung erstellt worden sein. Andernfalls schlägt die Nachricht fehl. |
| CDM_GETSPEC | Ruft den Dateinamen (nicht einschließlich des Pfads) der aktuell ausgewählten Datei in einem Dialogfeld Öffnen oder Speichern unter im Explorer-Stil ab. Das Dialogfeld muss mit der OFN_EXPLORER-Kennzeichnung erstellt worden sein. Andernfalls schlägt die Nachricht fehl. |
| CDM_HIDECONTROL | Blendet das angegebene Steuerelement in einem Dialogfeld Öffnen oder Speichern unter im Explorer-Stil aus. Das Dialogfeld muss mit der OFN_EXPLORER-Kennzeichnung erstellt worden sein. Andernfalls schlägt die Nachricht fehl. |
| CDM_SETCONTROLTEXT | Legt den Text für das angegebene Steuerelement in einem Dialogfeld Öffnen oder Speichern unter im Explorer-Stil fest. Das Dialogfeld muss mit der OFN_EXPLORER-Kennzeichnung erstellt worden sein. Andernfalls schlägt die Nachricht fehl. |
| CDM_SETDEFEXT | Legt die Standarddateierweiterung für ein Dialogfeld Öffnen oder Speichern unter im Explorer-Stil fest. Das Dialogfeld muss mit der OFN_EXPLORER-Kennzeichnung erstellt worden sein. Andernfalls schlägt die Nachricht fehl. |
| SETRGBSTRING | Die Hook-Prozedur eines Dialogfelds Farbe, CCHookProc, kann die registrierte Nachricht SETRGBSTRING 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_CHOOSEFONT_SETFLAGS-Nachricht an ein Dialogfeld Schriftart, um die Anzeigeoptionen für das Dialogfeld festzulegen. |
| WM_CHOOSEFONT_SETLOGFONT | Eine Anwendung sendet die WM_CHOOSEFONT_SETLOGFONT-Nachricht an ein Dialogfeld Schriftart, um die aktuellen logischen Schriftartinformationen festzulegen. |
Benachrichtigungen
| Name | Beschreibung |
|---|---|
| CDN_FILEOK | Gesendet von einem Dialogfeld Öffnen oder Speichern unter im Explorer-Stil, wenn der Benutzer einen Dateinamen angibt und auf die Schaltfläche OK klickt. |
| CDN_FOLDERCHANGE | Wird beim Öffnen eines neuen Ordners von einem Dialogfeld Öffnen oder Speichern unter im Explorer-Stil gesendet. |
| CDN_HELP | Wird von einem Dialogfeld Öffnen oder Speichern unter im Explorer-Stil gesendet, wenn der Benutzer auf die Schaltfläche Hilfe klickt. |
| CDN_INCLUDEITEM | Gesendet von einem Dialogfeld Öffnen oder Speichern unter, um zu bestimmen, ob das Dialogfeld ein Element in der Elementliste eines Shellordners anzeigen 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 | Gesendet von einem Dialogfeld Öffnen oder Speichern unter im Explorer-Stil, 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 Öffnen oder Speichern unter im Explorer-Stil gesendet, wenn sich die Auswahl im Listenfeld ändert, in dem der Inhalt des aktuell geöffneten Ordners oder Verzeichnisses angezeigt wird. |
| CDN_SHAREVIOLATION | Gesendet von einem Dialogfeld Öffnen oder Speichern unter im Explorer-Stil, wenn der Benutzer auf die Schaltfläche OK klickt und eine Netzwerkfreigabeverletzung für die ausgewählte Datei auftritt. |
| CDN_TYPECHANGE | Gesendet von einem Dialogfeld Öffnen oder Speichern unter im Explorer-Stil, wenn der Benutzer einen neuen Dateityp aus dem Kombinationsfeld „Dateitypen“ auswählt. |
| COLOROKSTRING | Ein Dialogfeld Farbe sendet die registrierte Nachricht COLOROKSTRING an Ihre Hook-Prozedur, CCHookProc, wenn der Benutzer eine Farbe auswählt und auf die Schaltfläche OK klickt. Die Hook-Prozedur kann die Farbe akzeptieren und das Schließen des Dialogfelds zulassen oder die Farbe ablehnen und das Öffnen des Dialogfelds erzwingen. |
| FILEOKSTRING | Ein Dialogfeld Öffnen oder Speichern unter sendet die registrierte Nachricht FILEOKSTRING an Ihre Hook-Prozedur, OFNHookProc, wenn der Benutzer einen Dateinamen angibt und auf die Schaltfläche OK klickt. Die Hook-Prozedur kann den Dateinamen akzeptieren und das Schließen des Dialogfelds zulassen oder den Dateinamen ablehnen und das Öffnen des Dialogfelds erzwingen. |
| FINDMSGSTRING | Ein Dialogfeld Suchen oder Ersetzen sendet die registrierte Nachricht FINDMSGSTRING an die Fensterprozedur des Besitzerfensters, wenn der Benutzer auf die Schaltfläche Weitersuchen, Ersetzen oder Alle ersetzen klickt oder das Dialogfeld schließt. |
| HELPMSGSTRING | Ein gängiges Dialogfeld sendet die registrierte Nachricht HELPMSGSTRING an die Fensterprozedur des Besitzerfensters, wenn der Benutzer auf die Schaltfläche Hilfe klickt. |
| LBSELCHSTRING | Ein Dialogfeld Öffnen oder Speichern unter sendet die registrierte Nachricht LBSELCHSTRING an Ihre Hook-Prozedur, wenn sich die Auswahl in einem der Listen- oder Kombinationsfelder des Dialogfelds ändert. |
| SHAREVISTRING | Ein Dialogfeld Öffnen oder Speichern unter sendet die registrierte Nachricht SHAREVISTRING an Ihre Hook-Prozedur, 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 Hook-Prozedur eines Dialogfelds Seite einrichten, PagePaintHook, dass das Dialogfeld dabei ist, das Umschlagstempelrechteck der Beispielseite zu zeichnen. |
| WM_PSD_FULLPAGERECT | Benachrichtigt eine PagePaintHook-Hook-Prozedur über die Koordinaten des Beispielseitenrechtecks im Dialogfeld Seite einrichten. Das Dialogfeld sendet diese Meldung, wenn der Inhalt der Beispielseite gezeichnet werden soll. |
| WM_PSD_GREEKTEXTRECT | Benachrichtigt die Hook-Prozedur eines Dialogfelds Seite einrichten, PagePaintHook, dass das Dialogfeld im Begriff ist, griechischen Text innerhalb des Randrechtecks der Beispielseite zu zeichnen. |
| WM_PSD_MARGINRECT | Benachrichtigt die Hook-Prozedur eines Dialogfelds Seite einrichten, PagePaintHook, dass das Dialogfeld dabei ist, das Randrechteck der Beispielseite zu zeichnen. |
| WM_PSD_MINMARGINRECT | Benachrichtigt eine PagePaintHook-Hook-Prozedur der Koordinaten des Randrechtecks auf der Beispielseite. Ein Dialogfeld Seite einrichten sendet diese Meldung, wenn der Inhalt der Beispielseite gezeichnet werden soll. |
| WM_PSD_PAGESETUPDLG | Benachrichtigt eine PagePaintHook-Hook-Prozedur, dass das Dialogfeld Seite einrichten dabei ist, den Inhalt der Beispielseite zu zeichnen. Die Hook-Prozedur kann diese Meldung verwenden, um Initialisierungsaufgaben im Zusammenhang mit dem Zeichnen des Inhalts der Beispielseite auszuführen. |
| WM_PSD_YAFULLPAGERECT | Benachrichtigt die Hook-Prozedur eines Dialogfelds Seite einrichten, PagePaintHook, dass das Dialogfeld im Begriff ist, den Abschnitt mit der Absenderadresse einer Umschlagbeispielseite zu zeichnen. |
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 von der ChooseFont-Funktion zum Initialisieren des Dialogfelds Schriftart verwendet werden. 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 Dialogfeld „Drucken“ zu 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 Nachricht FINDMSGSTRING verwendet diese Struktur, um die Such- oder Ersetzungseingabe des Benutzers an das Besitzerfenster eines Dialogfelds Suchen oder Ersetzen zu übergeben. |
| OFNOTIFY | Enthält Informationen über eine WM_NOTIFY-Nachricht, die an eine OFNHookProc-Hook-Prozedur 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-Benachrichtigung. |
| 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 verwendet, um das Dialogfeld Seite einrichten zu initialisieren. Nachdem der Benutzer das Dialogfeld geschlossen hat, gibt das System in dieser Struktur Informationen über die benutzerdefinierten Seitenparameter zurück. |
| PRINTDLG | Enthält Informationen, die von der PrintDlg-Funktion zum Initialisieren des Dialogfelds „Drucken“ verwendet werden. 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 von der PrintDlgEx-Funktion zum Initialisieren des Druckeigenschaftenblatts verwendet werden. 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 beim Aufrufen der PrintDlgEx-Funktion in der PrintDlgEx-Struktur bereitgestellt. |