MoveToBookmark

MoveToBookmark(string)

Déplace le curseur vers un signet.

public bool MoveToBookmark(string bookmarkName)
ParamètreTaperLa description
bookmarkNameStringLe nom du signet vers lequel déplacer le curseur.

Return_Value

vrai si le signet a été trouvé ;FAUX sinon.

Remarques

Déplace le curseur vers une position juste après le début du signet avec le nom spécifié .

La comparaison n’est pas sensible à la casse. Si le signet n’a pas été trouvé,FAUX is est renvoyé et le curseur n’est pas déplacé.

L’insertion d’un nouveau texte ne remplace pas le texte existant du signet.

Notez que certains signets du document sont affectés à des champs de formulaire. L’insertion de texte dans un tel signet insère ce texte dans le code du champ de formulaire. Bien que cela n’invalide pas le champ de formulaire, le texte inséré ne sera pas visible, car il sera intégré au code du champ.

Exemples

Montre comment déplacer le curseur d’un générateur de documents vers différents nœuds d’un document.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Créer un signet valide, une entité composée de nœuds entourés d'un nœud de départ de signet,
 // et un nœud de fin de signet.
builder.StartBookmark("MyBookmark");
builder.Write("Bookmark contents.");
builder.EndBookmark("MyBookmark");

NodeCollection firstParagraphNodes = doc.FirstSection.Body.FirstParagraph.GetChildNodes(NodeType.Any, false);

Assert.AreEqual(NodeType.BookmarkStart, firstParagraphNodes[0].NodeType);
Assert.AreEqual(NodeType.Run, firstParagraphNodes[1].NodeType);
Assert.AreEqual("Bookmark contents.", firstParagraphNodes[1].GetText().Trim());
Assert.AreEqual(NodeType.BookmarkEnd, firstParagraphNodes[2].NodeType);

// Le curseur du générateur de documents est toujours en avance sur le nœud que nous avons ajouté en dernier avec lui.
// Si le curseur du générateur est à la fin du document, son nœud actuel sera nul.
// Le nœud précédent est le nœud de fin de signet que nous avons ajouté en dernier.
// L'ajout de nouveaux nœuds avec le générateur les ajoutera au dernier nœud.
Assert.Null(builder.CurrentNode);

// Si nous souhaitons éditer une autre partie du document avec le générateur,
// nous devrons amener son curseur sur le nœud que nous souhaitons éditer.
builder.MoveToBookmark("MyBookmark");

// Le déplacer vers un signet le déplacera vers le premier nœud dans les nœuds de début et de fin du signet, l'exécution incluse.
Assert.AreEqual(firstParagraphNodes[1], builder.CurrentNode);

// Nous pouvons également déplacer le curseur vers un nœud individuel comme celui-ci.
builder.MoveTo(doc.FirstSection.Body.FirstParagraph.GetChildNodes(NodeType.Any, false)[0]);

Assert.AreEqual(NodeType.BookmarkStart, builder.CurrentNode.NodeType);
Assert.AreEqual(doc.FirstSection.Body.FirstParagraph, builder.CurrentParagraph);
Assert.IsTrue(builder.IsAtStartOfParagraph);

// Nous pouvons utiliser des méthodes spécifiques pour nous déplacer au début/à la fin d'un document.
builder.MoveToDocumentEnd();

Assert.IsTrue(builder.IsAtEndOfParagraph);

builder.MoveToDocumentStart();

Assert.IsTrue(builder.IsAtStartOfParagraph);

Voir également

MoveToBookmark(string, bool, bool)

Déplace le curseur vers un signet avec une plus grande précision.

public bool MoveToBookmark(string bookmarkName, bool isStart, bool isAfter)
ParamètreTaperLa description
bookmarkNameStringLe nom du signet vers lequel déplacer le curseur.
isStartBooleanQuandvrai , déplace le curseur au début du signet. LorsqueFAUX, déplace le curseur à la fin du signet.
isAfterBooleanQuandvrai , déplace le curseur pour qu’il soit après la position de début ou de fin du signet . LorsqueFAUXdéplace le curseur pour qu’il soit avant la position de début ou de fin du signet .

Return_Value

vrai si le signet a été trouvé ;FAUX sinon.

Remarques

Déplace le curseur vers une position avant ou après le début ou la fin du signet.

Si la position souhaitée n’est pas au niveau de la ligne, passe au paragraphe suivant.

La comparaison n’est pas sensible à la casse. Si le signet n’a pas été trouvé,FAUX is est renvoyé et le curseur n’est pas déplacé.

Exemples

Montre comment déplacer le curseur du point d’insertion du nœud d’un générateur de documents vers un signet.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Un signet valide se compose d'un nœud BookmarkStart, d'un nœud BookmarkEnd avec un
// nom du signet correspondant quelque part par la suite, et contenu entouré par ces nœuds.
builder.StartBookmark("MyBookmark");
builder.Write("Hello world! ");
builder.EndBookmark("MyBookmark");

// Il existe 4 façons de déplacer le curseur d'un générateur de documents vers un signet.
// Si nous sommes entre les nœuds BookmarkStart et BookmarkEnd, le curseur sera à l'intérieur du signet.
// Cela signifie que tout texte ajouté par le constructeur deviendra une partie du signet.
// 1 - En dehors du signet, devant le nœud BookmarkStart :
Assert.True(builder.MoveToBookmark("MyBookmark", true, false));
builder.Write("1. ");

Assert.AreEqual("Hello world! ", doc.Range.Bookmarks["MyBookmark"].Text);
Assert.AreEqual("1. Hello world!", doc.GetText().Trim());

// 2 - À l'intérieur du signet, juste après le nœud BookmarkStart :
Assert.True(builder.MoveToBookmark("MyBookmark", true, true));
builder.Write("2. ");

Assert.AreEqual("2. Hello world! ", doc.Range.Bookmarks["MyBookmark"].Text);
Assert.AreEqual("1. 2. Hello world!", doc.GetText().Trim());

// 2 - À l'intérieur du signet, juste devant le nœud BookmarkEnd :
Assert.True(builder.MoveToBookmark("MyBookmark", false, false));
builder.Write("3. ");

Assert.AreEqual("2. Hello world! 3. ", doc.Range.Bookmarks["MyBookmark"].Text);
Assert.AreEqual("1. 2. Hello world! 3.", doc.GetText().Trim());

// 4 - En dehors du signet, après le nœud BookmarkEnd :
Assert.True(builder.MoveToBookmark("MyBookmark", false, true));
builder.Write("4.");

Assert.AreEqual("2. Hello world! 3. ", doc.Range.Bookmarks["MyBookmark"].Text);
Assert.AreEqual("1. 2. Hello world! 3. 4.", doc.GetText().Trim());

Voir également

DocumentBuilder.MoveTo DocumentBuilder.MoveToCell