CustomTaskPane.DockPosition Propiedad

Referencia

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

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene o establece un valor que especifica la posición del panel de tareas personalizado respecto de la ventana de aplicación.

public:
 property Microsoft::Office::Core::MsoCTPDockPosition DockPosition { Microsoft::Office::Core::MsoCTPDockPosition get(); void set(Microsoft::Office::Core::MsoCTPDockPosition value); };

public Microsoft.Office.Core.MsoCTPDockPosition DockPosition { get; set; }

member this.DockPosition : Microsoft.Office.Core.MsoCTPDockPosition with get, set

Public Property DockPosition As MsoCTPDockPosition

Valor de propiedad

MsoCTPDockPosition

Uno de los valores Microsoft.Office.Core.MsoCTPDockPosition. El valor predeterminado es Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight.

Excepciones

ObjectDisposedException

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

COMException

El valor de la DockPositionRestrict propiedad es Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange cuando intenta cambiar el valor de la DockPosition propiedad.-o-Intenta establecer esta propiedad en el controlador de eventos para el DockPositionChanged evento o VisibleChanged .

Ejemplos

En el ejemplo de código siguiente se crea un panel de tareas personalizado y se configuran diferentes tamaños predeterminados para cuando el panel se muestra delante de la ventana de la aplicación activa y cuando está acoplado. 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

En la tabla siguiente se enumeran los valores de la Microsoft.Office.Core.MsoCTPDockPosition enumeración.

Valor	Descripción
`msoCTPDockPositionLeft`	Acopla el panel de tareas personalizado al lado izquierdo de la ventana.
`msoCTPDockPositionTop`	Acopla el panel de tareas personalizado en la parte superior de la ventana.
`msoCTPDockPositionRight`	Acopla el panel de tareas personalizado al lado derecho de la ventana.
`msoCTPDockPositionBottom`	Acopla el panel de tareas personalizado a la parte inferior de la ventana.
`msoCTPDockPositionFloating`	Muestra el panel de tareas personalizado delante de la ventana. El usuario puede arrastrar el panel de tareas a cualquier ubicación de la ventana.

Se aplica a