CHOOSEFONTA-Struktur (commdlg.h)
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.
Syntax
typedef struct tagCHOOSEFONTA {
DWORD lStructSize;
HWND hwndOwner;
HDC hDC;
LPLOGFONTA lpLogFont;
INT iPointSize;
DWORD Flags;
COLORREF rgbColors;
LPARAM lCustData;
LPCFHOOKPROC lpfnHook;
LPCSTR lpTemplateName;
HINSTANCE hInstance;
LPSTR lpszStyle;
WORD nFontType;
WORD ___MISSING_ALIGNMENT__;
INT nSizeMin;
INT nSizeMax;
} CHOOSEFONTA;
Angehörige
lStructSize
Typ: DWORD-
Die Länge der Struktur in Byte.
hwndOwner
Typ: HWND-
Ein Handle für das Fenster, das das Dialogfeld besitzt. Dieses Element kann ein beliebiges gültiges Fensterhandle sein, oder es kann NULL- werden, wenn das Dialogfeld keinen Besitzer hat.
hDC
Typ: HDC-
Dieses Element wird von der ChooseFont--Funktion ignoriert.
Windows Vista und Windows XP/2000: Ein Handle für den Gerätekontext oder den Informationskontext des Druckers, dessen Schriftarten im Dialogfeld aufgeführt werden. Dieses Element wird nur verwendet, wenn das Flags-Element Element die CF_PRINTERFONTS oder CF_BOTH-Kennzeichnung angibt; andernfalls wird dieses Element ignoriert.
lpLogFont
Typ: LPLOGFONT
Ein Zeiger auf eine LOGFONT- Struktur. Wenn Sie das CF_INITTOLOGFONTSTRUCT Flag im Flags Member festlegen und die anderen Member initialisieren, initialisiert die ChooseFont-Funktion das Dialogfeld mit einer Schriftart, die mit den LOGFONT- Mitgliedern übereinstimmt. Wenn der Benutzer auf die Schaltfläche OK klickt, legt ChooseFont die Elemente der LOGFONT- Struktur basierend auf den Auswahlen des Benutzers fest.
iPointSize
Typ: INT-
Die Größe der ausgewählten Schriftart in Einheiten von 1/10 punkt. Die ChooseFont--Funktion legt diesen Wert fest, nachdem der Benutzer das Dialogfeld geschlossen hat.
Flags
Typ: DWORD-
Eine Reihe von Bitkennzeichnungen, mit denen Sie das Dialogfeld Schriftart initialisieren können. Wenn das Dialogfeld zurückgegeben wird, werden diese Flags festgelegt, um die Benutzereingabe anzugeben. Bei diesem Element kann es sich um einen oder mehrere der folgenden Werte handeln.
| Wert | Bedeutung |
|---|---|
|
Bewirkt, dass das Dialogfeld die Schaltfläche Anwenden anzeigt. Sie sollten eine Hook-Prozedur bereitstellen, um WM_COMMAND Nachrichten für die Schaltfläche Anwenden zu verarbeiten. Die Hook-Prozedur kann die WM_CHOOSEFONT_GETLOGFONT Nachricht an das Dialogfeld senden, um die Adresse der Struktur abzurufen, die die aktuellen Auswahlen für die Schriftart enthält. |
|
Dieses Kennzeichen ist veraltet. Verwenden Sie CF_SCRIPTSONLY, um die Schriftartauswahl auf alle Skripts zu beschränken, mit Ausnahme von Zeichensätzen, die oem- oder Symbolzeichensätze verwenden. Verwenden Sie zum Abrufen des ursprünglichen CF_ANSIONLY Verhaltens CF_SELECTSCRIPT, und geben Sie ANSI_CHARSET im lfCharSet Member der LOGFONT- Struktur an, auf die lpLogFontverweist. |
|
Dieses Kennzeichen wird für die Schriftartenaufzählung ignoriert.
Windows Vista und Windows XP/2000: Bewirkt, dass das Dialogfeld die verfügbaren Drucker- und Bildschirmschriftarten auflistet. Das hDC- Mitglied ist ein Handle für den Gerätekontext oder Den Informationskontext, der dem Drucker zugeordnet ist. Diese Kennzeichnung ist eine Kombination aus den CF_SCREENFONTS und CF_PRINTERFONTS Flags. |
|
Bewirkt, dass das Dialogfeld die Steuerelemente anzeigt, mit denen der Benutzer Durchgestrichen, Unterstrichen und Textfarbenoptionen angeben kann. Wenn dieses Kennzeichen festgelegt ist, können Sie die rgbColors Member verwenden, um die ursprüngliche Textfarbe anzugeben. Sie können die lfStrikeOut- und lfUnderline- Elemente der Struktur verwenden, auf die lpLogFont verweist, um die Anfangseinstellungen der Durchgestrichen- und Unterstreichungskontrollkästchen anzugeben. ChooseFont können diese Mitglieder verwenden, um die Auswahl des Benutzers zurückzugeben. |
|
Aktiviert die im lpfnHook Member dieser Struktur angegebene Hook-Prozedur. |
|
Gibt an, dass die hInstance und lpTemplateName- Member eine Dialogfeldvorlage angeben, die anstelle der Standardvorlage verwendet werden soll. |
|
Gibt an, dass das hInstance-element einen Datenblock identifiziert, der eine vorab geladene Dialogfeldvorlage enthält. Das System ignoriert den lpTemplateName Member, wenn dieses Flag angegeben ist. |
|
ChooseFont sollte nur Schriftarten mit fester Neigung aufzählen und zulassen. |
|
ChooseFont sollte eine Fehlerbedingung angeben, wenn der Benutzer versucht, eine Schriftart oder einen Stil auszuwählen, der nicht im Dialogfeld aufgeführt ist. |
|
ChooseFont- sollten zusätzlich Schriftarten anzeigen, die in der Systemsteuerung "Schriftarten" auf "Ausblenden" festgelegt sind. Windows Vista und Windows XP/2000: Dieses Flag wird erst unter Windows 7 unterstützt. |
|
ChooseFont- sollte die Struktur verwenden, auf die vom lpLogFont Member verwiesen wird, um die Dialogfeldsteuerelemente zu initialisieren. |
|
ChooseFont- sollte nur Schriftgrade innerhalb des bereichs auswählen, der durch die nSizeMin und nSizeMax Member angegeben ist. |
|
Identisch mit der CF_NOVECTORFONTS-Kennzeichnung. |
|
Wenn Sie eine LOGFONT- Struktur zum Initialisieren der Dialogfeldsteuerelemente verwenden, verwenden Sie dieses Kennzeichen, um zu verhindern, dass im Dialogfeld eine anfängliche Auswahl für das Kombinationsfeld für den Schriftartnamen angezeigt wird. Dies ist nützlich, wenn es keinen einzelnen Schriftartnamen gibt, der für die Textauswahl gilt. |
|
Deaktiviert das Kombinationsfeld Skript-. Wenn dieses Flag festgelegt ist, wird das lfCharSet Mitglied der LOGFONT- Struktur auf DEFAULT_CHARSET festgelegt, wenn ChooseFont zurückgegeben wird. Dieses Kennzeichen wird nur zum Initialisieren des Dialogfelds verwendet. |
|
ChooseFont- sollte die Auswahl von Schriftartsimulationen nicht anzeigen oder zulassen. |
|
Wenn Sie eine Struktur zum Initialisieren der Dialogfeldsteuerelemente verwenden, verwenden Sie dieses Kennzeichen, um zu verhindern, dass das Dialogfeld eine anfängliche Auswahl für das Kombinationsfeld Schriftgrad anzeigt. Dies ist nützlich, wenn für die Textauswahl kein einzelner Schriftgrad gilt. |
|
Wenn Sie eine LOGFONT- Struktur zum Initialisieren der Dialogfeldsteuerelemente verwenden, verwenden Sie dieses Kennzeichen, um zu verhindern, dass im Dialogfeld eine anfängliche Auswahl für das Schriftartformat Kombinationsfeld angezeigt wird. Dies ist nützlich, wenn es keinen einzelnen Schriftschnitt gibt, der für die Textauswahl gilt. |
|
ChooseFont- sollte keine Vektorschriftartenauswahl zulassen. |
|
Bewirkt, dass das Dialogfeld Schriftart nur horizontal ausgerichtete Schriftarten auflistet. |
|
Dieses Kennzeichen wird für die Schriftartenaufzählung ignoriert.
Windows Vista und Windows XP/2000: Bewirkt, dass das Dialogfeld nur die Schriftarten auflistet, die vom Drucker unterstützt werden, der dem Gerätekontext oder Dem Informationskontext zugeordnet ist, der vom hDC Mitglied identifiziert wird. Außerdem wird die Beschreibung der Schriftart am unteren Rand des Dialogfelds Schriftart angezeigt. |
|
Gibt an, dass ChooseFont- nur die Auswahl skalierbarer Schriftarten zulassen soll. Skalierbare Schriftarten umfassen Vektorschriftarten, skalierbare Druckerschriftarten, TrueType-Schriftarten und Von anderen Technologien skalierte Schriftarten. |
|
Dieses Kennzeichen wird für die Schriftartenaufzählung ignoriert.
Windows Vista und Windows XP/2000: Bewirkt, dass das Dialogfeld nur die vom System unterstützten Bildschirmschriftarten auflistet. |
|
ChooseFont- sollte die Auswahl von Schriftarten für alle Nicht-OEM- und Symbolzeichensätze sowie den ANSI-Zeichensatz zulassen. Dadurch wird der CF_ANSIONLY Wert ersetzt. |
|
Bei Angabe der Eingabe werden nur Schriftarten mit dem zeichensatz angezeigt, der im lfCharSet Member der LOGFONT- Struktur identifiziert wird. Der Benutzer darf den im Kombinationsfeld Skripts angegebenen Zeichensatzes nicht ändern. |
|
Bewirkt, dass das Dialogfeld die Schaltfläche Hilfe- anzeigt. Der hwndOwner Member muss das Fenster angeben, das das HELPMSGSTRING registrierten Nachrichten empfängt, die das Dialogfeld sendet, wenn der Benutzer auf die Schaltfläche Hilfe klickt. |
|
ChooseFont sollte nur die Auswahl von TrueType-Schriftarten aufzählen und zulassen. |
|
Das lpszStyle Member ist ein Zeiger auf einen Puffer, der Formatvorlagendaten enthält, die ChooseFont- zum Initialisieren des Schriftartformatvorlagen- Kombinationsfelds verwenden sollten. Wenn der Benutzer das Dialogfeld schließt, kopiert ChooseFont Formatvorlagendaten für die Auswahl des Benutzers in diesen Puffer.
Hinweis Um Ihre Anwendung zu globalisieren, sollten Sie die Formatvorlage mithilfe der lfWeight und lfItalic Member der LOGFONT Struktur angeben, auf die lpLogFontverweist. Der Formatvorlagenname kann sich je nach Sprache der Systembenutzeroberflächen ändern.
|
|
Obsolet.
ChooseFont dieses Flag ignoriert.
Windows Vista und Windows XP/2000: ChooseFont sollte nur die Auswahl von Schriftarten zulassen, die sowohl auf dem Drucker als auch auf dem Display verfügbar sind. Wenn diese Kennzeichnung angegeben ist, sollten auch die CF_SCREENSHOTS und CF_PRINTERFONTSoder CF_BOTH Flags angegeben werden. |
rgbColors
Typ: COLORREF-
Wenn das CF_EFFECTS Flag festgelegt ist, gibt rgbColors die ursprüngliche Textfarbe an. Wenn ChooseFont erfolgreich zurückgegeben wird, enthält dieses Element den RGB-Wert der Vom Benutzer ausgewählten Textfarbe. Verwenden Sie zum Erstellen eines COLORREF- Farbwerts das RGB- Makro.
lCustData
Typ: LPARAM-
Anwendungsdefinierte Daten, die das System an die Hook-Prozedur übergibt, die vom lpfnHook Mitglied identifiziert wird. Wenn das System die WM_INITDIALOG Nachricht an die Hook-Prozedur sendet, ist der lParam- Parameter der Nachricht ein Zeiger auf die CHOOSEFONT- Struktur, die beim Erstellen des Dialogfelds angegeben wurde. Die Hook-Prozedur kann diesen Zeiger verwenden, um den wert lCustData abzurufen.
lpfnHook
Typ: LPCFHOOKPROC-
Ein Zeiger auf eine CFHookProc Hook-Prozedur, die Nachrichten verarbeiten kann, die für das Dialogfeld vorgesehen sind. Dieses Element wird ignoriert, es sei denn, das CF_ENABLEHOOK Flag wird im Flags Mitglied festgelegt.
lpTemplateName
Typ: LPCTSTR-
Der Name der Dialogfeldvorlagenressource im Modul, das vom hInstance Member identifiziert wird. Diese Vorlage wird durch die Standarddialogfeldvorlage ersetzt. Für nummerierte Dialogfeldressourcen kann lpTemplateName- ein Wert sein, der vom MAKEINTRESOURCE Makro zurückgegeben wird. Dieses Element wird ignoriert, es sei denn, das CF_ENABLETEMPLATE Flag wird im Flags Mitglied festgelegt.
hInstance
Typ: HINSTANCE-
Wenn das CF_ENABLETEMPLATEHANDLE Flag im Flags Member festgelegt ist, ist hInstance ein Handle für ein Speicherobjekt, das eine Dialogfeldvorlage enthält. Wenn das CF_ENABLETEMPLATE Flag festgelegt ist, ist hInstance ein Handle für ein Modul, das eine Dialogfeldvorlage enthält, die vom lpTemplateName Member benannt ist. Wenn weder CF_ENABLETEMPLATEHANDLE noch CF_ENABLETEMPLATE festgelegt ist, wird dieses Element ignoriert.
lpszStyle
Typ: LPTSTR-
Die Formatvorlagendaten. Wenn das CF_USESTYLE Flag angegeben ist, verwendet ChooseFont die Daten in diesem Puffer, um das Schriftartformat Kombinationsfeld zu initialisieren. Wenn der Benutzer das Dialogfeld schließt, kopiert ChooseFont die Zeichenfolge im Kombinationsfeld Schriftartformatvorlage in diesen Puffer.
nFontType
Typ: WORD-
Der Typ der ausgewählten Schriftart, wenn ChooseFont zurückgegeben wird. Bei diesem Element kann es sich um einen oder mehrere der folgenden Werte handeln.
| Wert | Bedeutung |
|---|---|
|
Die Schriftbreite ist fett formatiert. Diese Informationen werden im lfWeight Member der LOGFONT Struktur dupliziert und entspricht FW_BOLD. |
|
Das Kursivschriftart-Attribut wird festgelegt. Diese Informationen werden im lfItalic Mitglied der LOGFONT Struktur dupliziert. |
|
Die Schriftart ist eine Druckerschriftart. |
|
Die Schriftbreite ist normal. Diese Informationen werden im lfWeight Member der LOGFONT Struktur dupliziert und entspricht FW_REGULAR. |
|
Die Schriftart ist eine Bildschirmschriftart. |
|
Die Schriftart wird von der Grafikgeräteschnittstelle (GDI) simuliert. |
___MISSING_ALIGNMENT__
nSizeMin
Typ: INT-
Die Mindestpunktgröße, die ein Benutzer auswählen kann. ChooseFont erkennt dieses Element nur, wenn das CF_LIMITSIZE Flag angegeben ist.
nSizeMax
Typ: INT-
Die maximale Punktgröße, die ein Benutzer auswählen kann. ChooseFont erkennt dieses Element nur, wenn das CF_LIMITSIZE Flag angegeben ist.
Bemerkungen
Anmerkung
Der commdlg.h-Header definiert CHOOSEFONT als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Header- | commdlg.h |
Siehe auch
allgemeine Dialogfeldbibliothek
Konzeptionelle
Referenz-