Placeholder

IStructuredDocumentTag.Placeholder property

Ottiene ilBuildingBlock contenente testo segnaposto che dovrebbe essere visualizzato quando il contenuto di questa esecuzione SDT è vuoto, l’elemento XML mappato associato è vuoto come specificato tramiteXmlMapping elemento o ilIsShowingPlaceholderText l’elemento è vero.

public BuildingBlock Placeholder { get; }

Osservazioni

Può essere nullo, il che significa che il segnaposto non è applicabile per questo Sdt.

Esempi

Mostra come utilizzare il contenuto di un blocco di costruzione come testo segnaposto personalizzato per un tag di documento strutturato.

Document doc = new Document();

// Inserire un tag di documento strutturato in testo normale di tipo "PlainText", che funzionerà come una casella di testo.
// Per impostazione predefinita, il contenuto visualizzato è un prompt "Fai clic qui per immettere il testo".
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Inline);

// Possiamo far sì che il tag visualizzi il contenuto di un blocco di costruzione anziché il testo predefinito.
// Per prima cosa, aggiungi un blocco di costruzione con contenuti al documento del glossario.
GlossaryDocument glossaryDoc = doc.GlossaryDocument;

BuildingBlock substituteBlock = new BuildingBlock(glossaryDoc);
substituteBlock.Name = "Custom Placeholder";
substituteBlock.AppendChild(new Section(glossaryDoc));
substituteBlock.FirstSection.AppendChild(new Body(glossaryDoc));
substituteBlock.FirstSection.Body.AppendParagraph("Custom placeholder text.");

glossaryDoc.AppendChild(substituteBlock);

// Quindi, utilizzare la proprietà "PlaceholderName" del tag del documento strutturato per fare riferimento a quel blocco di costruzione tramite il nome.
tag.PlaceholderName = "Custom Placeholder";

// Se "PlaceholderName" fa riferimento a un blocco esistente nel documento glossario del documento padre,
// saremo in grado di verificare il blocco di costruzione tramite la proprietà "Segnaposto".
Assert.AreEqual(substituteBlock, tag.Placeholder);

// Imposta la proprietà "IsShowingPlaceholderText" su "true" per trattare il
// contenuto corrente del tag del documento strutturato come testo segnaposto.
// Ciò significa che cliccando sulla casella di testo in Microsoft Word verrà immediatamente evidenziato tutto il contenuto del tag.
// Imposta la proprietà "IsShowingPlaceholderText" su "false" per ottenere il
// tag del documento strutturato per trattare il suo contenuto come testo già inserito dall'utente.
// Facendo clic su questo testo in Microsoft Word, il cursore lampeggiante verrà posizionato nel punto cliccato.
tag.IsShowingPlaceholderText = isShowingPlaceholderText;

DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertNode(tag);

doc.Save(ArtifactsDir + "StructuredDocumentTag.PlaceholderBuildingBlock.docx");

Guarda anche

IStructuredDocumentTag.Node IStructuredDocumentTag.PlaceholderName