CustomTaskPane.DockPosition A propriedade (sistema de 2007)

Artigo
08/25/2010

Obtém ou define um valor que especifica onde o custom tarefa painel está localizado em relação à janela do aplicativo.

Namespace: Microsoft.Office.Tools
Assembly: Microsoft.Office.Tools.Common.v9.0 (em Microsoft.Office.Tools.Common.v9.0.dll)

Sintaxe

Public Property DockPosition As MsoCTPDockPosition

Dim instance As CustomTaskPane
Dim value As MsoCTPDockPosition

value = instance.DockPosition

instance.DockPosition = value

public MsoCTPDockPosition DockPosition { get; set; }

Valor de propriedade

Tipo: Microsoft.Office.Core.MsoCTPDockPosition
Um do Microsoft.Office.Core.MsoCTPDockPosition valores. O padrão é Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight.

Exceções

Exceção	Condição
ObjectDisposedException	The Dispose método para o CustomTaskPane já foi chamado.
COMException	O valor de DockPositionRestrict propriedade é Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange ao tentar alterar o valor da DockPosition propriedade. - ou - Tentar conjunto essa propriedade no manipulador de eventos para o DockPositionChanged ou VisibleChanged evento.

ObjectDisposedException

The Dispose método para o CustomTaskPane já foi chamado.

COMException

O valor de DockPositionRestrict propriedade é Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange ao tentar alterar o valor da DockPosition propriedade.

- ou -

Tentar conjunto essa propriedade no manipulador de eventos para o DockPositionChanged ou VisibleChanged evento.

Comentários

A tabela a seguir lista os valores do Microsoft.Office.Core.MsoCTPDockPosition enumeração.

Valor	Descrição
msoCTPDockPositionLeft	Encaixa o custom tarefa painel do lado esquerdo da janela.
msoCTPDockPositionTop	Encaixa o custom tarefa painel na parte superior da janela.
msoCTPDockPositionRight	Encaixa o custom tarefa painel do lado direito da janela.
msoCTPDockPositionBottom	Encaixa o custom tarefa painel até a parte inferior da janela.
msoCTPDockPositionFloating	Exibe o custom tarefa painel na frente da janela.O usuário pode arrastar o tarefa painel em qualquer local na janela.

Exemplos

O exemplo de código a seguir cria um personalizado tarefa painel e configura os tamanhos padrão diferentes para quando o painel exibe na frente da janela do aplicativo ativo, e quando ela estiver encaixada.Este exemplo de código é parte de um exemplo maior fornecido para a classe CustomTaskPane.

Private myUserControl1 As MyUserControl
PrivateWithEvents myCustomTaskPane As Microsoft.Office.Tools.CustomTaskPane

PrivateSub ThisAddIn_Startup(ByVal sender AsObject, ByVal e As System.EventArgs) _
    HandlesMe.Startup

    myUserControl1 = New MyUserControl()
    myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "New Task Pane")

    With myCustomTaskPane
        .DockPosition = Office.MsoCTPDockPosition.msoCTPDockPositionFloating
        .Height = 500
        .Width = 500
        .DockPosition = Office.MsoCTPDockPosition.msoCTPDockPositionRight
        .Width = 300
        .Visible = TrueEndWithEndSub

private MyUserControl myUserControl1;
private Microsoft.Office.Tools.CustomTaskPane myCustomTaskPane;

privatevoid ThisAddIn_Startup(object sender, System.EventArgs e)
{
    myUserControl1 = new MyUserControl();
    myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1,
        "New Task Pane");

    myCustomTaskPane.DockPosition =
        Office.MsoCTPDockPosition.msoCTPDockPositionFloating;
    myCustomTaskPane.Height = 500;
    myCustomTaskPane.Width = 500;

    myCustomTaskPane.DockPosition =
        Office.MsoCTPDockPosition.msoCTPDockPositionRight;
    myCustomTaskPane.Width = 300;

    myCustomTaskPane.Visible = true;
    myCustomTaskPane.DockPositionChanged +=
        new EventHandler(myCustomTaskPane_DockPositionChanged);
}

Permissões

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de códigos parcialmente Confiável.

Consulte também

Referência

CustomTaskPane Classe

Membros CustomTaskPane

Namespace Microsoft.Office.Tools

Partilhar via