Passes an CTPFactory object to a Microsoft ActiveX add-in that can then used when creating a custom task pane.

Note
You can create custom task panes in any language that supports COM and allows you to create dynamic-linked library (DLL) files. For example, Microsoft Visual Basic 6.0, Microsoft Visual Basic .NET, Microsoft Visual C++, Microsoft Visual C++ .NET, and Microsoft Visual C#. However, Microsoft Visual Basic for Applications (VBA) does not support creating custom task panes.

Syntax

expression.CTPFactoryAvailable(CTPFactoryInst)

expression An expression that returns a ICustomTaskPaneConsumer object.

Parameters

Name Required/Optional Data Type Description
CTPFactoryInst Required ICTPFactory The object is used by an add-in to create a task pane.

Example

The following example, written in C#, creates an instance of a CustomTaskPane object through the ICustomTaskPaneConsumer interface and implements its only method, CTPFactoryAvailable.CTPFactoryAvailable passes an CTPFactory object to the add-in, which you can use during the add-in's lifetime to create a task pane by using the CreateCTP method. Note that the example assumes that the task pane is part of an COM add-in and thus implements Extensibility.IDTExtensibility2. The add-in also refers to an ActiveX control, SampleActiveX.myControl, that was created in a separate project.

C#
public class Connect : Object, Extensibility.IDTExtensibility2, ICustomTaskPaneConsumer ... object missing = Type.Missing; public CustomTaskPane CTP = null; public void CTPFactoryAvailable(ICTPFactory CTPFactoryInst) { CTP = CTPFactoryInst.CreateCTP("SampleActiveX.myControl", "Task Pane Example", missing); sampleAX = (myControl)CTP.ContentControl; sampleAX.InsertTextClicked += new InsertTextEventHandler(sampleAX_InsertTextClicked); CTP.Visible = true; } 

See also: