Método IRibbonExtensibility.GetCustomUI (Office)

Carrega a marcação XML, do arquivo de personalização XML ou da marcação XML incorporada no procedimento, a qual personaliza a interface com o usuário Ribbon.

Sintaxe

expressão. GetCustomUI (RibbonID)

Expressão Uma expressão que retorna um objeto IRibbonExtensibility .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Ribbonid	Obrigatório	String	A identificação da IU RibbonX.

Valor de retorno

Cadeia de caracteres

Comentários

Para Word, Excel, PowerPoint e Access, há apenas uma ID para cada aplicativo. O Outlook usa extensibilidade de faixa de opções para personalizar não apenas a faixa de opções em um inspetor, mas também a faixa de opções em um explorador, em vários menus de contexto, em guias contextuais em uma faixa de opções e na exibição backstage do Microsoft Office. Em cada um desses cenários, o desenvolvedor Especifica a IU personalizada em um arquivo XML que é carregado quando o Office chama o GetCustomUI com uma identificação de faixa de opções específicas.

Exemplo

O exemplo a seguir, criado em c#, a interface IRibbonExtensibility é especificada na definição da classe. O exemplo, em seguida, implementa o único método do interfaces, GetCustomUI. O método cria uma instância de um objeto StreamReader que lê na marcação de personalização em um arquivo XML externo.

public class Connect : Object, Extensibility.IDTExtensibility2, IRibbonExtensibility 
... 
public string GetCustomUI(string RibbonID) 
{ 
 StreamReader customUIReader = new System.IO.StreamReader("C:\\RibbonXSampleCS\\customUI.xml"); 
 string customUIData = customUIReader.ReadToEnd(); 
 return customUIData; 
} 

Confira também

• Membros do objeto IRibbonExtensibility

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.