DocumentBase.CreateRibbonExtensibilityObject Método

Referência

Definição

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.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.

Retorna um objeto que implementa a interface Microsoft.Office.Core.IRibbonExtensibility.

protected:
 virtual Microsoft::Office::Core::IRibbonExtensibility ^ CreateRibbonExtensibilityObject();

protected virtual Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject ();

abstract member CreateRibbonExtensibilityObject : unit -> Microsoft.Office.Core.IRibbonExtensibility
override this.CreateRibbonExtensibilityObject : unit -> Microsoft.Office.Core.IRibbonExtensibility

Protected Overridable Function CreateRibbonExtensibilityObject () As IRibbonExtensibility

Retornos

IRibbonExtensibility

Um objeto que implementa a interface Microsoft.Office.Core.IRibbonExtensibility.

Exemplos

O exemplo de código a seguir substitui o CreateRibbonExtensibilityObject método na ThisAddin classe ou ThisDocument do projeto e retorna a Faixa de Opções que você deseja exibir. O exemplo exige que você adicione duas Faixas de Opções ao seu projeto chamada Ribbon1 e Ribbon2 usando o item Faixa de Opções (Visual Designer). O exemplo verifica o valor de um campo chamado myCondition e retorna a Faixa de Opções apropriada. Para usar esse exemplo, execute-o na classe ThisDocument em um projeto no nível de documento.

    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

Substitua esse método para retornar uma implementação da Microsoft.Office.Core.IRibbonExtensibility interface. Se você tiver várias Faixas de Opções em seu projeto, poderá especificar quais Faixas de Opções exibir em tempo de execução.

Você não precisa substituir esse método para retornar faixas de opções adicionadas ao projeto usando o modelo de item Faixa de Opções (Visual Designer). Por padrão, esse método retorna um RibbonManager objeto que representa todos os itens da Faixa de Opções (Visual Designer) no projeto. Para obter mais informações, consulte Visão geral da faixa de opções.

Você deve substituir o CreateRibbonExtensibilityObject método ou RequestService para retornar Faixas de Opções em seu projeto que você adicionar usando o modelo de item faixa de opções (XML ). Para obter mais informações sobre como substituir o CreateRibbonExtensibilityObject método, consulte Ribbon XML.

Aplica-se a

Compartilhar via