Método RibbonFactory.CreateRibbonManager

Artigo
08/01/2011

Cria um IRibbonExtensibility objeto que representa uma personalização da faixa de opções.

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (em Microsoft.Office.Tools.Common.dll)

Sintaxe

'Declaração
Function CreateRibbonManager ( _
    ribbons As IRibbonExtension() _
) As IRibbonExtensibility

IRibbonExtensibility CreateRibbonManager(
    IRibbonExtension[] ribbons
)

Parâmetros

ribbons
Tipo: array<Microsoft.Office.Tools.Ribbon.IRibbonExtension[]
Uma matriz de IRibbonExtension instâncias.

Valor de retorno

Tipo: Microsoft.Office.Core.IRibbonExtensibility
Um objeto que representa uma personalização da faixa de opções.

Comentários

Retornar a IRibbonExtensibility objeto na CreateRibbonExtensibilityObject método da ThisAddin, ThisWorkbook, ou ThisDocument a classe do projeto para retornar a faixa de opções que você deseja exibir no aplicativo do Office.

Exemplos

O exemplo a seguir usa uma condição para determinar qual faixa de opções personalizada para exibir. Este exemplo usa a CreateRibbonManager método para criar e retornar um IRibbonExtension objeto que representa a faixa de opções personalizada.

Observação
A sintaxe usada neste exemplo retorna uma faixa de opções foi criada usando o a faixa de opções (Visual Designer) item. A sintaxe para retornar uma faixa de opções é criada usando um Da faixa de opções (XML) item é um pouco diferente. Para obter mais informações sobre como retornar um Da faixa de opções (XML) item, consulte XML da faixa de opções.

Protected Overrides Function CreateRibbonExtensibilityObject() As  _
    Microsoft.Office.Core.IRibbonExtensibility
    If myCondition = True Then
        Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
                 {New Ribbon1()})
    Else
        Return Globals.Factory.GetRibbonFactory().CreateRibbonManager _
            (New Microsoft.Office.Tools.Ribbon.IRibbonExtension() _
                 {New Ribbon2()})
    End If
End Function

    protected override Microsoft.Office.Core.IRibbonExtensibility
CreateRibbonExtensibilityObject()
    {
        if (myCondition == true)
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon1() });
        }
        else
        {
            return Globals.Factory.GetRibbonFactory().CreateRibbonManager(
                new Microsoft.Office.Tools.Ribbon.IRibbonExtension[] { new Ribbon2() });
        }
    }

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

RibbonFactory Interface

Namespace Microsoft.Office.Tools.Ribbon

Partilhar via