Hide Table of Contents
AddControl3 Method (IModelViewManager)

Adds a tab to this model view that supports tab traversal using the specified ActiveX control.

.NET Syntax

Visual Basic (Declaration) 
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
Visual Basic (Usage) 
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)
C# 
System.object AddControl3( 
   System.string Name,
   System.string ControlName,
   System.string BstrLicKey,
   System.bool SplitWindow
)
C++/CLI 
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

Remarks

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.

 

See Also

Availability

SOLIDWORKS 2007 FCS, Revision Number 15.0


Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

 
*Email:  
Subject:   Feedback on Help Topics
Page:   AddControl3 Method (IModelViewManager)
*Comment:  
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:



x

We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again
x

Web Help Content Version: API Help (English only) 2015 SP05

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.