Lavorare con Content Control SDT

In Microsoft Word, puoi creare un modulo iniziando con un modello e aggiungendo controlli del contenuto, tra cui caselle di controllo, caselle di testo, selettori di data ed elenchi a discesa. In Aspose.Words, un tag di documento strutturato o un controllo del contenuto da qualsiasi documento caricato in Aspose.Words viene importato come nodo StructuredDocumentTag. I tag di documenti strutturati (SDT o controllo del contenuto) consentono di incorporare in un documento la semantica definita dal cliente, nonché il suo comportamento e il suo aspetto. StructuredDocumentTag può verificarsi in un documento nei seguenti luoghi:

• A livello di blocco - Tra paragrafi e tabelle, come figlio di un nodo Body, HeaderFooter, Comment, Footnote o Shape
• A livello di riga: tra le righe di una tabella, come figlio di un nodo Table
• A livello di cella: tra le celle in una riga di tabella, come figlio di un nodo Row
• Livello in linea: tra i contenuti in linea all’interno, come figlio di un Paragraph
• Nidificato all’interno di un altro StructuredDocumentTag

Inserimento di controlli contenuto in un documento

In questa versione di Aspose.Words è possibile creare i seguenti tipi di SDT o controllo del contenuto:

• Checkbox
• DropDownList
• ComboBox
• Date
• BuildingBlockGallery
• Group
• Picture
• RichText
• PlainText

Nell’esempio di codice seguente viene illustrato come creare un controllo contenuto di tipo casella di controllo.

Nell’esempio di codice seguente viene illustrato come creare un controllo contenuto di tipo casella di testo RTF.

Nell’esempio di codice seguente viene illustrato come creare il controllo contenuto della casella combinata tipo.

Come aggiornare i controlli del contenuto

Questa sezione spiega come aggiornare i valori di SDT o il controllo del contenuto a livello di codice

L’esempio di codice seguente mostra come impostare lo stato corrente della casella di controllo:

Il seguente esempio di codice mostra come modificare i controlli del contenuto di tipo casella di testo semplice, elenco a discesa e immagine:

È possibile scaricare il file di esempio di questi esempi da Aspose.Words GitHub.

Associazione del controllo del contenuto a parti XML personalizzate

È possibile associare i controlli del contenuto ai dati XML (parte XML personalizzata) nei documenti di Word.

L’esempio di codice seguente mostra come associare il controllo del contenuto a parti XML personalizzate:

XMLMapping dell’intervallo di tag del documento strutturato

Puoi ottenere la mappatura di questo intervallo di tag del documento strutturato sui dati XML in una parte XML personalizzata del documento corrente utilizzando la proprietà StructuredDocumentTagRangeStart.xml_mapping. Tuttavia, il metodo set_mapping può essere utilizzato per mappare un intervallo di tag di documento strutturato su dati XML.

L’esempio di codice seguente mostra come impostare la mappatura XML:

Cancella contenuto di un controllo contenuto

È possibile cancellare il contenuto di un controllo contenuto visualizzando un segnaposto. Il metodo StructuredDocumentTag.clear cancella il contenuto di questo tag di documento strutturato e visualizza un segnaposto se è definito. Tuttavia, non è possibile cancellare il contenuto di un controllo contenuto se presenta revisioni. Se un controllo del contenuto non ha segnaposto, vengono inseriti cinque spazi come in MS Word (eccetto sezioni ripetute, elementi di sezione ripetuti, gruppi, caselle di controllo, citazioni). Se un controllo contenuto viene mappato a un codice XML personalizzato, il nodo XML a cui si fa riferimento viene cancellato.

L’esempio di codice seguente mostra come cancellare il contenuto del controllo contenuto:

Modificare i colori dello sfondo e del bordo del controllo contenuto

La proprietà StructuredDocumentTag.color consente di ottenere o impostare il colore del controllo del contenuto. Il colore influisce sul controllo del contenuto in due situazioni:

1. MS Word evidenzia lo sfondo del controllo del contenuto quando il mouse si sposta sul controllo del contenuto. Ciò aiuta a identificare il controllo del contenuto. Il colore dell’evidenziazione è un po' più “morbido” rispetto al color. Ad esempio, MS Word evidenzia lo sfondo con il colore rosa, quando color è rosso.
2. Quando interagisci (modifica, selezione, ecc.) con il controllo del contenuto, il bordo del controllo del contenuto è colorato con il color.

L’esempio di codice seguente mostra come modificare il colore del controllo contenuto:

Come impostare lo stile per formattare il testo digitato nel controllo contenuto

Se desideri impostare lo stile del controllo del contenuto, puoi utilizzare le proprietà StructuredDocumentTag.style o StructuredDocumentTag.style_name. Quando digiti il testo nel controllo del contenuto nel documento di output, il testo digitato avrà lo stile “Citazione”.

Tieni presente che solo gli stili Collegato e Carattere possono essere applicati al controllo del contenuto. Viene generata un’eccezione (“Impossibile applicare questo stile all’SDT”) quando viene applicato uno stile che esiste ma non è collegato o uno stile di carattere.

L’esempio di codice seguente mostra come impostare lo stile del controllo del contenuto:

Lavorare con il controllo del contenuto della sezione ripetuta

Il controllo del contenuto della sezione ripetuta consente di ripetere il contenuto in essa contenuto. Utilizzando Aspose.Words, è possibile creare i nodi dei tag del documento strutturato della sezione ripetuta e dei tipi di elementi della sezione ripetuta e, a questo scopo, il tipo di enumerazione SdtType fornisce la proprietà REPEATING_SECTION_ITEM.

L’esempio di codice seguente mostra come associare un controllo del contenuto della sezione ripetuta a una tabella: