BasicMaker und TextMaker > Objektstruktur von TextMaker

Zugriffspfade:

▪Application à Documents à Item à Selection à Font

▪Application à ActiveDocument à Selection à Font

1 Beschreibung

Das Font-Objekt beschreibt die Zeichenformatierung eines Textstücks. Es ist ein Tochterobjekt von Selection und lässt Sie alle Zeichenattribute der aktuellen Selektion lesen und setzen.

2 Zugriff auf das Objekt

Jedes geöffnete Dokument besitzt genau eine Instanz des Font-Objekts. Diese wird über Document.Selection.Font angesprochen:

' Der aktuellen Selektion die Schriftart Arial zuweisen

tm.ActiveDocument.Selection.Font.Name = "Arial"

3 Eigenschaften, Objekte, Sammlungen und Methoden

Eigenschaften:

▪Name (Defaulteigenschaft)

▪Size

▪Bold

▪Italic

▪Underline

▪StrikeThrough

▪Superscript

▪Subscript

▪AllCaps

▪SmallCaps

▪PreferredSmallCaps

▪Blink

▪Color

▪ColorIndex

▪BColor

▪BColorIndex

▪Spacing

▪Pitch

Objekte:

▪Application → Application

▪Parent → Selection

Name (Eigenschaft)

Datentyp: String

Liest oder setzt den Namen der Schriftart (als Zeichenkette).

Falls innerhalb der Selektion mehrere Schriftarten vorkommen, wird eine leere Zeichenkette zurückgeliefert.

Size (Eigenschaft)

Datentyp: Single

Liest oder setzt die Schriftgröße in Punkt (pt).

Falls innerhalb der Selektion mehrere Schriftgrößen vorkommen, wird smoUndefined (9.999.999) zurückgeliefert.

Beispiel:

' Setze die Schriftgröße des selektierten Textes auf 10,3 pt

tm.ActiveDocument.Selection.Font.Size = 10.3

Bold (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenformatierung "Fettdruck":

▪True: Fettdruck ein

▪False: Fettdruck aus

▪smoToggle (nur beim Setzen): Aktueller Zustand wird ins Gegenteil gekehrt.

▪smoUndefined (nur beim Lesen): Die Selektion ist teils fett, teils nicht.

Italic (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenformatierung "Kursivschrift":

▪True: Kursivschrift ein

▪False: Kursivschrift aus

▪smoToggle (nur beim Setzen): Aktueller Zustand wird ins Gegenteil gekehrt.

▪smoUndefined (nur beim Lesen): Die Selektion ist teils kursiv, teils nicht.

Underline (Eigenschaft)

Datentyp: Long (TmUnderline)

Liest oder setzt die Zeichenformatierung "Unterstreichen". Folgende Werte sind zulässig:

tmUnderlineNone = 0 ' aus

tmUnderlineSingle = 1 ' einfach durchgehend

tmUnderlineDouble = 2 ' doppelt durchgehend

tmUnderlineWords = 3 ' einfach wortweise

tmUnderlineWordsDouble = 4 ' doppelt wortweise

Lesen Sie die Eigenschaft aus und die Selektion ist teils unterstrichen, teils nicht, wird smoUndefined zurückgeliefert.

StrikeThrough (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenformatierung "Durchstreichen":

▪True: Durchstreichen ein

▪False: Durchstreichen aus

▪smoToggle (nur beim Setzen): Aktueller Zustand wird ins Gegenteil gekehrt.

▪smoUndefined (nur beim Lesen): Die Selektion ist teils durchgestrichen, teils nicht.

Superscript (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenformatierung "Hochstellen":

▪True: Hochstellen ein

▪False: Hochstellen aus

▪smoToggle (nur beim Setzen): Aktueller Zustand wird ins Gegenteil gekehrt.

▪smoUndefined (nur beim Lesen): Die Selektion ist teils hochgestellt, teils nicht.

Subscript (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenformatierung "Tiefstellen":

▪True: Tiefstellen ein

▪False: Tiefstellen aus

▪smoToggle (nur beim Setzen): Aktueller Zustand wird ins Gegenteil gekehrt.

▪smoUndefined (nur beim Lesen): Die Selektion ist teils tiefgestellt, teils nicht.

AllCaps (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenformatierung "Großbuchstaben":

▪True: Großbuchstaben ein

▪False: Großbuchstaben aus

▪smoToggle (nur beim Setzen): Aktueller Zustand wird ins Gegenteil gekehrt.

▪smoUndefined (nur beim Lesen): Das Attribut ist bei einem Teil der Selektion gesetzt, bei einem anderen Teil nicht.

SmallCaps (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenformatierung "Kapitälchen":

▪True: Kapitälchen ein

▪False: Kapitälchen aus

▪smoToggle (nur beim Setzen): Aktueller Zustand wird ins Gegenteil gekehrt.

▪smoUndefined (nur beim Lesen): Die Selektion ist teils in Kapitälchen, teils nicht.

PreferredSmallCaps (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenformatierung "Kapitälchen", lässt Sie aber im Gegensatz zur Eigenschaft SmallCaps den Skalierungsfaktor frei wählen. Der Wert 0 bedeutet "keine Kapitälchen", alle anderen Werte stellen den prozentualen Skalierungsfaktor der Kapitälchen dar.

Beispiel:

' Den selektierten Text als Kapitälchen mit 75% Größe formatieren

tm.ActiveDocument.Selection.Font.PreferredSmallCaps = 75

' Die Kapitälchen wieder ausschalten

tm.ActiveDocument.Selection.Font.PreferredSmallCaps = 0

Blink (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenformatierung "Blinkend" (obsolet):

▪True: Blinken ein

▪False: Blinken aus

▪smoToggle (nur beim Setzen): Aktueller Zustand wird ins Gegenteil gekehrt.

▪smoUndefined (nur beim Lesen): Die Selektion ist teils blinkend, teils nicht.

Color (Eigenschaft)

Datentyp: Long (SmoColor)

Liest oder setzt die Vordergrundfarbe der Schrift als "BGR"-Wert (Blau-Grün-Rot-Triplet). Sie können entweder einen beliebigen Wert angeben oder eine der vordefinierten BGR-Farbkonstanten verwenden.

Ist die Selektion in unterschiedlichen Farben formatiert, wird beim Auslesen smoUndefined zurückgeliefert.

ColorIndex (Eigenschaft)

Datentyp: Long (SmoColorIndex)

Liest oder setzt die Vordergrundfarbe der Schrift als Indexfarbe. "Indexfarben" sind die 16 Standardfarben von TextMaker, durchnummeriert von 0 für Schwarz bis 15 für Hellgrau. Sie dürfen ausschließlich die in der Tabelle der Indexfarben genannten Werte verwenden.

Ist die Selektion in unterschiedlichen Farben oder in einer anderen als einer der Indexfarben formatiert, wird beim Auslesen smoUndefined zurückgeliefert.

Hinweis: Wir empfehlen, stattdessen die Eigenschaft Color (siehe dort) zu verwenden, da Sie mit dieser nicht auf die 16 Standardfarben beschränkt sind, sondern mit beliebigen Farben der BGR-Palette arbeiten können.

BColor (Eigenschaft)

Datentyp: Long (SmoColor)

Liest oder setzt die Hintergrundfarbe der Schrift als "BGR"-Wert (Blau-Grün-Rot-Triplet). Sie können entweder einen beliebigen Wert angeben oder eine der vordefinierten BGR-Farbkonstanten verwenden

Lesen Sie die Eigenschaft aus und die Selektion ist in unterschiedlichen Farben formatiert, wird smoUndefined zurückgeliefert.

BColorIndex (Eigenschaft)

Datentyp: Long (SmoColorIndex)

Liest oder setzt die Hintergrundfarbe der Schrift als Indexfarbe. "Indexfarben" sind die Standardfarben von TextMaker, durchnummeriert von -1 für Transparent bis 15 für Hellgrau. Sie dürfen ausschließlich die in der Tabelle der Indexfarben genannten Werte verwenden.

Ist die Selektion in unterschiedlichen Farben oder in einer anderen als einer der Indexfarben formatiert, wird beim Auslesen smoUndefined zurückgeliefert.

Hinweis: Wir empfehlen, stattdessen die Eigenschaft BColor (siehe dort) zu verwenden, da Sie mit dieser nicht auf diese Standardfarben beschränkt sind, sondern beliebige Farben der BGR-Palette wählen können.

Spacing (Eigenschaft)

Datentyp: Long

Liest oder setzt den Zeichenabstand. Der Standardwert ist 100 für einen normalen (100%) Zeichenabstand.

Lesen Sie die Eigenschaft aus und die Selektion ist in unterschiedlichen Zeichenabständen formatiert, wird smoUndefined zurückgeliefert.

Pitch (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenbreite. Der Standardwert ist 100 für normalbreite (100%) Zeichen.

Lesen Sie die Eigenschaft aus und die Selektion ist in unterschiedlichen Zeichenbreiten formatiert, wird smoUndefined zurückgeliefert.

Beachten Sie bitte, dass manche Drucker die Änderung der Zeichenbreite bei druckerinternen Schriften ignorieren.

Application (Zeiger auf Objekt)

Datentyp: Object

Liefert das Application-Objekt.

Parent (Zeiger auf Objekt)

Datentyp: Object

Liefert das übergeordnete Objekt, also ein Objekt vom Typ Document.

Font (Objekt)

Font (Objekt)