Evento CustomTaskPane. DockPositionStateChange (Office)CustomTaskPane.DockPositionStateChange event (Office)

Ocorre quando o usuário altera a posição de encaixe do painel de tarefas personalizado ativo.Occurs when the user changes the docking position of the active custom task pane.

SintaxeSyntax

expressão. DockPositionStateChange (CustomTaskPaneInst)expression.DockPositionStateChange (CustomTaskPaneInst)

expressão Uma expressão que retorna um objeto CustomTaskPane .expression An expression that returns a CustomTaskPane object.

ParâmetrosParameters

NomeName Obrigatório/OpcionalRequired/Optional Tipo de dadosData type DescriçãoDescription
CustomTaskPaneInstCustomTaskPaneInst ObrigatórioRequired ObjectObject O painel de tarefas personalizado ativo.The active custom task pane.

ExemploExample

O exemplo a seguir, criado em C#, cria um painel de tarefas personalizado e adiciona um controle de botão do Microsoft ActiveX que foi criado em outro projeto.The following example, written in C#, creates a custom task pane and adds a Microsoft ActiveX button control that was created in another project. Um evento DockPositionStateChange do tipo _CustomTaskPaneEvents_DockPositionStateChangeEventHandler, em seguida, é definido.A DockPositionStateChange event of type _CustomTaskPaneEvents_DockPositionStateChangeEventHandler is then defined. Quando o evento for disparado, uma caixa de mensagem é exibida informando ao usuário que o painel de tarefas ancorada foi movido.When the event is triggered, a message box is displayed telling the user that the docked task pane has been moved.

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 tarefas personalizados em qualquer idioma que ofereça suporte a COM e permite que você crie arquivos de biblioteca de vínculo dinâmico (DLL); por exemplo, Microsoft Visual Basic 6,0, Visual Basic .NET, Visual C++, Visual C++ .NET e Visual C#.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, Visual Basic .NET, Visual C++, Visual C++ .NET, and 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.However, Microsoft Visual Basic for Applications (VBA) does not support creating custom task panes.

Confira tambémSee also

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.