IFont-Schnittstelle (ocidl.h)

Stellt einen Wrapper um ein Windows-Schriftartobjekt bereit. Das COM-Schriftartobjekt unterstützt eine Reihe von Lese-/Schreibeigenschaften sowie eine Reihe von Methoden über die IFont-Schnittstelle . Es unterstützt den gleichen Satz von Eigenschaften (aber nicht die Methoden) über die Dispatch-Schnittstelle IFontDisp, die von IDispatch abgeleitet wird, um den Zugriff auf die Eigenschaften der Schriftart über Automation zu ermöglichen. Das System bietet eine Standardimplementierung des Schriftartobjekts mit beiden Schnittstellen.

Das Schriftartobjekt unterstützt auch die ausgehende Schnittstelle IPropertyNotifySink , sodass ein Client bestimmen kann, wann sich die Schriftarteigenschaften ändern. Da das Schriftartobjekt mindestens eine ausgehende Schnittstelle unterstützt, implementiert es zu diesem Zweck auch IConnectionPointContainer und zugehörige Schnittstellen.

Das Font-Objekt stellt eine hFont-Eigenschaft bereit, bei der es sich um ein Windows-Schriftarthandle handelt, das den anderen für die Schriftart angegebenen Attributen entspricht. Das Schriftartobjekt verzögert die Realisierung dieses hFont-Objekts nach Möglichkeit, sodass das aufeinander folgende Festlegen von zwei Eigenschaften für eine Schriftart nicht dazu führt, dass eine Zwischenschriftart realisiert wird. Darüber hinaus verwaltet das vom System implementierte Schriftartobjekt als Optimierung einen Cache mit Schriftarthandles. Zwei Schriftartobjekte im selben Prozess, die über identische Eigenschaften verfügen, geben das gleiche Schriftarthandle zurück. Das Schriftartobjekt kann Schriftarthandles aus diesem Cache nach Bewilligen entfernen, was besondere Überlegungen für Clients einführt, die die hFont-Eigenschaft verwenden.

Das Schriftartobjekt unterstützt auch IPersistStream, sodass es sich aus einer instance von IStream speichern und laden kann. Ein Objekt, das intern ein Schriftartobjekt verwendet, würde normalerweise die Schriftart im Rahmen der eigenen Persistenzbehandlung des Objekts speichern und laden.

Darüber hinaus unterstützt das Schriftartobjekt IDataObject, das einen Eigenschaftssatz rendern kann, der die Attribute der Schriftart enthält, sodass ein Client diese Eigenschaften als Text speichern kann.

Vererbung

Die IFont-Schnittstelle erbt von der IUnknown-Schnittstelle . IFont verfügt auch über folgende Arten von Membern:

Methoden

Die IFont-Schnittstelle verfügt über diese Methoden.

IFont::AddRefHfont Benachrichtigt das Schriftartobjekt, dass die zuvor realisierte Schriftart, die mit hFont identifiziert wurde, gültig bleiben soll, bis ReleaseHfont aufgerufen wird oder das Schriftobjekt selbst vollständig freigegeben wird.
IFont::Clone Erstellt ein dupliziertes Schriftartobjekt.
IFont::get_Bold Ruft die aktuelle Bold-Eigenschaft der Schriftart ab.
IFont::get_Charset Ruft den Zeichensatz ab, der in der Schriftart verwendet wird.
IFont::get_hFont Ruft ein Handle für die Schriftart ab, die von diesem Schriftartobjekt beschrieben wird.
IFont::get_Italic Ruft die aktuelle italische Eigenschaft der Schriftart ab.
IFont::get_Name Ruft den Namen der Schriftfamilie ab.
IFont::get_Size Ruft die Punktgröße der Schriftart ab.
IFont::get_Strikethrough Ruft die aktuelle Strikethrough-Eigenschaft der Schriftart ab.
IFont::get_Underline Ruft die aktuelle Underline-Eigenschaft der Schriftart ab.
IFont::get_Weight Ruft die aktuelle Weight-Eigenschaft der Schriftart ab.
IFont::IsEqual Vergleicht dieses Schriftartobjekt auf Äquivalenz mit einem anderen.
IFont::p ut_Bold Legt die Bold-Eigenschaft der Schriftart fest.
IFont::p ut_Charset Legt den Zeichensatz der Schriftart fest.
IFont::p ut_Italic Legt die italische Eigenschaft der Schriftart fest.
IFont::p ut_Name Gibt einen neuen Namen für die Schriftfamilie an.
IFont::p ut_Size Legt die Punktgröße der Schriftart fest.
IFont::p ut_Strikethrough Legt die Strikethrough-Eigenschaft der Schriftart fest.
IFont::p ut_Unterstrichen Legt die Underline-Eigenschaft der Schriftart fest.
IFont::p ut_Weight Legt die Weight-Eigenschaft der Schriftart fest.
IFont::QueryTextMetrics Füllt eine vom Aufrufer zugewiesene Struktur mit Informationen zur Schriftart.
IFont::ReleaseHfont Benachrichtigt das Schriftartobjekt, dass der Aufrufer, der diese Schriftart zuvor mit IFont::AddRefHfont im Cache gesperrt hat, die Sperre nicht mehr benötigt.
IFont::SetHdc Stellt einen Gerätekontext für die Schriftart bereit, die den logischen Zuordnungsmodus beschreibt.
IFont::SetRatio Konvertiert den Skalierungsfaktor für diese Schriftart zwischen logischen Einheiten und HIMETRIC-Einheiten.

Hinweise

Jede Eigenschaft in der IFont-Schnittstelle enthält eine get_PropertyName-Methode , wenn die Eigenschaft Lesezugriff unterstützt, und eine put_PropertyName-Methode , wenn die Eigenschaft schreibzugriff unterstützt. Die meisten dieser Eigenschaften unterstützen sowohl Lese- als auch Schreibzugriff.

Eigenschaft	Typ	Lesezugriffsmethode	Schreibzugriffsmethode	BESCHREIBUNG
Name	BSTR	get_Name	put_Name	Der Gesichtsname der Schriftart, z. B. Arial.
Größe	CY	get_Size	put_Size	Die Punktgröße der Schriftart, ausgedrückt in einem CY-Typ , um Bruchpunktgrößen zu ermöglichen.
Fett	BOOL	get_Bold	put_Bold	Gibt an, ob die Schriftart fett formatiert ist.
Kursiv	BOOL	get_Italic	put_Italic	Gibt an, ob die Schriftart kursiv ist.
Unterstreichen	BOOL	get_Underline	put_Underline	Gibt an, ob die Schriftart unterstrichen ist.
Durchgestrichen	BOOL	get_Strikethrough	put_Strikethrough	Gibt an, ob die Schriftart durchgestrichen ist.
Weight	short	get_Weight	put_Weight	Die Fettschrift der Schriftart.
Charset	short	get_Charset	put_Charset	Der in der Schriftart verwendete Zeichensatz, z. B. ANSI_CHARSET, DEFAULT_CHARSET oder SYMBOL_CHARSET.
hFont	HFONT	get_hFont		Das Windows-Schriftarthandle, das zum Rendern in einem Gerätekontext ausgewählt werden kann.

 

OLE-Implementierung

Das System bietet eine Standardimplementierung eines Schriftartobjekts mit der IFont-Schnittstelle auf der zugrunde liegenden Systemschriftartunterstützung. Ein Schriftartobjekt wird über die Funktion OleCreateFontIndirect erstellt. Ein Schriftartobjekt unterstützt eine Reihe von Lese-/Schreibeigenschaften sowie eine Reihe von Methoden über seine IFont-Schnittstelle und unterstützt denselben Satz von Eigenschaften (aber nicht die Methoden) über eine Dispatch-Schnittstelle IFontDisp , die von IDispatch abgeleitet wird, um den Zugriff auf die Eigenschaften der Schriftart über Automation zu ermöglichen. Die Systemimplementierung des Schriftartobjekts stellt beide Schnittstellen bereit.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	ocidl.h

Weitere Informationen

IFontDisp