Compartilhar via


AutoCaptions Collection Object

Word Developer Reference

A collection of AutoCaption objects that represent the captions that can be automatically added when items such as tables, pictures, or OLE objects are inserted into a document.

Remarks

Use the AutoCaptions property to return the AutoCaptions collection. The following example displays the names of the selected items in the AutoCaption dialog box.

Visual Basic for Applications
  For Each autoCap In AutoCaptions
    If autoCap.AutoInsert = True Then
        MsgBox autoCap.Name & " is configured for auto insert"
    End If
Next autoCap

The AutoCaptions collection contains all the captions listed in the AutoCaption dialog box. AutoCaption objects cannot be programmatically added to or deleted from the AutoCaptions collection.

Use AutoCaptions(index), where index is the caption name or index number, to return a single AutoCaption object. The caption names correspond to the items listed in the AutoCaption dialog box. You must exactly match the spelling (but not necessarily the capitalization) of the name, as it is shown in the AutoCaption dialog box. The following example displays the caption text "Microsoft Word Table."

Visual Basic for Applications
  MsgBox AutoCaptions("Microsoft Word Table").CaptionLabel.Name

The index number represents the position of the AutoCaption object in the list of captions in the AutoCaption dialog box. The following example displays the name of the first item selected in the AutoCaption dialog box.

Visual Basic for Applications
  MsgBox AutoCaptions(1).Name

See Also