WD98: How to Use Built-in (or Predefined) Bookmarks in VBALast reviewed: March 17, 1998Article ID: Q182586 |
The information in this article applies to:
SUMMARYThis article discusses "built-in" or predefined bookmarks you can use to go to a location in a document.
MORE INFORMATIONMicrosoft provides programming examples for illustration only, without warranty either expressed or implied, including, but not limited to, the implied warranties of merchantability and/or fitness for a particular purpose. This article assumes that you are familiar with the programming language being demonstrated and the tools used to create and debug procedures. Microsoft support engineers can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific needs. If you have limited programming experience, you may want to contact the Microsoft fee-based consulting line at (800) 936-5200. For more information about the support options available from Microsoft, please see the following page on the World Wide Web:
http://www.microsoft.com/support/supportnet/refguide/default.aspWord sets, and automatically updates, a number of reserved bookmarks. You can use these predefined bookmarks just as you use the ones that you place in documents, except that you do not have to set them and they are not listed on the Go To tab in the Find And Replace dialog box (Edit menu). NOTE: Predefined Bookmarks cannot be used while your insertion point is within a header, footer, comment or footnote. If your macro attempts to access a predefined bookmark while the insertion point is anywhere other than the main body of a document, the following error message will appear:
Run-time error '5941': The requested member of the collection does not exist.You can use predefined bookmarks with the Bookmarks property. The following example sets the bookmark named "currpara" to the location marked by the predefined bookmark named "\Para."
ActiveDocument.Bookmarks("\Para").Copy "currpara"
The following example moves the insertion point to the end of the document
using the predefined bookmark "\EndOfDoc":
Selection.GoTo What:=wdGoToBookmark, Name:="\endofdoc"The following table describes the predefined bookmarks available in Word.
Bookmark Description
--------------------------------------------------------------------------
\Sel Current selection or the insertion point.
\PrevSel1 Most recent selection where editing occurred; going to
this bookmark is equivalent to running the GoBack method
once.
\PrevSel2 Second most recent selection where editing occurred;
going to this bookmark is equivalent to running the
GoBack method twice.
\StartOfSel Start of the current selection.
\EndOfSel End of the current selection.
\Line Current line or the first line of the current selection.
If the insertion point is at the end of a line that is
not the last line in the paragraph, the bookmark includes
the entire next line.
\Char Current character, which is the character following the
insertion point if there is no selection, or the first
character of the selection.
\Para Current paragraph, which is the paragraph that contains
the insertion point or, if more than one paragraph is
selected, the first paragraph of the selection. Note that
if the insertion point or selection is in the last
paragraph of the document, the "\Para" bookmark does not
include the paragraph mark.
\Section Current section, including the break at the end of the
section, if any. The current section contains the
insertion point or selection. If the selection contains
more than one section, the "\Section" bookmark is the
first section in the selection.
\Doc Entire contents of the active document, with the
exception of the final paragraph mark.
\Page Current page, including the break at the end of the page,
if any. The current page contains the insertion point. If
the current selection contains more than one page, the
"\Page" bookmark is the first page of the selection. Note
that if the insertion point or selection is in the last
page of the document, the "\Page" bookmark does not
include the final paragraph mark.
\StartOfDoc Beginning of the document.
\EndOfDoc End of the document.
\Cell Current cell in a table, which is the cell that contains
the insertion point. If one or more cells of a table are
included in the current selection, the "\Cell" bookmark
is the first cell in the selection.
\Table Current table, which is the table that contains the
insertion point or selection. If the selection includes
more than one table, the "\Table" bookmark is the entire
first table of the selection, even if the entire table is
not selected.
\HeadingLevel The heading that contains the insertion point or
selection, plus any subordinate headings and text. If the
current selection is body text, the "\HeadingLevel"
bookmark includes the preceding heading, plus any
headings and text subordinate to that heading.
For more information about predefined bookmarks, click the Office Assistant
while in the Visual Basic Editor, type "predefined bookmarks," click
Search, and then click to view "Predefined Bookmarks."
NOTE: If the Assistant is hidden, click the Office Assistant button on the Standard toolbar. If the Assistant is not able to answer your query, please see the following article in the Microsoft Knowledge Base:
ARTICLE-ID: Q176476 TITLE : OFF: Office Assistant Not Answering Visual Basic QuestionsFor additional information, please see the following article in the Microsoft Knowledge Base:
ARTICLE-ID: Q181058 TITLE : OFF98: How to Run Sample Code from Knowledge Base Articles REFERENCESFor more information about getting help with Visual Basic for Applications, please see the following article in the Microsoft Knowledge Base:
ARTICLE-ID: Q163435 TITLE : VBA: Programming Resources for Visual Basic for Applications |
Additional query words: vb vba vbe
© 1998 Microsoft Corporation. All rights reserved. Terms of Use. |