Método DocumentBase.CreateRibbonExtensibilityObject

Artigo
05/21/2013

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

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 a interface de Microsoft.Office.Core.IRibbonExtensibility .

Comentários

Substitua esse método para retornar uma implementação da interface de Microsoft.Office.Core.IRibbonExtensibility .Se você tiver vários fitas em seu projeto, você pode especificar que as fitas para exibir em tempo de execução.

Você não precisa substituir esse método para retornar as fitas que você adiciona ao projeto usando o modelo de item de Faixa de Opções (Visual Designer) .Por padrão, esse método retorna um objeto de RibbonManager que representa todos os itens de 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 método de CreateRibbonExtensibilityObject ou de RequestService para retornar fitas em seu projeto que você adiciona usando o modelo de item de Faixa de Opções (XML) .Para obter mais informações sobre como substituir o método de CreateRibbonExtensibilityObject , consulte Faixa de opções XML.

Exemplos

O exemplo de código substitui o método de CreateRibbonExtensibilityObject na classe de ThisAddin ou de ThisDocument de projeto e retorna a fita que você deseja exibir.O exemplo requer que você adiciona duas fitas ao seu projeto chamado Ribbon1 e Ribbon2 usando o item de Faixa de Opções (Visual Designer) .O exemplo verifica o valor de um campo denominado myCondition e retorna a fita apropriado.Para usar este exemplo, ele execução da classe de ThisDocument em um projeto de um documento nível.

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