Freigeben über


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