Partager via


CustomTaskPane.Height Propriété

Définition

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é

Hauteur, en points, du volet Office personnalisé.

Exceptions

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 .

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 à