CustomTaskPane.DockPosition, propriété
Obtient ou définit une valeur qui spécifie l'emplacement du volet Office personnalisé par rapport à la fenêtre d'application.
Espace de noms : Microsoft.Office.Tools
Assembly : Microsoft.Office.Tools.Common (dans Microsoft.Office.Tools.Common.dll)
Syntaxe
'Déclaration
Property DockPosition As MsoCTPDockPosition
MsoCTPDockPosition DockPosition { get; set; }
Valeur de propriété
Type : Microsoft.Office.Core.MsoCTPDockPosition
Une des valeurs de Microsoft.Office.Core.MsoCTPDockPosition.La valeur par défaut est Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight.
Exceptions
| Exception | Condition |
|---|---|
| ObjectDisposedException | La méthode Dispose du CustomTaskPane a déjà été appelée. |
| COMException | La valeur de la propriété DockPositionRestrict est Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange lorsque vous essayez de modifier la valeur de la propriété DockPosition. ou Vous essayez de définir cette propriété dans le gestionnaire d'événements pour l'événement DockPositionChanged ou VisibleChanged. |
Notes
Le tableau suivant répertorie les valeurs de l'énumération Microsoft.Office.Core.MsoCTPDockPosition.
Valeur |
Description |
|---|---|
msoCTPDockPositionLeft |
Ancre le volet de tâches personnalisé au côté gauche de la fenêtre. |
msoCTPDockPositionTop |
Ancre le volet de tâches personnalisé en haut de la fenêtre. |
msoCTPDockPositionRight |
Ancre le volet de tâches personnalisé au côté droit de la fenêtre. |
msoCTPDockPositionBottom |
Ancre le volet de tâches personnalisé en bas de la fenêtre. |
msoCTPDockPositionFloating |
Affiche le volet de tâches personnalisé devant la fenêtre.L'utilisateur peut faire glisser le volet de tâches n'importe où dans la fenêtre. |
Exemples
L'exemple de code suivant crée un volet de tâches personnalisé et configure des tailles par défaut différentes selon que le volet apparaît devant la fenêtre d'application active ou qu'il est ancré.Cet exemple de code fait partie d'un exemple plus complet, fourni pour 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);
}
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.