PopulateImage Method [Office 2003 SDK Documentation]
The PopulateImage method specifies the image to be displayed in the Document Actions task pane. Applies to controls that are specified as C_TYPE_IMAGE.
Applies to
Syntax
[Visual Basic 6.0]
Private Sub ISmartDocument_PopulateImage(ByVal ControlID As Long, ByVal ApplicationName As String, ByVal LocaleID As Long, ByVal Text As String, ByVal Xml As String, ByVal Target As Object, ByVal Props As SmartTagLib.ISmartDocProperties, ImageSrc As String)
[Visual Basic .NET]
Public Sub PopulateImage(ByVal ControlID As Integer, ByVal ApplicationName As String, ByVal LocaleID As Integer, ByVal [Text] As String, ByVal Xml As String, ByVal Target As Object, ByVal Props As Microsoft.Office.Interop.SmartTag.ISmartDocProperties, ByRef ImageSrc As String) Implements Microsoft.Office.Interop.SmartTag.ISmartDocument.PopulateImage
[C#]
public void ISmartDocument.PopulateImage(int ControlID, string ApplicationName, int LocaleID, string Text, string Xml, object Target, Microsoft.Office.Interop.SmartTag.ISmartDocProperties Props, ref string ImageSrc)
[Visual C++ 6.0]
STDMETHOD(PopulateImage)(INT ControlID, BSTR ApplicationName, INT LocaleID, BSTR Text, BSTR Xml, IDispatch * Target, ISmartDocProperties * Props, BSTR * ImageSrc)
[Visual C++ .NET]
STDMETHOD(PopulateImage)(int ControlID, BSTR ApplicationName, int LocaleID, BSTR Text, BSTR Xml, LPDISPATCH Target, ISmartDocProperties * Props, BSTR * ImageSrc)
Parameters
ControlID Represents the ID number assigned to a control in the ControlID property.
ApplicationName Specifies the name of the application. You can use the ****ApplicationName parameter to customize a single smart document DLL to provide smart document actions in multiple Microsoft Office applications.
LocaleID Represents the language setting of the application. You can use the LocaleID parameter to specify different actions for multiple languages in a smart document.
Text The text contained in the XML element with which the control is associated.
Xml Specifies the XML element, including the markup and data, with which the control is associated.
Target Specifies the Microsoft Word or Microsoft Excel Range object that represents the XML element for which the action is defined.
Props Returns an ISmartDocProperties collection that represents the properties, such as height or width, for the control.
ImageSrc Specifies the file location and file name of the image to display. The file location must be an absolute path; it cannot be a relative path.
Remarks
From within this method, you cannot refresh the task pane by using the RefreshPane method for the SmartDocument object. If you need to refresh the task pane, use the OnPaneUpdateComplete method.
Note The RefreshPane method and the SmartDocument object are part of the Microsoft Office Word 2003 and Microsoft Office Excel 2003 Visual Basic for Applications (VBA) object models.