MoveToStructuredDocumentTag

MoveToStructuredDocumentTag(int, int)

Déplace le curseur vers une balise de document structuré dans la section actuelle.

public void MoveToStructuredDocumentTag(int structuredDocumentTagIndex, int characterIndex)
ParamètreTaperLa description
structuredDocumentTagIndexInt32L’index de la balise du document structuré vers laquelle se déplacer.
characterIndexInt32L’index du caractère à l’intérieur de la balise du document structuré. Une valeur négative permet de spécifier une position à partir de la fin de la balise du document structuré. Utilisez -1 pour déplacer vers la fin de la balise du document structuré. Si la balise du document structuré est au niveau du bloc et que vous souhaitez déplacer le curseur à la fin de son dernier paragraphe, précisez -2.

Remarques

La navigation s’effectue à l’intérieur de l’histoire en cours de la section en cours. Autrement dit, si vous avez déplacé le curseur vers l’en-tête principal de la première section, alorsstructuredDocumentTagIndex a spécifié l’index de la balise du document structuré à l’intérieur de cet en-tête de cette section.

QuandstructuredDocumentTagIndex est supérieur ou égal à 0, il spécifie un index dès le début de la section, 0 étant la première balise du document structuré. Quand structuredDocumentTagIndex est inférieur à 0, il a spécifié un index à partir de la fin de la section , -1 étant la dernière balise du document structuré.

Exemples

Montre comment déplacer le curseur de DocumentBuilder à l’intérieur d’une balise de document structuré.

Document doc = new Document(MyDir + "Structured document tags.docx");
DocumentBuilder builder = new DocumentBuilder(doc);

// Il existe plusieurs manières de déplacer le curseur :
// 1 - Passer au premier caractère de la balise du document structuré par index.
builder.MoveToStructuredDocumentTag(1, 1);

// 2 - Passer au premier caractère de la balise du document structuré par objet.
StructuredDocumentTag tag = (StructuredDocumentTag)doc.GetChild(NodeType.StructuredDocumentTag, 2, true);
builder.MoveToStructuredDocumentTag(tag, 1);
builder.Write(" New text.");

Assert.AreEqual("R New text.ichText", tag.GetText().Trim());

// 3 - Passer à la fin de la deuxième balise du document structuré.
builder.MoveToStructuredDocumentTag(1, -1);
Assert.True(builder.IsAtEndOfStructuredDocumentTag);            

// Récupère la balise du document structuré actuellement sélectionné.
builder.CurrentStructuredDocumentTag.Color = Color.Green;

doc.Save(ArtifactsDir + "Document.MoveToStructuredDocumentTag.docx");

Voir également


MoveToStructuredDocumentTag(StructuredDocumentTag, int)

Déplace le curseur vers la balise du document structuré.

public void MoveToStructuredDocumentTag(StructuredDocumentTag structuredDocumentTag, 
    int characterIndex)
ParamètreTaperLa description
structuredDocumentTagStructuredDocumentTagBalise du document structuré vers laquelle se déplacer.
characterIndexInt32L’index du caractère à l’intérieur de la balise du document structuré. Une valeur négative permet de spécifier une position à partir de la fin de la balise du document structuré. Utilisez -1 pour déplacer vers la fin de la balise du document structuré. Si la balise du document structuré est au niveau du bloc et que vous souhaitez déplacer le curseur à la fin de son dernier paragraphe, précisez -2.

Exemples

Montre comment déplacer le curseur de DocumentBuilder à l’intérieur d’une balise de document structuré.

Document doc = new Document(MyDir + "Structured document tags.docx");
DocumentBuilder builder = new DocumentBuilder(doc);

// Il existe plusieurs manières de déplacer le curseur :
// 1 - Passer au premier caractère de la balise du document structuré par index.
builder.MoveToStructuredDocumentTag(1, 1);

// 2 - Passer au premier caractère de la balise du document structuré par objet.
StructuredDocumentTag tag = (StructuredDocumentTag)doc.GetChild(NodeType.StructuredDocumentTag, 2, true);
builder.MoveToStructuredDocumentTag(tag, 1);
builder.Write(" New text.");

Assert.AreEqual("R New text.ichText", tag.GetText().Trim());

// 3 - Passer à la fin de la deuxième balise du document structuré.
builder.MoveToStructuredDocumentTag(1, -1);
Assert.True(builder.IsAtEndOfStructuredDocumentTag);            

// Récupère la balise du document structuré actuellement sélectionné.
builder.CurrentStructuredDocumentTag.Color = Color.Green;

doc.Save(ArtifactsDir + "Document.MoveToStructuredDocumentTag.docx");

Voir également