Freigeben über


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