Allgemeine Dialogfeldbibliothek

Die Allgemeine Dialogfeldbibliothek 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. Dadurch wird der Aufwand verringert, den Benutzer beim Lernen des Benutzeroberflächenverhaltens für Ihre Anwendung aufwenden.

In diesem Abschnitt werden die allgemeinen Dialogfelder beschrieben, die die Dialogfelder Datei öffnen und Speichern unter enthalten. die Dialogfelder "Bearbeiten suchenund ersetzen "; die Dialogfelder Drucken, Druckeinrichtung, Eigenschaftenblatt drucken und Seiteneinrichtung drucken; und die Dialogfelder Farbe und Schriftart .

Hinweis

Ab Windows Vista wurden die allgemeinen 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 Allgemeinen Dialogfeldbibliothek zu verwenden.

In diesem Abschnitt

Name BESCHREIBUNG
Allgemeine Dialogfeldtypen Erläutert die verschiedenen Dialogfelder.
Allgemeine Dialogfeldinitialisierungsflags Erläutert, wie Flags verwendet werden, um das Verhalten und die Darstellung eines allgemeinen Dialogfelds zu ändern.
Anpassen allgemeiner Dialogfelder Erläutert die Verwendung allgemeiner Dialogfelder.
Verwenden allgemeiner Dialogfelder 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 bestimmt 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 die Standarddialogfeldprozedur des Dialogfelds Schriftart vorgesehen sind. Dies ist eine anwendungsdefinierte 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 , das es dem Benutzer ermöglicht, Attribute für eine logische Schriftart auszuwählen. Zu diesen Attributen gehören eine Schriftartfamilie und ein zugeordneter Schriftstil, eine Punktgröße, Effekte (Unterstrichen, Streichen und Textfarbe) sowie ein Skript (oder Zeichensatz).
CommDlgExtendedError Gibt einen allgemeinen Dialogfeldfehlercode zurück. Dieser Code gibt den neuesten Fehler an, der während der Ausführung einer der allgemeinen Dialogfeldfunktionen auftritt.
Findtext Erstellt ein systemdefiniertes Dialogfeld " Moduslose Suche", in dem der Benutzer eine Zeichenfolge angeben kann, nach der gesucht werden soll, und optionen, die bei der Suche nach Text in einem Dokument verwendet werden sollen.
FRHookProc Empfängt Nachrichten oder Benachrichtigungen, die für die Standarddialogfeldprozedur des Dialogfelds Suchen oder Ersetzen bestimmt 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 , in dem der Benutzer das Laufwerk, das Verzeichnis und den Namen einer zu öffnenden Datei oder gruppe von Dateien angeben kann.
GetSaveFileName Erstellt ein Dialogfeld Speichern , in dem der Benutzer das Laufwerk, das Verzeichnis und den Namen einer zu speichernden Datei angeben kann.
OFNHookProc Empfängt Benachrichtigungen, die vom Dialogfeld gesendet werden. Die Funktion empfängt auch Nachrichten für alle zusätzlichen Steuerelemente, die Sie durch Angeben einer untergeordneten Dialogvorlage definiert haben. Dies ist eine anwendungsdefinierte oder bibliotheksdefinierte Rückruffunktion, die mit den Dialogfeldern öffnen und speichern unter Explorer verwendet wird.
OFNHookProcOldStyle Empfängt Nachrichten oder Benachrichtigungen, die für die Dialogfeldprozedur 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 Seiteneinrichtung , das es dem Benutzer ermöglicht, die Attribute einer gedruckten Seite anzugeben. 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 die Standarddialogfeldprozedur des Dialogfelds Seite einrichten bestimmt sind. Dies ist eine anwendungsdefinierte oder bibliotheksdefinierte Rückruffunktion, die mit derPageSetupDlg-Funktionverwendet wird.
PrintDlg Zeigt einDialogfeld "Drucken" an. Im Dialogfeld Drucken kann der Benutzer die Eigenschaften eines bestimmten Druckauftrags angeben.
PrintDlgEx Zeigt ein Print-Eigenschaftenblatt an, das es dem Benutzer ermöglicht, die Eigenschaften eines bestimmten Druckauftrags anzugeben. EinPrint-Eigenschaftenblattverfügt über eine Seite Allgemein , die Steuerelemente ähnlich dem Dialogfeld Drucken enthält. 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 bestimmt sind. Dies ist eine anwendungsdefinierte oder bibliotheksdefinierte Rückruffunktion, die mit der PrintDlg-Funktion verwendet wird.
ReplaceText Erstellt ein systemdefiniertes, modusloses Dialogfeld, in dem der Benutzer eine zu suchende Zeichenfolge und eine Ersatzzeichenfolge 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 Hookprozedur empfängt Nachrichten oder Benachrichtigungen, die für die Standarddialogfeldprozedur des Dialogfelds Druckeinrichtung vorgesehen sind.

Schnittstellen

Name BESCHREIBUNG
IPrintDialogCallback Stellt Methoden bereit, die es einer Anwendung ermöglichen, Benachrichtigungen und Meldungen von der PrintDlgEx-Funktion zu empfangen, 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 im Explorer-Format Öffnen oder Speichern unter ab. Das Dialogfeld muss mit dem Flag "OFN_EXPLORER" erstellt worden sein. Andernfalls schlägt die Meldung fehl.
CDM_GETFOLDERIDLIST Ruft die Adresse der Elementbezeichnerliste ab, die dem Ordner entspricht, den ein Dialogfeld im Explorer-Format Öffnen oder Speichern unter derzeit geöffnet hat. Das Dialogfeld muss mit dem Flag "OFN_EXPLORER " erstellt worden sein. Andernfalls schlägt die Meldung fehl.
CDM_GETFOLDERPATH Ruft den Pfad des aktuell geöffneten Ordners oder Verzeichnisses für ein dialogfeld im Explorer-Format Öffnen oder Speichern unter ab. Das Dialogfeld muss mit dem Flag "OFN_EXPLORER " erstellt worden sein. Andernfalls schlägt die Meldung fehl.
CDM_GETSPEC Ruft den Dateinamen (ohne Den Pfad) der aktuell ausgewählten Datei in einem Explorer Dialogfeld Öffnen oder Speichern unter ab. Das Dialogfeld muss mit dem Flag "OFN_EXPLORER " erstellt worden sein. Andernfalls schlägt die Meldung fehl.
CDM_HIDECONTROL Blendet das angegebene Steuerelement in einem Explorer Dialogfeld Öffnen oder Speichern unter aus. Das Dialogfeld muss mit dem Flag "OFN_EXPLORER " erstellt worden sein. Andernfalls schlägt die Meldung fehl.
CDM_SETCONTROLTEXT Legt den Text für das angegebene Steuerelement in einem Explorer Dialogfeld Öffnen oder Speichern unter fest. Das Dialogfeld muss mit dem Flag "OFN_EXPLORER " erstellt worden sein. Andernfalls schlägt die Meldung fehl.
CDM_SETDEFEXT Legt die Standarddateierweiterung für ein Dialogfeld "Öffnen" oder "Speichern unter" im Explorer-Format fest. Das Dialogfeld muss mit dem Flag "OFN_EXPLORER " erstellt worden sein. Andernfalls schlägt die Meldung fehl.
SETRGBSTRING Die Hookprozedur eines FarbdialogfeldsCCHookProc 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 zu den aktuellen Schriftartauswahlen des Benutzers abzurufen.
WM_CHOOSEFONT_SETFLAGS Eine Anwendung sendet die WM_CHOOSEFONT_SETFLAGS Meldung an ein Dialogfeld Schriftart , um die Anzeigeoptionen für das Dialogfeld festzulegen.
WM_CHOOSEFONT_SETLOGFONT Eine Anwendung sendet die WM_CHOOSEFONT_SETLOGFONT Meldung an ein Dialogfeld Schriftart , um die aktuellen Informationen zur logischen Schriftart festzulegen.

Benachrichtigungen

Name BESCHREIBUNG
CDN_FILEOK Wird von einem Explorer Dialogfeld "Öffnen" oder "Speichern unter" gesendet, wenn der Benutzer einen Dateinamen angibt und auf die Schaltfläche OK klickt.
CDN_FOLDERCHANGE Wird vom Dialogfeld "Öffnen" oder "Speichern unter" im Explorer-Format gesendet, wenn ein neuer Ordner geöffnet wird.
CDN_HELP Wird von einem Explorer Dialogfeld "Öffnen" 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 flag OFN_ENABLEINCLUDENOTIFY beim Erstellen des Dialogfelds festgelegt wurde.
CDN_INITDONE Wird von einem Explorer Dialogfeld "Öffnen" oder "Speichern unter" gesendet, wenn das System das Anordnen 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 Explorer Dialogfeld "Öffnen" oder "Speichern unter" gesendet, wenn sich die Auswahl in dem Listenfeld ändert, in dem der Inhalt des aktuell geöffneten Ordners oder Verzeichnisses angezeigt wird.
CDN_SHAREVIOLATION Wird von einem Explorer Dialogfeld Öffnen 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 Explorer Dialogfeld Öffnen oder Speichern unter gesendet, wenn der Benutzer im Kombinationsfeld Dateitypen einen neuen Dateityp auswählt.
COLOROKSTRING Ein Farbdialogfeld sendet die registrierte COLOROKSTRING-Nachricht an Ihre Hookprozedur CCHookProc, wenn der Benutzer eine Farbe auswählt und auf die Schaltfläche OK klickt. Die Hookprozedur kann die Farbe akzeptieren und das Schließen des Dialogfelds zulassen 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 Ihre Hookprozedur OFNHookProc, wenn der Benutzer einen Dateinamen angibt und auf die Schaltfläche OK klickt. Die Hookprozedur kann den Dateinamen akzeptieren und das Schließen des Dialogfelds zulassen oder den Dateinamen ablehnen und erzwingen, dass das Dialogfeld geöffnet bleibt.
FINDMSGSTRING Ein Dialogfeld Suchen oder Ersetzen sendet die registrierte FINDMSGSTRING-Nachricht 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 registrierte HELPMSGSTRING-Nachricht 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 Listen- oder Kombinationsfelder des Dialogfelds ändert.
SHAREVISTRING Ein Dialogfeld Öffnen oder Speichern unter sendet die registrierte SHAREVISTRING-Nachricht an Ihre 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 des Dialogfelds PagePaintHook des Dialogfelds PagePaintHook, dass das Dialogfeld das Umschlagstempelrechteck der Beispielseite zeichnet.
WM_PSD_FULLPAGERECT Benachrichtigt eine PagePaintHook-Hookprozedur ü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 Hookprozedur des Dialogfelds Page Setup ( PagePaintHook), dass das Dialogfeld griechischen Text innerhalb des Randrechtecks der Beispielseite zeichnen wird.
WM_PSD_MARGINRECT Benachrichtigt die Hookprozedur des Dialogfelds Page Setup (PagePaintHook), dass das Dialogfeld das Randrechteck der Beispielseite zeichnet.
WM_PSD_MINMARGINRECT Benachrichtigt eine PagePaintHook-Hookprozedur über die 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-Hookprozedur , dass das Dialogfeld Seite einrichten 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 des Dialogfelds Page Setup ( PagePaintHook), dass das Dialogfeld den Rücksendeadressenteil einer Umschlagbeispielseite zeichnet.

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 zum Initialisieren des Dialogfelds Schriftart verwendet. 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 FINDMSGSTRING-Nachricht verwendet diese Struktur, um die Such- oder Ersatzeingabe des Benutzers an das Besitzerfenster eines Dialogfelds Suchen oder Ersetzen zu übergeben.
OFNOTIFY Ccontains-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 Benachrichtigungsnachricht.
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 Informationen zu den benutzerdefinierten Seitenparametern in dieser Struktur zurück.
PRINTDLG Enthält Informationen, die die PrintDlg-Funktion zum Initialisieren des Dialogfelds Drucken verwendet. Nachdem der Benutzer das Dialogfeld geschlossen hat, verwendet das System diese Struktur, um Informationen über die Auswahl des Benutzers zurückzugeben.
PRINTDLGEX Enthält Informationen, die die PrintDlgEx-Funktion zum Initialisieren des Print-Eigenschaftenblatts verwendet. Nachdem der Benutzer das Eigenschaftenblatt geschlossen hat, verwendet das System diese Struktur, um Informationen über die 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 bereitgestellt, wenn die PrintDlgEx-Funktion aufgerufen wird.