ITextFont-Schnittstelle (tom.h)

Auf die Rich-Textbereichsattribute (Text Object Model, TOM) wird über ein Paar von dualen Schnittstellen zugegriffen: ITextFont und ITextPara.

Vererbung

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

Methoden

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

ITextFont::CanChange Bestimmt, ob die Schriftart geändert werden kann.
ITextFont::GetAllCaps Ruft ab, ob die Zeichen alle Großbuchstaben sind.
ITextFont::GetAnimation Ruft den Animationstyp ab.
ITextFont::GetBackColor Ruft die Farbe des Texthintergrunds (Hervorhebung) ab.
ITextFont::GetBold Ruft ab, ob die Zeichen fett formatiert sind.
ITextFont::GetDuplicate Ruft ein Duplikat dieses Textschriftartobjekts ab.
ITextFont::GetEmboss Ruft ab, ob Zeichen geprägt sind.
ITextFont::GetEngrave Ruft ab, ob Zeichen als beschriftete Zeichen angezeigt werden.
ITextFont::GetForeColor Ruft die Vordergrund- oder Textfarbe ab.
ITextFont::GetHidden Ruft ab, ob Zeichen ausgeblendet sind.
ITextFont::GetItalic Ruft ab, ob Zeichen kursiv sind.
ITextFont::GetKerning Ruft den minimalen Schriftgrad ab, bei dem kerning erfolgt.
ITextFont::GetLanguageID Ruft die Sprach-ID oder den Sprachcodebezeichner (Language Code Identifier, LCID) ab.
ITextFont::GetName Ruft den Namen der Schriftart ab.
ITextFont::GetOutline Ruft ab, ob Zeichen als umrissene Zeichen angezeigt werden.
ITextFont::GetPosition Ruft den Wert ab, in dem Zeichen vertikal relativ zur Baseline versetzt werden.
ITextFont::GetProtected Ruft ab, ob Zeichen vor Änderungsversuchen geschützt sind.
ITextFont::GetShadow Ruft ab, ob Zeichen als schattierte Zeichen angezeigt werden.
ITextFont::GetSize Ruft den Schriftgrad ab. (ITextFont.GetSize)
ITextFont::GetSmallCaps Ruft ab, ob Zeichen in kleinen Großbuchstaben enthalten sind.
ITextFont::GetSpacing Ruft den horizontalen Abstand zwischen Zeichen ab.
ITextFont::GetStrikeThrough Ruft ab, ob Zeichen mit einer horizontalen Linie durch die Mitte angezeigt werden.
ITextFont::GetStyle Ruft das Zeichenformathandle der Zeichen in einem Bereich ab.
ITextFont::GetSubscript Ruft ab, ob Zeichen als tiefgestellt angezeigt werden.
ITextFont::GetSuperscript Ruft ab, ob Zeichen als hochgestellt angezeigt werden.
ITextFont::GetUnderline Ruft den Typ der Unterstreichung für die Zeichen in einem Bereich ab.
ITextFont::GetWeight Ruft die Schriftstärke für die Zeichen in einem Bereich ab.
ITextFont::IsEqual Bestimmt, ob dieses Textschriftartobjekt über die gleichen Eigenschaften wie das angegebene Textschriftartobjekt verfügt. (ITextFont.IsEqual)
ITextFont::Reset Setzt die Zeichenformatierung auf die angegebenen Werte zurück.
ITextFont::SetAllCaps Legt fest, ob die Zeichen alle Großbuchstaben sind.
ITextFont::SetAnimation Legt den Animationstyp fest.
ITextFont::SetBackColor Legt die Hintergrundfarbe fest.
ITextFont::SetBold Legt fest, ob Zeichen fett formatiert sind.
ITextFont::SetDuplicate Legt die Zeichenformatierung durch Kopieren eines anderen Textschriftartobjekts fest.
ITextFont::SetEmboss Legt fest, ob Zeichen geprägt werden.
ITextFont::SetEngrave Legt fest, ob Zeichen als beschriftete Zeichen angezeigt werden.
ITextFont::SetForeColor Legt die Vordergrundfarbe (Text) fest.
ITextFont::SetHidden Legt fest, ob Zeichen ausgeblendet werden.
ITextFont::SetItalic Legt fest, ob Zeichen kursiv sind.
ITextFont::SetKerning Legt den minimalen Schriftgrad fest, bei dem kerning erfolgt.
ITextFont::SetLanguageID Legt die Sprach-ID oder den Sprachcodebezeichner (Language Code Identifier, LCID) fest.
ITextFont::SetName Legt den Namen der Schriftart fest.
ITextFont::SetOutline Legt fest, ob Zeichen als umrissene Zeichen angezeigt werden.
ITextFont::SetPosition Legt den Wert fest, in dem Zeichen vertikal relativ zur Baseline versetzt werden.
ITextFont::SetProtected Legt fest, ob Zeichen vor Änderungsversuchen geschützt sind.
ITextFont::SetShadow Legt fest, ob Zeichen als Schattenzeichen angezeigt werden.
ITextFont::SetSize Legt den Schriftgrad fest.
ITextFont::SetSmallCaps Legt fest, ob Zeichen in kleinen Großbuchstaben enthalten sind.
ITextFont::SetSpacing Legt den horizontalen Abstand zwischen Zeichen fest.
ITextFont::SetStrikeThrough Legt fest, ob Zeichen mit einer horizontalen Linie durch die Mitte angezeigt werden.
ITextFont::SetStyle Legt das Zeichenformathandle der Zeichen in einem Bereich fest.
ITextFont::SetSubscript Legt fest, ob Zeichen als Tiefgestellt angezeigt werden.
ITextFont::SetSuperscript Legt fest, ob Zeichen als hochgestellt angezeigt werden.
ITextFont::SetUnderline Legt den Typ der Unterstreichung für die Zeichen in einem Bereich fest.
ITextFont::SetWeight Legt die Schriftstärke für die Zeichen in einem Bereich fest.

Hinweise

Die Schnittstellen ITextFont und ITextPara kapseln die Funktionalität der Dialogfelder Microsoft Word Format Font bzw. Absatz. Beide Schnittstellen enthalten eine doppelte Eigenschaft (Value), die ein Duplikat der Attribute in einem Bereichsobjekt zurückgeben oder einen Satz von Attributen in einen Bereich übertragen kann. Daher wirken sie wie programmierbare Formatmaler. Sie könnten beispielsweise alle Attribute aus dem Bereich r1 in den Bereich r2 übertragen, mit Ausnahme von r2 fett und der Schriftgrad 12 Punkte, indem Sie die folgende Unterroutine verwenden.

Sub AttributeCopy(r1 As ITextRange, r2 As ITextRange)
    Dim tf As ITextFont
    tf = r1.Font                ' Value is the default property    
    tf.Bold = tomTrue           ' You can make some modifications
    tf.Size = 12
    tf.Animation = tomSparkleText
    r2.Font = tf                ' Apply font attributes all at once
End Sub

Ein ähnliches Beispiel, das in C++ geschrieben wurde, finden Sie unter SetFont .

Die ITextFont-Attributschnittstelle stellt die herkömmliche Microsoft Visual Basic for Applications (VBA)-Methode zum Festlegen von Eigenschaften dar und gibt die gewünschte VBA-Notation an.

ITextFont verwendet den Typ "tomBool" für Rich-Text-Attribute, die binäre Zustände aufweisen. Weitere Informationen finden Sie unter Der TomBool-Typ.

Das Rich-Edit-Steuerelement kann alle intakten ITextFont-Eigenschaften akzeptieren und zurückgeben, d. h. ohne Änderungen, sowohl über TOM als auch über die RTF-Konverter (Rich Text Format). Die Schriftarteigenschaften "Alle Caps", "Animation", "Embossed", "Imprint", "Shadow", "Small Caps", "Hidden", "Kerning", "Outline" und "Style" können jedoch nicht angezeigt werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tom.h

Siehe auch

Konzept

Textobjektmodell

Verwenden des Textobjektmodells