ContentControls Collection

Word Developer Reference

A collection of ContentControl objects. Content controls are bounded and potentially labeled regions in a document that serve as containers for specific types of content. Individual content controls may contain content such as dates, lists, or paragraphs of formatted text.

Remarks

Use the Add method to create a new content control and insert it into a document. The following example creates a new drop-down list content control and adds several items to the list.

Visual Basic for Applications

Dim objcc As ContentControl Dim objMap As XMLMapping Set objcc = ActiveDocument.ContentControls.Add(wdContentControlDropdownList) objcc.Title = "My Favorite Animal" If objcc.ShowingPlaceholderText Then _ objcc.SetPlaceholderText , , "Select your favorite animal " 'List entries objcc.DropdownListEntries.Add "Cat" objcc.DropdownListEntries.Add "Dog" objcc.DropdownListEntries.Add "Horse" objcc.DropdownListEntries.Add "Monkey" objcc.DropdownListEntries.Add "Snake" objcc.DropdownListEntries.Add "Other"

Use the Item method to access a specific content control in the collection. The following example accesses the third content control in the active document and, if the control is a drop-down list or a combo box, moves the first item to the bottom of the list and the last item to the top of the list.

Visual Basic for Applications

Dim objcc As ContentControl Dim objLE1 As ContentControlListEntry Dim objLE2 As ContentControlListEntry Dim intCount As Integer Set objcc = ActiveDocument.ContentControls.Item(3) If objcc.Type = wdContentControlComboBox Or _ objcc.Type = wdContentControlDropdownList Then 'First item in the list. Set objLE1 = objcc.DropdownListEntries.Item(1) 'Last item in the list. Set objLE2 = objcc.DropdownListEntries.Item(objcc.DropdownListEntries.Count) For intCount = 1 To objcc.DropdownListEntries.Count 'Move the first item down one. objLE1.MoveDown 'Move the last item up one. objLE2.MoveUp Next End If

Use the ContentControl object to work with individual content controls. For more information, see Working with Content Controls.

See Also

• Word Object Model Reference
• ContentControls Object Members
• How to: Bind a Content Control to a Node in the Data Store
• How to: Bind Controls to a Specific Row in the Data Store When Inserting a Building Block
• How to: Capture and Respond to Events in the Data Store
• How to: Change a Content Control from One Type to Another
• How to: Change the Editability of a Content Control
• How to: Insert a Content Control into a Building Block
• How to: Remove Data from the Data Store When Deleting a Content Control
• How to: Set the Building Blocks That You Can Use for a Content Control
• Walkthrough: Connect an Item in the Data Store to a SQL Server Database
• Walkthrough: Connect an Item in the Data Store to a Web Service
• Walkthrough: Connect an Item in the Data Store to an Access Database
• Walkthrough: Connect an Item in the Data Store to an Excel Workbook
• Working with Content Controls