IRibbonUI Interface

Definição

Namespace:

Microsoft.Office.Core

Assembly:

office.dll

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

GuidAttribute

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:

<customUI … onLoad=”MyAddInInitialize” …>

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.