OLEFormat Interface
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Represents the OLE characteristics (other than linking) for an OLE object, ActiveX control, or field.
public interface class OLEFormat[System.Runtime.InteropServices.Guid("00020933-0000-0000-C000-000000000046")]
public interface OLEFormattype OLEFormat = interfacePublic Interface OLEFormat- Attributes
Remarks
Use the OLEFormat property for a Shape, InlineShape, or Field object to return the OLEFormat object.
Not all types of shapes, inline shapes, and fields have OLE capabilities. Use the Type property for the Shape and InlineShape objects to determine what category the specified shape or inline shape falls into. The Type property for a Field object returns the type of field.
You can use the Activate(), Edit(), Open(), and DoVerb(Object) methods to automate an OLE object.
Use the Object property to return an object that represents an ActiveX control or OLE object. With this object, you can use the properties and methods of the container application or the ActiveX control.
Properties
| Application |
Returns a Application object that represents the Microsoft Word application. |
| ClassType |
Returns or sets the class type for the specified OLE object, picture, or field. |
| Creator |
Returns a 32-bit integer that indicates the application in which the specified object was created. |
| DisplayAsIcon |
True if the specified object is displayed as an icon. |
| IconIndex |
Returns or sets the icon that's used when the DisplayAsIcon property is True: 0 (zero) corresponds to the first icon, 1 corresponds to the second icon, and so on. If this argument is omitted, the first (default) icon is used. |
| IconLabel |
Returns or sets the text displayed below the icon for an OLE object. |
| IconName |
Returns or sets the program file in which the icon for an OLE object is stored. |
| IconPath |
Returns the path of the file in which the icon for an OLE object is stored. |
| Label |
Returns a string that's used to identify the portion of the source file that's being linked. For example, if the source file is a Microsoft Excel workbook, the Label property might return "Workbook1!R3C1:R4C2" if the OLE object contains only a few cells from the worksheet. |
| Object |
Returns an Object that represents the specified OLE object's top-level interface. This property allows you to access the properties and methods of an ActiveX control or the application in which an OLE object was created. The OLE object must support OLE Automation for this property to work. |
| Parent |
Returns an object that represents the parent object of the specified object. |
| PreserveFormattingOnUpdate |
True preserves formatting done in Microsoft Word to a linked OLE object, such as a table linked to a Microsoft Excel spreadsheet. |
| ProgID |
Returns the programmatic identifier (ProgID) for the specified OLE object. |
Methods
| Activate() |
Activates the specified object. |
| ActivateAs(String) |
Sets the Windows registry value that determines the default application used to activate the specified OLE object. |
| ConvertTo(Object, Object, Object, Object, Object) |
Converts the specified OLE object from one class to another, making it possible for you to edit the object in a different server application, or change how the object is displayed in the document. |
| DoVerb(Object) |
Requests that an OLE object perform one of its available verbs— the actions an OLE object takes to activate its contents. Each OLE object supports a set of verbs that pertain to that object. |
| Edit() |
Opens the specified OLE object for editing in the application it was created in. |
| Open() |
Opens the specified object. |