Compartilhar via


IRibbonUI Interface

Definição

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.

public interface class IRibbonUI
[System.Runtime.InteropServices.Guid("000C03A7-0000-0000-C000-000000000046")]
public interface IRibbonUI
[<System.Runtime.InteropServices.Guid("000C03A7-0000-0000-C000-000000000046")>]
type IRibbonUI = interface
Public Interface IRibbonUI
Atributos

Exemplos

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.

A seguir está a marcação XML para o Office carregar a faixa de opções personalizada:

&lt;customUI … onLoad=”MyAddInInitialize” …&gt;

A seguir está o método de retorno de chamada para o evento onLoad :

Dim MyRibbon As IRibbonUI
Sub MyAddInInitialize(Ribbon As IRibbonUI)
    Set MyRibbon = Ribbon
End Sub

Sub myFunction()
    ‘ Invalidates the caches of all of this add-in’s controls 
    MyRibbon.Invalidate()            
End Sub

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. É possível utilizar esse objeto para chamar os métodos Invalidate, InvalidateControl e Refresh.

Métodos

ActivateTab(String)

Ativa a guia personalizada especificada.

ActivateTabMso(String)

Ativa a guia interna especificada.

ActivateTabQ(String, String)

Ativa a guia personalizada especificada na interface do usuário da Faixa de Opções do Microsoft Office Fluent. Usa o nome totalmente qualificado da guia que inclui o identificador e o namespace da guia.

Invalidate()

Invalida os valores em cache para todos os controles da interface do usuário Ribbon.

InvalidateControl(String)

Invalida o valor em cache de um controle exclusivo na interface do usuário Ribbon.

InvalidateControlMso(String)

Usado para invalidar um controle interno.

Aplica-se a