Id

StructuredDocumentTag.Id property

Especifica una identificación numérica persistente única de solo lectura para estoTED.

public int Id { get; }

Observaciones

El atributo de identificación deberá seguir estas reglas:

  • El documento conservará los identificadores de SDT solo si se clona todo el documento.Clone.
  • DuranteImportNode El ID se conservará si la importación no causa conflictos con otros ID de SDT en el documento de destino.
  • Si varios nodos SDT especifican el mismo valor numérico decimal para el atributo Id, , entonces el primer SDT del documento mantendrá este Id. original, y todos los nodos SDT posteriores tendrán nuevos identificadores asignados cuando se cargue el documento.
  • Durante la SDT independienteINodeCloningListener) operación se generará una nueva ID única para el nodo SDT clonado.
  • Si no se especifica Id en el documento fuente, entonces el nodo SDT tendrá asignado un nuevo identificador único cuando se cargue el documento.

Ejemplos

Muestra cómo crear una etiqueta de documento estructurado en un cuadro de texto sin formato y modificar su apariencia.

Document doc = new Document();

// Crea una etiqueta de documento estructurado que contendrá texto sin formato.
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Inline);

// Establece el título y el color del marco que aparece cuando pasas el mouse sobre la etiqueta del documento estructurado en Microsoft Word.
tag.Title = "My plain text";
tag.Color = Color.Magenta;

// Establece una etiqueta para esta etiqueta de documento estructurado, que se puede obtener
// como un elemento XML denominado "etiqueta", con la cadena siguiente en su atributo "@val".
tag.Tag = "MyPlainTextSDT";

// Cada etiqueta de documento estructurado tiene una identificación única aleatoria.
Assert.That(tag.Id, Is.Positive);

// Establece la fuente para el texto dentro de la etiqueta del documento estructurado.
tag.ContentsFont.Name = "Arial";

// Establece la fuente para el texto al final de la etiqueta del documento estructurado.
// Cualquier texto que escribamos en el cuerpo del documento después de salir de la etiqueta con las teclas de flecha utilizará esta fuente.
tag.EndCharacterFont.Name = "Arial Black";

// De forma predeterminada, esto es falso y presionar Intro mientras se encuentra dentro de una etiqueta de documento estructurado no hace nada.
// Cuando se establece en verdadero, nuestra etiqueta de documento estructurado puede tener varias líneas.

// Establece la propiedad "Multilínea" en "falso" para permitir solo el contenido
// de esta etiqueta de documento estructurado para abarcar una sola línea.
// Establece la propiedad "Multiline" en "true" para permitir que la etiqueta contenga varias líneas de contenido.
tag.Multiline = true;

// Establece la propiedad "Apariencia" en "SdtAppearance.Tags" para mostrar etiquetas alrededor del contenido.
 // De forma predeterminada, la etiqueta del documento estructurado se muestra como BoundingBox.
tag.Appearance = SdtAppearance.Tags;

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

// Inserta un clon de nuestra etiqueta de documento estructurado en un nuevo párrafo.
StructuredDocumentTag tagClone = (StructuredDocumentTag)tag.Clone(true);
builder.InsertParagraph();
builder.InsertNode(tagClone);

// Utilice el método "RemoveSelfOnly" para eliminar una etiqueta de documento estructurado, manteniendo su contenido en el documento.
tagClone.RemoveSelfOnly();

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

Ver también

StructuredDocumentTag.FullDate StructuredDocumentTag.IsShowingPlaceholderText