CHOOSEFONT

Die CHOOSEFONT -Struktur enthält Informationen, die die ChooseFont -Funktion verwendet, um das Standarddialogfeld Schriftart zu initialisieren. Nachdem der Benutzer das Dialogfeld geschlossen wurde, gibt das System Informationen über die Auswahl des Benutzers in dieser Struktur.

typedef Struct {/ / Cf DWORD lStructSize; 
    HWND HwndOwner; 
    HDC hDC; 
    LPLOGFONT LpLogFont; 
    INT iPointSize; 
    DWORD Flags; 
    DWORD RgbColors; 
    LPARAM lCustData; 
    LPCFHOOKPROC LpfnHook; 
    LPCTSTR LpTemplateName; 
    HINSTANCE hInstance; 
    LPTSTR LpszStyle; 
    WORD nFontType; 
    WORT ___MISSING_ALIGNMENT__; 
    INT nSizeMin; 
    INT nSizeMax; 
} CHOOSEFONT 

 

Mitglieder

lStructSize

Gibt die Länge in Bytes, der Struktur.

hwndOwner

Identifiziert das Fenster, das das Dialogfeld besitzt. Dieser Member kann gültiges Fensterhandle, oder es kann NULL sein, wenn das Dialogfeld keine Besitzer hat.

hDC

Identifiziert den Gerätekontext (oder Informationskontext) des Druckers dessen Schriftarten im Dialogfeld aufgeführt werden. Dieser Member wird verwendet, nur wenn das Flags -Mitglied der CF_PRINTERFONTS oder CF_BOTH-Flag gibt an; Andernfalls wird dieses Element ignoriert.

lpLogFont

Zeiger auf eine LOGFONT -Struktur. Wenn Sie das CF_INITTOLOGFONTSTRUCT-Flag in den Flags festgelegt und die LOGFONT -Member zu initialisieren, initialisiert die ChooseFont -Funktion im Dialogfeld mit eine Schriftart, die die ähnlichste Entsprechung möglich ist. Wenn der Benutzer die Schaltfläche OK klickt, legt ChooseFont als Mitglied die LOGFONT -Struktur basierend auf der Benutzerauswahl.

iPointSize

Gibt die Größe der ausgewählten Schriftart, in Einheiten von 1/10 eines Punktes. Die ChooseFont -Funktion legt diesen Wert fest, nachdem der Benutzer das Dialogfeld schließt.

Flaggen

Ein Satz von Bitflags, die Sie verwenden können, um das Standarddialogfeld Schriftart zu initialisieren. Wenn das Dialogfeld zurückgegeben wird, legt diese Flags an die Eingabe des Benutzers fest. Dieser Member kann eine Kombination der folgenden Flags sein:

Flagge	Bedeutung
CF_APPLY	Bewirkt, dass das Dialogfeld die Schaltfläche Übernehmen angezeigt. Sie sollten eine Hookprozedur WM_COMMAND Nachrichten für die übernehmen-Schaltfläche bereitstellen. Die Hook-Prozedur kann die WM_CHOOSEFONT_GETLOGFONT -Nachricht senden, im Dialogfeld Abrufen die Adresse der LOGFONT -Struktur, die die aktuellen Einstellungen für die Schriftart enthält.
CF_ANSIONLY	Dieses Flag ist veraltet. Um Schriftart Auswahl alle Skripts außer diejenigen beschränken, die der OEM oder Symbol Zeichensätze verwenden, verwenden Sie CF_SCRIPTSONLY. Um Windows 3.1 CF_ANSIONLY Verhalten zu erhalten, verwenden Sie CF_SELECTSCRIPT, und geben Sie ANSI_CHARSET im LfCharSet Mitglied die LOGFONT -Struktur, auf die lpLogFont.
CF_BOTH	Bewirkt, dass das Dialogfeld in der Liste der verfügbaren Drucker und Bildschirm-Schriften. Der hDC -Member gibt das Gerät Kontext (bzw. Informationskontext) dem Drucker zugeordnet. Dieses Flag ist eine Kombination der Flags CF_SCREENFONTS und CF_PRINTERFONTS.
CF_TTONLY	Gibt an, dass ChooseFont sollte nur aufzählen und die Auswahl von TrueType-Schriftarten erlauben.
CF_EFFECTS	Bewirkt, dass das Dialogfeld die Steuerelemente anzuzeigen, die dem Benutzer ermöglichen, durchgestrichen, unterstrichen und Farboptionen für Text angeben. Wenn dieses Flag festgelegt ist, können Sie das RgbColors -Mitglied die ersten Textfarbe angeben. Können Sie die LfStrikeOut und LfUnderline Mitglieder der LpLogFont an die ursprünglichen Einstellungen das Kontrollkästchen Durchgestrichen und unterstrichen auf die LOGFONT -Struktur. ChooseFont können diese Member verwenden, um die Benutzerauswahl zurückgegeben.
CF_ENABLEHOOK	Ermöglicht die Hook-Prozedur in der LpfnHook -Member der Struktur angegebenen.
CF_ENABLETEMPLATE	Gibt an, dass die hInstance und LpTemplateName Member geben eine Dialogfeld Feld Vorlage statt der Standardvorlage verwenden.
CF_ENABLETEMPLATEHANDLE	Gibt an, dass das hInstance Mitglied ein Datenblockes identifiziert, das eine vorgespannte Dialogfeld Feld Vorlage enthält. Das System ignoriert den LpTemplateName Member, wenn dieses Flag angegeben ist.
CF_FIXEDPITCHONLY	Gibt an, dass ChooseFont nur fixed-Pitch-Schriftarten auswählen sollte.
CF_FORCEFONTEXIST	Gibt an, dass ChooseFont eine Fehlerbedingung anzugeben, wenn der Benutzer versucht, wählen eine Schriftart oder das Format, das nicht existiert.
CF_INITTOLOGFONTSTRUCT	Gibt an, dass ChooseFont verwenden, sollten die LOGFONT -Struktur, auf die das LpLogFont -Element, um die Dialogfeld-Steuerelemente zu initialisieren.
CF_LIMITSIZE	Gibt an, dass ChooseFont nur Schriftgrößen innerhalb des Bereichs angegeben durch die nSizeMin und nSizeMax Mitglieder wählen sollten.
CF_NOOEMFONTS	Dasselbe wie das CF_NOVECTORFONTS-flag.
CF_NOFACESEL	Wenn eine LOGFONT -Struktur verwenden, um die Dialogfeld-Steuerelemente zu initialisieren, verwenden Sie das Flag selektiv das Dialogfeld verhindern eine erste Auswahl für das Kombinationsfeld Schriftart-Namen anzeigt. Dies ist nützlich, wenn es ist kein einziger Font-Name, für die die Textauswahl gilt.
CF_NOSCRIPTSEL	Im Kombinationsfeld Skript deaktiviert. Wenn dieses Flag festgelegt ist, das LfCharSet Mitglied der LOGFONT -Struktur auf DEFAULT_CHARSET festgelegt ist, wenn ChooseFont zurückgibt. Dieses Flag wird verwendet, nur, um das Dialogfeld zu initialisieren.
CF_NOSTYLESEL	Wenn eine LOGFONT -Struktur verwenden, um die Dialogfeld-Steuerelemente zu initialisieren, verwenden Sie das Flag selektiv verhindern im Dialogfeld anzeigt eine erste Auswahl für das Kombinationsfeld Schriftart-Stil. Dies ist nützlich, wenn es gibt keine einzelne Schriftschnitt, für die gilt die Textauswahl.
CF_NOSIZESEL	Bei Verwendung einer LOGFONT -Struktur initialisieren die Dialogfeld-Steuerelemente, verwenden Sie das Flag selektiv das Dialogfeld verhindern eine erste Auswahl für das Kombinationsfeld Schriftart Größe anzeigt. Dies ist nützlich, wenn es gibt keine einzige Schriftgröße, die auf den markierten Text angewendet wird.
CF_NOSIMULATIONS	Gibt an, dass ChooseFont nicht Grafiken Gerät Interface (GDI) Schriftartsimulationen lassen sollten.
CF_NOVECTORFONTS	Gibt an, dass ChooseFont nicht Vektor Schriftart Auswahl lassen sollten.
CF_NOVERTFONTS	Bewirkt, dass das Dialogfeld Schriftart nur waagrecht ausgerichtete Schriftarten auflisten.
CF_PRINTERFONTS	Das Dialogfeld Liste nur die Schriftarten, unterstützt durch den Drucker-Gerätekontext (oder Informationskontext) zugeordnet identifiziert durch den hDC -member.
CF_SCALABLEONLY	Gibt an, dass ChooseFont nur die Auswahl von skalierbaren Schriftarten ermöglichen soll. (Skalierbare Fonts enthalten Vektorschriftarten, skalierbare Druckerschriftarten TrueType-Schriftarten und Fonts durch andere Technologien skaliert.)
CF_SCREENFONTS	Das Dialogfeld nur die vom System unterstützten Bildschirmschriftarten aufgelistet.
CF_SCRIPTSONLY	Gibt an, dass ChooseFont Auswahl von Schriftarten für alle nicht-OEM und Symbolzeichensätze legt, sowie den ANSI-Zeichensatz erlauben sollte. Dies ersetzt den CF_ANSIONLY-Wert.
CF_SELECTSCRIPT	Wenn bei der Eingabe angegeben, nur Schriftarten mit dem Zeichensatz im LfCharSet Member identifiziert die LOGFONT -Struktur angezeigt werden. Der Benutzer dürfen keine Skripte im Kombinationsfeld angegebenen Zeichensatz ändern.
CF_SHOWHELP	Bewirkt, dass das Dialogfeld die Schaltfläche Hilfe anzeigen. Das HwndOwner -Mitglied muss angeben, dass das Fenster die HELPMSGSTRING empfangen Nachrichten registriert, die im Dialogfeld sendet, wenn der Benutzer die Schaltfläche Hilfe klickt.
CF_USESTYLE	Gibt an, dass der LpszStyle Mitglied zeigt auf einen Puffer, der Daten enthält, dass ChooseFont verwenden sollten, um das Kombinationsfeld Stil zu initialisieren. Wenn der Benutzer das Dialogfeld schließt, Stil ChooseFont Kopien Daten für die Benutzerauswahl in diesen Puffer .
CF_WYSIWYG	Gibt an, dass ChooseFont nur die Auswahl von Schriftarten auf den Drucker und Display ermöglichen soll. Wenn dieses Flag angegeben ist, sollten die Flags CF_BOTH und CF_SCALABLEONLY ebenfalls angegeben werden.

rgbColors

Wenn das CF_EFFECTS-Flag festgelegt ist, gibt RgbColors die erste Textfarbe. Wenn ChooseFont erfolgreich zurückgegeben wird, enthält dieser Member den RGB-Wert der Textfarbe vom Benutzer ausgewählten.

lCustData

Gibt anwendungsdefinierten Daten, die das System an die Hook-Prozedur durch das LpfnHook -Element identifiziert wird. Sendet das System die WM_INITDIALOG -Meldung an die Hook-Prozedur, ist die Nachricht lParam -Parameter ein Zeiger auf die Struktur CHOOSEFONT angegeben, wenn das Dialogfeld erstellt wurde. Die Hook-Prozedur können diesen Zeiger zum Abrufen des Werts lCustData.

lpfnHook

Zeiger auf ein CFHookProc Haken Verfahren, die Nachrichten für das Dialogfeld verarbeiten kann. Dieser Member wird ignoriert, es sei denn, das CF_ENABLEHOOK-Flag in den Flags gesetzt ist.

lpTemplateName

Zeiger auf eine auf Null endende Zeichenfolge, die Vorlage die Dialogfeldressource im Modul identifiziert das hInstance -Mitglied benennt. Diese Vorlage ist für das standard-Dialogfeld Feld Vorlage ersetzt. Für nummerierte Dialogfeld Feld Ressourcen können LpTemplateName einen Wert des Makros MAKEINTRESOURCE zurückgegeben werden. Dieser Member wird ignoriert, es sei denn, das CF_ENABLETEMPLATE-Flag in den Flags gesetzt ist.

hInstance

Wenn das CF_ENABLETEMPLATEHANDLE-Flag in den Flags festgelegt ist, ist hInstance das Handle für ein Objekt mit eine Dialogfeldvorlage. Wenn das CF_ENABLETEMPLATE-Flag festgelegt ist, identifiziert hInstance ein Modul, das eine Dialogfeld Feld Vorlage mit dem Namen des Mitglieds LpTemplateName enthält. Wenn weder CF_ENABLETEMPLATEHANDLE noch CF_ENABLETEMPLATE festgelegt ist, wird dieses Element ignoriert.

lpszStyle

Zeiger auf einen Puffer, der Daten enthält. Wenn das CF_USESTYLE-Flag angegeben ist, verwendet ChooseFont die Daten in diesen Puffer initialisieren im Kombinationsfeld Schriftart-Stil. Wenn der Benutzer das Dialogfeld schließt, kopiert ChooseFont die Zeichenfolge in das Kombinationsfeld Schriftart-Stil in diesen Puffer.

nFontType

Gibt den Typ der ausgewählten Schriftart ChooseFont gibt. Dieses Mitglied kann eine Kombination der folgenden Werte sein.:

Wert	Bedeutung
BOLD_FONTTYPE	Die Schriftbreite ist Fett. Diese Informationen wird dupliziert im LfWeight Mitglied der LOGFONT -Struktur und ist äquivalent zu FW_BOLD.
ITALIC_FONTTYPE	Das kursiv-Attribut festgelegt ist. Diese Information wird im LfItalic Mitglied die LOGFONT -Struktur dupliziert.
PRINTER_FONTTYPE	Die Schriftart ist eine Druckerschriftart.
REGULAR_FONTTYPE	Die Schriftbreite ist normal. Diese Informationen wird dupliziert im LfWeight Mitglied die LOGFONT -Struktur und ist äquivalent zu FW_REGULAR.
SCREEN_FONTTYPE	Die Schriftart ist eine Bildschirmschriftart.
SIMULATED_FONTTYPE	Die Schriftart wird durch die Graphics Device Interface (GDI) simuliert.

nSizeMin

Gibt die minimale Größe, die ein Benutzer auswählen kann. ChooseFont erkennt das Mitglied nur dann, wenn das CF_LIMITSIZE-Flag angegeben ist.

nSizeMax

Gibt die maximale Größe, die ein Benutzer auswählen kann. ChooseFont erkennt das Mitglied nur dann, wenn das CF_LIMITSIZE-Flag angegeben ist.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.
Header:In commdlg.h deklariert.
Unicode:Als Unicode und ANSI Strukturen definiert.

Siehe auch

Übersicht über Common Dialog Box Library, gemeinsamen Dialog Box Strukturen, ChooseFont, LOGFONT, MAKEINTRESOURCE

Index