CustomTaskPane.Height Eigenschaft

Definition

Ruft die Höhe des benutzerdefinierten Aufgabenbereichs in Punkt ab oder legt diese fest.

public int Height { get; set; }

Eigenschaftswert

Int32

Die Höhe des benutzerdefinierten Aufgabenbereichs in Punkt.

Ausnahmen

Der Wert der DockPosition-Eigenschaft ist Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight oder Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft, wenn Sie versuchen, die Height-Eigenschaft festzulegen.

- oder - wenn Sie versuchen, die Height-Eigenschaft im Ereignishandler für das DockPositionChanged-Ereignis oder das VisibleChanged-Ereignis festzulegen.

Die Microsoft.Office.Tools.CustomTaskPane.Dispose-Methode von CustomTaskPane wurde bereits aufgerufen.

Beispiele

Im folgenden Codebeispiel wird ein benutzerdefinierter Aufgabenbereich erstellt, der eine angegebene Höhe hat, wenn er vor dem aktiven Anwendungsfenster angezeigt wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für bereitgestellt wird 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

Hinweise

Verwenden Sie die- Height Eigenschaft nicht, wenn der benutzerdefinierte Aufgabenbereich Links oder rechts vom Dokument Fenster angedockt ist. Wenn die- DockPosition Eigenschaft Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight oder ist Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft , Height gibt die-Eigenschaft 0 zurück und löst eine aus, COMException Wenn Sie versuchen, Sie festzulegen.

Die maximale Höhe hängt von der Andock Position ab. Wenn der benutzerdefinierte Aufgabenbereich am oberen oder unteren Rand des Dokument Fensters angedockt ist, beträgt die maximale Höhe ungefähr die halbe Höhe des Bildschirms. Wenn der benutzerdefinierte Aufgabenbereich unverankert ist, gibt es keine maximale Höhe.

Die minimale Höhe hängt von mehreren Faktoren ab und kann sich in zukünftigen Versionen von Microsoft Office ändern. Wenn Sie versuchen, die- Height Eigenschaft auf einen Wert festzulegen, der kleiner als die Mindesthöhe ist, wird die- Height Eigenschaft von der Anwendung automatisch der Mindesthöhe zugewiesen.

Gilt für