Freigeben über


CustomTaskPane.Height-Eigenschaft

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

Namespace:  Microsoft.Office.Tools
Assembly:  Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Syntax

'Declaration
Property Height As Integer
    Get
    Set
int Height { get; set; }

Eigenschaftswert

Typ: System.Int32
Die Höhe des benutzerdefinierten Aufgabenbereichs in Punkt.

Ausnahmen

Ausnahme Bedingung
COMException

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

– oder –

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

ObjectDisposedException

Die Dispose()-Methode des CustomTaskPane wurde bereits aufgerufen.

Hinweise

Verwenden Sie nicht die Height-Eigenschaft, wenn der benutzerdefinierte Aufgabenbereich an die linke oder rechte Seite des Dokumentfensters angedockt ist. Wenn die DockPosition-Eigenschaft Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight oder Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft ist, gibt die Height-Eigenschaft 0 zurück und löst eine COMException aus, wenn Sie sie festzulegen versuchen.

Die maximale Höhe hängt von der Dockposition ab. Wenn der benutzerdefinierte Aufgabenbereich am oberen oder unteren Rand des Dokumentfensters angedockt ist, beträgt die maximale Höhe die halbe Bildschirmhöhe. Wenn der benutzerdefinierte Aufgabenbereich unverankert ist, gibt es keine maximale Höhe.

Die Mindesthö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 kleineren Wert als die minimale Höhe festzulegen, weist die Anwendung der Height-Eigenschaft automatisch erneut die minimale Höhe zu.

Beispiele

Im folgenden Codebeispiel wird ein benutzerdefinierter Aufgabenbereich erstellt, der eine bestimmte Höhe hat, wenn er vor dem aktiven Anwendungsfenster angezeigt wird. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels zu 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);
}

.NET Framework-Sicherheit

Siehe auch

Referenz

CustomTaskPane Schnittstelle

Microsoft.Office.Tools-Namespace