CustomTaskPane.Visible 屬性
取得或設定指定自訂工作窗格是否可見的值。
命名空間: Microsoft.Office.Tools
組件: Microsoft.Office.Tools.Common (在 Microsoft.Office.Tools.Common.dll 中)
語法
'宣告
Property Visible As Boolean
Get
Set
bool Visible { get; set; }
屬性值
型別:System.Boolean
如果自訂工作窗格是可見則為 true,否則為 false。預設值為 false。
例外狀況
例外狀況 | 條件 |
---|---|
COMException | 您嘗試在 DockPositionChanged 或 VisibleChanged 事件的事件處理常式中設定這個屬性。 |
ObjectDisposedException | 已經呼叫過 CustomTaskPane 的 Dispose() 方法。 |
備註
Microsoft Office 應用程式並未提供預設 UI,供使用者用來顯示自訂工作窗格。 如果在增益集中建立自訂工作窗格,則應同時建立 UI 項目,例如使用者可以按一下來顯示或隱藏自訂工作窗格的按鈕。 如需詳細資訊,請參閱自訂工作窗格概觀。
範例
下列程式碼範例會建立並顯示自訂工作窗格。 這個程式碼範例是 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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。