Compartir a través de


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

Vea también

Referencia

CustomTaskPane Interfaz

Microsoft.Office.Tools (Espacio de nombres)