Método ICustomTaskPaneConsumer.CTPFactoryAvailable (Office)

  • Artigo

Passa um objeto ICTPFactory para um suplemento do Microsoft ActiveX que pode ser usado ao criar um painel de tarefas personalizado.

Sintaxe

expressão. CTPFactoryAvailable (CTPFactoryInst)

Expressão Uma expressão que retorna um objeto ICustomTaskPaneConsumer .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
CTPFactoryInst Obrigatório ICTPFactory O objeto é utilizado por um suplemento para criar um painel de tarefas.

Exemplo

O exemplo a seguir, criado em c#, cria uma instância de um objeto CustomTaskPane por meio da interface ICustomTaskPaneConsumer e implementa CTPFactoryAvailable, o único método. CTPFactoryAvailable passa um objeto ICTPFactory para o suplemento, que você pode usar para criar um painel de tarefas usando o método CreateCTP durante ciclo de vida do suplemento.

Observe que o exemplo pressupõe que o painel de tarefas faz parte de um suplemento COM e, portanto, implementa Extensibility.IDTExtensibility2. O suplemento também se refere a um controle ActiveX, SampleActiveX.myControl, que foi criado em um projeto separado.

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; 
}

Observação

Você pode criar painéis de tarefa personalizados em qualquer idioma que dê suporte a COM e permitir que você crie arquivos DLL (biblioteca vinculada dinâmica). por exemplo, Microsoft Visual Basic 6.0, Visual Basic .NET, Visual C++, Visual C++ .NET e Visual C#. No entanto, Visual Basic for Applications (VBA) não dá suporte à criação de painéis de tarefas personalizados.

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.