Objeto IRibbonUI (Office)

O objeto retornado pelo procedimento onLoad especificado na marca customUI. O objeto contém métodos para propriedades do controle de invalidação e atualizar a interface do usuário.

O objeto IRibbonUI não gera eventos na interação com o utilizador. Em vez disso, os elementos do friso efetuam chamadas de retorno para o seu código e a ligação entre os elementos do friso e o código é definida no XML que descreve as adições do friso.

Para obter informações sobre as funções de chamada de retorno disponíveis para cada elemento da IU, procure "Como posso determinar as assinaturas corretas para cada procedimento de chamada de retorno?" em Personalizar o Friso do Office Fluent para Programadores de 2007.

Comentários

Pode personalizar a interface de utilizador (IU) do Friso através de procedimentos de chamada de retorno em suplementos COM. Quando a aplicação anfitriã é iniciada, o procedimento de chamada de retorno onLoad é chamado. Em seguida, o procedimento de retorno de chamada retorna um objeto IRibbonUI apontando para a interface do usuário. Utilize esse objeto para invocar os métodos Invalidate, InvalidateControl e Refresh .

Exemplo

No exemplo seguinte, iniciar a aplicação anfitriã aciona o procedimento de evento onLoad que, em seguida, chama um procedimento que cria um objeto IRibbonUI que representa a IU do Friso. Em seguida, é definido um procedimento de retorno de chamada que invalida todos os controles de cache e atualiza a interface do usuário.

<customUI … OnLoad="MyAddInInitialize" …>

Dim MyRibbon As IRibbonUI 
 
Sub MyAddInInitialize(Ribbon As IRibbonUI) 
 Set MyRibbon = Ribbon 
End Sub 
 
Sub myFunction() 
 MyRibbon.Invalidate() ' Invalidates the caches of all of this add-in's controls 
End Sub

Confira também

• Membros do objeto IRibbonUI
• Chamadas de retorno ribbonXML
• Referência do modelo de objeto

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.