CustomTaskPane.Height A propriedade (sistema de 2007)

Artigo
08/25/2010

Obtém ou define a altura da personalizado tarefa painel, em pontos.

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

Sintaxe

Public Property Height As Integer

Dim instance As CustomTaskPane
Dim value As Integer

value = instance.Height

instance.Height = value

public int Height { get; set; }

Valor de propriedade

Tipo: System.Int32
A altura da personalizado tarefa painel, em pontos.

Exceções

Exceção	Condição
COMException	O valor de DockPosition propriedade é Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight ou Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft Quando você tentar conjunto o Height propriedade. - ou - Você tentar conjunto o Height 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 DockPosition propriedade é Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight ou Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft Quando você tentar conjunto o Height propriedade.

- ou -

Você tentar conjunto o Height propriedade no manipulador de eventos para o DockPositionChanged ou VisibleChanged evento.

ObjectDisposedException

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

Comentários

Não use o Height propriedade se personalizado tarefa painel é encaixado para a esquerda ou direita da janela do documento. Se o DockPosition propriedade é Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight ou Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft, o Height propriedade retornará 0 e lança um COMException Se você tentar defini-la.

Exemplos

O exemplo de código a seguir cria um personalizado tarefa painel possui uma altura especificada quando ele for exibido na frente da janela do aplicativo ativo.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