Table of contents
TOC
Recolher sumário
Expandir sumário

Método IRibbonExtensibility.GetCustomUI (Office)IRibbonExtensibility.GetCustomUI Method (Office)

office 365 dev account|Última Atualização: 22/03/2018
|
2 Colaboradores

Carrega a marcação XML, de um arquivo de personalização XML ou da marcação XML incorporada no procedimento, que personaliza a interface do usuário da faixa de opções.Loads the XML markup, either from an XML customization file or from XML markup embedded in the procedure, that customizes the Ribbon user interface.

SintaxeSyntax

expressão. GetCustomUI ( RibbonID )expression. GetCustomUI( RibbonID )

expressão Uma expressão que retorna um objeto IRibbonExtensibility .expression An expression that returns a IRibbonExtensibility object.

ParâmetrosParameters

NomeNameObrigatório/opcionalRequired/OptionalTipo de dadosData TypeDescriçãoDescription
RibbonIDRibbonIDObrigatórioRequiredStringStringA identificação da IU RibbonX.The ID for the RibbonX UI.

Valor retornadoReturn Value

StringString

ComentáriosRemarks

Para Word, Excel, PowerPoint e Access, há apenas uma ID para cada aplicativo. O Outlook usa extensibilidade da faixa de opções para personalizar não apenas a faixa de opções em um inspector, mas também a faixa de opções em um explorer, nos vários menus de contexto, em guias contextuais em uma faixa de opções e no Microsoft Office Backstage. 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.For Word, Excel, PowerPoint, and Access, there is only one ID for each application. Outlook uses ribbon extensibility to customize not only the ribbon in an inspector, but also the ribbon in an explorer, in various context menus, in contextual tabs in a ribbon, and in the Microsoft Office Backstage view. In each of these scenarios, the developer specifies the custom UI in an XML file that is loaded when Office calls GetCustomUI with a specific ribbon ID.

ExemploExample

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 de SteamReader que lê na marcação de personalização em um arquivo XML externo.In the following example, written in C#, the IRibbonExtensibility interface is specified in the class definition. The example then implements the interfaces's only method, GetCustomUI. The method creates an instance of a SteamReader object that reads in the customization markup in an external XML file.

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; 
} 

Ver tambémSee also

ConceitosConcepts

Objeto IRibbonExtensibilityIRibbonExtensibility Object

Outros recursosOther resources

Membros do objeto IRibbonExtensibilityIRibbonExtensibility Object Members

© 2018 Microsoft