Cenni preliminari sugli smart tag

Articolo
04/28/2010

Aggiornamento: Luglio 2008

Si applica a
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Progetti a livello di documento Excel 2003 Excel 2007 Word 2003 Word 2007 Progetti a livello di applicazione Excel 2007 Word 2007 Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazione.

Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati.

Progetti a livello di documento

Excel 2003
Excel 2007
Word 2003
Word 2007

Progetti a livello di applicazione

Excel 2007
Word 2007

Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazione.

Gli smart tag sono stringhe di testo alle quali sono associate informazioni sui tipi. Quando in un documento appare una stringa di testo che corrisponde ai criteri indicati, questa viene riconosciuta e l'utente può eseguire azioni appropriate a tale tipo di stringa. È possibile ad esempio creare uno smart tag per il riconoscimento dei simboli dei titoli azionari. Quando l'utente digita una stringa di quattro lettere in caratteri maiuscoli, potrebbe essere visualizzato un elenco di azioni correlate ai titoli azionari, ad esempio l'individuazione del prezzo del titolo su Internet.

Visual Studio Tools per Office fornisce classi utilizzabili per aggiungere rapidamente smart tag ai documenti di Microsoft Office Word e alle cartelle di lavoro di Microsoft Office Excel. Per esempi che illustrano come utilizzare queste classi, vedere Procedura: aggiungere smart tag ai documenti di Word e Procedura: aggiungere smart tag a cartelle di lavoro di Excel.

Per eseguire uno smart tag gli utenti finali devono avere gli smart tag attivati in Word o Excel. Per ulteriori informazioni, vedere Procedura: attivare gli smart tag in Word ed Excel.

Per creare uno smart tag in progetti per un'applicazione diversa da Word o Excel occorre utilizzare il kit Smart Tag SDK. Per ulteriori informazioni, vedere Creare smart tag in applicazioni diverse da Word ed Excel.

Funzionalità degli strumenti per la creazione di smart tag di Office

Durante la creazione di codice per gli smart tag in un progetto Visual Studio Tools per Office per Word o Excel è possibile sfruttare la tecnologia IntelliSense, la Guida integrata e le altre funzionalità di Visual Studio. Tutto il codice relativo agli smart tag è racchiuso in una sola classe. Pertanto, non occorre creare classi separate per le azioni e per il riconoscimento. Per ulteriori informazioni sulle classi di smart tag, vedere Architettura degli smart tag.

Ambito del documento

Il comportamento degli smart tag creati tramite Visual Studio Tools per Office varia seconda che il progetto sia a livello di documento o a livello di applicazione.

Se si crea uno smart tag in una personalizzazione a livello di documento, lo smart tag viene eseguito solo nel documento appartenente alla personalizzazione, non in ogni documento di Word o di Excel aperto. Ciò significa che è possibile riconoscere testo che risulterebbe troppo generico se lo smart tag fosse applicato a più tipi di documenti. Ad esempio, un numero a cinque cifre destinato a rappresentare solo un numero di prodotto in una fattura, potrebbe rappresentare anche un numero di matricola in un documento del reparto del personale. Se lo smart tag funziona solo nella fattura, non bisognerà preoccuparsi che esegua un riconoscimento errato e assegni azioni a un numero di matricola.

A partire da Visual Studio 2008 Service Pack 1 (SP1) è possibile creare uno smart tag in un componente aggiuntivo a livello di applicazione. È possibile rendere disponibile lo smart tag solo per un documento specifico oppure per ogni documento aperto in Word o Excel. Questo tipo di smart tag è definito anche smart tag a livello di applicazione.

Nota:
Prima di poter aggiungere uno smart tag a livello di applicazione in un progetto creato prima di installare SP1, è necessario modificare il progetto in modo da generare alcuni elementi necessari di codice. Per ulteriori informazioni, vedere la classe Procedura: aggiungere smart tag a livello di applicazione in progetti creati prima di SP1.

Distribuzione

Poiché gli smart tag di Visual Studio Tools per Office fanno parte del progetto Visual Studio Tools per Office, non è necessaria alcuna distribuzione separata. Non vi è inoltre alcuna esigenza di impostare criteri di protezione specifici; gli smart tag, infatti, verranno eseguiti quando è impostata la protezione per la soluzione.

Registrazione

Non occorre registrare gli smart tag. La registrazione verrà eseguita automaticamente da Visual Studio Tools per Office, con la creazione di un'unica voce del Registro di sistema che include tutti gli smart tag di Visual Studio Tools per Office.

Creare smart tag in applicazioni diverse da Word ed Excel

Le classi di smart tag fornite da Visual Studio Tools per Office possono essere utilizzate solo in progetti per Word ed Excel. Gli smart tag sono tuttavia supportati da altre applicazioni Microsoft Office, quali PowerPoint e Outlook (se Word viene utilizzato come editor per la posta elettronica). Per creare uno smart tag per tali applicazioni, è necessario utilizzare il kit Smart Tag SDK invece di Visual Studio Tools per Office. Questo processo prevede due passaggi principali:

Creare una DLL dello smart tag (un assembly gestito o una DLL non gestita) che implementa le interfacce COM ISmartTagRecognizer e ISmartTagAction necessarie.
Distribuire la DLL dello smart tag nei computer degli utenti finali e creare le chiavi del Registro di sistema necessarie per abilitare alle applicazioni Microsoft Office di individuare la DLL dello smart tag.

Per ulteriori informazioni, vedere la documentazione relativa a Smart Tag SDK in MSDN Library.

In genere, non è consigliabile implementare le interfacce COM dello smart tag in un componente aggiuntivo Visual Studio Tools per Office, ma implementarle in un assembly diverso o in una DLL non gestita. In caso contrario, il codice ridondante verrà caricato nella memoria, poiché l'assembly del componente aggiuntivo verrà caricato due volte dall'applicazione Office: una volta al caricamento del componente aggiuntivo da parte dell'applicazione e quindi una seconda volta quando l'applicazione individua e carica le DLL dello smart tag installate nel sistema. Ogni istanza dell'assembly del componente aggiuntivo verrà caricata in un dominio applicazione distinto.