Information
Switch
Switch
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CustomTaskPane::Height Property

 

Gets or sets the height of the custom task pane, in points.

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

C#
C++
F#
VB
Copy 
property int Height {
	int get();
	void set(int value);
}

Property Value

Type: System::Int32

The height of the custom task pane, in points.

Exception Condition
COMException

The value of the DockPosition property is Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight or Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft when you try to set the Height property.

-or-

You try to set the Height property in the event handler for the DockPositionChanged or VisibleChanged event.

ObjectDisposedException

The M:Microsoft.Office.Tools.CustomTaskPane.Dispose method of the CustomTaskPane has already been called.

Do not use the Height property if the custom task pane is docked to the left or the right of the document window. If the DockPosition property is Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight or Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft, the Height property returns 0 and throws a COMException if you try to set it.

The maximum height depends on the dock position. When the custom task pane is docked to the top or bottom of the document window, the maximum height is approximately half the height of the screen. When the custom task pane is floating, there is no maximum height.

The minimum height depends on several factors, and can change in future releases of Microsoft Office. If you try to set the Height property to a value that is less than the minimum height, the application will automatically reassign the Height property to the minimum height.

The following code example creates a custom task pane that has a specified height when it displays in front of the active application window. This code example is part of a larger example provided for CustomTaskPane.

C#
VB
C++
Copy
No code example is currently available or this language may not be supported.
Return to top
Show: