CustomTaskPane.Width (Propiedad) (2007 System)
Actualización: noviembre 2007
Obtiene o establece el ancho del panel de tareas personalizado, en puntos.
Espacio de nombres: Microsoft.Office.Tools
Ensamblado: Microsoft.Office.Tools.Common.v9.0 (en Microsoft.Office.Tools.Common.v9.0.dll)
Sintaxis
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 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.
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 referente a la clase 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);
}
Permisos
- 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.