BasicMaker und PlanMaker > Objektstruktur von PlanMaker

Zugriffspfade:

▪Application à Workbooks à Item à Sheets à Item à Range à Font

▪Application à Workbooks à ActiveSheet à Range à Font

▪Application à ActiveWorkbook à ActiveSheet à Range à Font

▪Application à ActiveSheet à Range à Font

Statt "Range" können Sie auch alle anderen Objekte und Eigenschaften angeben, die ein Range-Objekt zurückgeben: ActiveCell, Selection, Rows(n), Columns(n) und Cells(x, y). Beispiele für diese Zugriffspfade finden Sie beim Range-Objekt.

1 Beschreibung

Das Font-Objekt beschreibt die Zeichenformatierung (Schriftart, Textfarbe, Unterstreichen etc.) von Zellen.

2 Zugriff auf das Objekt

Das Font-Objekt ist ein Tochterobjekt eines Range-Objekts und repräsentiert die Zeichenformatierung der Zellen in diesem Bereich, entsprechend dem Dialogfenster für die Zeichenformatierung.

Beispiel:

' Schrift von Zelle A1 anzeigen

MsgBox pm.ActiveSheet.Range("A1").Font.Name

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 → Range

Name (Eigenschaft)

Datentyp: String

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

Falls innerhalb der Zellen 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 Zellen mehrere Schriftgrößen vorkommen, wird smoUndefined (9.999.999) zurückgeliefert.

Beispiel:

' Setze die Schriftgröße der selektierten Zellen auf 10,3 pt

pm.ActiveSheet.Selection.Font.Size = 10.3

Bold (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenformatierung "Fettdruck":

▪True: Fettdruck ein

▪False: Fettdruck aus

▪smoUndefined (nur beim Lesen): Die Zellen sind teils fett, teils nicht.

Italic (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenformatierung "Kursivschrift":

▪True: Kursivschrift ein

▪False: Kursivschrift aus

▪smoUndefined (nur beim Lesen): Die Zellen sind teils kursiv, teils nicht.

Underline (Eigenschaft)

Datentyp: Long (PmUnderline)

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

pmUnderlineNone = 0 ' aus

pmUnderlineSingle = 1 ' einfach durchgehend

pmUnderlineDouble = 2 ' doppelt durchgehend

pmUnderlineWords = 3 ' einfach wortweise

pmUnderlineWordsDouble = 4 ' doppelt wortweise

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

StrikeThrough (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenformatierung "Durchstreichen":

▪True: Durchstreichen ein

▪False: Durchstreichen aus

▪smoUndefined (nur beim Lesen): Die Zellen sind teils durchgestrichen, teils nicht.

Superscript (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenformatierung "Hochstellen":

▪True: Hochstellen ein

▪False: Hochstellen aus

▪smoUndefined (nur beim Lesen): Die Zellen sind teils hochgestellt, teils nicht.

Subscript (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenformatierung "Tiefstellen":

▪True: Tiefstellen ein

▪False: Tiefstellen aus

▪smoUndefined (nur beim Lesen): Die Zellen sind teils tiefgestellt, teils nicht.

AllCaps (Eigenschaft)

Datentyp: Long

Liest oder setzt die Zeichenformatierung "Großbuchstaben":

▪True: Großbuchstaben ein

▪False: Großbuchstaben aus

▪smoUndefined (nur beim Lesen): Das Attribut ist bei einem Teil der Zellen 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

▪smoUndefined (nur beim Lesen): Die Zellen sind 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:

' Formatiere die aktive Zelle als Kapitälchen mit 75% Größe

pm.ActiveCell.Font.PreferredSmallCaps = 75

' Schalte die Kapitälchen wieder aus

pm.ActiveCell.Font.PreferredSmallCaps = 0

Blink (Eigenschaft)

Datentyp: Long

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

▪True: Blinken ein

▪False: Blinken aus

▪smoUndefined (nur beim Lesen): Die Zellen sind 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.

Falls die Zellen in unterschiedlichen Farben formatiert sind, wird beim Auslesen smoUndefined zurückgeliefert.

ColorIndex (Eigenschaft)

Datentyp: Long (SmoColorIndex)

Liest oder setzt die Vordergrundfarbe der Schrift als Indexfarbe. "Indexfarben" sind die Standardfarben von PlanMaker, 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.

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

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 Zellen sind 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 PlanMaker, 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.

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

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 Zeichenabstand (100%).

Lesen Sie die Eigenschaft aus und die Zellen sind 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 Zeichen (100%).

Lesen Sie die Eigenschaft aus und die Zellen sind 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 Range.

Beispiel für das Font-Objekt

Im nachfolgenden Beispiel wird der Bereich A1 bis C3 auf die Schrift Times New Roman fett mit 24 Punkt gesetzt.

Sub Main

Dim pm as Object

Set pm = CreateObject("PlanMaker.Application")

pm.Visible = True

With pm.ActiveSheet.Range("A1:C3")

.Font.Name = "Times New Roman"

.Font.Size = 24

.Font.Bold = True

End With

Set pm = Nothing

End Sub

Font (Objekt)

Font (Objekt)