Function AddControl3( _
   ByVal Name As System.String, _
   ByVal ControlName As System.String, _
   ByVal BstrLicKey As System.String, _
   ByVal SplitWindow As System.Boolean _
) As System.Object

Dim instance As IModelViewManager
Dim Name As System.String
Dim ControlName As System.String
Dim BstrLicKey As System.String
Dim SplitWindow As System.Boolean
Dim value As System.Object
 
value = instance.AddControl3(Name, ControlName, BstrLicKey, SplitWindow)

System.object AddControl3( 
   System.string Name,
   System.string ControlName,
   System.string BstrLicKey,
   System.bool SplitWindow
)

System.Object^ AddControl3( 
&   System.String^ Name,
&   System.String^ ControlName,
&   System.String^ BstrLicKey,
&   System.bool SplitWindow
) 

Parameters

Name

User-defined label that appears on the tab

ControlName

Name or class ID for the ActiveX control

BstrLicKey

Optional license key; this data is needed to create ActiveX controls that require a runtime license key; if the ActiveX control supports licensing, then provide a license key for the creation of the ActiveX control; default value is NULL

SplitWindow

True to add a splitter window, false to not

Return Value

Pointer to the new ActiveX control

If your ActiveX control does not need tab traversal support, then use IModelViewManager::AddControl.

This method sets the class ID and license key information for the ActiveX control when the API PropertyManager page is shown and the ActiveX control is created. The controlName argument can be either the name of the control (ProgID) or the class ID (CLSID), for example, "MSCAL.calendar" or "{8E27C92B-1264-101C-8A2F-040224009C02}". Both provide the calendar protocol. You can obtain these strings using a combination of the Microsoft OLE/COM Object Viewer and the registry editor.

For example:

' ProgID

bRet = m_pActiveXControl.SetClass("MSCAL.Calendar", "")

bRet = m_pActiveXControl2.SetClass("MSComctlLib.ListViewCtrl", "")

' CLSID

bRet = m_pActiveXControl.SetClass("{8E27C92B-1264-101C-8A2F-040224009C02}", "")

bRet = m_pActiveXControl2.SetClass("{BDD1F04B-858B-11D1-B16A-00C0F0283628}", "")

Two or more tabs cannot be added with the same name.

To delete a tab created by this method, use IModelViewManager::DeleteControlTab. Each use of IModelViewManager::AddControl3 must use a corresponding IModelViewManager::DeleteControlTab before exiting your macro or application.

See also Keystrokes and Accelerator Keys in ActiveX Modeless Dialogs and PropertyManager Pages.