Documentation – Panoramica di Document Builder in C++

Cpp: Navigazione con cursore in C++

Mon, 01 Jan 0001 00:00:00 +0000

Mentre lavori con un documento, anche se è breve o lungo, dovrai navigare nel documento. La navigazione con un cursore virtuale rappresenta la possibilità di navigare tra diversi nodi in un documento.

All’interno di un breve documento, muoversi in un documento è semplice in quanto è possibile spostare il punto di inserimento anche utilizzando i tasti freccia della tastiera o facendo clic con il mouse per individuare il punto di inserimento dove si desidera. Ma una volta che hai un documento di grandi dimensioni che ha molte pagine, queste tecniche di base saranno insufficienti.

Questo articolo spiega come spostarsi in un documento e spostarsi con un cursore virtuale in diverse parti di esso.

Rilevamento della posizione corrente del cursore

Prima di iniziare il processo di navigazione nel documento, è necessario ottenere il nodo attualmente selezionato. È possibile ottenere la posizione esatta del cursore su un nodo selezionato utilizzando la proprietà CurrentNode. Inoltre, invece di ottenere il nodo corrente, è possibile ottenere il paragrafo attualmente selezionato o la sezione attualmente selezionata utilizzando le proprietà CurrentParagraph e CurrentSection.

Qualsiasi operazione di inserimento eseguita utilizzando DocumentBuilder verrà inserita prima di CurrentNode. Quando il paragrafo corrente è vuoto o il cursore è posizionato appena prima della fine del paragrafo, CurrentNode restituisce nullptr.

Metodi di navigazione in un documento

Quando si modifica il testo, è importante sapere come navigare nel documento e dove spostarlo esattamente. Aspose.Words consente di spostarsi in un documento e passare alle sue diverse sezioni e parti, in modo simile alla funzionalità del riquadro di spostamento in Microsoft Word per andare a una pagina o all’intestazione di un documento Word senza scorrere.

Il metodo principale è quello di essere in grado di spostare la posizione del cursore su un nodo specifico nel documento, è possibile ottenere ciò utilizzando il metodo MoveTo.

L’esempio di codice seguente mostra come spostare DocumentBuilder in nodi diversi in un documento:

Ma oltre al metodo di base MoveTo, ce ne sono di più specifici.

Passare all’inizio o alla fine di un documento

Puoi andare all’inizio o alla fine del documento usando i metodi MoveToDocumentStart e MoveToDocumentEnd.

L’esempio di codice seguente mostra come spostare la posizione del cursore all’inizio o alla fine di un documento:

Navigare con i segnalibri

È possibile contrassegnare un luogo che si desidera trovare e spostarlo di nuovo facilmente. È possibile inserire tutti i segnalibri nel documento che si desidera e quindi navigare attraverso di essi identificando i segnalibri con nomi univoci. È possibile passare a un segnalibro utilizzando il metodo MoveToBookmark.

Gli esempi di codice seguenti mostrano come spostare una posizione del cursore in un segnalibro:

Passare alle celle della tabella

È possibile passare a una cella di tabella utilizzando il metodo MoveToCell. Questo metodo vi permetterà di navigare il cursore in qualsiasi cella in una tabella specifica. Inoltre, è possibile specificare un indice per spostare il cursore in qualsiasi posizione o carattere specificato in una cella all’interno del metodo MoveToCell.

L’esempio di codice seguente mostra come spostare una posizione del cursore in una cella di tabella specificata:

Passare a un campo

È possibile passare a un campo specifico nel documento utilizzando il metodo MoveToField. Inoltre, è possibile passare a un campo di unione specifico utilizzando il metodo MoveToMergeField.

L’esempio di codice seguente mostra come spostare il cursore del generatore di documenti in un campo specifico:

Passare a un’intestazione o piè di pagina

È possibile passare all’inizio di un’intestazione o di un piè di pagina utilizzando il metodo MoveToHeaderFooter.

L’esempio di codice seguente mostra come spostare il cursore del generatore di documenti in un’intestazione o piè di pagina del documento:

Passare a una sezione o a un paragrafo

È possibile passare a una sezione o a un paragrafo specifici utilizzando i metodi MoveToParagraph o MoveToSection. Inoltre, è possibile specificare un indice per spostare il cursore in qualsiasi posizione o un carattere specificato in un paragrafo all’interno del metodo MoveToParagraph.

L’esempio di codice seguente mostra come passare a una sezione specifica e a un paragrafo specifico in un documento:

Cpp: Utilizzare DocumentBuilder per inserire elementi del documento

Mon, 01 Jan 0001 00:00:00 +0000

Il DocumentBuilder viene utilizzato per modificare i documenti. Questo articolo spiega e descrive come eseguire una serie di attività:

Inserimento di una stringa di testo

Passa semplicemente la stringa di testo che devi inserire nel documento al metodo DocumentBuilder.Write. La formattazione del testo è determinata dalla proprietà Font. Questo oggetto contiene diversi attributi di carattere (nome del carattere, dimensione del carattere, colore e così via). Alcuni importanti attributi dei font sono rappresentati anche dalle proprietà DocumentBuilder che consentono di accedervi direttamente. Queste sono proprietà booleane Font.Bold, Font.Italic e Font.Underline.

Si noti che la formattazione dei caratteri impostata si applicherà a tutto il testo inserito dalla posizione corrente nel documento in poi.

L’esempio seguente Inserisce testo formattato usando DocumentBuilder.

Inserimento di un paragrafo

DocumentBuilder.Writeln inserisce anche una stringa di testo nel documento, ma in aggiunta aggiunge un’interruzione di paragrafo. La formattazione corrente del carattere è specificata anche dalla proprietà DocumentBuilder.Font e la formattazione corrente del paragrafo è determinata dalla proprietà DocumentBuilder.ParagraphFormat. L’esempio seguente mostra come inserire un paragrafo nel documento.

Inserimento di una tabella

L’algoritmo di base per creare una tabella usando DocumentBuilder è semplice:

Avviare la tabella usando DocumentBuilder.StartTable.
Inserire una cella usando DocumentBuilder.InsertCell. Questo avvia automaticamente una nuova riga. Se necessario, utilizzare la proprietà DocumentBuilder.CellFormat per specificare la formattazione delle celle.
Inserire il contenuto della cella utilizzando i metodi DocumentBuilder.
Ripetere i passaggi 2 e 3 fino al completamento della riga.
Chiama DocumentBuilder.EndRow per terminare la riga corrente. Se necessario, utilizzare la proprietà DocumentBuilder.RowFormat per specificare la formattazione delle righe.
Ripetere i passaggi 2 - 5 fino al completamento della tabella.
Chiama DocumentBuilder.EndTable per terminare la costruzione del tavolo. I metodi di creazione della tabella DocumentBuilder appropriati sono descritti di seguito.

Avvio di un tavolo

Chiamare DocumentBuilder.StartTable è il primo passo nella costruzione di una tabella. Può anche essere chiamato all’interno di una cella, nel qual caso avvia una tabella nidificata. Il metodo successivo da chiamare è DocumentBuilder.InsertCell.

Inserimento di una cella

Dopo aver chiamato DocumentBuilder->InsertCell, viene creata una nuova cella e qualsiasi contenuto aggiunto utilizzando altri metodi della classe DocumentBuilder verrà aggiunto alla cella corrente. Per avviare una nuova cella nella stessa riga, chiamare di nuovo DocumentBuilder->InsertCell. Utilizzare la proprietà DocumentBuilder.CellFormat per specificare la formattazione delle celle. Restituisce un oggetto CellFormat che rappresenta tutta la formattazione per una cella di tabella.

Fine di una riga

Chiama DocumentBuilder.EndRow per terminare la riga corrente. Se si chiama DocumentBuilder->InsertCell immediatamente dopo, la tabella continua su una nuova riga.

Utilizzare la proprietà DocumentBuilder.RowFormat per specificare la formattazione delle righe. Restituisce un oggetto RowFormat che rappresenta tutta la formattazione per una riga di tabella.

Fine di un tavolo

Chiama DocumentBuilder.EndTable per terminare la tabella corrente. Questo metodo dovrebbe essere chiamato solo una volta dopo che DocumentBuilder->EndRow è stato chiamato. Quando viene chiamato, DocumentBuilder.EndTable sposta il cursore fuori dalla cella corrente in una posizione subito dopo la tabella. Nell’esempio seguente viene illustrato come creare una tabella formattata contenente 2 righe e 2 colonne.

Inserimento di una pausa

Se si desidera avviare esplicitamente una nuova riga, paragrafo, colonna, sezione o pagina, chiamare DocumentBuilder.InsertBreak. Passare a questo metodo il tipo di interruzione che è necessario inserire rappresentato dall’enumerazione BreakType. L’esempio seguente mostra come inserire interruzioni di pagina in un documento.

Inserimento di un’immagine

DocumentBuilder fornisce diversi sovraccarichi del metodo DocumentBuilder->InsertImage che consente di inserire un’immagine in linea o mobile. Se l’immagine è un metafile EMF o WMF, verrà inserita nel documento in formato metafile. Tutte le altre immagini saranno memorizzate in formato PNG. Il metodo DocumentBuilder->InsertImage può utilizzare immagini provenienti da fonti diverse:

Da un file o URL passando un parametro stringa DocumentBuilder->InsertImage.
Da un flusso passando un parametro Stream DocumentBuilder->InsertImage.
Da un oggetto Immagine passando un parametro Immagine DocumentBuilder->InsertImage.
Da un array di byte passando un parametro array di byte DocumentBuilder.InsertImage.Per ciascuno dei metodi DocumentBuilder->InsertImage, ci sono ulteriori sovraccarichi che consentono di inserire un’immagine con le seguenti opzioni:
In linea o fluttuante in una posizione specifica, ad esempio DocumentBuilder->InsertImage.
Scala percentuale o dimensione personalizzata, ad esempio DocumentBuilder.InsertImage. Inoltre il metodo DocumentBuilder->InsertImage restituisce un oggetto Shape appena creato e inserito in modo da poter modificare ulteriormente le proprietà della Forma.

Inserimento di un’immagine in linea

Passare una singola stringa che rappresenta un file che contiene l’immagine a DocumentBuilder->InsertImage per inserire l’immagine nel documento come grafica in linea. L’esempio seguente mostra come inserire un’immagine in linea nella posizione del cursore in un documento.

Inserimento di un’immagine fluttuante (assolutamente posizionata)

Questo esempio inserisce un’immagine mobile da un file o URL in una posizione e dimensione specificate.

Inserimento di un segnalibro

Per inserire un segnalibro nel documento, è necessario effettuare le seguenti operazioni:

Chiama DocumentBuilder->StartBookmark passandogli il nome desiderato del segnalibro.
Inserire il testo del segnalibro usando i metodi DocumentBuilder.
Chiama DocumentBuilder.EndBookmark passandogli lo stesso nome che hai usato con DocumentBuilder->StartBookmark.
I segnalibri possono sovrapporsi e coprire qualsiasi intervallo. Per creare un segnalibro valido è necessario chiamare sia DocumentBuilder->StartBookmark che DocumentBuilder->EndBookmark con lo stesso nome del segnalibro.

Segnalibri mal formati o segnalibri con nomi duplicati verranno ignorati quando il documento viene salvato.

L’esempio seguente mostra come inserire un segnalibro in un documento utilizzando un generatore di documenti.

Inserimento di un campo <code>Form</code>

I campi modulo sono un caso particolare di campi Word che consente “interazione” con l’utente. I campi modulo in Microsoft Word includono casella di testo, casella combinata e casella di controllo.DocumentBuilder fornisce metodi speciali per inserire ogni tipo di campo modulo nel documento: DocumentBuilder.InsertTextInput, DocumentBuilder->InsertCheckBox e DocumentBuilder.InsertComboBox. Si noti che se si specifica un nome per il campo modulo, viene creato automaticamente un segnalibro con lo stesso nome.

Inserimento di un input di testo

DocumentBuilder.InsertTextInput per inserire una casella di testo nel documento. L’esempio seguente mostra come inserire un campo modulo di input di testo in un documento.

Inserimento di una casella di controllo

Chiamare DocumentBuilder.InsertCheckBox per inserire una casella di controllo nel documento. L’esempio seguente mostra come inserire un campo modulo casella di controllo in un documento.

Inserimento di una casella combinata

Chiamare DocumentBuilder.InsertComboBox per inserire una casella combinata nel documento. L’esempio seguente mostra come inserire un campo modulo casella combinata in un documento.

Inserimento di locale a livello di campo

I clienti possono specificare Locale a livello di campo ora e possono ottenere un migliore controllo. Gli ID locali possono essere associati a ciascun campo all’interno di DocumentBuilder. Gli esempi seguenti illustrano come utilizzare questa opzione.

Inserimento di un collegamento ipertestuale

Utilizzare DocumentBuilder.InsertHyperlink per inserire un collegamento ipertestuale nel documento. Questo metodo accetta tre parametri: il testo del collegamento da visualizzare nel documento, la destinazione del collegamento (URL o un nome di un segnalibro all’interno del documento) e un parametro booleano che dovrebbe essere vero se URL è un nome di un segnalibro all’interno del documento.DocumentBuilder.InsertHyperlink chiama internamente DocumentBuilder.InsertField.Il metodo aggiunge sempre apostrofi all’inizio e alla fine dell’URL. Si noti che è necessario specificare la formattazione del carattere per il testo visualizzato collegamento ipertestuale in modo esplicito utilizzando la proprietà Font. L’esempio seguente inserisce un collegamento ipertestuale in un documento utilizzando DocumentBuilder.

Inserimento dell’oggetto Ole

Se si desidera chiamare l’oggetto Ole DocumentBuilder.InsertOleObject. Passare a questo metodo il ProgId esplicitamente con altri parametri. L’esempio seguente mostra come inserire l’oggetto Ole in un documento.

Impostare il nome del file e l’estensione quando si inserisce l’oggetto Ole

Il pacchetto OLE è un modo legacy e" non documentato " per archiviare l’oggetto incorporato se il gestore OLE è sconosciuto. Le prime versioni di Windows come Windows 3.1, 95 e 98 avevano Packager.applicazione exe che può essere utilizzata per incorporare qualsiasi tipo di dato nel documento. Ora, questa applicazione è esclusa da Windows ma MS Word e altre applicazioni lo usano ancora per incorporare i dati se il gestore OLE è mancante o sconosciuto. La classe OlePackage consente di accedere alle proprietà del pacchetto OLE. L’esempio seguente mostra come impostare il nome del file, l’estensione e il nome visualizzato per il pacchetto OLE.

Inserimento HTML

È possibile inserire facilmente una stringa HTML che contiene un frammento HTML o un intero documento HTML nel documento Word. Basta passare questa stringa al metodo DocumentBuilder->InsertHtml. Una delle implementazioni utili del metodo è la memorizzazione di una stringa HTML in un database e l’inserimento nel documento durante Mail Merge per ottenere il contenuto formattato aggiunto invece di costruirlo utilizzando vari metodi del generatore di documenti. Sotto esempio mostra inserisce HTML in un documento utilizzando DocumentBuilder.

Inserire la regola orizzontale nel documento

L’esempio Below code mostra come inserire la forma della regola orizzontale in un documento utilizzando il metodo DocumentBuilder->InsertHorizontalRule.

Cpp: Utilizzo di DocumentBuilder per modificare facilmente un documento

Mon, 01 Jan 0001 00:00:00 +0000

Specificare la formattazione

Formattazione dei caratteri

La formattazione corrente del carattere è rappresentata da un oggetto Font restituito dalla proprietà DocumentBuilder.Font. La classe Font contiene un’ampia varietà di proprietà del carattere possibili in Microsoft Word. L’esempio seguente mostra come impostare la formattazione dei caratteri.

Formattazione del paragrafo

La formattazione corrente del paragrafo è rappresentata da un oggetto ParagraphFormat restituito dalla proprietà DocumentBuilder.ParagraphFormat. Questo oggetto incapsula varie proprietà di formattazione del paragrafo disponibili in Microsoft Word. È possibile ripristinare facilmente la formattazione del paragrafo per impostazione predefinita su stile normale, allineato a sinistra, nessun rientro, nessuna spaziatura, nessun bordo e nessuna ombreggiatura chiamando ParagraphFormat.ClearFormatting. L’esempio seguente mostra come impostare la formattazione del paragrafo.

Lavorare con la tipografia asiatica

Regola automaticamente lo spazio tra testo asiatico e latino, numeri

Se si sta progettando un modello con testo latino e orientale e si desidera migliorare l’aspetto del modello di modulo controllando gli spazi tra entrambi i tipi di testo, è possibile configurare il modello di modulo per regolare automaticamente gli spazi tra questi due tipi di testo. È possibile utilizzare le proprietà AddSpaceBetweenFarEastAndAlpha e AddSpaceBetweenFarEastAndDigit della classe ParagraphFormat per ottenere questo risultato.

Il seguente esempio di codice mostra come utilizzare le proprietà ParagraphFormat.AddSpaceBetweenFarEastAndAlpha e ParagraphFormat.AddSpaceBetweenFarEastAndDigit.

Modifica della spaziatura e dei rientri dei paragrafi asiatici

Nell’esempio di codice seguente viene illustrato come modificare la spaziatura dei paragrafi asiatici e i rientri.

Imposta le opzioni di interruzione linea

La scheda Tipografia asiatica della finestra di dialogo proprietà Paragraph in MS Word ha un gruppo di interruzione di riga. Le opzioni di questo gruppo possono essere impostate usando FarEastLineBreakControl, WordWrap, HangingPunctuation proprietà della classe ParagraphFormat. L’esempio Below code mostra come utilizzare queste proprietà.

Formattazione delle celle

La formattazione delle celle viene utilizzata durante la creazione di una tabella. È rappresentato da un oggetto CellFormat restituito dalla proprietà DocumentBuilder.CellFormat. CellFormat incapsula varie proprietà delle celle della tabella come la larghezza o l’allineamento verticale. L’esempio seguente mostra come creare una tabella che contiene una singola cella formattata.

Formattazione delle righe

La formattazione corrente delle righe è determinata da un oggetto RowFormat restituito dalla proprietà DocumentBuilder.RowFormat. L’oggetto incapsula le informazioni su tutta la formattazione delle righe della tabella. L’esempio seguente mostra come creare una tabella che contiene una singola cella e applicare la formattazione delle righe.

Formattazione elenco

Aspose.Words consente di creare facilmente liste applicando la formattazione delle liste. DocumentBuilder fornisce la proprietà DocumentBuilder.ListFormat che restituisce un oggetto ListFormat. Questo oggetto ha diversi metodi per iniziare e terminare un elenco e per aumentare/diminuire il rientro. Esistono due tipi generali di elenchi in Microsoft Word: puntati e numerati.

Per avviare un elenco puntato, chiamare ListFormat.ApplyBulletDefault.
Per avviare un elenco numerato, chiamare ListFormat.ApplyNumberDefault.

Il punto elenco o il numero e la formattazione vengono aggiunti al paragrafo corrente e a tutti gli altri paragrafi creati utilizzando DocumentBuilder fino a quando ListFormat.RemoveNumbers non viene chiamato per interrompere la formattazione dell’elenco puntato. Nei documenti Word, gli elenchi possono essere composti da un massimo di nove livelli. La formattazione dell’elenco per ogni livello specifica quale punto elenco o numero viene utilizzato, il rientro a sinistra, lo spazio tra il punto elenco e il testo, ecc.

Per aumentare il livello di elenco del paragrafo corrente di un livello, chiamare ListFormat.ListIndent.
Per ridurre il livello di elenco del paragrafo corrente di un livello, chiamare ListFormat.ListOutdent.

I metodi modificano il livello dell’elenco e applicano le proprietà di formattazione del nuovo livello.

È inoltre possibile utilizzare la proprietà ListFormat.ListLevelNumber per ottenere o impostare il livello di elenco per il paragrafo. I livelli della lista sono numerati da 0 a 8.

L’esempio seguente mostra come creare un elenco multilivello.

Impostazione della pagina e formattazione delle sezioni

Le proprietà Configurazione pagina e sezione sono incapsulate nell’oggetto PageSetup restituito dalla proprietà DocumentBuilder.PageSetup. L’oggetto contiene tutti gli attributi di impostazione della pagina di una sezione (margine sinistro, margine inferiore, formato carta e così via) come proprietà. L’esempio seguente mostra come impostare tali proprietà come dimensione della pagina e orientamento per la sezione corrente.

Applicare uno stile

Alcuni oggetti di formattazione come Font o ParagraphFormat supportano gli stili. Un singolo stile incorporato o definito dall’utente è rappresentato da un oggetto Style che contiene le proprietà di stile corrispondenti come nome, stile di base, carattere e formattazione del paragrafo dello stile e così via.

Inoltre, un oggetto Style fornisce la proprietà Style.StyleIdentifier che restituisce un identificatore di stile indipendente dalle impostazioni locali rappresentato da un valore di enumerazione Style.StyleIdentifier. Il punto è che i nomi degli stili incorporati in Microsoft Word sono localizzati per lingue diverse. Utilizzando un identificatore di stile, è possibile trovare lo stile corretto indipendentemente dalla lingua del documento. I valori di enumerazione corrispondono agli stili predefiniti Microsoft Word come Normal, Heading 1, Heading 2 ecc. A tutti gli stili definiti dall’utente viene assegnato StyleIdentifier.User value. L’esempio seguente mostra come applicare uno stile di paragrafo.

Bordi e ombreggiatura

I confini sono rappresentati dal BorderCollection. Si tratta di una raccolta di oggetti di bordo a cui si accede per indice o per tipo di bordo. Il tipo di bordo è rappresentato dall’enumerazione BorderType. Alcuni valori dell’enumerazione sono applicabili a più o solo un elemento del documento. Ad esempio, BorderType.Bottom è applicabile a un paragrafo o a una cella di tabella mentre BorderType.DiagonalDown specifica il bordo diagonale solo in una cella di tabella.

Sia la collezione di bordi che ogni bordo separato hanno attributi simili come colore, stile della linea, larghezza della linea, distanza dal testo e ombra opzionale. Sono rappresentati da proprietà con lo stesso nome. È possibile ottenere diversi tipi di bordi combinando i valori delle proprietà. Inoltre, entrambi gli oggetti BorderCollection e Border consentono di ripristinare questi valori di default chiamando il metodo Border.ClearFormatting. Si noti che quando le proprietà del bordo vengono reimpostate sui valori predefiniti, il bordo è invisibile. La classe Shading contiene attributi di ombreggiatura per gli elementi del documento. È possibile impostare la texture di ombreggiatura desiderata e i colori applicati allo sfondo e al primo piano dell’elemento.

La texture di ombreggiatura è impostata con un valore di enumerazione TextureIndex che consente l’applicazione di vari modelli all’oggetto Shading. Ad esempio, per impostare un colore di sfondo per un elemento documento, utilizzare il valore TextureIndex.TextureSolid e impostare il colore di ombreggiatura in primo piano come appropriato. L’esempio seguente mostra come applicare bordi e ombreggiature a un paragrafo.

Aggancia alla griglia

Aspose.Words fornisce due proprietà ParagraphFormat.SnapToGrid e Font.SnapToGrid per ottenere e impostare la proprietà di paragrafo snap alla griglia.

Spostare il cursore

Rilevamento della posizione corrente del cursore

È possibile ottenere dove il cursore del costruttore è attualmente posizionato in qualsiasi momento. La proprietà DocumentBuilder.CurrentNode restituisce il nodo attualmente selezionato in questo generatore. Il nodo è un figlio diretto di un paragrafo. Qualsiasi operazione di inserimento eseguita utilizzando DocumentBuilder verrà inserita prima di DocumentBuilder.CurrentNode. Quando il paragrafo corrente è vuoto o il cursore è posizionato appena prima della fine del paragrafo, DocumentBuilder.CurrentNode restituisce null.

Inoltre, è possibile utilizzare la proprietà DocumentBuilder.CurrentParagraph, che ottiene il paragrafo attualmente selezionato in questo DocumentBuilder. L’esempio seguente mostra come accedere al nodo corrente in un generatore di documenti. È possibile scaricare il file modello di questo esempio da qui.

Spostamento in qualsiasi nodo (paragrafi e loro figli)

Se si dispone di un nodo oggetto documento, che è un paragrafo o un figlio diretto di un paragrafo, è possibile puntare il cursore del builder a questo nodo. Utilizzare il metodo DocumentBuilder.MoveTo per eseguire questa operazione. L’esempio seguente mostra come spostare una posizione del cursore su un nodo specificato. È possibile scaricare il file modello di questo esempio da qui.

Spostamento al documento Inizio / Fine

Se è necessario spostarsi all’inizio del documento, chiamare DocumentBuilder.MoveToDocumentStart. Se è necessario spostarsi alla fine del documento, chiamare DocumentBuilder.MoveToDocumentEnd. L’esempio seguente mostra come spostare una posizione del cursore all’inizio o alla fine di un documento. È possibile scaricare il file modello di questo esempio da qui.

Spostamento in una sezione

Se si lavora con un documento che contiene più sezioni, è possibile passare a una sezione desiderata utilizzando DocumentBuilder.MoveToSection. Questo metodo sposta il cursore all’inizio di una sezione specificata e accetta l’indice della sezione richiesta. Quando l’indice di sezione è maggiore o uguale a 0, specifica un indice dall’inizio del documento con 0 come prima sezione. Quando l’indice di sezione è inferiore a 0, specifica un indice dalla fine del documento con -1 come ultima sezione. L’esempio seguente mostra come spostare una posizione del cursore nella sezione specificata. È possibile scaricare il file modello di questo esempio da qui.

Spostamento in un’intestazione / piè di pagina

Quando è necessario inserire alcuni dati in un’intestazione o in un piè di pagina, è necessario spostarsi prima usando DocumentBuilder.MoveToHeaderFooter. Il metodo accetta un valore di enumerazione HeaderFooterType che identifica il tipo di intestazione o piè di pagina in cui il cursore deve essere spostato. Se si desidera creare intestazioni e piè di pagina diversi per la prima pagina, è necessario impostare la proprietà PageSetup.DifferentFirstPageHeaderFooter su true. Se si desidera creare intestazioni e piè di pagina diversi per le pagine pari e dispari, è necessario impostare PageSetup.OddAndEvenPagesHeaderFooter su true.

Se devi tornare alla storia principale, usa DocumentBuilder.MoveToSection per uscire dall’intestazione o dal piè di pagina. L’esempio seguente crea intestazioni e piè di pagina in un documento utilizzando DocumentBuilder.

Passare a un paragrafo

Utilizzare DocumentBuilder.MoveToParagraph per spostare il cursore su un paragrafo desiderato nella sezione corrente. Dovresti passare due parametri a questo metodo: paragraphIndex (l’indice del paragrafo in cui passare) e characterIndex (l’indice del carattere all’interno del paragrafo).

La navigazione viene eseguita all’interno della storia corrente della sezione corrente. Cioè, se hai spostato il cursore sull’intestazione primaria della prima sezione, allora paragraphIndex specifica l’indice del paragrafo all’interno di quell’intestazione di quella sezione.

Quando paragraphIndex è maggiore o uguale a 0, specifica un indice dall’inizio della sezione con 0 come primo paragrafo. Quando paragraphIndex è minore di 0, specifica un indice dalla fine della sezione con -1 come ultimo paragrafo.

L’indice dei caratteri può attualmente essere specificato solo come 0 per spostarsi all’inizio del paragrafo o -1 per spostarsi alla fine del paragrafo. L’esempio seguente mostra come spostare una posizione del cursore nel paragrafo specificato. È possibile scaricare il file modello di questo esempio da qui.

Spostamento in una cella tabella

Utilizzare DocumentBuilder.MoveToCell se è necessario spostare il cursore su una cella della tabella nella sezione corrente. Questo metodo accetta quattro parametri:

tableIndex - l’indice della tabella in cui spostarsi.
rowIndex - l’indice della riga nella tabella.
columnIndex - l’indice della colonna nella tabella.
characterIndex - l’indice del carattere all’interno della cella.

La navigazione viene eseguita all’interno della storia corrente della sezione corrente. Per i parametri dell’indice, quando l’indice è maggiore o uguale a 0, specifica un indice dall’inizio con 0 come primo elemento. Quando l’indice è inferiore a 0, specifica un indice dalla fine con -1 come ultimo elemento.

Inoltre, si noti che characterIndex attualmente può specificare solo 0 per spostarsi all’inizio della cella o -1 per spostarsi alla fine della cella. L’esempio seguente mostra come spostare una posizione del cursore nella cella della tabella specificata. È possibile scaricare il file modello di questo esempio da qui.

Spostamento in un segnalibro

I segnalibri vengono utilizzati frequentemente per contrassegnare determinati punti del documento in cui devono essere inseriti nuovi elementi. Per passare a un segnalibro, utilizzare DocumentBuilder.MoveToBookmark. Questo metodo ha due sovraccarichi. Il più semplice non accetta altro che il nome del segnalibro in cui il cursore deve essere spostato. L’esempio seguente mostra come spostare una posizione del cursore su un segnalibro. È possibile scaricare il file modello di questo esempio da qui.

Questo sovraccarico sposta il cursore in una posizione subito dopo l’inizio del segnalibro con il nome specificato. Un altro sovraccarico DocumentBuilder.MoveToBookmark sposta il cursore su un segnalibro con maggiore precisione. Accetta due parametri booleani aggiuntivi:

isStart determina se spostare il cursore all’inizio o alla fine del segnalibro.
isAfter determina se spostare il cursore dopo la posizione iniziale o finale del segnalibro o se spostare il cursore prima della posizione iniziale o finale del segnalibro.

L’esempio seguente mostra come spostare una posizione del cursore subito dopo la fine del segnalibro.

Il confronto per entrambi i metodi non è case-sensitive.

L’inserimento di nuovo testo in questo modo non sostituisce il testo esistente del segnalibro. Si noti che alcuni segnalibri nel documento sono assegnati ai campi modulo. Passando a tale segnalibro e inserendo il testo, il testo viene inserito nel codice del campo del modulo. Anche se questo non invaliderà il campo modulo, il testo inserito non sarà visibile perché diventa parte del codice del campo.

Come convertire tra unità di misura

La maggior parte delle proprietà dell’oggetto fornite nell’API Aspose.Words che rappresentano alcune misurazioni (larghezza/altezza, margini e varie distanze) accetta valori in punti (1 pollice equivale a 72 punti). A volte questo non è conveniente quindi c’è la classe ConvertUtil che fornisce funzioni di supporto per convertire tra varie unità di misura. Consente di convertire pollici in punti, punti in pollici, pixel in punti e punti in pixel. Quando i pixel vengono convertiti in punti e viceversa, può essere eseguita a 96 dpi (punti per pollice) o alla risoluzione dpi specificata. ConvertUtil

Documentation – Panoramica di Document Builder in C++

Cpp: Navigazione con cursore in C++

Rilevamento della posizione corrente del cursore

Metodi di navigazione in un documento

Passare all&rsquo;inizio o alla fine di un documento

Navigare con i segnalibri

Passare alle celle della tabella

Passare a un campo

Passare a un&rsquo;intestazione o piè di pagina

Passare a una sezione o a un paragrafo

Cpp: Utilizzare DocumentBuilder per inserire elementi del documento

Inserimento di una stringa di testo

Inserimento di un paragrafo

Inserimento di una tabella

Avvio di un tavolo

Inserimento di una cella

Fine di una riga

Fine di un tavolo

Inserimento di una pausa

Inserimento di un&rsquo;immagine

Inserimento di un&rsquo;immagine in linea

Inserimento di un&rsquo;immagine fluttuante (assolutamente posizionata)

Inserimento di un segnalibro

Inserimento di un campo <code>Form</code>

Inserimento di un input di testo

Inserimento di una casella di controllo

Inserimento di una casella combinata

Inserimento di locale a livello di campo

Inserimento di un collegamento ipertestuale

Inserimento dell&rsquo;oggetto Ole

Impostare il nome del file e l&rsquo;estensione quando si inserisce l&rsquo;oggetto Ole

Inserimento HTML

Inserire la regola orizzontale nel documento

Cpp: Utilizzo di DocumentBuilder per modificare facilmente un documento

Specificare la formattazione

Formattazione dei caratteri

Formattazione del paragrafo

Lavorare con la tipografia asiatica

Regola automaticamente lo spazio tra testo asiatico e latino, numeri

Modifica della spaziatura e dei rientri dei paragrafi asiatici

Imposta le opzioni di interruzione linea

Formattazione delle celle

Formattazione delle righe

Formattazione elenco

Impostazione della pagina e formattazione delle sezioni

Applicare uno stile

Bordi e ombreggiatura

Aggancia alla griglia

Spostare il cursore

Rilevamento della posizione corrente del cursore

Spostamento in qualsiasi nodo (paragrafi e loro figli)

Spostamento al documento Inizio / Fine

Spostamento in una sezione

Spostamento in un&rsquo;intestazione / piè di pagina

Passare a un paragrafo

Spostamento in una cella tabella

Spostamento in un segnalibro

Come convertire tra unità di misura

Passare all’inizio o alla fine di un documento

Passare a un’intestazione o piè di pagina

Inserimento di un’immagine

Inserimento di un’immagine in linea

Inserimento di un’immagine fluttuante (assolutamente posizionata)

Inserimento dell’oggetto Ole

Impostare il nome del file e l’estensione quando si inserisce l’oggetto Ole

Spostamento in un’intestazione / piè di pagina