# Bookmark Interface

Visual Studio 2013

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

The Bookmark control is a bookmark that has a unique name, exposes events, and can be bound to data.

Namespace:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

## Syntax

```[GuidAttribute("716bd356-0f64-430b-9ea0-bde2921a0227")]
public interface Bookmark : IBindableComponent,
IComponent, IDisposable, ISupportInitialize
```

The Bookmark type exposes the following members.

## Properties

NameDescription
ApplicationGets an Application that represents the creator of the Bookmark control.
BindingContextGets or sets the collection of currency managers for the IBindableComponent. (Inherited from IBindableComponent.)
BoldGets or sets a value that indicates whether the text in the Bookmark control is formatted as bold.
BoldBiGets or sets a value that indicates whether the text in the Bookmark control is formatted as bold.
BookmarkIDGets the position of the Bookmark control in the document.
BookmarksGets a Microsoft.Office.Interop.Word.Bookmarks collection that represents all the bookmarks inside of the Bookmark control.
BordersGets a Borders collection that represents all the borders for the Bookmark control.
CanEditInfrastructure.
CanPasteInfrastructure.
CaseGets or sets a WdCharacterCase constant that represents the case of the text in the Bookmark control.
CellsGets a Cells collection that represents the table cells in a Bookmark control.
CharactersGets a Characters collection that represents the characters in a Bookmark control.
CharacterStyleGets the style that is used to format one or more characters in the Bookmark.
CharacterWidthGets or sets the character width of the text in the Bookmark control.
ColumnGets a value that indicates whether the Bookmark control is a table column.
ColumnsGets a Columns collection that represents all the table columns in the Bookmark control.
CombineCharactersGets or sets a value that indicates whether the Bookmark control contains combined characters.
ConflictsGets all the co-authoring conflicts in the Bookmark.
ContainerInfrastructure.
ContentControlsGets the content controls that are contained in the Bookmark.
CreatorGets a value that indicates the application in which the Bookmark control was created.
DataBindingsGets the collection of data-binding objects for this IBindableComponent. (Inherited from IBindableComponent.)
DefaultDataSourceUpdateModeGets or sets the default DataSourceUpdateMode for the Bookmark.
DisableCharacterSpaceGridGets or sets a value that indicates whether Microsoft Office Word ignores the number of characters per line for the corresponding Bookmark control.
DocumentGets the Microsoft.Office.Interop.Word.Document associated with the Bookmark control.
DuplicateGets a read-only Range object that represents all the properties of the Bookmark control.
EditorsGets an Editors object that represents all the users authorized to modify a Bookmark control within a document.
EmphasisMarkGets or sets the emphasis mark for a character or designated character string within a Bookmark control.
EmptyGets a value that indicates whether the Bookmark control is empty.
EndGets or sets the ending character position of a Bookmark control.
EndnoteOptionsGets an EndnoteOptions object that represents the endnotes in Bookmark control.
EndnotesGets an Endnotes collection that represents all the endnotes in a Bookmark control.
EnhMetaFileBitsGets a picture representation of how the range of the Bookmark control appears.
FieldsGets a read-only Fields collection that represents all the fields in the Bookmark control.
FindGets a Find object that contains the criteria for a find operation within a Bookmark control.
FitTextWidthGets or sets the width (in the current measurement units) in which Microsoft Office Word fits the text in the Bookmark control.
FontGets or sets a Font object that represents the character formatting of the text assigned to a Bookmark control.
FootnoteOptionsGets a FootnoteOptions object that represents the footnotes in a Bookmark control.
FootnotesGets a Footnotes collection that represents all the footnotes in a Bookmark control.
FormattedTextGets or sets a Range object that includes the formatted text in the Bookmark control.
FormFieldsGets a FormFields collection that represents all the form fields in the Bookmark control.
FramesGets a Frames collection that represents all the frames in a Bookmark control.
GrammarCheckedGets or sets a value that indicates whether a grammar check has been run on the Bookmark control.
GrammaticalErrorsGets a ProofreadingErrors collection that represents the sentences that failed the grammar check on the Bookmark control.
HighlightColorIndexGets or sets the highlight color for the Bookmark control.
HorizontalInVerticalGets or sets the formatting for horizontal text set within vertical text in the Bookmark control.
HTMLDivisionsGets an HTMLDivisions object that represents an HTML division in a Web document.
IDGets or sets the identifying label for the Bookmark control when the current document is saved as a Web page.
InformationGets information about the Bookmark control.
InlineShapesGets an InlineShapes collection that represents all the InlineShape objects in a Bookmark control.
InnerObjectGets the underlying Microsoft.Office.Interop.Word.Bookmark object of the Microsoft.Office.Tools.Word.Bookmark control.
IsEndOfRowMarkGets a value that indicates whether the Bookmark control is collapsed and is located at the end-of-row mark in a table.
ItalicGets or sets a value indicating whether the text in a Bookmark control is formatted as italic.
ItalicBiGets or sets a value that indicates whether the text in the Bookmark control is formatted as italic.
KanaGets or sets a value that indicates whether the specified range of Japanese language text in a Bookmark control is hiragana or katakana.
LanguageDetectedGets or sets a value that indicates whether Microsoft Office Word has detected the language of the text in the Bookmark control.
LanguageIDGets or sets the language for the Bookmark control.
LanguageIDFarEastGets or sets an East Asian language for the Bookmark control.
LanguageIDOtherGets or sets the language for the Bookmark control.
ListFormatGets a ListFormat object that represents all the list formatting characteristics of a Bookmark control.
ListParagraphsGets a ListParagraphs collection that represents all the numbered paragraphs in the Bookmark control.
ListStyleGets the style that is used to format a bulleted list or numbered list in the Bookmark.
LocksGets the co-authoring locks in the Bookmark.
NameGets the name of the Bookmark control.
NextStoryRangeGets a Range object that refers to the next story, as shown in the following table.
NoProofingGets or set a value that indicates whether the spelling and grammar checker ignores the text in the Bookmark control.
OMathsGets the equations that are contained in the Bookmark.
OrientationGets or sets the orientation of text in a Bookmark control when the Text Direction feature is enabled.
PageSetupGets or sets the Microsoft.Office.Interop.Word.PageSetup that is associated with the range of the Bookmark control.
ParagraphFormatGets or sets a Microsoft.Office.Interop.Word.ParagraphFormat object that represents the paragraph settings for the Bookmark control.
ParagraphsGets a Microsoft.Office.Interop.Word.Paragraphs collection that represents all the paragraphs in the Bookmark control.
ParagraphStyleGets the style that is used to format paragraphs in the Bookmark.
ParentGets the parent object of the Bookmark control.
ParentContentControlGets the parent content control for the Bookmark.
PreviousBookmarkIDGets a value that represents the number of the last bookmark that starts before or at the same place as the Bookmark control.
RangeGets a Range object that represents the portion of a document that is contained in the Bookmark control.
RevisionsGets a Revisions collection that represents the tracked changes in the Bookmark control.
RowsGets a Rows collection that represents all the table rows in a Bookmark control.
ScriptsGets a Scripts collection that represents the collection of HTML scripts in the Bookmark control.
SectionsGets a Sections collection that represents the sections in the Bookmark control.
SentencesGets a Sentences collection that represents all the sentences in the Bookmark control.
ShapeRangeGets a ShapeRange collection that represents all the Shape objects in the Bookmark control.
ShowAllGets or sets a value that indicates whether all nonprinting characters (such as hidden text, tab marks, space marks, and paragraph marks) within a Bookmark control are displayed.
SiteGets or sets the ISite associated with the IComponent. (Inherited from IComponent.)
SmartTagsGets a SmartTags object that represents a smart tag in a Bookmark control. This type or member is intended to be used only in projects for the 2007 Microsoft Office system. Smart tags are deprecated in Office 2010.
.
SpellingCheckedGets or sets a value that indicates whether spelling has been checked throughout the Bookmark control.
SpellingErrorsGets a ProofreadingErrors collection that represents the words identified as spelling errors in the Bookmark control.
StartGets or sets the starting character position of a Bookmark control.
StoryLengthGets the number of characters in the story that contains the Bookmark control.
StoryTypeGets the story type for the Bookmark control.
StyleGets or sets the style for the Bookmark control.
SynonymInfoGets a SynonymInfo that contains information from the thesaurus on synonyms, antonyms, or related words and expressions for the text in the Bookmark control.
TablesGets a Tables collection that represents all the tables in the Bookmark control.
TableStyleGets the style that is used to format tables in the Bookmark.
TagInfrastructure.
TextGets or sets the text in the Bookmark control.
TextRetrievalModeGets or sets a TextRetrievalMode object that controls how text is retrieved from the Bookmark control.
TopLevelTablesGets a Tables collection that represents the tables at the outermost nesting level in the range of the Bookmark control.
TwoLinesInOneGets or sets a value that indicates whether Microsoft Office Word sets two lines of text in one and specifies the characters, if any, that enclose the text in a Bookmark control.
UnderlineGets or sets the type of underline applied to the text of the Bookmark control.
WordOpenXMLGets the contents of the Bookmark in the Word Open XML format.
WordsGets a Words collection that represents all the words in a Bookmark control.
XMLGets the XML text in the Bookmark control.
XMLNodesGets an XMLNodes collection that represents the collection of all XML elements within a Bookmark control, including those elements that are only partially within the Bookmark control.
XMLParentNodeGets an Microsoft.Office.Interop.Word.XMLNode object that represents the parent node of a Bookmark control.
Top

## Methods

NameDescription
AutoFormatAutomatically formats a Bookmark control.
BeginInitSignals the object that initialization is starting. (Inherited from ISupportInitialize.)
CalculateCalculates a mathematical expression within a Bookmark control.
CheckGrammarBegins a spelling and grammar check for the Bookmark control.
CheckSpellingBegins a spelling check for the document from the start of the Bookmark control to the end of the document.
CheckSynonymsDisplays the Thesaurus dialog box, which lists alternative word choices, or synonyms, for the text in the Bookmark control.
CollapseCollapses a Bookmark control to the starting or ending position.
ComputeStatisticsGets a statistic based on the contents of the Bookmark control.
ConvertHangulAndHanjaConverts the Bookmark control text from Hangul to Hanja or vice versa.
ConvertToTableConverts text within a Bookmark control to a table.
ConvertToTableOldInfrastructure.
Copy()Creates a new Microsoft.Office.Interop.Word.Bookmark in the same location as the existing Microsoft.Office.Tools.Word.Bookmark control.
Copy(String)Creates a new Microsoft.Office.Interop.Word.Bookmark with the specified Name argument in the same location as the existing Microsoft.Office.Tools.Word.Bookmark control.
CopyAsPictureThe CopyAsPicture method copies the contents of the Bookmark control to the Clipboard.
CreatePublisherInfrastructure.
CutRemoves the contents of the Bookmark control from the document and places it in the Clipboard.
DeleteDeletes a dynamically created Bookmark from the document and removes it from the ControlCollection.
DetectLanguageAnalyzes the text of the Bookmark control to determine the language that it is written in.
DisposePerforms application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. (Inherited from IDisposable.)
EndInitSignals the object that initialization is complete. (Inherited from ISupportInitialize.)
EndOfMoves or extends the ending character position of a Bookmark control to the end of the nearest text unit.
ExpandExpands the Bookmark control.
ExportAsFixedFormatSaves the Bookmark in PDF or XPS format.
ExportFragmentExports the Bookmark to a document for use as a document fragment.
get_InformationInfrastructure. Use the Information property instead of this method.
get_XMLInfrastructure. Use the XML property instead of this method.
GetSpellingSuggestionsGets a SpellingSuggestions collection that represents the words suggested as spelling replacements for the first word in the Bookmark control.
GoToGets a Range object that represents the start position of an item within the Bookmark control.
GoToEditableRangeGets a Range object that represents an area of a Bookmark control that can be modified by the user or group of users.
GoToNextGets a Range object that refers to the start position of the next item or location within the Bookmark control specified by the What argument.
GoToPreviousGets a Range object that refers to the start position of the previous item or location in the Bookmark control specified by the What argument.
ImportFragmentImports a document fragment into the Bookmark.
InRangeDetermines if the Range to which the method is applied is contained in the Bookmark control.
InsertAfterInserts the specified text at the end of a Bookmark control.
InsertAlignmentTabInserts an absolute tab in the Bookmark that is always positioned in the same spot, relative to either the margins or indents.
InsertAutoTextAttempts to match the text in the Bookmark control with an existing AutoText entry name.
InsertBeforeInserts the specified text before the Bookmark control.
InsertBreakInserts a page, column, or section break into the Bookmark control.
InsertCaptionInserts a caption immediately preceding or following the Bookmark control.
InsertCaptionXPInfrastructure.
InsertCrossReferenceInserts a cross-reference to a heading, bookmark, footnote, or endnote, or to an item for which a caption label is defined (for example, an equation, figure, or table) into a Bookmark control.
InsertCrossReference_2002Infrastructure.
InsertDatabaseRetrieves data from a data source (for example, a separate Microsoft Office Word document, a Microsoft Office Excel worksheet, or a Microsoft Access database) and inserts the data as a table in place of the Bookmark control.
InsertDateTimeInserts the current date or time, or both, either as text or as a TIME field in the Bookmark control.
InsertDateTimeOldInfrastructure.
InsertFileInserts all or part of the specified file into the Bookmark control.
InsertParagraphReplaces the Bookmark control with a new paragraph.
InsertParagraphAfterInserts a paragraph mark after a Bookmark control.
InsertParagraphBeforeInserts a new paragraph before the Bookmark control.
InsertSymbolInserts a symbol in place of the Bookmark control.
InsertXMLInserts the specified XML text into the Bookmark control.
InStoryDetermines if the Bookmark control to which this method is applied is in the same story as the range specified by the Range argument.
IsEqualDetermines if the Bookmark control to which this method is applied is equal to the range specified by the Range argument.
LookupNamePropertiesLooks up a name in the global address book list and displays the Properties dialog box, which includes information about the specified name of the Bookmark control.
ModifyEnclosureAdds, modifies, or removes an enclosure around the specified character or characters in the Bookmark control.
MoveInfrastructure.
MoveEndMoves the ending character position of a Bookmark control.
MoveEndUntilMoves the end position of the Bookmark control until any of the specified characters are found in the document.
MoveEndWhileMoves the ending character position of a Bookmark control while any of the specified characters are found in the document.
MoveStartMoves the start position of the Bookmark control.
MoveStartUntilMoves the start position of the Bookmark control until one of the specified characters is found in the document.
MoveStartWhileMoves the start position of the Bookmark control while any of the specified characters are found in the document.
MoveUntilMoves the Bookmark control until one of the specified characters is found in the document.
MoveWhileMoves the Bookmark control while any of the specified characters are found in the document.
NextGets a Range object that represents the specified unit relative to the Bookmark control.
PasteInserts the contents of the Clipboard into the Bookmark control.
PasteAndFormatPastes the selected table cells into the Bookmark control and formats them as specified.
PasteAppendTableMerges pasted cells into an existing table in a Bookmark control by inserting the pasted rows between the selected rows.
PasteAsNestedTablePastes a cell or group of cells as a nested table into the Bookmark control.
PasteExcelTablePastes and formats a Microsoft Office Excel table into the Bookmark control.
PasteSpecialInserts the contents of the Clipboard into the Bookmark control.
PhoneticGuideAdds phonetic guides to the Bookmark control.
PreviousGets a Range object relative to the Bookmark control.
RelocateIn outline view, moves the paragraphs within the Bookmark control after the next visible paragraph or before the previous visible paragraph.
SelectSelects the Bookmark control.
SetListLevelSets the list level for one or more items in a numbered list in the Bookmark.
SetRangeSets the starting and ending character positions for the Bookmark control.
SortSorts the paragraphs in the Bookmark control.
SortAscendingSorts paragraphs or table rows in ascending alphanumeric order within a Bookmark control.
SortDescendingSorts paragraphs or table rows in descending alphanumeric order within a Bookmark control.
SortOldInfrastructure.
StartOfMoves or extends the start position of the Bookmark control to the beginning of the nearest specified text unit.
SubscribeToInfrastructure.
TCSCConverterConverts the specified range of a Bookmark control from Traditional Chinese to Simplified Chinese or vice versa.
WholeStoryExpands a Bookmark control to include the entire story.
Top

## Events

NameDescription
BeforeDoubleClickOccurs when a Bookmark control is double-clicked, before the default double-click action.
BeforeRightClickOccurs when a Bookmark control is right-clicked, before the default right-click action.
BindingContextChangedOccurs when the value of the BindingContext property of the Bookmark changes.
DeselectedOccurs when selection moves from the Bookmark control to an area outside of the Bookmark control.
DisposedRepresents the method that handles the Disposed event of a component. (Inherited from IComponent.)
SelectedOccurs when the Bookmark control is selected.
SelectionChangeOccurs when the selection inside the Bookmark control changes.
Top

## Remarks

Use the AddBookmark method to add a bookmark to a document range.

Note

This interface is implemented by the Visual Studio Tools for Office runtime. It is not intended to be implemented in your code. For more information, see Visual Studio Tools for Office Runtime Overview.

### Usage

This documentation describes the version of this type that is used in Office projects that target the .NET Framework 4 and the .NET Framework 4.5. In projects that target the .NET Framework 3.5, this type might have different members and the code examples provided for this type might not work. For documentation about this type in projects that target the .NET Framework 3.5, see the following reference section in the Visual Studio 2008 documentation: http://go.microsoft.com/fwlink/?LinkId=160658.