CustomTaskPane.Height-Eigenschaft (2007 System)
Aktualisiert: November 2007
Ruft die Höhe des benutzerdefinierten Aufgabenbereichs in Punkt ab oder legt diese fest.
Namespace: Microsoft.Office.Tools
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)
Syntax
Public Property Height As Integer
Dim instance As CustomTaskPane
Dim value As Integer
value = instance.Height
instance.Height = value
public int Height { get; set; }
Eigenschaftenwert
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.
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, das für die CustomTaskPane-Klasse bereitgestellt wird.
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);
}
Berechtigungen
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.