CustomTaskPane.Width, propriété (System 2007)
Mise à jour : novembre 2007
Obtient ou définit la largeur, en points, du volet de tâches personnalisé.
Espace de noms : Microsoft.Office.Tools
Assembly : Microsoft.Office.Tools.Common.v9.0 (dans Microsoft.Office.Tools.Common.v9.0.dll)
Syntaxe
Public Property Width As Integer
Dim instance As CustomTaskPane
Dim value As Integer
value = instance.Width
instance.Width = value
public int Width { get; set; }
Valeur de propriété
Type : System.Int32
Largeur, en points, du volet de tâches personnalisé.
Exceptions
| Exception | Condition |
|---|---|
| COMException | La valeur de la propriété DockPosition est Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop ou Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom lorsque vous essayez de définir la propriété Width. - ou - Vous essayez de définir la propriété Width dans le gestionnaire d'événements pour l'événement DockPositionChanged ou VisibleChanged. |
| ObjectDisposedException | La méthode Dispose du CustomTaskPane a déjà été appelée. |
Notes
N'utilisez pas la propriété Width si le volet de tâches personnalisé est ancré en haut ou en bas de la fenêtre de document. Si la propriété DockPosition est Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop ou Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom, la propriété Width retourne 0 et lève une COMException si vous essayez de la définir.
Exemples
L'exemple de code suivant crée un volet de tâches personnalisé qui présente une largeur par défaut différente selon que le volet apparaît devant la fenêtre d'application active ou qu'il est ancré à gauche ou à droite de la fenêtre. Cet exemple de code fait partie d'un exemple plus développé fourni pour la classe 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);
}
Autorisations
- 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.