RibbonFactory.CreateRibbonManager(IRibbonExtension[]) Método

Referência

Definição

Namespace:: Microsoft.Office.Tools.Ribbon

Assemblies:: Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

public:
 Microsoft::Office::Core::IRibbonExtensibility ^ CreateRibbonManager(cli::array <Microsoft::Office::Tools::Ribbon::IRibbonExtension ^> ^ ribbons);

public Microsoft.Office.Core.IRibbonExtensibility CreateRibbonManager (Microsoft.Office.Tools.Ribbon.IRibbonExtension[] ribbons);

abstract member CreateRibbonManager : Microsoft.Office.Tools.Ribbon.IRibbonExtension[] -> Microsoft.Office.Core.IRibbonExtensibility

Public Function CreateRibbonManager (ribbons As IRibbonExtension()) As IRibbonExtensibility

Parâmetros

ribbons: IRibbonExtension[]

Uma matriz de instâncias IRibbonExtension.

Retornos

IRibbonExtensibility

Um objeto que representa uma personalização da Faixa de Opções.

Exemplos

O exemplo a seguir usa uma condição para determinar qual Faixa de Opções personalizada exibir. Em seguida, este exemplo usa o CreateRibbonManager método para criar e, em seguida, 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 que foi criada usando o item Faixa de Opções (Visual Designer). A sintaxe para retornar uma Faixa de Opções criada usando um item de Faixa de Opções (XML) é ligeiramente diferente. Para obter mais informações sobre como retornar um item da Faixa de Opções (XML), consulte XML da Faixa de Opções.

    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() });
        }
    }

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

Comentários

Retorne o IRibbonExtensibility objeto no CreateRibbonExtensibilityObject método da ThisAddinclasse , ThisWorkbookou ThisDocument do projeto para retornar a Faixa de Opções que você deseja exibir no aplicativo do Office.

Aplica-se a

Compartilhar via