CustomTaskPane.Visible-Eigenschaft (2007 System)
Aktualisiert: November 2007
Ruft einen Wert ab, der angibt, ob der benutzerdefinierte Aufgabenbereich sichtbar ist, oder legt diesen fest.
Namespace: Microsoft.Office.Tools
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)
Syntax
Public Property Visible As Boolean
Dim instance As CustomTaskPane
Dim value As Boolean
value = instance.Visible
instance.Visible = value
public bool Visible { get; set; }
Eigenschaftenwert
Typ: System.Boolean
true, wenn der benutzerdefinierte Aufgabenbereich sichtbar ist, andernfalls false. Die Standardeinstellung ist false.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| COMException | Sie versuchen, diese Eigenschaft im Ereignishandler für das DockPositionChanged-Ereignis oder das VisibleChanged-Ereignis festzulegen. |
| ObjectDisposedException | Die Dispose-Methode des CustomTaskPane wurde bereits aufgerufen. |
Hinweise
Anwendungen in 2007 Microsoft Office System stellen keine Standardbenutzeroberfläche zum Anzeigen von benutzerdefinierten Aufgabenbereichen für Benutzer bereit. Wenn Sie im Add-In einen benutzerdefinierten Aufgabenbereich erstellen, sollten Sie auch ein Benutzeroberflächenelement, z. B. eine Schaltfläche, erstellen, auf das Benutzer klicken können, um den benutzerdefinierten Aufgabenbereich anzuzeigen oder auszublenden. Weitere Informationen hierzu finden Sie unter Übersicht über benutzerdefinierte Aufgabenbereiche.
Beispiele
Im folgenden Codebeispiel wird ein benutzerdefinierter Aufgabenbereich erstellt und angezeigt. 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.