Interface RibbonOfficeMenu

  • Artigo

Fornece acesso aos controles que você adiciona ao Menu de Microsoft Office.

Namespace:  Microsoft.Office.Tools.Ribbon
Assembly:  Microsoft.Office.Tools.Common (em Microsoft.Office.Tools.Common.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 da faixa de opções que você adicionou ao Menu de Microsoft Office.
Propriedade pública Name Obtém ou define o nome deste RibbonComponent. (Herdado de RibbonComponent.)
Propriedade pública Parent Obtém um RibbonComponent que representa o pai RibbonComponent. (Herdado de RibbonComponent.)
Propriedade pública Ribbon Obtém um nível superior Ribbon objeto que contém a hierarquia de controle. (Herdado de RibbonComponent.)
Propriedade pública RibbonUI Infraestrutura. Obtém o IRibbonUI instância que é fornecida pelo aplicativo de Microsoft Office para o código de extensibilidade da faixa de opções. (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á associados esta RibbonComponent. (Herdado de RibbonComponent.)

Início

Métodos

  Nome Descrição
Método público Dispose Executa tarefas de definição de aplicativo associadas liberando, liberando ou redefinindo recursos não gerenciados. (Herdado de IDisposable.)
Método público PerformDynamicLayout Chamadas a Microsoft.Office.Core.IRibbonUI.InvalidateControl método do pai de controle se o RibbonComponent tem um pai dinâmico, como, por exemplo, um menu dinâmico, e o layout não for suspensa. (Herdado de RibbonComponent.)
Método público PerformLayout Chamadas Microsoft.Office.Core.IRibbonUI.InvalidateControl se a RibbonComponent tem um pai e o layout não for suspensa. (Herdado de RibbonComponent.)
Método público ResumeLayout() Reverte o efeito da SuspendLayout método. (Herdado de RibbonComponent.)
Método público ResumeLayout(Boolean) Reverte o efeito da SuspendLayout método. (Herdado de RibbonComponent.)
Método público SuspendLayout Impede que o aplicativo Microsoft Office o estado dos controles da faixa de opções de atualização. (Herdado de RibbonComponent.)

Início

Eventos

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

Início

Comentários

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

Você pode adicionar controles em tempo de execução, mas antes da faixa de opções é carregada. Criar uma instância do controle e, em seguida, adicione o novo controle de Items coleção. For more information, see Visão geral do modelo de objeto de faixa de opções.

ObservaçãoObservação

Esta 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.

Usage

Esta documentação descreve a versão deste tipo que é usada em projetos do Office destinados ao .NET Framework 4. Em projetos destinados ao .NET Framework 3.5, este tipo poderá ter membros diferentes, e os exemplos de código fornecidos para o 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 a seguir itera através dos controles personalizados no menu Office da faixa de opções e exibe seu nome. Para executar este exemplo de código, realize as seguintes etapas:

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

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

  3. Definir o (nome) a propriedade do botão de myOfficeMenuButton.

  4. Definir o PositionType propriedade para AfterOfficeID sob o posição propriedade.

  5. Definir o OfficeID propriedade para FilePrintMenu sob o posição propriedade.

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: Personalizar o Menu Microsoft Office

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