Metodo DocumentBase.RequestService
Restituisce un oggetto che implementa l'interfaccia Microsoft.Office.Core.IRibbonExtensibility in una personalizzazione a livello di documento.
Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Sintassi
'Dichiarazione
Protected Overridable Function RequestService ( _
serviceGuid As Guid _
) As Object
protected virtual Object RequestService(
Guid serviceGuid
)
Parametri
- serviceGuid
Tipo: System.Guid
Oggetto Guid che identifica l'interfaccia Microsoft.Office.Core.IRibbonExtensibility.
Valore restituito
Tipo: System.Object
Oggetto della personalizzazione a livello di documento che implementa l'interfaccia Microsoft.Office.Core.IRibbonExtensibility.
Note
Eseguire l'override di questo metodo in caso di personalizzazione della barra multifunzione del documento attraverso la creazione di un'implementazione propria dell'interfaccia Microsoft.Office.Core.IRibbonExtensibility o l'aggiunta di un elemento Barra multifunzione (XML) al progetto.
Personalizzando la barra multifunzione tramite l'aggiunta di un elemento Barra multifunzione (finestra di progettazione visiva) al progetto, il metodo viene automaticamente sottoposto a override. Per ulteriori informazioni, vedere Cenni preliminari sulla barra multifunzione e Finestra di progettazione della barra multifunzione.
Quando si esegue l'override di questo metodo, verificare il valore del parametro serviceGuid per determinare se l'interfaccia Microsoft.Office.Core.IRibbonExtensibility viene richiesta e quindi restituire un oggetto che implementa tale interfaccia. Quando il documento viene aperto, Runtime di Visual Studio Tools per Office chiama RequestService e invia il valore restituito a Microsoft Office Word. Per ulteriori informazioni sull'interfaccia Microsoft.Office.Core.IRibbonExtensibility, vedere Oggetto IRibbonExtensibility nella documentazione Microsoft Office.
In alternativa è possibile eseguire l'override del metodo CreateRibbonExtensibilityObject anziché del metodo RequestService. Per ulteriori informazioni, vedere Elemento XML della barra multifunzione.
Nota
Microsoft.Office.Core.IRibbonExtensibility rappresenta una delle diverse interfacce (denominate anche interfacce di estensibilità) fornite da Microsoft Office. Si tratta tuttavia dell'unica interfaccia implementabile in una personalizzazione a livello di documento per Word. Le altre interfacce di estensibilità possono essere implementate nei componenti aggiuntivi a livello di applicazione. Per ulteriori informazioni, vedere Personalizzazione delle funzionalità dell'interfaccia utente utilizzando le interfacce di estensibilità.
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.