Add Method (TablesOfAuthorities Collection)

See Also         Example         Applies To

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.