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 der 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 Visual Studio 2012 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 dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die über eine Formularvorlage geöffnet wurden, die mithilfe der Kategorie "Sicherheit und Vertrauensstellung" im Dialogfeld "Formularoptionen" so konfiguriert wurde, dass sie mit voller Vertrauenswürdigkeit ausgeführt wird. Dieses Mitglied erfordert die volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer und kann von teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie auf MSDN unter "Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code".
Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in 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 die Anweisung using oder Imports 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")