Window.CommandBars-Eigenschaft
Ruft einen Verweis auf die Microsoft Office-CommandBars-Auflistung des Fensters ab, das dem Window-Objekt zugeordnet ist.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride ReadOnly Property CommandBars As Object
Get
'Usage
Dim instance As Window
Dim value As Object
value = instance.CommandBars
public abstract Object CommandBars { get; }
Eigenschaftswert
Typ: System.Object
Ein Verweis auf die Microsoft Office-CommandBars-Auflistung des Fensters, das dem Window-Objekt zugeordnet ist.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| SecurityException | Die Formularvorlage ist in der Kategorie Sicherheit und Vertrauensstellung des Dialogfeldes Formularoptionen nicht auf Voll Vertrauenswürdig festgelegt. |
Hinweise
Nachdem Sie einen Verweis auf die CommandBars-Auflistung eingerichtet haben, können Sie auf alle Eigenschaften und Methoden dieser Klasse zugreifen.
Wichtig
Damit die CommandBars-Eigenschaft funktionsfähig ist, müssen Sie über die Registerkarte COM im Dialogfeld Verweis hinzufügen in Microsoft Visual Studio Tools for Applications einen Verweis auf die Microsoft Office 14.0-Objektbibliothek einrichten. Dadurch wird ein Verweis auf den Microsoft.Office.Core-Namespace eingerichtet, der die CommandBars-Klasse enthält. Darüber hinaus muss das Formular als "Voll vertrauenswürdig" ausgeführt werden.
Auf den Member kann nur über Formulare zugegriffen werden, die über eine Formularvorlage geöffnet werden. Die Formularvorlage muss zum voll vertrauenswürdigen Ausführen mithilfe der Kategorie Sicherheit und Vertrauensstellung des Dialogfelds Formularoptionen konfiguriert werden. Der Member erfordert volle Vertrauenswürdigkeit für den sofortigen Aufrufer und kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter "Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code" auf MSDN.
Auf diesen Typ oder diesen Member kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft InfoPath Filler geöffnet wurden.
Beispiele
Im folgenden Beispiel wird die CommandBars-Eigenschaft der Window-Klasse verwendet, um eine CommandBars-Auflistung abzurufen und die Anzahl der Befehlsleisten anzuzeigen.
Dieses Beispiel erfordert eine using- oder Imports-Direktive für den Microsoft.Office.Core-Namespace im Deklarationsabschnitt des Formularcodemoduls.
// Get CommandBars collection casting to
// Microsoft.Office.Core.CommandBars type.
CommandBars myCommandBars =
(CommandBars)this.Application.ActiveWindow.CommandBars;
// Get count using CommandBars Count property.
int commandBarsCount = myCommandBars.Count;
// Display count of command bars.
MessageBox.Show("There are " + commandBarsCount.ToString() +
" Command Bars");
' Get CommandBars collection casting to
' Microsoft.Office.Core.CommandBars type.
Dim myCommandBars As CommandBars =
DirectCast(Me.Application.ActiveWindow.CommandBars, CommandBars)
' Get count using CommandBars Count property.
Dim commandBarsCount As Integer = myCommandBars.Count
' Display count of command bars.
MessageBox.Show("There are " & commandBarsCount.ToString() &
" Command Bars")