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