How to: Resize Bookmark Controls

How to: Resize Bookmark Controls

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

Microsoft Visual Studio Tools for the Microsoft Office system (version 3.0)

How to: Resize Bookmark Controls

Updated: July 2008

Applies to
The information in this topic applies only to the specified Visual Studio Tools for Office projects and versions of Microsoft Office. Document-level projects Word 2003 Word 2007 Application-level projects Word 2007 For more information, see Features Available by Application and Project Type.

Applies to

The information in this topic applies only to the specified Visual Studio Tools for Office projects and versions of Microsoft Office.

Document-level projects

Word 2003
Word 2007

Application-level projects

Word 2007

For more information, see Features Available by Application and Project Type.

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.

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. Starting in Visual Studio 2008 Service Pack 1 (SP1), you can add Bookmark controls to any open document at run time by using an application-level add-in for Word 2007. 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

Select the bookmark in the Properties window.
Increase or decrease the value of the Start property.
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.
Visual Basic
```
Me.SampleBookmark.Start = Me.SampleBookmark.Start - 5
```
C#
```
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.
Visual Basic
```
Me.SampleBookmark.End = Me.SampleBookmark.End + 5
```
C#
```
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.

Visual Basic

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

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

Select the text to be included in the new Bookmark control.
On the Insert menu, click Bookmark.
In the Bookmark dialog box, select the name of the bookmark that you want to resize and click Add.

Change History

Date	History	Reason
July 2008	Added new procedures for application-level add-ins.	SP1 feature change.

Date

History

Reason

July 2008

Added new procedures for application-level add-ins.

SP1 feature change.

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

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

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

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

Tasks

Concepts

Other Resources