AddOLEControl Method

Microsoft Word Visual Basic

Creates an ActiveX control (formerly known as an OLE control). Returns the InlineShape object that represents the new ActiveX control.

expression.AddOLEControl(ClassType, Range)

expression    Required. An expression that returns an InlineShapes object.

ClassType   Optional Variant. The programmatic identifier for the ActiveX control to be created.

Range   Optional Variant. The range where the ActiveX control will be placed in the text. The ActiveX control replaces the range, if the range isn't collapsed. If this argument is omitted, the Active X control is placed automatically.

ShowAddOLEControl method as it applies to the Shapes object.

Creates an ActiveX control (formerly known as an OLE control). Returns the Shape object that represents the new ActiveX control.

expression.AddOLEControl(ClassType, Left, Top, Width, Height, Anchor)

expression    Required. An expression that returns a Shapes object.

ClassType   Optional Variant. The programmatic identifier for the ActiveX control to be created.

Left   Optional Variant. The position (in points) of the left edge of the new object relative to the anchor.

Top   Optional Variant. The position (in points) of the upper edge of the new object relative to the anchor.

Width   Optional Variant. The width of the ActiveX control, in points.

Height   Optional Variant.The height of the ActiveX control, in points.

Anchor   Optional Variant. The range to which the ActiveX control is bound. If Anchor is specified, the anchor is positioned at the beginning of the first paragraph in the anchoring range. If this argument is omitted, however, the anchor is placed automatically and the ActiveX control is positioned relative to the top and left edges of the page.

Remarks

ActiveX controls are represented as either Shape objects or InlineShape objects in Microsoft Word. To modify the properties for an ActiveX control, you use the Object property of the OLEFormat object for the specified shape or inline shape.

For information about available ActiveX control class types, see OLE Programmatic Identifiers.

Example

ShowAs it applies to the Shape object.

This example adds a check box to the active document.

ActiveDocument.Shapes.AddOLEControl ClassType:="Forms.CheckBox.1"
				

This example adds a combo box to the active document.

ActiveDocument.Shapes.AddOLEControl ClassType:="Forms.ComboBox.1"
				

This example adds a check box to the active document, clears the check box, and then adds a caption for it.

Set myCB = ActiveDocument.Shapes _
    .AddOLEControl(ClassType:="Forms.CheckBox.1")
With myCB.OLEFormat.Object
    .Value = False
    .Caption = "Check if over 21"
End With