Compartilhar via


Evento CustomTaskPane.DockPositionStateChange (Office)

Ocorre quando o usuário altera a posição de encaixe do painel de tarefas personalizado ativo.

Sintaxe

expressão. DockPositionStateChange (CustomTaskPaneInst)

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
CustomTaskPaneInst Obrigatório Objeto O painel de tarefas personalizado ativo.

Exemplo

O exemplo a seguir, escrito em C#, cria um painel de tarefas personalizado e adiciona um controle de botão do Microsoft ActiveX criado em outro projeto. Um evento DockPositionStateChange do tipo _CustomTaskPaneEvents_DockPositionStateChangeEventHandler, em seguida, é definido. Quando o evento for disparado, uma caixa de mensagem é exibida informando ao usuário que o painel de tarefas ancorada foi movido.

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; 
 
 CTP.DockPositionStateChange += new _CustomTaskPaneEvents_DockPositionStateChangeEventHandler(CTP_DockPositionStateChange); 
 
} 
 
private void CTP_DockPositionStateChange(object sender, string dockpositionArgs) 
{ 
 Console.WriteLine("The custom task pane was moved"); 
}

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, o Microsoft Visual Basic for Applications (VBA) não oferece suporte para a 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.