Add Method (TablesOfAuthorities Collection)
Applies To
TablesOfAuthorities collection object.
Description
Adds a table of authorities to a document.
Syntax
expression.Add(Range, Category, Bookmark, Passim, KeepEntryFormatting,
ú Separator, IncludeSequenceName, EntrySeparator, PageRangeSeparator,
ú IncludeCategoryHeader, PageNumberSeparator)
expression Required. An expression that returns a TablesOfAuthorities object.
Range Required Range. The range where you want the table of authorities to appear. The table of authorities replaces the range, if the range isn't collapsed.
Category Optional Variant. The category of entries you want to include in the table of authorities. Corresponds to the \c switch for a TOA (Table of Authorities) field. Values 0 through 16 correspond to the items listed in the Category box on the Table of Authorities tab in the Index and Tables dialog box (Insert menu). The default value is 1.
Bookmark Optional Variant. The string name of the bookmark from which you want to collect entries for the table of authorities. If Bookmark is specified, the entries are collected only from the portion of the document marked by the bookmark. Corresponds to the \b switch for a TOA (Table of Authorities) field.
Passim Optional Variant. True to replace five or more page references to the same authority with "Passim" in the table of authorities. Corresponds to the \p switch for a TOA (Table of Authorities) field. If this argument is omitted, Passim is assumed to be False.
KeepEntryFormatting Optional Variant. True to apply formatting from table of authorities entries to the entries in the table of authorities. Corresponds to the \f switch for a TOA (Table of Authorities) field. If this argument is omitted, KeepEntryFormatting is assumed to be True.
Separator Optional Variant. The characters (up to five) between each sequence number and its page number in the table of authorities. Corresponds to the \d switch for a TOA (Table of Authorities) field. If argument is omitted, a hyphen (-) is used.
IncludeSequenceName Optional Variant. A string that specifies the SEQ (Sequence) field identifier for the table of authorities. Corresponds to the \s switch for a TOA (Table of Authorities) field.
EntrySeparator Optional Variant. The characters (up to five) that separate each entry and its page number in the table of authorities. Corresponds to the \e switch for a TOA (Table of Authorities) field. If this argument is omitted, no separator is used.
PageRangeSeparator Optional Variant. The characters (up to five) that separate the beginning and ending page numbers in each page range the table of authorities. Corresponds to the \g switch for a TOA (Table of Authorities) field. If this argument is omitted, an en dash is used.
IncludeCategoryHeader Optional Variant. True to have the category name for each group of entries appear in the table of authorities (for example, Cases). Corresponds to the \h switch for a TOA (Table of Authorities) field. If this argument is omitted, IncludeCategoryHeader is assumed to be True.
PageNumberSeparator Optional Variant. The characters (up to five) that separate individual page numbers within page references in the table of authorities. Corresponds to the \l switch for a TOA (Table of Authorities) field. If this argument is omitted, a comma and a space are used.
Remarks
A table of authorities is built from TA (Table of Authorities Entry) fields in a document. Use the MarkCitation method to mark citations to be included in the table of authorities.
See Also
MarkCitation method, TablesOfAuthorities collection object.
Example
This example adds, at the beginning of the active document, a table of authorities that includes all categories.
Set myRange = ActiveDocument.Range(0, 0)
ActiveDocument.TablesOfAuthorities.Add Range:=myRange, _
Passim:= True, Category:= 0, EntrySeparator:= ", "