Compartilhar via

Interface RibbonOfficeMenu

  • Artigo

Fornece acesso aos controles que você adicionar a Microsoft Office o menu.

Namespace:  Microsoft.Office.Tools.Ribbon
Assemblies:   Microsoft.Office.Tools.Common (em Microsoft.Office.Tools.Common.dll)
  Microsoft.Office.Tools.Common.v4.0.Utilities (em Microsoft.Office.Tools.Common.v4.0.Utilities.dll)

Sintaxe

'Declaração
<GuidAttribute("49cea6a9-3670-4ae0-9a36-9305e27f302b")> _
Public Interface RibbonOfficeMenu _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("49cea6a9-3670-4ae0-9a36-9305e27f302b")]
public interface RibbonOfficeMenu : RibbonComponent, 
    IComponent, IDisposable

O tipo RibbonOfficeMenu expõe os membros a seguir.

Propriedades

  Nome Descrição
Propriedade pública Items Obtém os controles de fita que você adicionou a Microsoft Office o menu.
Propriedade pública Name Obtém ou define o nome do RibbonComponent. (Herdado de RibbonComponent.)
Propriedade pública Parent Obtém RibbonComponent que representa o pai deste RibbonComponent. (Herdado de RibbonComponent.)
Propriedade pública Ribbon Obtém o objeto de nível superior de Ribbon que contém a hierarquia de controle. (Herdado de RibbonComponent.)
Propriedade pública RibbonUI Infraestrutura. Obtém a instância de IRibbonUI que é fornecida pelo aplicativo do Microsoft Office para o código de extensibilidade de fita. (Herdado de RibbonComponent.)
Propriedade pública Site Obtém ou define o ISite associados a IComponent. (Herdado de IComponent.)
Propriedade pública Tag Obtém ou define os dados específicos do aplicativo que estão associados com esse RibbonComponent. (Herdado de RibbonComponent.)

Superior

Métodos

  Nome Descrição
Método público Dispose Executa tarefas definido pelo aplicativo associadas liberando, liberando ou redefinindo recursos não gerenciados. (Herdado de IDisposable.)
Método público PerformDynamicLayout Chama o método de Microsoft.Office.Core.IRibbonUI.InvalidateControl do controle pai se RibbonComponent tem um pai dinâmico, como um menu dinâmico, e layout não está suspenso. (Herdado de RibbonComponent.)
Método público PerformLayout Chama Microsoft.Office.Core.IRibbonUI.InvalidateControl se RibbonComponent tem um pai e o layout não está suspenso. (Herdado de RibbonComponent.)
Método público ResumeLayout() Inverte o efeito de método de SuspendLayout . (Herdado de RibbonComponent.)
Método público ResumeLayout(Boolean) Inverte o efeito de método de SuspendLayout . (Herdado de RibbonComponent.)
Método público SuspendLayout Impede que o aplicativo do Microsoft Office atualizar o estado de controles em fita. (Herdado de RibbonComponent.)

Superior

Eventos

  Nome Descrição
Evento público Disposed Representa o método que manipula o Disposed o evento de um componente. (Herdado de IComponent.)

Superior

Comentários

Quando você adiciona um item de Faixa de Opções (Visual Designer) ao seu projeto, o Visual Studio automaticamente atribui um novo objeto de RibbonOfficeMenu à propriedade de OfficeMenu de interface de OfficeRibbon gerado.Use esse objeto para adicionar em tempo de execução novos controles para o menu do Microsoft Office, ou aos controles de acesso que você adicionou a Microsoft Office o menu.

Você pode adicionar controles em tempo de execução, mas somente antes que a fita é carregada.Crie uma instância do controle e em seguida, adicione o novo controle à coleção de Items .Para obter mais informações, consulte Visão geral do modelo de objeto de faixa de opções.

ObservaçãoObservação

Essa interface é implementada pelo Visual Studio Tools for Office Runtime. Ela não se destina a ser implementada em seu código. Para obter mais informações, consulte Visual Studio Tools for Office visão geral sobre o tempo de execução.

Uso

Essa documentação descreve a versão desse tipo que é usada apenas nos projetos do Office direcionados ao .NET Framework 4 e ao .NET Framework 4.5. Em projetos direcionados ao .NET Framework 3.5, esse tipo pode ter membros diferentes e os exemplos de código fornecidos para este tipo talvez não funcionem. Para obter documentação sobre este tipo em projetos destinados ao .NET Framework 3.5, consulte a seguinte seção de referência na documentação do Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Exemplos

O exemplo efetua iterações através dos controles personalizados no menu do Office de fita e exibe o nome.Para executar este exemplo de código, primeiro você deve executar as seguintes etapas:

  1. Adicionar um item de Faixa de Opções (Visual Designer) a um projeto do Office.

  2. Adicione um botão para o botão do Microsoft Office.

  3. Defina a propriedade de (Nome) do botão como myOfficeMenuButton.

  4. Defina a propriedade de PositionType a AfterOfficeID sob a propriedade de Posição .

  5. Defina a propriedade de OfficeID a FilePrintMenu sob a propriedade de Posição .

Private Sub ListOfficeRibbonCustomControls()
    System.Windows.Forms.MessageBox.Show( _
            "Listing all Office Menu custom controls...")
    For Each control As RibbonComponent In Globals.Ribbons.Ribbon1.OfficeMenu.Items
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name)
    Next
End Sub

private void ListOfficeRibbonCustomControls()
{
    System.Windows.Forms.MessageBox.Show(
        "Listing all Office Menu custom controls...");
    foreach (RibbonComponent control in Globals.Ribbons.Ribbon1.OfficeMenu.Items)
    {
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name);
    }
}

Consulte também

Referência

Namespace Microsoft.Office.Tools.Ribbon

Outros recursos

Como: adicionar controles ao modo de exibição Backstage

Visão geral do modelo de objeto de faixa de opções