CustomTaskPane.Width A propriedade (sistema de 2007)

Artigo
08/25/2010

Obtém ou define a largura 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 Width As Integer

Dim instance As CustomTaskPane
Dim value As Integer

value = instance.Width

instance.Width = value

public int Width { get; set; }

Valor de propriedade

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

Exceções

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

- ou -

Você tentar conjunto o Width 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 Width propriedade se personalizado tarefa painel é encaixado na parte superior ou inferior da janela do documento. Se o DockPosition propriedade é Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop ou Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom, o Width 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 que tenha uma largura padrão diferente quando ele for exibido na frente da janela do aplicativo ativo e quando ela estiver encaixada à esquerda ou direita da janela.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