CustomTaskPane.Width, propriété

Obtient ou définit la largeur, en points, du volet Office personnalisé.

Espace de noms :  Microsoft.Office.Tools
Assembly :  Microsoft.Office.Tools.Common (dans Microsoft.Office.Tools.Common.dll)

Syntaxe

'Déclaration
Property Width As Integer

int Width { get; set; }

Valeur de propriété

Type : System.Int32
Largeur, en points, du volet Office personnalisé.

Exceptions

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.

La largeur maximale dépend de la position d'ancrage.Lorsque le volet de tâches personnalisé est ancré à gauche ou à droite de la fenêtre du document, la largeur maximale est approximativement la moitié de la largeur de l'écran.Lorsque le volet de tâches personnalisé est flottant, il n'y a aucune largeur maximale.

La largeur minimale dépend de plusieurs facteurs et peut changer dans les versions ultérieures de Microsoft Office.Si vous tentez d'affecter à la propriété Width une valeur inférieure à la largeur minimale, l'application redéfinira automatiquement la propriété Width à la largeur minimale.

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 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.

Voir aussi

Référence

CustomTaskPane Interface

Microsoft.Office.Tools, espace de noms