MoveToBookmark

MoveToBookmark(string)

Flyttar markören till ett bokmärke.

public bool MoveToBookmark(string bookmarkName)
ParameterTypBeskrivning
bookmarkNameStringNamnet på bokmärket att flytta markören till.

Returvärde

Sann om bokmärket hittades;falsk annat.

Anmärkningar

Flyttar markören till en position precis efter början av bokmärket med det angivna namnet .

Jämförelsen är inte skiftlägeskänslig. Om bokmärket inte hittades,falsk is returneras och markören flyttas inte.

Att infoga ny text ersätter inte befintlig text i bokmärket.

Observera att vissa bokmärken i dokumentet är tilldelade formulärfält. Om du flyttar till ett sådant bokmärke och infogar text där infogas texten i formulärfältskoden . Även om detta inte gör formulärfältet ogiltigt, kommer texten inserted inte att vara synlig eftersom den blir en del av fältkoden.

Exempel

Visar hur man flyttar en dokumentbyggares markör till olika noder i ett dokument.

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

// Skapa ett giltigt bokmärke, en enhet som består av noder som omges av en bokmärkesstartnod,
 // och en bokmärkesslutnod.
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);

// Dokumentbyggarens markör är alltid före den nod som vi senast lade till med den.
// Om byggarens markör är i slutet av dokumentet kommer dess nuvarande nod att vara null.
// Den föregående noden är bokmärkets slutnod som vi senast lade till.
// Lägga till nya noder med byggaren kommer att lägga till dem till den sista noden.
Assert.Null(builder.CurrentNode);

// Om vi vill redigera en annan del av dokumentet med byggaren,
// vi måste föra dess markör till den nod vi vill redigera.
builder.MoveToBookmark("MyBookmark");

// Om du flyttar den till ett bokmärke flyttas den till den första noden inom bokmärkets start- och slutnod, den bifogade körningen.
Assert.AreEqual(firstParagraphNodes[1], builder.CurrentNode);

// Vi kan också flytta markören till en enskild nod så här.
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);

// Vi kan använda specifika metoder för att flytta till början/slutet av ett dokument.
builder.MoveToDocumentEnd();

Assert.IsTrue(builder.IsAtEndOfParagraph);

builder.MoveToDocumentStart();

Assert.IsTrue(builder.IsAtStartOfParagraph);

Se även

MoveToBookmark(string, bool, bool)

Flyttar markören till ett bokmärke med större precision.

public bool MoveToBookmark(string bookmarkName, bool isStart, bool isAfter)
ParameterTypBeskrivning
bookmarkNameStringNamnet på bokmärket att flytta markören till.
isStartBooleanNärSann , flyttar markören till början av bokmärket. Whenfalsk, flyttar markören till slutet av bokmärket.
isAfterBooleanNärSann , flyttar markören efter start- eller slutpositionen för bokmärke . Närfalsk, flyttar markören till att vara före start- eller slutpositionen för bokmärke .

Returvärde

Sann om bokmärket hittades;falsk annat.

Anmärkningar

Flyttar markören till en position före eller efter bokmärkets start eller slut.

Om önskad position inte är på inline-nivå, går du till nästa stycke.

Jämförelsen är inte skiftlägeskänslig. Om bokmärket inte hittades,falsk is returneras och markören flyttas inte.

Exempel

Visar hur man flyttar markören för en dokumentbyggares nodinsättningspunkt till ett bokmärke.

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

// Ett giltigt bokmärke består av en BookmarkStart-nod, en BookmarkEnd-nod med en
// matchande bokmärkesnamn någonstans efteråt, och innehåll som omges av dessa noder.
builder.StartBookmark("MyBookmark");
builder.Write("Hello world! ");
builder.EndBookmark("MyBookmark");

// Det finns fyra sätt att flytta en dokumentbyggares markör till ett bokmärke.
// Om vi är mellan noderna BookmarkStart och BookmarkEnd, kommer markören att vara inuti bokmärket.
// Detta betyder att all text som läggs till av byggaren kommer att bli en del av bokmärket.
// 1 - Utanför bokmärket, framför BookmarkStart-noden:
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 - Inuti bokmärket, precis efter BookmarkStart-noden:
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 - Inuti bokmärket, precis framför BookmarkEnd-noden:
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 - Utanför bokmärket, efter noden 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());

Se även

DocumentBuilder.MoveTo DocumentBuilder.MoveToCell