Utilisation des volets de tâches d'extension Web

Introduction

Bienvenue dans ce didacticiel détaillé sur l’utilisation des volets de tâches d’extension Web dans un document Word à l’aide d’Aspose.Words pour .NET. Si vous avez toujours voulu améliorer vos documents Word avec des volets de tâches interactifs, vous êtes au bon endroit. Ce guide vous guidera à travers chaque étape pour y parvenir en toute transparence.

Prérequis

Avant de commencer, assurons-nous que vous avez tout ce dont vous avez besoin :

  • Aspose.Words pour .NET : vous pouvez le téléchargerici.
  • Environnement de développement .NET : Visual Studio ou tout autre IDE de votre choix.
  • Connaissances de base de C# : cela vous aidera à suivre les exemples de code.
  • Licence pour Aspose.Words : Vous pouvez en acheter uneici ou obtenir un permis temporaireici.

Importer des espaces de noms

Avant de commencer à coder, assurez-vous que les espaces de noms suivants sont importés dans votre projet :

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

Guide étape par étape

Maintenant, décomposons le processus en étapes faciles à suivre.

Étape 1 : Configuration de votre répertoire de documents

Tout d’abord, nous devons définir le chemin d’accès à votre répertoire de documents. C’est là que votre document Word sera enregistré.

// Le chemin vers le répertoire des documents.
string dataDir = "YOUR DOCUMENT DIRECTORY";

Remplacer"YOUR DOCUMENT DIRECTORY" avec le chemin réel vers votre dossier de documents.

Étape 2 : Créer un nouveau document

Ensuite, nous allons créer un nouveau document Word en utilisant Aspose.Words.

Document doc = new Document();

Cette ligne initialise une nouvelle instance duDocument classe, qui représente un document Word.

Étape 3 : Ajout d’un volet des tâches

Nous allons maintenant ajouter un volet de tâches à notre document. Les volets de tâches sont utiles pour fournir des fonctionnalités et des outils supplémentaires dans un document Word.

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

Ici, nous créons un nouveauTaskPane objet et l’ajouter au documentWebExtensionTaskPanes collection.

Étape 4 : Configuration du volet des tâches

Pour rendre notre volet des tâches visible et définir ses propriétés, nous utilisons le code suivant :

taskPane.DockState = TaskPaneDockState.Right;
taskPane.IsVisible = true;
taskPane.Width = 300;
  • DockState définit l’emplacement où le volet des tâches apparaît. Dans ce cas, il se trouve à droite.
  • IsVisible garantit que le volet des tâches est visible.
  • Width définit la largeur du volet des tâches.

Étape 5 : Configuration de la référence d’extension Web

Ensuite, nous configurons la référence d’extension Web qui inclut l’ID, la version, le type de magasin et le magasin.

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";
  • Idest un identifiant unique pour l’extension Web.
  • Version spécifie la version de l’extension.
  • StoreType indique le type de magasin (dans ce cas, OMEX).
  • Store spécifie le code langue/culture du magasin.

Étape 6 : Ajout de propriétés à l’extension Web

Vous pouvez ajouter des propriétés à votre extension Web pour définir son comportement ou son contenu.

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

Ici, nous ajoutons une propriété nomméemailchimpCampaign.

Étape 7 : lier l’extension Web

Enfin, nous ajoutons des liaisons à notre extension Web. Les liaisons vous permettent de lier l’extension à des parties spécifiques du document.

taskPane.WebExtension.Bindings.Add(new WebExtensionBinding("UnnamedBinding_0_1506535429545", WebExtensionBindingType.Text, "194740422"));
  • UnnamedBinding_0_1506535429545 est le nom de la liaison.
  • WebExtensionBindingType.Text indique que la reliure est de type texte.
  • 194740422 est l’ID de la partie du document à laquelle l’extension est liée.

Étape 8 : enregistrement du document

Après avoir tout configuré, enregistrez votre document.

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

Cette ligne enregistre le document dans le répertoire spécifié avec le nom de fichier donné.

Étape 9 : Chargement et affichage des informations du volet des tâches

Pour vérifier et afficher les informations du volet des tâches, nous chargeons le document et parcourons les volets des tâches.

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}\";");
}

Ce code charge le document et imprime le fournisseur, la version et l’identifiant de catalogue de chaque volet des tâches dans la console.

Conclusion

Et voilà ! Vous avez ajouté et configuré avec succès un volet de tâches d’extension Web dans un document Word à l’aide d’Aspose.Words pour .NET. Cette fonctionnalité puissante peut améliorer considérablement vos documents Word en fournissant des fonctionnalités supplémentaires directement dans le document.

FAQ

Qu’est-ce qu’un volet des tâches dans Word ?

Un volet des tâches est un élément d’interface qui fournit des outils et des fonctionnalités supplémentaires dans un document Word, améliorant ainsi l’interaction et la productivité de l’utilisateur.

Puis-je personnaliser l’apparence du volet des tâches ?

Oui, vous pouvez personnaliser l’apparence du volet des tâches en définissant des propriétés telles queDockState, IsVisible , etWidth.

Que sont les propriétés d’extension Web ?

Les propriétés d’extension Web sont des propriétés personnalisées que vous pouvez ajouter à une extension Web pour définir son comportement ou son contenu.

Comment lier une extension Web à une partie du document ?

Vous pouvez lier une extension Web à une partie du document à l’aide de l’WebExtensionBinding classe, spécifiant le type de liaison et l’ID cible.

Où puis-je trouver plus d’informations sur Aspose.Words pour .NET ?

Vous trouverez une documentation détailléeici.