ITextRow-Schnittstelle (tom.h)

Die ITextRow-Schnittstelle stellt Methoden zum Einfügen einer oder mehrerer identischer Tabellenzeilen sowie zum Abrufen und Ändern von Tabellenzeileneigenschaften bereit. Um nicht identische Zeilen einzufügen, rufen Sie ITextRow::Insert für jede andere Zeilenkonfiguration auf.

Vererbung

Die ITextRow-Schnittstelle erbt von der IDispatch-Schnittstelle . ITextRow verfügt auch über folgende Arten von Membern:

Methoden

Die ITextRow-Schnittstelle verfügt über diese Methoden.

ITextRow::Apply Wendet die Formatierungsattribute dieses Textzeilenobjekts auf die angegebenen Zeilen im zugeordneten ITextRange2 an.
ITextRow::CanChange Bestimmt, ob Änderungen an dieser Zeile vorgenommen werden können.
ITextRow::GetAlignment Ruft die horizontale Ausrichtung einer Zeile ab.
ITextRow::GetCellAlignment Ruft die vertikale Ausrichtung der aktiven Zelle ab.
ITextRow::GetCellBorderColors Ruft die Rahmenfarben der aktiven Zelle ab.
ITextRow::GetCellBorderWidths Ruft die Rahmenbreiten der aktiven Zelle ab.
ITextRow::GetCellColorBack Ruft die Hintergrundfarbe der aktiven Zelle ab.
ITextRow::GetCellColorFore Ruft die Vordergrundfarbe der aktiven Zelle ab.
ITextRow::GetCellCount Ruft die Anzahl der Zellen in dieser Zeile ab.
ITextRow::GetCellCountCache Ruft die Anzahl der Zellen ab, die für diese Zeile zwischengespeichert wurden.
ITextRow::GetCellIndex Ruft den Index der aktiven Zelle ab, für die Parameter abgerufen oder festgelegt werden sollen.
ITextRow::GetCellMargin Ruft den Zellrand dieser Zeile ab.
ITextRow::GetCellMergeFlags Ruft die Mergeflags der aktiven Zelle ab.
ITextRow::GetCellShading Ruft die Schattierung der aktiven Zelle ab.
ITextRow::GetCellVerticalText Ruft die Vertical-Text-Einstellung der aktiven Zelle ab.
ITextRow::GetCellWidth Ruft die Breite der aktiven Zelle ab.
ITextRow::GetHeight Ruft die Höhe der Zeile ab.
ITextRow::GetIndent Ruft den Einzug dieser Zeile ab.
ITextRow::GetKeepTogether Ruft ab, ob diese Zeile seitenübergreifend unterbrochen werden darf.
ITextRow::GetKeepWithNext Ruft ab, ob diese Zeile auf derselben Seite wie die darauf folgende Zeile angezeigt werden soll.
ITextRow::GetNestLevel Ruft die Schachtelungsebene einer Tabelle ab.
ITextRow::GetProperty Ruft den Wert der angegebenen Eigenschaft ab. (ITextRow.GetProperty)
ITextRow::GetRTL Ruft ab, ob diese Zeile von rechts nach links ausgerichtet ist.
ITextRow::Insert Fügt eine Zeile (oder Zeilen) an der Position ein, die durch das zugeordnete ITextRange2-Objekt identifiziert wird.
ITextRow::IsEqual Vergleicht zwei Tabellenzeilen, um zu bestimmen, ob sie über die gleichen Eigenschaften verfügen.
ITextRow::Reset Setzt eine Zeile zurück.
ITextRow::SetAlignment Legt die horizontale Ausrichtung einer Zeile fest.
ITextRow::SetCellAlignment Legt die vertikale Ausrichtung der aktiven Zelle fest.
ITextRow::SetCellBorderColors Legt die Rahmenfarben der aktiven Zelle fest.
ITextRow::SetCellBorderWidths Legt die Rahmenbreiten der aktiven Zelle fest.
ITextRow::SetCellColorBack Legt die Hintergrundfarbe der aktiven Zelle fest.
ITextRow::SetCellColorFore Legt die Vordergrundfarbe der aktiven Zelle fest.
ITextRow::SetCellCount Legt die Anzahl der Zellen in einer Zeile fest.
ITextRow::SetCellCountCache Legt die Anzahl der Zellen fest, die für eine Zeile zwischengespeichert werden.
ITextRow::SetCellIndex Legt den Index der aktiven Zelle fest.
ITextRow::SetCellMargin Legt den Zellrand einer Zeile fest.
ITextRow::SetCellMergeFlags Legt die Mergeflags der aktiven Zelle fest.
ITextRow::SetCellShading Legt die Schattierung der aktiven Zelle fest.
ITextRow::SetCellVerticalText Legt die Vertical-Text-Einstellung der aktiven Zelle fest.
ITextRow::SetCellWidth Legt die breite der aktiven Zelle in Twips fest.
ITextRow::SetHeight Legt die Höhe einer Zeile fest.
ITextRow::SetIndent Legt den Einzug einer Zeile fest.
ITextRow::SetKeepTogether Legt fest, ob diese Zeile seitenübergreifend unterbrochen werden darf.
ITextRow::SetKeepWithNext Legt fest, ob eine Zeile auf derselben Seite wie die darauf folgende Zeile angezeigt werden soll.
ITextRow::SetProperty Legt den Wert der angegebenen Eigenschaft fest. (ITextRow.SetProperty)
ITextRow::SetRTL Legt fest, ob diese Zeile von rechts nach links ausgerichtet ist.

Hinweise

Um eine Tabelle, eine Zeile oder eine Zelle auszuwählen, verwenden Sie ITextRange::Expand, wobei der Unit-Parameter auf tomTable, tomRow oder tomCell festgelegt ist. Diese Einheiten können auch mit den ITextRange::Move-Methoden verwendet werden, um mehrere Zeilen oder Zellen zu navigieren und auszuwählen.

Einige der ITextRow-Eigenschaften gelten für die gesamte Zeile, z. B. die Zeilenausrichtung. Darüber hinaus gibt es eine Reihe von Eigenschaften, z. B. die Zellausrichtung, die für eine Zelle gelten, deren Index über die ITextRow::SetCellIndex-Methode festgelegt ist. Diese Zelle wird als aktive Zelle bezeichnet.

ITextRow funktioniert ähnlich wie ITextPara2, ändert das Dokument jedoch erst, wenn die Methoden ITextRow::Apply oder ITextRow::Insert aufgerufen werden. Darüber hinaus sind die Zeilen- und Zellparameter immer aktiv, d. h. sie können nicht den Wert tomDefault aufweisen.

Bei der Initialisierung ruft das ITextRow-Objekt die Tabellenzeileneigenschaften (sofern vorhanden) am aktiven Ende des zugeordneten ITextRange2 ab. Die ITextRow::Reset-Methode kann verwendet werden, um diese Eigenschaften auf die aktuellen Werte für das ITextRange2-Objekt zu aktualisieren.

Eine Rich-Edit-Steuerelementtabelle besteht aus einer Sequenz von Tabellenzeilen, die wiederum aus Sequenzen von Absätzen bestehen. Eine Tabellenzeile beginnt mit dem speziellen Zweizeichentrennzeichenabsatz U+FFF9 U+000D und endet mit dem Zweizeichentrennzeichenabsatz U+FFFB U+000D. Jede Zelle wird durch die Zellmarke U+0007 beendet, die genauso wie U+000D (CR) als hartes Ende des Absatzes behandelt wird. Die Tabellenzeilen- und Zellparameter werden als spezielle Absatzformatierung der Tabellenzeilentrennzeichen behandelt. Die Zellparameter werden in einer erweiterten Version des Registerkartenarrays gespeichert. Dieses Format ermöglicht es, Tabellen in anderen Tabellen zu verschachteln, und es ist zulässig, fünfzehn Ebenen tief zu gehen.

Die Architektur ist sehr flexibel, da jede Tabellenzeile über beliebige gültige Tabellenzeilenparameter verfügen kann, unabhängig von den Parametern für andere Zeilen (mit Ausnahme von vertikalen Mergeflags). Beispielsweise kann sich die Anzahl der Zellen und die Anfangseinzüge von Tabellenzeilen unterscheiden, anders als in HTML, das ein rechteckiges n×m-Format aufweist, wobei alle Zeilen mit demselben Einzug beginnen.

Auf der anderen Seite wird keine formale Tabellenbeschreibung gespeichert. Informationen wie die Anzahl der Zeilen müssen durch die Navigation durch die Tabelle herausgefunden werden. Beispielsweise kann die Anzahl der Zeilen in einer Tabelle abgerufen werden, indem Sie ITextRange::StartOf (tomTable, tomFalse, NULL) aufrufen, um zum Anfang der aktuellen Tabelle zu wechseln, und dann ITextRange::Move (tomRow, tomForward, &dcRow) aufrufen. Die Menge &dcRow + 1 enthält dann die Anzahl der Zeilen in der Tabelle, da das Verschieben von tomRow-Schritten nicht über die letzte Tabellenzeile hinausgeht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tom.h