How to: Resize Bookmark Controls

You set the size of a Bookmark control when you add it to a Microsoft Office Word document. You can also resize it at a later time.

Applies to: The information in this topic applies to document-level projects and application-level projects for Word 2007 and Word 2010. For more information, see Features Available by Office Application and Project Type.

There are three ways to resize a bookmark:

• Add or remove text in the Bookmark control.

  Whenever you add text in a bookmark, the size of the bookmark automatically increases to contain the new text. When you delete text, the size of the bookmark automatically decreases.

• Change the Start and End properties of the Bookmark control.

  This is useful if you are changing the size by only a few characters.

• Recreate the Bookmark control.

  This is useful if there is a substantial change in the size or location of a bookmark.

In document-level projects, you can add Bookmark controls to the document in your project at design time or at run time. In application-level projects, you can add Bookmark controls to any open document at run time. For more information, see How to: Add Bookmark Controls to Word Documents.

Note

Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. The Visual Studio edition that you have and the settings that you use determine these elements. For more information, see Visual Studio Settings.

Changing the Start and End Properties

To resize a bookmark in a document-level project at design time

1. Select the bookmark in the Properties window.

2. Increase or decrease the value of the Start property.

3. Increase or decrease the value of the End property.

To resize a bookmark in a document-level project at run time

• Modify the Start and End properties of a Bookmark you created at run time or at design time.

  The following code example adds five characters to the start of a bookmark named SampleBookmark. This code assumes that there are at least five characters of text before the bookmark.

  Me.SampleBookmark.Start = Me.SampleBookmark.Start - 5
  

  this.SampleBookmark.Start = this.SampleBookmark.Start - 5;
  

  The following code example adds five characters to the end of the same bookmark. This code assumes that there are at least five characters of text after the bookmark.

  Me.SampleBookmark.End = Me.SampleBookmark.End + 5
  

  this.SampleBookmark.End = this.SampleBookmark.End + 5;
  

To resize a bookmark in an application-level project at run time

• Modify the Start and End properties of a Bookmark you created at run time.

  The following code example creates a Bookmark that contains the text in the first paragraph of the active document, and then removes five characters from the start and end of the Bookmark.

  ' Use the following line of code in projects that target the .NET Framework 4.
  Dim VstoDocument As Microsoft.Office.Tools.Word.Document = _
      Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
  
  ' In projects that target the .NET Framework 3.5, use the following line of code.
  ' Dim vstoDocument As Microsoft.Office.Tools.Word.Document = _
  '     Me.Application.ActiveDocument.GetVstoObject()
  
  vstoDocument.ActiveWindow.View.ShowBookmarks = True
  vstoDocument.Paragraphs(1).Range.InsertParagraphBefore()
  
  Dim firstParagraph As Word.Range = vstoDocument.Paragraphs(1).Range
  firstParagraph.Text = "123456789abcdefghijklmnopqrstuvwxyz"
  
  Dim sampleBookmark As Microsoft.Office.Tools.Word.Bookmark = _
      vstoDocument.Controls.AddBookmark(firstParagraph, "bookmark1")
  sampleBookmark.Start = sampleBookmark.Start + 5
  sampleBookmark.End = sampleBookmark.End - 5
  

  // Use the following line of code in projects that target the .NET Framework 4.
  Microsoft.Office.Tools.Word.Document vstoDocument =
      Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
  
  // In projects that target the .NET Framework 3.5, use the following line of code.
  // Microsoft.Office.Tools.Word.Document vstoDocument = 
  //     this.Application.ActiveDocument.GetVstoObject();
  
  vstoDocument.ActiveWindow.View.ShowBookmarks = true;
  vstoDocument.Paragraphs[1].Range.InsertParagraphBefore();
  
  Word.Range firstParagraph = vstoDocument.Paragraphs[1].Range;
  firstParagraph.Text = "123456789abcdefghijklmnopqrstuvwxyz";
  
  Microsoft.Office.Tools.Word.Bookmark sampleBookmark =
      vstoDocument.Controls.AddBookmark(firstParagraph, "bookmark1");
  sampleBookmark.Start = sampleBookmark.Start + 5;
  sampleBookmark.End = sampleBookmark.End - 5;
  

Recreating the Bookmark

You can resize a bookmark in a document-level project by adding a new bookmark that has the same name as the existing bookmark, but that has a different size.

To recreate a bookmark in a document-level project at design time

1. Select the text to be included in the new Bookmark control.

2. On the Insert menu, click Bookmark.

3. In the Bookmark dialog box, select the name of the bookmark that you want to resize and click Add.

See Also

Tasks

How to: Add Bookmark Controls to Word Documents

How to: Resize NamedRange Controls

How to: Resize ListObject Controls

Concepts

Automating Word by Using Extended Objects

Host Items and Host Controls Overview

Programmatic Limitations of Host Items and Host Controls