CustomTaskPane.DockPosition Propriété

Référence

Définition

Espace de noms:: Microsoft.Office.Tools

Assemblys:: 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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit une valeur qui spécifie l'emplacement du volet Office personnalisé par rapport à la fenêtre d'application.

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

Valeur de propriété

MsoCTPDockPosition

Une des valeurs Microsoft.Office.Core.MsoCTPDockPosition. La valeur par défaut est Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight.

Exceptions

ObjectDisposedException

La méthode Microsoft.Office.Tools.CustomTaskPane.Dispose du CustomTaskPane a déjà été appelée.

COMException

La valeur de la DockPositionRestrict propriété est Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange lorsque vous essayez de modifier la valeur de la DockPosition propriété.-ou-Vous essayez de définir cette propriété dans le gestionnaire d’événements pour l’événement DockPositionChanged ou VisibleChanged .

Exemples

L’exemple de code suivant crée un volet Office personnalisé et configure différentes tailles par défaut quand le volet s’affiche devant la fenêtre d’application active et quand il est ancré. Cet exemple de code fait partie d’un exemple plus grand fourni pour 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

Remarques

Le tableau suivant répertorie les valeurs des constantes manifestesMicrosoft.Office.Core.MsoCTPDockPosition.

Value	Description
`msoCTPDockPositionLeft`	Ancre le volet Office personnalisé sur le côté gauche de la fenêtre.
`msoCTPDockPositionTop`	Ancre le volet Office personnalisé en haut de la fenêtre.
`msoCTPDockPositionRight`	Ancre le volet Office personnalisé sur le côté droit de la fenêtre.
`msoCTPDockPositionBottom`	Ancre le volet Office personnalisé au bas de la fenêtre.
`msoCTPDockPositionFloating`	Affiche le volet Office personnalisé devant la fenêtre. L’utilisateur peut faire glisser le volet Office vers n’importe quel emplacement dans la fenêtre.

S’applique à