<< Click to Display Table of Contents >> Border (Objekt) |
Zugriffspfade für Umrandungen von Absätzen:
▪Application à Documents à Item à Paragraphs à Item à Borders à Item
▪Application à ActiveDocument à Paragraphs à Item à Borders à Item
Zugriffspfade für Umrandungen von Tabellen:
▪Application à Documents à Item à Tables à Item à Borders à Item
▪Application à ActiveDocument à Tables à Item à Borders à Item
Zugriffspfade für Umrandungen von Tabellenzeilen:
▪Application à Documents à Item à Tables à Item à Rows à Item à Borders à Item
▪Application à ActiveDocument à Tables à Item à Rows à Item à Borders à Item
Zugriffspfade für Umrandungen von Tabellenzellen:
▪Application à Documents à Item à Tables à Item à Cell(x, y) à Borders à Item
▪Application à ActiveDocument à Tables à Item à Cell(x, y) à Borders à Item
▪Application à Documents à Item à Tables à Item à Rows à Item à Cells à Item à Borders à Item
▪Application à ActiveDocument à Tables à Item à Rows à Item à Cells à Item à Borders à Item
1 Beschreibung
Ein Border-Objekt repräsentiert jeweils eine der Umrandungslinien von Absätzen, Tabellen, Tabellenzeilen beziehungsweise Tabellenzellen (z.B. die obere, untere, linke oder rechte Linie). Es lässt Sie die Liniendicke, Farbe etc. dieser Umrandungslinie auslesen und setzen.
2 Zugriff auf das Objekt
Die einzelnen Border-Objekte können ausschließlich über die Borders-Sammlung eines Absatzes, einer Tabelle, einer Tabellenzeile oder einer Tabellenzelle angesprochen werden. Hierbei übergeben Sie der Borders-Sammlung als Parameter die Nummer der Umrandungslinie, die Sie ansprechen möchten:
tmBorderTop = -1 ' Obere Umrandungslinie
tmBorderLeft = -2 ' Linke Umrandungslinie
tmBorderBottom = -3 ' Untere Umrandungslinie
tmBorderRight = -4 ' Rechte Umrandungslinie
tmBorderHorizontal = -5 ' Horizontale Gitterlinie (nur bei Tabellen)
tmBorderVertical = -6 ' Vertikale Gitterlinie (nur Tabellen, Tabellenzeilen)
tmBorderBetween = -7 ' Umrandungslinie zwischen Absätzen (nur Absätze)
Einige Beispiele:
' Linke Umrandung des ersten Absatzes ändern
tm.ActiveDocument.Paragraphs(1).Borders(tmBorderLeft).Type = tmLineStyleSingle
' Obere Umrandung der ersten Tabelle ändern
tm.ActiveDocument.Tables(1).Borders(tmBorderTop).Type = tmLineStyleDouble
' Vertikale Gitterlinien der der zweiten Zeile der ersten Tabelle ändern
tm.ActiveDocument.Tables(1).Rows(2).Borders(tmBorderVertical).Color = smoColorRed
' Untere Umrandung der dritten Zelle der zweiten Zeile der ersten Tabelle ändern
tm.ActiveDocument.Tables(1).Rows(2).Cells(3).Borders(tmBorderBottom).Type = tmLineStyleDouble
3 Eigenschaften, Objekte, Sammlungen und Methoden
Eigenschaften:
▪Type
▪Thick1
▪Thick2
▪Separation
▪Color
▪ColorIndex
Objekte:
▪Application → Application
▪Parent → Borders
Type (Eigenschaft)
Datentyp: Long (TmLineStyle)
Liest oder setzt den Typ der Umrandungslinie. Mögliche Werte:
tmLineStyleNone = 0 ' Keine Umrandung
tmLineStyleSingle = 1 ' Einfache Umrandung
tmLineStyleDouble = 2 ' Doppelte Umrandung
Thick1 (Eigenschaft)
Datentyp: Single
Liest oder setzt die Dicke der ersten Umrandungslinie in Punkt (1 Punkt entspricht 1/72 Zoll).
Thick2 (Eigenschaft)
Datentyp: Single
Liest oder setzt die Dicke der zweiten Umrandungslinie in Punkt (1 Punkt entspricht 1/72 Zoll).
Diese Eigenschaft wird nur verwendet, wenn der Typ der Umrandung auf tmLineStyleDouble steht.
Separation (Eigenschaft)
Datentyp: Single
Liest oder setzt den Abstand zwischen den beiden Umrandungslinien in Punkt (1 Punkt entspricht 1/72 Zoll).
Diese Eigenschaft wird nur verwendet, wenn der Typ der Umrandung auf tmLineStyleDouble steht.
Color (Eigenschaft)
Datentyp: Long (SmoColor)
Liest oder setzt die Farbe der Umrandungslinie(n) als "BGR"-Wert (Blau-Grün-Rot-Triplet). Sie können entweder einen beliebigen Wert angeben oder eine der vordefinierten BGR-Farbkonstanten verwenden.
ColorIndex (Eigenschaft)
Datentyp: Long (SmoColorIndex)
Liest oder setzt die Farbe der Umrandungslinie(n) als Indexfarbe. "Indexfarben" sind die 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.
Hinweis: Wir empfehlen, stattdessen die Eigenschaft Color (siehe oben) zu verwenden, da Sie mit dieser nicht auf die 16 Standardfarben beschränkt sind, sondern mit beliebigen Farben der BGR-Palette arbeiten können.
Application (Zeiger auf Objekt)
Datentyp: Object
Liefert das Application-Objekt.
Parent (Zeiger auf Objekt)
Datentyp: Object
Liefert das übergeordnete Objekt, also Borders.