Visão geral do objeto IRibbonControl

  • Artigo

O objeto IRibbonControl é passado na maioria dos retornos de chamada disponíveis para controles na faixa de opções ou no modo de exibição backstage do Microsoft Office, bem como os itens de menu personalizáveis no Microsoft Outlook. O objeto é especialmente útil para desenvolvedores do Outlook porque fornece uma propriedade IRibbonControl.Context que retorna o objeto do Outlook relacionado ao qual a personalização é aplicada e que está prestes a ser exibido.

Por exemplo, a propriedade Context retornará o objeto Explorer, se você personalizar a faixa de opções em um gerenciador, e retornará o objeto Store, se você personalizar o menu de atalho para uma pasta de repositório.

IRibbonControl expõe as seguintes propriedades.

Propriedade Tipo Descrição
Context Object Retorna um objeto que representa a janela na qual a faixa de opções personalizada está prestes a ser exibida ou o objeto relacionado ao qual a personalização do menu é aplicada e está prestes a ser exibida. Somente leitura.
Id String Retorna uma cadeia de caracteres que representa o atributo Id do controle ou item de menu personalizado. Somente leitura.
Tag String Retorna uma cadeia de caracteres que representa o atributo Tag do controle ou item de menu personalizado. Somente leitura.

Ao escrever código gerenciado, tente lançar o objeto representado por IRibbonControl.Context para o objeto do Outlook correspondente. Por exemplo, se você personalizar uma faixa de opções em um inspetor, faça a conversão do objeto Inspector. Em seguida, se a conversão for bem-sucedida, você poderá comparar o objeto Inspector que é retornado por IRibbonControl.Context com outras janelas de inspetor que estão abertas. Para determinar o item subjacente em uma janela do inspetor, examine Inspector.CurrentItem. Como CurrentItem é um tipo Object, o código deverá converter o objeto em um tipo de item apropriado, como MailItem ou ContactItem.

Confira também

Extensibilidade da interface do usuário fluente do Office para Outlookimplementando a Interface IRibbonExtensibility

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.