Window.CommandBars-Eigenschaft

Artikel
04/27/2010

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
'Usage
Dim instance As Window
Dim value As Object

value = instance.CommandBars

public abstract Object CommandBars { get; }

Eigenschaftswert

Ein Verweis auf die Microsoft Office-CommandBars-Auflistung des Fensters, das dem Window-Objekt zugeordnet ist.

Ausnahmen

Ausnahmetyp	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 für Anwendungen (VSTA) oder Visual Studio einen Verweis auf die Microsoft Office 12.0 Object Library 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 "Using Libraries from Partially Trusted Code" (in Englisch) auf MSDN.

Auf diesen Typ oder diesen Member kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 geöffnet wurden.

Beispiel

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")

Siehe auch

Referenz

Window-Klasse
Window-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über