RibbonPosition-Schnittstelle

Artikel
05/07/2013

Stellt Folgendes dar: die Position eines Menüband-Steuerelements im Microsoft Office-Menü relativ zu einem integrierten Steuerelement, die Position einer Registerkarte relativ zu einer integrierten Registerkarte oder die Position einer Gruppe relativ zu einer integrierten Gruppe.

Namespace: Microsoft.Office.Tools.Ribbon
Assemblys:   Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
  Microsoft.Office.Tools.Common.v4.0.Utilities (in Microsoft.Office.Tools.Common.v4.0.Utilities.dll)
  Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)
  Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Syntax

'Declaration
<GuidAttribute("d7167a9c-8d5c-4ca4-9de8-8d19b66d1aa5")> _
Public Interface RibbonPosition _
    Inherits IEquatable(Of RibbonPosition)

[GuidAttribute("d7167a9c-8d5c-4ca4-9de8-8d19b66d1aa5")]
public interface RibbonPosition : IEquatable<RibbonPosition>

Der RibbonPosition-Typ macht die folgenden Member verfügbar.

Eigenschaften

	Name	Beschreibung
	OfficeId	Ruft die ID des integrierten Menüband-Steuerelements bzw. der Gruppe oder Registerkarte ab, mit der die aktuelle RibbonPosition eine relative Position für ein anderes Steuerelement bzw. eine Gruppe oder Registerkarte definiert.
	PositionType	Ruft einen Wert ab, der angibt, ob es sich bei der aktuellen RibbonPosition um eine Position handelt, die vor oder hinter einem integrierten Steuerelement, einer Gruppe oder einer Registerkarte liegt.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Equals	Gibt an, ob das aktuelle Objekt gleich einem anderen Objekt des gleichen Typs ist. (Von IEquatable<RibbonPosition> geerbt.)

Zum Seitenanfang

Hinweise

Geben Sie mithilfe der Position-Eigenschaft von RibbonGroup die Position einer Gruppe auf einer integrierten Registerkarte relativ zu einer integrierten Gruppe auf der Registerkarte an.Weitere Informationen finden Sie unter Gewusst wie: Anpassen einer integrierten Registerkarte.

Verwenden Sie die Position-Eigenschaft von Steuerelementen, die im Microsoft Office-Menü verwendet werden können (beispielsweise RibbonButton), um die Position des Steuerelements relativ zu einem integrierten Steuerelement im Menü anzugeben.Die Position-Eigenschaft dieser Steuerelemente hat keine Auswirkungen, wenn die Steuerelemente auf einer Menübandregisterkarte platziert werden.Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen von Steuerelementen zur Backstage-Ansicht.

Geben Sie mithilfe der Position-Eigenschaft von RibbonTab die Position der Registerkarte relativ zu einer integrierten Registerkarte an.

Zum Erstellen eines RibbonPosition-Objekts rufen Sie die AfterOfficeId-Methode oder die BeforeOfficeId-Methode des RibbonPositionStatics-Objekts auf.

Sie können ein RibbonPositionStatics-Objekt zur Laufzeit mithilfe der RibbonPosition-Eigenschaft des RibbonFactory-Objekts abrufen.

Es gibt zwei Möglichkeiten, um auf das RibbonFactory-Objekt zuzugreifen:

Mithilfe der Factory-Eigenschaft der Ribbon-Klasse.Verwenden Sie diesen Ansatz aus Code in der Ribbon-Klasse.
Mithilfe der Globals.Factory.GetRibbonFactory-Methode.Verwenden Sie diesen Ansatz aus Code außerhalb der Ribbon-Klasse.