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