CustomTaskPane.Height 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 la hauteur, en points, du volet Office personnalisé.

public:
 property int Height { int get(); void set(int value); };

public int Height { get; set; }

member this.Height : int with get, set

Public Property Height As Integer

Valeur de propriété

Int32

Hauteur, en points, du volet Office personnalisé.

Exceptions

COMException

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

ObjectDisposedException

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

Exemples

L’exemple de code suivant crée un volet Office personnalisé qui a une hauteur spécifiée lorsqu’il s’affiche devant la fenêtre d’application active. 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

N’utilisez pas la Height propriété si le volet Office personnalisé est ancré à gauche ou à droite de la fenêtre de document. Si la DockPosition propriété est Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight ou Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft, la Height propriété retourne 0 et lève un COMException si vous essayez de la définir.

La hauteur maximale dépend de la position d’ancrage. Lorsque le volet Office personnalisé est ancré en haut ou en bas de la fenêtre de document, la hauteur maximale est environ la moitié de la hauteur de l’écran. Lorsque le volet Office personnalisé est flottant, il n’y a pas de hauteur maximale.

La hauteur minimale dépend de plusieurs facteurs et peut changer dans les versions ultérieures de Microsoft Office. Si vous essayez de définir la Height propriété sur une valeur inférieure à la hauteur minimale, l’application réaffectera automatiquement la Height propriété à la hauteur minimale.

S’applique à

Partager via