|
<< Click to Display Table of Contents >> Row (Objekt) |
Zugriffspfade:
▪ Application à Documents à Item à Tables à Item à Rows à Item
▪ Application à ActiveDocument à Tables à Item à Rows à Item
1 Beschreibung
Ein Row-Objekt repräsentiert eine einzelne Tabellenzeile einer Tabelle und erlaubt es Ihnen, die Formatierung dieser Tabellenzeile zu ändern.
Für jede Tabellenzeile existiert ein eigenes Row-Objekt. Fügen Sie einer Tabelle Zeilen hinzu oder löschen diese, werden die zugehörigen Row-Objekte dynamisch angelegt bzw. entfernt.
2 Zugriff auf das Objekt
Die einzelnen Row-Objekte können ausschließlich durch Aufzählung der Elemente der Rows-Sammlung angesprochen werden. Von dieser Sammlung besitzt jede Tabelle genau eine Instanz.
Ein Beispiel:
' Die Höhe der zweiten Zeile der ersten Tabelle des Dokuments anzeigen
MsgBox tm.ActiveDocument.Tables(1).Rows.Item(2).Height
3 Eigenschaften, Objekte, Sammlungen und Methoden
Eigenschaften:
▪ Height
▪ HeightRule
▪ KeepTogether
▪ BreakPageAtRow
▪ AllowBreakInRow
▪ RepeatAsHeaderRow
Objekte:
▪ Shading → Shading
▪ Application → Application
▪ Parent → Rows
Sammlungen:
▪ Cells → Cells
▪ Borders → Borders
Height (Eigenschaft)
Datentyp: Single
Liest oder setzt die Höhe der durch Row repräsentierten Tabellenzeile in Punkt (1 Punkt entspricht 1/72 Zoll).
Zwei Besonderheiten gibt es zu beachten, wenn die HeightRule-Eigenschaft (siehe unten) der Tabellenzeile auf "Automatisch" gestellt ist:
▪Beim Lesen der Eigenschaft wird der Wert SmoUndefined (9.999.999) zurückgeliefert.
▪Beim Setzen der Eigenschaft wird die Methode zur Festlegung der Zeilenhöhe (HeightRule) auf "Mindestens" geändert.
HeightRule (Eigenschaft)
Datentyp: Long (TmRowHeightRule)
Liest oder setzt die Methode zur Festlegung der Höhe der durch Row repräsentierten Tabellenzeile. Mögliche Werte:
tmRowHeightAuto = 0 ' Zeilenhöhe "automatisch"
tmRowHeightExact = 1 ' Zeilenhöhe "exakt"
tmRowHeightAtLeast = 2 ' Zeilenhöhe "mindestens"
KeepTogether (Eigenschaft)
Datentyp: Boolean
Liest oder setzt die Eigenschaft "Mit der nächsten Zeile zusammenhalten".
Bei True wird verhindert, dass TextMaker zwischen dieser Tabellenzeile und der nächsten einen automatischen Seitenumbruch einfügt. Der Umbruch wird dann bereits vor der aktuellen Tabellenzeile durchgeführt.
BreakPageAtRow (Eigenschaft)
Datentyp: Boolean
Liest oder setzt die Eigenschaft "Seitenumbruch vor dieser Zeile". Bei True fügt TextMaker vor dieser Tabellenzeile einen Seitenumbruch ein.
AllowBreakInRow (Eigenschaft)
Datentyp: Boolean
Liest oder setzt die Eigenschaft "Seitenumbruch in Zeile erlauben".
Bei True ist TextMaker berechtigt, bei Bedarf auch innerhalb der Zeile einen Seitenumbruch durchzuführen. Bei False wird die gesamte Tabellenzeile auf die nächste Seite übernommen.
RepeatAsHeaderRow (Eigenschaft)
Datentyp: Boolean
Liest oder setzt die Eigenschaft "Diese Zeile als Kopfzeile wiederholen". Diese Eigenschaft ist nur für die erste Zeile einer Tabelle verfügbar.
Bei True wiederholt TextMaker diese Zeile auf jeder neuen Seite, wenn sich die Tabelle über zwei oder mehr Seiten erstreckt. Dies ist nützlich, um Tabellenüberschriften auf jeder Seite erscheinen zu lassen.
Shading (Zeiger auf Objekt)
Datentyp: Object
Liefert das zur Row gehörende Shading-Objekt, das die Schattierung der gesamten Tabellenzeile repräsentiert.
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 Rows.
Cells (Zeiger auf Sammlung)
Datentyp: Object
Liefert die zur Tabelle gehörende Cells-Sammlung, die alle Zellen der Tabellenzeile enthält.
Borders (Zeiger auf Sammlung)
Datentyp: Object
Liefert die Borders-Sammlung, die die fünf Umrandungslinien der Tabellenzeile repräsentiert. Sie können mit Hilfe dieser Sammlung die Linieneinstellungen (Dicke, Farbe etc.) auslesen und verändern.