This documentation is archived and is not being maintained.

CustomTaskPane.Visible Property


Gets or sets a value that specifies whether the custom task pane is visible.

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

bool Visible { get; set; }

Property Value

Type: System.Boolean

true if the custom task pane is visible; otherwise, false. The default is false.

Exception Condition

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


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

Microsoft Office applications do not provide a default UI for users to display custom task panes. If you create a custom task pane in your add-in, you should also create a UI element, such as a button, that users can click to display or hide your custom task pane. For more information, see Custom Task Panes.

The following code example creates a custom task pane and displays it. This code example is part of a larger example provided for 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 =
    myCustomTaskPane.Height = 500;
    myCustomTaskPane.Width = 500;

    myCustomTaskPane.DockPosition =
    myCustomTaskPane.Width = 300;

    myCustomTaskPane.Visible = true;
    myCustomTaskPane.DockPositionChanged +=
        new EventHandler(myCustomTaskPane_DockPositionChanged);
Return to top