CustomTaskPane.DockPosition (Propiedad) (2007 System)
Actualización: noviembre 2007
Obtiene o establece un valor que especifica la posición del panel de tareas personalizado respecto de la ventana de aplicación.
Espacio de nombres: Microsoft.Office.Tools
Ensamblado: Microsoft.Office.Tools.Common.v9.0 (en Microsoft.Office.Tools.Common.v9.0.dll)
Sintaxis
Public Property DockPosition As MsoCTPDockPosition
Dim instance As CustomTaskPane
Dim value As MsoCTPDockPosition
value = instance.DockPosition
instance.DockPosition = value
public MsoCTPDockPosition DockPosition { get; set; }
Valor de propiedad
Tipo: Microsoft.Office.Core.MsoCTPDockPosition
Uno de los valores de Microsoft.Office.Core.MsoCTPDockPosition. De manera predeterminada, es Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight.
Excepciones
| Excepción | Condición |
|---|---|
| ObjectDisposedException | Ya se ha llamado al método Dispose de CustomTaskPane. |
| COMException | El valor de la propiedad DockPositionRestrict es Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange cuando se intenta cambiar el valor de la propiedad DockPosition. O bien Intenta establecer esta propiedad en el controlador del evento VisibleChanged o DockPositionChanged. |
Comentarios
En la siguiente tabla se muestran los valores de la enumeración Microsoft.Office.Core.MsoCTPDockPosition.
Value |
Description |
|---|---|
msoCTPDockPositionLeft |
Acopla el panel de tareas personalizado en el 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 en el lado derecho de la ventana. |
msoCTPDockPositionBottom |
Acopla el panel de tareas personalizado en 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 parte de la ventana. |
Ejemplos
En el ejemplo de código siguiente se crea un panel de tareas personalizado y se configuran los distintos tamaños predeterminados para cuando el panel se muestre delante de la ventana de la aplicación activa y para cuando esté acoplado. 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.