Share via


PopulateRadioGroup Method [Office 2003 SDK Documentation]

The PopulateRadioGroup method specifies the appearance of radio group controls that are displayed in the Document Actions task pane. Applies to controls that are specified as C_TYPE_RADIOGROUP.

Applies to

ISmartDocument Interface

Syntax

[Visual Basic 6.0]

Private Sub ISmartDocument_PopulateRadioGroup(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, List() As String, Count As Long, InitialSelected As Long)

[Visual Basic .NET]

Public Sub PopulateRadioGroup(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 List As System.Array, ByRef Count As Integer, ByRef InitialSelected As Integer) Implements Microsoft.Office.Interop.SmartTag.ISmartDocument.PopulateRadioGroup

[C#]

public void ISmartDocument.PopulateRadioGroup(int ControlID, string ApplicationName, int LocaleID, string Text, string Xml, object Target, Microsoft.Office.Interop.SmartTag.ISmartDocProperties Props, ref System.Array List, ref int Count, ref int InitialSelected)

[Visual C++ 6.0]

STDMETHOD(PopulateRadioGroup)(INT ControlID, BSTR ApplicationName, INT LocaleID, BSTR Text, BSTR Xml, IDispatch * Target, ISmartDocProperties * Props, SAFEARRAY * * List, INT * Count, INT * InitialSelected)

[Visual C++ .NET]

STDMETHOD(PopulateRadioGroup)(int ControlID, BSTR ApplicationName, int LocaleID, BSTR Text, BSTR Xml, LPDISPATCH Target, ISmartDocProperties * Props, SAFEARRAY * * List, int * Count, int * InitialSelected)

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 interface that represents the properties, such as height or width, for the control.

List   Specifies a 1-based array of the radio buttons in the radio group control in the order in which they should appear in the task pane.

Count   Represents the total number of items in the radio group.

InitialSelected   Specifies the number of the item to be selected when the radio group is initially displayed. The default value is -1, which means that nothing is initially selected.

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.