WorkbookBase.RequestService(Guid) Método

Definição

Retorna um objeto que implementa a interface Microsoft.Office.Core.IRibbonExtensibility em uma personalização no nível de documento.

protected virtual object RequestService (Guid serviceGuid);

Parâmetros

serviceGuid
Guid

Um Guid que identifica a interface Microsoft.Office.Core.IRibbonExtensibility.

Retornos

Object

Um objeto na personalização no nível de documento que implementa a interface Microsoft.Office.Core.IRibbonExtensibility.

Implementações

Comentários

Substitua esse método se você estiver personalizando a faixa de uma da pasta de trabalho criando sua própria implementação da Microsoft.Office.Core.IRibbonExtensibility interface ou adicionando um item da faixa (XML) ao seu projeto.

Se você personalizar a faixa de faixas adicionando um item da faixa de Ribbon (designer visual) ao seu projeto, o Visual Studio substituirá esse método por você. Para obter mais informações, consulte visão geral da faixa de e Designer de faixade forma.

Se você substituir esse método, verifique o valor do serviceGuid parâmetro para determinar se a Microsoft.Office.Core.IRibbonExtensibility interface está sendo solicitada e, em seguida, retorne um objeto que implementa a interface. Quando a pasta de trabalho é aberta, as Visual Studio Tools para Office Runtime chamadas RequestService e envia o valor de retorno para Microsoft Office Excel. Para obter mais informações sobre a Microsoft.Office.Core.IRibbonExtensibility interface, consulte objeto IRibbonExtensibility na documentação do Microsoft Office.

Como alternativa, você pode substituir o CreateRibbonExtensibilityObject método em vez de substituir o RequestService método. Para obter mais informações, consulte Ribbon XML.

Observação

Microsoft.Office.Core.IRibbonExtensibilityé uma das várias interfaces (também nomeadas como interfaces de extensibilidade) fornecidas pelo Microsoft Office. No entanto, essa é a única interface que você pode implementar em uma personalização em nível de documento para o Excel. Você pode implementar outras interfaces de extensibilidade em suplementos de nível de aplicativo. Para obter mais informações, consulte Personalizando recursos da interface do usuário usando interfaces de extensibilidade.

Aplica-se a