Compartir a través de


CustomTaskPane.Height (Propiedad)

Obtiene o establece el alto del panel de tareas personalizado, en puntos.

Espacio de nombres:  Microsoft.Office.Tools
Ensamblado:  Microsoft.Office.Tools.Common (en Microsoft.Office.Tools.Common.dll)

Sintaxis

'Declaración
Property Height As Integer
    Get
    Set
int Height { get; set; }

Valor de propiedad

Tipo: System.Int32
Alto del panel de tareas personalizado, en puntos.

Excepciones

Excepción Condición
COMException

El valor de la propiedad DockPosition es Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight o Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft cuando se intenta establecer la propiedad Height.

O bien

Intenta establecer la propiedad Height en el controlador del evento DockPositionChanged o VisibleChanged.

ObjectDisposedException

Ya se ha llamado al método Dispose() de CustomTaskPane.

Comentarios

No utilice la propiedad Height si el panel de tareas personalizado está acoplado a la derecha o a la izquierda de la ventana de documento. Si la propiedad DockPosition es Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight o Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft, la propiedad Height devuelve 0 y produce una COMException si intenta establecerla.

El alto máximo depende de la posición de acoplamiento. Cuando el panel de tareas personalizado se acopla a la parte inferior o superior de la ventana de documento, el alto máximo es aproximadamente la mitad del alto de la pantalla. Cuando el panel de tareas personalizado es flotante, no hay alto máximo.

El alto mínimo depende de varios factores y puede cambiar en versiones futuras de Microsoft Office. Si intenta establecer la propiedad Height en un valor que es menor que el alto mínimo, la aplicación reasignará automáticamente la propiedad Height al alto mínimo.

Ejemplos

En el ejemplo de código siguiente se crea un panel de tareas personalizado que tiene un alto específico cuando se muestra delante de la ventana de la aplicación activa. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado 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);
}

Seguridad de .NET Framework

Vea también

Referencia

CustomTaskPane Interfaz

Microsoft.Office.Tools (Espacio de nombres)