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
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.