Compartilhar via


Visão geral do objeto IRibbonUI

Um suplemento pode usar o objeto IRibbonUI para invalidar controles ou itens de menu e atualizar seu conteúdo na interface de usuário correspondente do Microsoft Outlook. O suplemento especifica métodos de retorno de chamada no XML que IRibbonExtensibility.GetCustomUI retorna. Esses métodos de retorno de chamada lidam com eventos para controles personalizados ou itens de menu personalizados.

Quando o Outlook chama um desses métodos, ele passa um objeto IRibbonUI como um parâmetro para o método de retorno de chamada. O objeto IRibbonUI tem um escopo, de modo que o suplemento somente possa invalidar seus próprios controles ou itens de menu que usem o objeto. O suplemento não pode invalidar os controles ou itens de menu criados por outro suplemento.

IRibbonUI expõe os seguintes métodos para personalizar a interface do usuário do Outlook:

Method Action Descrição
Invalidar() Callback Marca todos os controles ou itens de menu personalizados no suplemento para atualização.
InvalidateControl(string controlID) Callback Marca um determinado controle ou item de menu que é definido por um controlID no suplemento para atualização.
ActivateTab Callback Ativa a guia personalizada especificada na interface do usuário da faixa de opções do Microsoft Office Fluent.
ActivateTabQ Callback Ativa a guia personalizada especificada na faixa de opções usando o nome totalmente qualificado da guia.

Para minimizar o impacto no desempenho, use o método InvalidateControl em vez do método Invalidate , a menos que você realmente precise invalidar todos os controles personalizados ou itens de menu que seu suplemento define. Chamar Invalidate invalida todos os controles e itens de menu definidos pelo suplemento e os retornos de chamada ocorrerão em inspetores e gerenciadores abertos e em menus.

Confira também

Implementando a extensibilidade da interface IRibbonExtensibilitydo Office Fluent User Interface para Outlook

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.