Método DocumentBase.CreateRibbonExtensibilityObject

Artigo
08/01/2011

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

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (em Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Sintaxe

'Declaração
Protected Overridable Function CreateRibbonExtensibilityObject As IRibbonExtensibility

protected virtual IRibbonExtensibility CreateRibbonExtensibilityObject()

Valor de retorno

Tipo: Microsoft.Office.Core.IRibbonExtensibility
Um objeto que implementa o Microsoft.Office.Core.IRibbonExtensibility interface.

Comentários

Substituir esse método para retornar uma implementação de Microsoft.Office.Core.IRibbonExtensibility interface. Se você tiver várias faixas de opções em seu projeto, você pode especificar que faixas de opções para exibir em tempo de execução.

Não é necessário substituir esse método para retornar a faixas de opções que você adicionar ao projeto, usando o a faixa de opções (Visual Designer) modelo de item. Por padrão, esse método retorna um RibbonManager objeto que representa todos os a faixa de opções (Visual Designer) itens no projeto. For more information, see Visão geral da faixa de opções.

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

Exemplos

O seguinte código exemplo substitui o CreateRibbonExtensibilityObject método na ThisAddin ou ThisDocument a classe do projeto e retorna a faixa de opções que você deseja exibir. O exemplo requer que você adicione duas faixas ao seu projeto chamado Ribbon1 e Ribbon2 usando o a faixa de opções (Visual Designer) item. O exemplo verifica o valor de um campo denominado myCondition e retorna a faixa de opções apropriadas. Para usar esse exemplo, executá-lo do ThisDocument a classe em um projeto de nível de documento.

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

DocumentBase Classe

Namespace Microsoft.Office.Tools.Word

Compartilhar via