CustomTaskPane.Height Propriété

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é

Hauteur, en points, du volet Office personnalisé.

Exceptions

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 à