CustomTaskPane.Width (Propiedad)
Obtiene o establece el ancho 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 Width As Integer
Get
Set
int Width { get; set; }
Valor de propiedad
Tipo: System.Int32
Ancho del panel de tareas personalizado, en puntos.
Excepciones
| Excepción | Condición |
|---|---|
| COMException | El valor de la propiedad DockPosition es Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop o Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom cuando se intenta establecer la propiedad Width. O bien Intenta establecer la propiedad Width en el controlador del evento DockPositionChanged o VisibleChanged. |
| ObjectDisposedException | Ya se ha llamado al método Dispose() de CustomTaskPane. |
Comentarios
No utilice la propiedad Width si el panel de tareas personalizado está acoplado en la parte superior o inferior de la ventana de documento. Si la propiedad DockPosition es Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop o Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom, la propiedad Width devuelve 0 y produce una COMException si intenta establecerla.
El ancho máximo depende de la posición de acoplamiento. Cuando el panel de tareas personalizado se acopla a la izquierda o derecha de la ventana de documento, el ancho máximo es aproximadamente la mitad del ancho de la pantalla. Cuando el panel de tareas personalizado es flotante, no hay ancho máximo.
El ancho mínimo depende de varios factores y puede cambiar en versiones futuras de Microsoft Office. Si intenta establecer la propiedad Width en un valor que es menor que el ancho mínimo, la aplicación reasignará automáticamente la propiedad Width al ancho mínimo.
Ejemplos
En el ejemplo de código siguiente se crea un panel de tareas personalizado que tiene un ancho predeterminado diferente cuando se muestra delante de la ventana de la aplicación activa y cuando se acopla en el lado izquierdo o derecho de la ventana. 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.