Overzicht van lintobjectmodel

Visual Studio Tools voor Office Runtime maakt een sterk getypt objectmodel beschikbaar dat u kunt gebruiken om de eigenschappen van lintbesturingselementen tijdens runtime op te halen en in te stellen. U kunt bijvoorbeeld menubesturingselementen dynamisch vullen of besturingselementen contextueel weergeven en verbergen. U kunt ook tabbladen, groepen en besturingselementen toevoegen aan een lint, maar alleen voordat het lint wordt geladen door de Office-toepassing. Zie Eigenschappen instellen die het kenmerk Alleen-lezen hebben.

Van toepassing op: De informatie in dit onderwerp is van toepassing op projecten op documentniveau en VSTO-invoegtoepassingsprojecten voor de volgende toepassingen: Excel; InfoPath 2013 en InfoPath 2010; Vooruitzicht; PowerPoint; Project; Visio; Woord. Zie Functies die beschikbaar zijn voor de Office-toepassing en het projecttype voor meer informatie.

Dit lintobjectmodel bestaat voornamelijk uit de klassen Lint,Lint-gebeurtenissen en Lintbesturingselementklassen.

Lintklasse

Wanneer u een nieuw Ribbon (Visual Designer)-item aan een project toevoegt, voegt Visual Studio een Ribbon-klasse aan uw project toe. De Ribbon-klasse erft van de RibbonBase-klasse.

Deze klasse wordt weergegeven als een gedeeltelijke klasse die wordt gesplitst tussen het lintcodebestand en het codebestand Lintontwerper.

Ribbon-gebeurtenissen

De Ribbon-klasse bevat de volgende drie events:

Lintcontrole

De Microsoft.Office.Tools.Ribbon naamruimte bevat een type voor elke controle die u ziet in de groep Besturingselementen van het Office-lint van de Toolbox.

In de volgende tabel wordt het type voor elke Ribbon controle weergegeven. Zie het lintoverzicht voor een beschrijving van elk besturingselement.

De Microsoft.Office.Tools.Ribbon-naamruimte maakt gebruik van het voorvoegsel 'Lint' voor deze typen om conflicten met de namen van controleklassen in de System.Windows.Forms-naamruimte te voorkomen.

Wanneer u een besturingselement toevoegt aan de Lintontwerper, declareert de Lintontwerper de klasse voor dat besturingselement als een veld in het codebestand van de Lintontwerper.

Algemene taken met behulp van de eigenschappen van lintbesturingselementen

Elk Ribbon besturingselement bevat eigenschappen die u kunt gebruiken om verschillende taken uit te voeren, zoals het toewijzen van een label aan een besturingselement of het verbergen en weergeven van besturingselementen.

In sommige gevallen zijn eigenschappen alleen-lezen zodra de Ribbon is geladen of zodra een besturingselement is toegevoegd aan een dynamisch menu. Zie Eigenschappen instellen die alleen-lezen worden voor meer informatie.

In de volgende tabel worden enkele taken beschreven die u kunt uitvoeren met behulp van Ribbon besturingseigenschappen.

Eigenschappen instellen die het kenmerk Alleen-lezen hebben

Sommige eigenschappen kunnen alleen worden ingesteld voordat het lint wordt geladen. Er zijn drie plaatsen om deze eigenschappen in te stellen:

• In het venster Eigenschappen van Visual Studio.

• In de constructor van de Ribbon klasse.

• In de CreateRibbonExtensibilityObject-methode van de ThisAddin, ThisWorkbook, of ThisDocument-klasse van uw project.

  Dynamische menu's bieden enkele uitzonderingen. U kunt nieuwe besturingselementen maken, hun eigenschappen instellen en deze vervolgens toevoegen aan een dynamisch menu tijdens runtime, zelfs nadat het lint met het menu is geladen.

  Eigenschappen van besturingselementen die u aan een dynamisch menu toevoegt, kunnen op elk gewenst moment worden ingesteld.

  Zie Eigenschappen die het kenmerk Alleen-lezen hebben voor meer informatie.

Eigenschappen instellen in de constructor van het lint

U kunt de eigenschappen van een Ribbon controle instellen in de constructor van de Ribbon class. Deze code moet worden weergegeven na de aanroep van de InitializeComponent methode. In het volgende voorbeeld wordt een nieuwe knop aan een groep toegevoegd als de huidige tijd 17:00 Pacific Time (UTC-8) of later is.

Voeg de volgende code toe.

public Ribbon1()
    : base(Globals.Factory.GetRibbonFactory())
{
    InitializeComponent();
    if (System.DateTime.Now.Hour > 16)
    {
        Microsoft.Office.Tools.Ribbon.RibbonButton button =
            this.Factory.CreateRibbonButton();
        button.Label = "New Button";
        group1.Items.Add(button);
    }
}

<System.Diagnostics.DebuggerNonUserCode()> _
Public Sub New()
    MyBase.New(Globals.Factory.GetRibbonFactory())

    'This call is required by the Component Designer.
    InitializeComponent()
    Dim MyButton As Microsoft.Office.Tools.Ribbon.RibbonButton = _
        Me.Factory.CreateRibbonButton()
    MyButton.Label = "New Button"
    If System.DateTime.Now.Hour > 16 Then
        Group1.Items.Add(MyButton)
    End If

End Sub

In Visual C#-projecten die u hebt bijgewerkt vanuit Visual Studio 2008, wordt de constructor weergegeven in het lintcodebestand.

In Visual Basic-projecten of in Visual C#-projecten die u in Visual Studio 2013 hebt gemaakt, wordt de constructor weergegeven in het codebestand lintontwerper. Dit bestand heeft de naam YourRibbonItem. Designer.cs of YourRibbonItem. Designer.vb. Als u dit bestand in Visual Basic-projecten wilt zien, moet u eerst op de knop Alle bestanden weergeven in Solution Explorer klikken.

Eigenschappen instellen in de methode CreateRibbonExtensibilityObject

U kunt de eigenschappen van een Ribbon besturingselement instellen wanneer u de CreateRibbonExtensibilityObject methode in de ThisAddin, ThisWorkbookof ThisDocument klasse van uw project overschrijft. Zie CreateRibbonExtensibilityObject voor meer informatie over de methode.

In het volgende voorbeeld worden linteigenschappen ingesteld in de CreateRibbonExtensibilityObject methode van de ThisWorkbook klasse van een Excel-werkmapproject.

Voeg de volgende code toe.

protected override Microsoft.Office.Core.IRibbonExtensibility
    CreateRibbonExtensibilityObject()
{
    bool myCondition = false;
    if (myCondition == true)
    {
        Ribbon1 tempRibbon = new Ribbon1();
        tempRibbon.tab1.ControlId.ControlIdType =
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office;
        tempRibbon.tab1.ControlId.OfficeId = "TabHome";
        return Globals.Factory.GetRibbonFactory().CreateRibbonManager( 
            new Microsoft.Office.Tools.Ribbon.IRibbonExtension[]
             { tempRibbon });
    }
    else
    {
        Ribbon2 tempRibbon = new Ribbon2();
        tempRibbon.tab1.ControlId.ControlIdType =
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office;
        tempRibbon.tab1.ControlId.OfficeId = "TabInsert";
        return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                            new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { tempRibbon });
    }
}

Protected Overrides Function CreateRibbonExtensibilityObject() _
    As Microsoft.Office.Core.IRibbonExtensibility
    Dim myCondition As Boolean = True
    If myCondition = True Then
        Dim tempRibbon As New Ribbon1()
        tempRibbon.Tab1.ControlId.ControlIdType = _
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office
        tempRibbon.Tab1.ControlId.OfficeId = "TabHome"
        Return Globals.Factory.GetRibbonFactory.CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() {tempRibbon})
    Else
        Dim tempRibbon As New Ribbon2()
        tempRibbon.Tab1.ControlId.ControlIdType = _
            Microsoft.Office.Tools.Ribbon.RibbonControlIdType.Office
        tempRibbon.Tab1.ControlId.OfficeId = "TabInsert"
        Return Globals.Factory.GetRibbonFactory.CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() {tempRibbon})
    End If
End Function

Eigenschappen die alleen-lezen worden

In de volgende tabel ziet u eigenschappen die alleen kunnen worden ingesteld voordat het lint wordt geladen.

Eigenschappen instellen voor linten die worden weergegeven in Outlook-inspectors

Telkens wanneer een gebruiker een Inspector opent waarin het lint wordt weergegeven, wordt er een nieuw exemplaar van het lint gemaakt. U kunt de eigenschappen in de bovenstaande tabel echter alleen instellen voordat het eerste exemplaar van het lint wordt gemaakt. Nadat de eerste instantie is gemaakt, worden deze eigenschappen alleen-lezen omdat de eerste instantie het XML-bestand definieert dat Outlook gebruikt om de ribbon te laden.

Als u voorwaardelijke logica hebt waarmee een van deze eigenschappen wordt ingesteld op een andere waarde wanneer andere exemplaren van het lint worden gemaakt, heeft deze code geen effect.

Gebeurtenissen van lintbesturingselementen

Elke besturingsklasse bevat een of meer gebeurtenissen. In de volgende tabel worden deze gebeurtenissen beschreven.

De gebeurtenis-handlers voor deze gebeurtenissen hebben de volgende twee parameters.

Verwante inhoud

• Toegang tot het lint tijdens runtime
• Overzicht van het lint
• Procedure: Aan de slag met het aanpassen van het lint
• Ribbon Designer
• Overzicht: Een aangepast tabblad maken met de lintontwerper
• Stapsgewijze handleiding: De besturingselementen op een lint bijwerken tijdens de uitvoertijd
• Een lint voor Outlook aanpassen
• Procedure: Een ingebouwd tabblad aanpassen
• Procedure: Besturingselementen toevoegen aan de weergave Backstage
• Procedure: Een lint exporteren van de Ribbon Designer naar Ribbon XML
• Hoe u: Fouten in de gebruikersinterface van invoegtoepassingen weergeeft