Utilizzo dei riquadri attività dell'estensione Web

Introduzione

Benvenuti a questo tutorial approfondito sull’uso dei riquadri attività Web Extension in un documento Word tramite Aspose.Words per .NET. Se avete mai desiderato migliorare i vostri documenti Word con riquadri attività interattivi, siete nel posto giusto. Questa guida vi guiderà passo dopo passo per raggiungere questo obiettivo senza problemi.

Prerequisiti

Prima di iniziare, assicuriamoci di avere tutto ciò di cui hai bisogno:

  • Aspose.Words per .NET: puoi scaricarloQui.
  • Ambiente di sviluppo .NET: Visual Studio o qualsiasi altro IDE tu preferisca.
  • Conoscenza di base di C#: ti aiuterà a seguire gli esempi di codice.
  • Licenza per Aspose.Words: puoi acquistarne unaQui o ottenere una licenza temporaneaQui.

Importazione degli spazi dei nomi

Prima di iniziare a scrivere il codice, assicurati di aver importato i seguenti namespace nel tuo progetto:

using Aspose.Words;
using Aspose.Words.WebExtensions;

Guida passo passo

Ora scomponiamo il processo in passaggi facili da seguire.

Passaggio 1: impostazione della directory dei documenti

Per prima cosa, dobbiamo impostare il percorso per la directory dei tuoi documenti. È qui che verrà salvato il tuo documento Word.

// Percorso verso la directory dei documenti.
string dataDir = "YOUR DOCUMENT DIRECTORY";

Sostituire"YOUR DOCUMENT DIRECTORY" con il percorso effettivo della cartella dei documenti.

Passaggio 2: creazione di un nuovo documento

Successivamente creeremo un nuovo documento Word utilizzando Aspose.Words.

Document doc = new Document();

Questa riga inizializza una nuova istanza diDocument classe, che rappresenta un documento Word.

Passaggio 3: aggiunta di un riquadro attività

Ora aggiungeremo un Task Pane al nostro documento. I Task Pane sono utili per fornire funzionalità e strumenti aggiuntivi all’interno di un documento Word.

TaskPane taskPane = new TaskPane();
doc.WebExtensionTaskPanes.Add(taskPane);

Qui creiamo un nuovoTaskPane oggetto e aggiungerlo al documentoWebExtensionTaskPanes collezione.

Passaggio 4: Configurazione del riquadro attività

Per rendere visibile il nostro Task Pane e impostarne le proprietà, utilizziamo il seguente codice:

taskPane.DockState = TaskPaneDockState.Right;
taskPane.IsVisible = true;
taskPane.Width = 300;
  • DockState imposta dove apparirà il Task Pane. In questo caso, è sulla destra.
  • IsVisible assicura che il riquadro attività sia visibile.
  • Width imposta la larghezza del riquadro attività.

Passaggio 5: impostazione del riferimento all’estensione Web

Successivamente, impostiamo il riferimento all’estensione Web che include ID, versione, tipo di archivio e archivio.

taskPane.WebExtension.Reference.Id = "wa102923726";
taskPane.WebExtension.Reference.Version = "1.0.0.0";
taskPane.WebExtension.Reference.StoreType = WebExtensionStoreType.OMEX;
taskPane.WebExtension.Reference.Store = "th-TH";
  • Idè un identificatore univoco per l’estensione web.
  • Version specifica la versione dell’estensione.
  • StoreType indica il tipo di negozio (in questo caso, OMEX).
  • Store specifica il codice lingua/cultura del negozio.

Passaggio 6: aggiunta di proprietà all’estensione Web

Puoi aggiungere proprietà alla tua estensione web per definirne il comportamento o il contenuto.

taskPane.WebExtension.Properties.Add(new WebExtensionProperty("mailchimpCampaign", "mailchimpCampaign"));

Qui aggiungiamo una proprietà denominatamailchimpCampaign.

Passaggio 7: associazione dell’estensione Web

Infine, aggiungiamo dei binding alla nostra estensione web. I binding consentono di collegare l’estensione a parti specifiche del documento.

taskPane.WebExtension.Bindings.Add(new WebExtensionBinding("UnnamedBinding_0_1506535429545", WebExtensionBindingType.Text, "194740422"));
  • UnnamedBinding_0_1506535429545 è il nome della rilegatura.
  • WebExtensionBindingType.Text indica che la rilegatura è di tipo testo.
  • 194740422 è l’ID della parte del documento a cui è associata l’estensione.

Passaggio 8: Salvataggio del documento

Dopo aver impostato tutto, salva il documento.

doc.Save(dataDir + "WorkingWithWebExtension.UsingWebExtensionTaskPanes.docx");

Questa riga salva il documento nella directory specificata con il nome file indicato.

Passaggio 9: caricamento e visualizzazione delle informazioni del riquadro attività

Per verificare e visualizzare le informazioni nel riquadro attività, carichiamo il documento e scorriamo i riquadri attività.

doc = new Document(dataDir + "WorkingWithWebExtension.UsingWebExtensionTaskPanes.docx");

Console.WriteLine("Task panes sources:\n");

foreach (TaskPane taskPaneInfo in doc.WebExtensionTaskPanes)
{
    WebExtensionReference reference = taskPaneInfo.WebExtension.Reference;
    Console.WriteLine($"Provider: \"{reference.Store}\", version: \"{reference.Version}\", catalog identifier: \"{reference.Id}\";");
}

Questo codice carica il documento e stampa il provider, la versione e l’identificativo del catalogo di ciascun riquadro attività nella console.

Conclusione

Ed ecco fatto! Hai aggiunto e configurato con successo un Web Extension Task Pane in un documento Word usando Aspose.Words per .NET. Questa potente funzionalità può migliorare significativamente i tuoi documenti Word fornendo funzionalità aggiuntive direttamente all’interno del documento.

Domande frequenti

Che cos’è un riquadro attività in Word?

Un riquadro attività è un elemento dell’interfaccia che fornisce strumenti e funzionalità aggiuntivi all’interno di un documento Word, migliorando l’interazione e la produttività dell’utente.

Posso personalizzare l’aspetto del riquadro attività?

Sì, puoi personalizzare l’aspetto del riquadro attività impostando proprietà comeDockState, IsVisible , EWidth.

Cosa sono le proprietà delle estensioni Web?

Le proprietà dell’estensione web sono proprietà personalizzate che puoi aggiungere a un’estensione web per definirne il comportamento o il contenuto.

Come posso associare un’estensione Web a una parte del documento?

È possibile associare un’estensione Web a una parte del documento utilizzandoWebExtensionBinding classe, specificando il tipo di binding e l’ID di destinazione.

Dove posso trovare maggiori informazioni su Aspose.Words per .NET?

Puoi trovare la documentazione dettagliataQui.