RibbonOfficeMenu Interface

Definição

public interface class RibbonOfficeMenu : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("49cea6a9-3670-4ae0-9a36-9305e27f302b")]
public interface RibbonOfficeMenu : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("49cea6a9-3670-4ae0-9a36-9305e27f302b")>]
type RibbonOfficeMenu = interface
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonOfficeMenu
Implements IComponent, IDisposable, RibbonComponent

Atributos

GuidAttribute

Implementações

RibbonComponent IComponent IDisposable

Exemplos

O exemplo a seguir itera pelos controles personalizados no menu Do Office da Faixa de Opções e exibe seu nome. Para executar esse exemplo de código, você deve primeiro executar as seguintes etapas:

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

2. Adicione um botão ao Botão do Microsoft Office.

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

4. Defina a propriedade PositionType como AfterOfficeID na propriedade Position .

5. Defina a propriedade OfficeID como FilePrintMenu na propriedade Position .

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

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

Comentários

Quando você adiciona um item da Faixa de Opções (Visual Designer) ao projeto, o Visual Studio atribui automaticamente um novo RibbonOfficeMenu objeto à OfficeMenu propriedade da interface geradaOfficeRibbon. Use este objeto para adicionar novos controles ao Menu do Microsoft Office em tempo de execução ou para acessar os controles que você adicionou ao Menu do Microsoft Office.

Você pode adicionar controles em tempo de execução, mas somente antes que a Faixa de Opções seja carregada. Crie uma instância do controle e 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.

Uso

Essa documentação descreve a versão desse tipo que é usada nos projetos do Office direcionados ao .NET Framework 4 ou posterior. 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. Conheça a documentação sobre este tipo em projetos direcionados ao .NET Framework 3.5 na seguinte seção de referência na documentação do Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Propriedades

Métodos

Aplica-se a