Interfaccia ITextRow (tom.h)

L'interfaccia ITextRow fornisce metodi per inserire una o più righe di tabella identiche e recuperare e modificare le proprietà delle righe della tabella. Per inserire righe non dentiche, chiamare ITextRow::Insert per ogni configurazione di riga diversa.

Ereditarietà

L'interfaccia ITextRow eredita dall'interfaccia IDispatch . ITextRow include anche questi tipi di membri:

Metodi

L'interfaccia ITextRow include questi metodi.

ITextRow::Apply Applica gli attributi di formattazione di questo oggetto riga di testo alle righe specificate nell'oggetto ITextRange2 associato.
ITextRow::CanChange Determina se è possibile apportare modifiche a questa riga.
ITextRow::GetAlignment Ottiene l'allineamento orizzontale di una riga.
ITextRow::GetCellAlignment Ottiene l'allineamento verticale della cella attiva.
ITextRow::GetCellBorderColors Ottiene i colori del bordo della cella attiva.
ITextRow::GetCellBorderWidths Ottiene le larghezze del bordo della cella attiva.
ITextRow::GetCellColorBack Ottiene il colore di sfondo della cella attiva.
ITextRow::GetCellColorFore Ottiene il colore di primo piano della cella attiva.
ITextRow::GetCellCount Ottiene il numero di celle in questa riga.
ITextRow::GetCellCountCache Ottiene il numero di celle memorizzate nella cache per questa riga.
ITextRow::GetCellIndex Ottiene l'indice della cella attiva per ottenere o impostare parametri per.
ITextRow::GetCellMargin Ottiene il margine della cella di questa riga.
ITextRow::GetCellMergeFlags Ottiene i flag di merge della cella attiva.
ITextRow::GetCellShading Ottiene l'ombreggiatura della cella attiva.
ITextRow::GetCellVerticalText Ottiene l'impostazione verticale del testo della cella attiva.
ITextRow::GetCellWidth Ottiene la larghezza della cella attiva.
ITextRow::GetHeight Ottiene l'altezza della riga.
ITextRow::GetIndent Ottiene il rientro di questa riga.
ITextRow::GetKeepTogether Ottiene se questa riga può essere interrotta tra pagine.
ITextRow::GetKeepWithNext Ottiene se questa riga deve essere visualizzata nella stessa pagina della riga che la segue.
ITextRow::GetNestLevel Ottiene il livello annidato di una tabella.
ITextRow::GetProperty Ottiene il valore della proprietà specificata. (ITextRow.GetProperty)
ITextRow::GetRTL Ottiene se questa riga ha orientamento da destra a sinistra.
ITextRow::Insert Inserisce una riga o righe nella posizione identificata dall'oggetto ITextRange2 associato.
ITextRow::IsEqual Confronta due righe di tabella per determinare se hanno le stesse proprietà.
ITextRow::Reset Reimposta una riga.
ITextRow::SetAlignment Imposta l'allineamento orizzontale di una riga.
ITextRow::SetCellAlignment Imposta l'allineamento verticale della cella attiva.
ITextRow::SetCellBorderColors Imposta i colori del bordo della cella attiva.
ITextRow::SetCellBorderWidths Imposta le larghezze del bordo della cella attiva.
ITextRow::SetCellColorBack Imposta il colore di sfondo della cella attiva.
ITextRow::SetCellColorFore Imposta il colore di primo piano della cella attiva.
ITextRow::SetCellCount Imposta il numero di celle in una riga.
ITextRow::SetCellCountCache Imposta il numero di celle memorizzate nella cache per una riga.
ITextRow::SetCellIndex Imposta l'indice della cella attiva.
ITextRow::SetCellMargin Imposta il margine della cella di una riga.
ITextRow::SetCellMergeFlags Imposta i flag di unione della cella attiva.
ITextRow::SetCellShading Imposta l'ombreggiatura della cella attiva.
ITextRow::SetCellVerticalText Imposta l'impostazione verticale del testo della cella attiva.
ITextRow::SetCellWidth Imposta la larghezza della cella attiva in twips.
ITextRow::SetHeight Imposta l'altezza di una riga.
ITextRow::SetIndent Imposta il rientro di una riga.
ITextRow::SetKeepTogether Imposta se questa riga può essere interrotta tra le pagine.
ITextRow::SetKeepWithNext Imposta un valore che indica se una riga deve essere visualizzata nella stessa pagina della riga che la segue.
ITextRow::SetProperty Imposta il valore della proprietà specificata. (ITextRow.SetProperty)
ITextRow::SetRTL Imposta un valore che indica se la riga ha un orientamento da destra a sinistra.

Commenti

Per selezionare una tabella, una riga o una cella, usare ITextRange::Expand, con il parametro Unit impostato rispettivamente su tomTable, tomRow o tomCell. Queste unità possono essere usate anche con i metodi ITextRange::Move per spostarsi e selezionare più righe o celle.

Alcune delle proprietà ITextRow si applicano all'intera riga, ad esempio l'allineamento delle righe. Inoltre, esistono diverse proprietà, ad esempio l'allineamento delle celle, che si applicano a una cella con l'indice impostato tramite il metodo ITextRow::SetCellIndex . Questa cella viene definita cella attiva.

ITextRow funziona in modo analogo a ITextPara2, ma non modifica il documento finché non vengono chiamati i metodi ITextRow::Apply o ITextRow::Insert . Inoltre, i parametri riga e cella sono sempre attivi, ovvero non possono avere il valore tomDefault.

Durante l'inizializzazione, l'oggetto ITextRow acquisisce le proprietà della riga della tabella, se presenti, alla fine attiva dell'oggetto ITextRange2 associato. Il metodo ITextRow::Reset può essere utilizzato per aggiornare queste proprietà ai valori correnti per l'oggetto ITextRange2 .

Una tabella di controllo di modifica avanzata è costituita da una sequenza di righe di tabella, che, a sua volta, sono costituite da sequenze di paragrafi. Una riga di tabella inizia con il paragrafo delimitatore a due caratteri speciale U+FFF9 U+000D e termina con il paragrafo delimitatore a due caratteri U+FFFB U+000D. Ogni cella viene terminata dal segno di cella U+0007, che viene considerato come un segno di fine paragrafo rigido come U+000D (CR). I parametri di riga e cella della tabella vengono considerati come formattazione di paragrafo speciale dei delimitatori di riga di tabella. I parametri della cella vengono archiviati in una versione espansa della matrice di schede. Questo formato consente di annidare le tabelle all'interno di altre tabelle e di raggiungere una profondità di quindici livelli.

L'architettura è abbastanza flessibile in quanto ogni riga di tabella può avere qualsiasi parametro di riga di tabella valido, indipendentemente dai parametri per altre righe (ad eccezione dei flag di unione verticale). Ad esempio, il numero di celle e i rientri iniziali delle righe di tabella possono essere diversi, a differenza di HTML con formato rettangolare n×m con tutte le righe che iniziano con lo stesso rientro.

D'altra parte, nessuna descrizione formale della tabella viene archiviata ovunque. Le informazioni, ad esempio il numero di righe, devono essere definite passando attraverso la tabella. Ad esempio, il numero di righe in una tabella può essere ottenuto chiamando ITextRange::StartOf (tomTable, tomFalse, NULL) per passare all'inizio della tabella corrente e quindi chiamando ITextRange::Move (tomRow, tomForward, &dcRow). La quantità &dcRow + 1 contiene quindi il numero di righe nella tabella, perché lo spostamento da incrementi tomRow non si sposta oltre l'ultima riga della tabella.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tom.h