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 devolve 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 utiliza a extensibilidade do friso para personalizar não só o friso num inspetor, mas também o friso num explorador, em vários menus de contexto, em separadores contextuais num friso e na vista 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 num ficheiro 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

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.