CustomTaskPane.Height Propiedad

Definición

Espacio de nombres:

Microsoft.Office.Tools

Ensamblados:

Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll, Microsoft.Office.Tools.Outlook.v4.0.Utilities.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

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

public:
 property int Height { int get(); void set(int value); };

public int Height { get; set; }

member this.Height : int with get, set

Public Property Height As Integer

Valor de propiedad

Int32

Alto del panel de tareas personalizado, en puntos.

Excepciones

COMException

El valor de la DockPosition propiedad es Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight o Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft cuando intenta establecer la Height propiedad.-o-Intenta establecer la Height propiedad en el controlador de eventos para el DockPositionChanged evento o VisibleChanged .

ObjectDisposedException

Ya se ha llamado al método Microsoft.Office.Tools.CustomTaskPane.Dispose del objeto CustomTaskPane.

Ejemplos

En el ejemplo de código siguiente se crea un panel de tareas personalizado que tiene un alto especificado cuando se muestra delante de la ventana de la aplicación activa. Este ejemplo de código forma parte de un ejemplo más grande proporcionado para CustomTaskPane.

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

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

Comentarios

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

La altura máxima depende de la posición del muelle. Cuando el panel de tareas personalizado se acopla a la parte superior o inferior de la ventana del documento, el alto máximo es aproximadamente la mitad del alto de la pantalla. Cuando el panel de tareas personalizado está flotante, no hay ningún alto máximo.

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