<< Click to Display Table of Contents >> Shading (Objekt)

Zugriffspfade für Schattierungen von Absätzen:

▪Application à Documents à Item à Paragraphs à Item à Shading

▪Application à ActiveDocument à Paragraphs à Item à Shading

Zugriffspfade für Schattierungen von Tabellen:

▪Application à Documents à Item à Tables à Item à Shading

▪Application à ActiveDocument à Tables à Item à Shading

Zugriffspfade für Schattierungen von Tabellenzeilen:

▪Application à Documents à Item à Tables à Item à Rows à Item à Shading

▪Application à ActiveDocument à Tables à Item à Rows à Item à Shading

Zugriffspfade für Schattierungen von Tabellenzellen:

▪Application à Documents à Item à Tables à Item à Cell(x, y) à Shading

▪Application à ActiveDocument à Tables à Item à Cell(x, y) à Shading

▪Application à Documents à Item à Tables à Item à Rows à Item à Cells à Item à Shading

▪Application à ActiveDocument à Tables à Item à Rows à Item à Cells à Item à Shading

 1  Beschreibung

Das Shading-Objekt beschreibt die Schattierung von Absätzen, Tabellen, Tabellenzeilen und Tabellenzellen. Es ist ein Tochterobjekt von Paragraph, Table, Row oder Cell.

 2  Zugriff auf das Objekt

Jeder Absatz, jede Tabelle, jede Tabellenzeile und jede Tabellenzelle besitzt genau eine Instanz des Shading-Objekts. Diese wird über den Objektzeiger Shading im jeweiligen Objekt angesprochen:

' Schattierung des ersten Absatzes ändern

tm.ActiveDocument.Paragraphs(1).Shading.Texture = smoPatternHalftone

 

' Schattierung der ersten Tabelle ändern

tm.ActiveDocument.Tables(1).Shading.Texture = smoPatternHalftone

 

' Schattierung der zweiten Zeile der ersten Tabelle ändern

tm.ActiveDocument.Tables(1).Rows(2).Shading.Texture = smoPatternHalftone

 

' Schattierung der dritten Zelle der zweiten Zeile der ersten Tabelle ändern

tm.ActiveDocument.Tables(1).Rows(2).Cells(3).Shading.Texture = smoPatternHalftone

 3  Eigenschaften, Objekte, Sammlungen und Methoden

Eigenschaften:

▪Texture

▪Intensity

▪ForegroundPatternColor

▪ForegroundPatternColorIndex

▪BackgroundPatternColor

▪BackgroundPatternColorIndex

 

Objekte:

▪Application → Application

▪Parent → Paragraph, Table, Row oder Cell

Texture (Eigenschaft)

Datentyp: Long (SmoShadePatterns)

Liest oder setzt das Füllmuster der Schattierung. Mögliche Werte:

smoPatternNone                       = 0

smoPatternHalftone                   = 1

smoPatternRightDiagCoarse            = 2

smoPatternLeftDiagCoarse             = 3

smoPatternHashDiagCoarse             = 4

smoPatternVertCoarse                 = 5

smoPatternHorzCoarse                 = 6

smoPatternHashCoarse                 = 7

smoPatternRightDiagFine              = 8

smoPatternLeftDiagFine               = 9

smoPatternHashDiagFine               = 10

smoPatternVertFine                   = 11

smoPatternHorzFine                   = 12

smoPatternHashFine                   = 13

Um eine Schattierung hinzuzufügen, setzen Sie Texture auf smoPatternHalftone und geben die gewünschte Stärke der Schattierung bei Intensity an.

Um ein Muster hinzuzufügen, setzen Sie Texture auf einen Wert zwischen smoPatternRightDiagCoarse und smoPatternHashFine.

Um eine Schattierung oder ein Muster wieder zu entfernen, setzen Sie Texture auf smoPatternNone.

Intensity (Eigenschaft)

Datentyp: Long

Liest oder setzt die Stärke der Schattierung. Die möglichen Werte liegen zwischen 0 und 100, entsprechend 0 bis 100 Prozent.

Dieser Wert darf nur gesetzt oder gelesen werden, wenn mittels Texture-Eigenschaft eine Schattierung angewählt wurde (Texture auf smoPatternHalftone gesetzt). Ist ein Muster gewählt (Texture enthält einen beliebigen anderen Wert), führt der Zugriff auf Intensity zu einem Fehler.

ForegroundPatternColor (Eigenschaft)

Datentyp: Long (SmoColor)

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

ForegroundPatternColorIndex (Eigenschaft)

Datentyp: Long (SmoColorIndex)

Liest oder setzt die Vordergrundfarbe der Schattierung oder des Musters 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.

Wir empfehlen, stattdessen die Eigenschaft ForegroundPatternColor (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.

BackgroundPatternColor (Eigenschaft)

Datentyp: Long (SmoColor)

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

BackgroundPatternColorIndex (Eigenschaft)

Datentyp: Long (SmoColorIndex)

Liest oder setzt die Hintergrundfarbe der Schattierung oder des Musters 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.

Wir empfehlen, stattdessen die Eigenschaft ForegroundPatternColor (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.

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 Paragraph, Table, Row oder Cell.

Beispiel für die Anwendung des Shading-Objekts

Sub Main

 Dim tm as Object

 

 Set tm = CreateObject("TextMaker.Application")

 tm.Visible = True

 

 With tm.ActiveDocument.Paragraphs.Item(1)

                 .Shading.Texture = smoPatternHorzFine

                 .Shading.BackgroundPatternColor = smoColorAqua

 End With

 

 Set tm = Nothing

End Sub