RibbonMenu Classe (sistema de 2007)

Artigo
08/25/2010

Representa um menu em uma guia faixa de opções ou no menu do Microsoft Office.

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (em Microsoft.Office.Tools.Common.v9.0.dll)

Sintaxe

<ToolboxBitmapAttribute(GetType(RibbonMenu), "RibbonMenu.bmp")> _
Public NotInheritable Class RibbonMenu _
    Inherits RibbonControl

Dim instance As RibbonMenu

[ToolboxBitmapAttribute(typeof(RibbonMenu), "RibbonMenu.bmp")]
public sealed class RibbonMenu : RibbonControl

Comentários

Visual Studio Tools for Office cria uma instância das RibbonMenu classe quando você arrasta um Menu controle o Controles da faixa de opções de escritório Guia de do Caixa de ferramentas para o Designer de faixa de opções.

Tarefas comuns

A tabela a seguir lista os membros que são úteis para tarefas comuns.Todas essas tarefas podem ser executadas em time de design.Algumas dessas tarefas podem ser executadas em time de execução apenas antes que a faixa de opções é carregada para o aplicativo do Office ou antes do controle é adicionado a um menu dinâmico em time de execução.Para obter mais informações, consulte Visão geral do modelo de objeto da Faixa de Opções.

Tarefa	Membro
Exiba uma imagem no menu.	Use o Image ou ImageName propriedade. Também é possível reutilizar imagens que aparecem em controles da faixa de opções internos.Para fazer isso, conjunto OfficeImageId sistema autônomo a ID de uma imagem interna do Microsoft Office que você deseja exibir sistema autônomo ícone do menu.
alterar o dimensionar do menu.	conjunto o ControlSize propriedade para o valor desejado. Por exemplo, para um vasto menu conjunto-o para Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
Altere o dimensionar de itens no menu.	conjunto o ItemSize propriedade para o valor desejado. Por exemplo, para exibir itens maiores, defini-la como Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge.
Habilitar alterações para o menu em time de execução (por exemplo, para ativar os controles sejam adicionados ao menu em time de execução).	Defina a propriedade Dynamic como true.
Acessar os controles no menu, adicionar controles ao menu ou remover controles de menu.	Use o Items propriedade.
Adicione um menu para o menu do Microsoft Office, um agrupar, ou outro controle que pode conter menus.	Criar uma instância do RibbonMenu classe usando o RibbonMenu construtor e, em seguida, adicione o novo RibbonMenu para o Items propriedade do menu do Microsoft Office, agrupar ou controle.

Exemplos

O exemplo a seguir demonstra como adicionar e popular um submenu a um menu existente em time de execução.

Para obter um exemplo mais sofisticado que atualiza controles em time de execução e envolve obter dados do banco de dados de exemplo AdventureWorks usando integrada consultas (LINQ), consulte Demonstra Passo a passo: Atualizar os controles em uma faixa de opções em tempo de execução.

Para executar este exemplo de código, realize as seguintes etapas:

Adicionar um Faixa de opções (Visual Designer) item to a Visual Studio Tools for Office projeto.
Adicione um agrupar à guia personalizada.
Adicione um menu ao agrupar.
conjunto o (Nome) propriedade do menu para CustomerMenu.
conjunto o Rótulo propriedade do menu para clientes.
conjunto o Dinâmico propriedade do menu para true.

Isso lhe permite adicionar e remover controles no menu em time de execução depois da faixa de opções é carregada no aplicativo do Office.

PrivateSub PopulateCustomerMenu()
    ' Add two sub-menus to EmployeeMenu and populate each sub-menu    ' First sub-menuDim subMenu1 AsNew RibbonMenu()
    subMenu1.Dynamic = True
    subMenu1.Label = "A - M"
    subMenu1.Items.Add(New RibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Hall, Don"
    subMenu1.Items.Add(New RibbonToggleButton())
    CType(subMenu1.Items.Last(), RibbonToggleButton).Label = "Valdez, Rachel"
    CustomerMenu.Items.Add(subMenu1)

    ' Second sub-menuDim subMenu2 AsNew RibbonMenu()
    subMenu2.Dynamic = True
    subMenu2.Label = "N - Z"
    subMenu2.Items.Add(New RibbonToggleButton())
    CType(subMenu2.Items.Last(), RibbonToggleButton).Label = "Robinson, Alex"
    CustomerMenu.Items.Add(subMenu2)

EndSub

privatevoid PopulateCustomerMenu()
{
    // Add two sub-menus to EmployeeMenu and populate each sub-menu// First sub-menu
    RibbonMenu subMenu1 = new RibbonMenu();
    subMenu1.Dynamic = true;
    subMenu1.Label = "A - M";
    subMenu1.Items.Add(new RibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Hall, Don";
    subMenu1.Items.Add(new RibbonToggleButton());
    ((RibbonToggleButton)subMenu1.Items.Last()).Label = "Valdez, Rachel";
    CustomerMenu.Items.Add(subMenu1);

    // Second sub-menu
    RibbonMenu subMenu2 = new RibbonMenu();
    subMenu2.Dynamic = true;
    subMenu2.Label = "N - Z";
    subMenu2.Items.Add(new RibbonToggleButton());
    ((RibbonToggleButton)subMenu2.Items.Last()).Label = "Robinson, Alex";
    CustomerMenu.Items.Add(subMenu2);
}

Hierarquia de herança

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonControl
          Microsoft.Office.Tools.Ribbon.RibbonMenu

Acesso thread-safe

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.