RibbonOfficeMenu Classe (sistema de 2007)

Artigo
08/25/2010

Fornece acesso aos controles que você adicionar ao 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

Public NotInheritable Class RibbonOfficeMenu _
    Inherits RibbonComponent

Dim instance As RibbonOfficeMenu

public sealed class RibbonOfficeMenu : RibbonComponent

Comentários

Quando você adiciona um Faixa de opções (Visual Designer) item ao seu projeto Visual Studio Tools for Office atribui automaticamente um novo RibbonOfficeMenu objeto para o OfficeMenu propriedade do gerado OfficeRibbon classe. Use este objeto para adicionar novos controles para o menu do Microsoft Office em time de execução, ou para controles de acesso que você adicionou ao menu do Microsoft Office.

Você pode adicionar controles em time de execução, mas antes da faixa de opções é carregada.Criar uma instância do controle e, em seguida, adicione o novo controle à Items coleção. Para obter mais informações, consulte Visão geral do modelo de objeto da Faixa de Opções.

Exemplos

O exemplo a seguir itera por meio de controles personalizados no menu Office faixa de opções e exibe seu nome.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 Botão do Office para o Botão do Office Microsoft Office.
conjunto o (Nome) propriedade do botão para myOfficeMenuButton.
conjunto o PositionType propriedade AfterOfficeID sob o Posiçãopropriedade .
conjunto o OfficeID propriedade FilePrintMenu sob o Posiçãopropriedade .

PrivateSub ListOfficeRibbonCustomControls()
    System.Windows.Forms.MessageBox.Show( _
            "Listing all Office Menu custom controls...")
    ForEach control As RibbonComponent In Globals.Ribbons.Ribbon1.OfficeMenu.Items
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name)
    NextEndSub

privatevoid 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);
    }
}

Hierarquia de herança

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonOfficeMenu

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.