Partager via


CustomTaskPane.DockPosition Propriété

Définition

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é

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

Exceptions

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

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 à