Propriedade CustomTaskPane.Visible

Artigo
05/21/2013

Obtém ou define um valor que especifica se o painel de tarefa personalizada é visível.

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

Sintaxe

'Declaração
Property Visible As Boolean

bool Visible { get; set; }

Valor de propriedade

Tipo: System.Boolean
true se o painel de tarefa personalizada é visível; caso contrário, false.O padrão é false.

Exceções

Exceção	Condição
COMException	Você tentar definir essa propriedade no manipulador de eventos para o evento de DockPositionChanged ou de VisibleChanged .
ObjectDisposedException	O método de Dispose de CustomTaskPane já tiver sido chamado.

Comentários

Os aplicativos do Microsoft Office não fornecem interface de usuário padrão para usuários aos painéis de tarefa personalizada de exibição.Se você criar um painel de tarefa personalizada no suplemento, você também deve criar um elemento de interface do usuário, como um botão, os usuários podem clicar para exibir ou ocultar o painel de tarefa personalizada.Para obter mais informações, consulte Painéis de tarefas personalizados.

Exemplos

O exemplo de código a seguir cria um painel de tarefa personalizada e exibi-lo.Este exemplo de código é parte de um exemplo maior fornecido para CustomTaskPane.

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

Private Sub ThisAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.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 = True
    End With
End Sub

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

private void 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);
}

Segurança do .NET Framework

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ódigo parcialmente confiáveis.

Consulte também

Referência

CustomTaskPane Interface

Namespace Microsoft.Office.Tools

Partilhar via