RibbonPosition-Schnittstelle

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
Assembly:  Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.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
Öffentliche Eigenschaft 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.
Öffentliche Eigenschaft 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
Öffentliche Methode Equals Gibt an, ob das aktuelle Objekt einem anderen Objekt des gleichen Typs entspricht. (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: Anpassen des Microsoft Office-Menüs.

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.

Siehe auch

Referenz

Microsoft.Office.Tools.Ribbon-Namespace

Weitere Ressourcen

Gewusst wie: Anpassen des Microsoft Office-Menüs

Gewusst wie: Anpassen einer integrierten Registerkarte

Multifunktionsleisten-Objektmodellübersicht