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. |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Feedback senden und anzeigen für