Objeto IRibbonUI (Office)

  • Artigo

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 em sua interação com o usuário. Em vez disso, os elementos de faixa de opções executam retornos de chamada ao código e a vinculação entre elementos de faixa de opções e seu código é definida no XML que descreve suas adições de faixa de opções.

Para obter informações sobre as funções de retorno de chamada disponíveis para cada elemento da interface do usuário, pesquise "Como posso determinar as assinaturas corretas para cada procedimento de retorno de chamada?" na Personalização da Faixa de Opções Fluente do Office 2007 para Desenvolvedores.

Comentários

Você pode personalizar a interface do usuário do Ribbon (interface do usuário) usando procedimentos de retorno de chamada em suplementos COM. Quando o aplicativo host é iniciado, o procedimento de retorno de chamada onLoad é chamado. Em seguida, o procedimento de retorno de chamada retorna um objeto IRibbonUI apontando para a interface do usuário. Use esse objeto para invocar os métodos Invalidate, InvalidateControl e Refresh .

Exemplo

No exemplo a seguir, iniciar o aplicativo host dispara o procedimento de evento onLoad que, em seguida, chama um procedimento que cria um objeto IRibbonUI que representa a interface do usuário da faixa de opções. 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

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.