Taakvensters voor webextensies gebruiken

Invoering

Welkom bij deze uitgebreide tutorial over het gebruik van taakvensters voor webextensies in een Word-document met Aspose.Words voor .NET. Als u ooit uw Word-documenten wilt uitbreiden met interactieve taakvensters, bent u hier aan het juiste adres. Deze gids begeleidt u bij elke stap om dit naadloos te bereiken.

Vereisten

Voordat we erin duiken, zorgen we ervoor dat je alles hebt wat je nodig hebt:

  • Aspose.Words voor .NET: je kunt het downloadenhier.
  • .NET-ontwikkelomgeving: Visual Studio of een andere IDE van uw voorkeur.
  • Basiskennis van C#: dit zal u helpen de codevoorbeelden te volgen.
  • Licentie voor Aspose.Woorden: Je kunt er een kopenhier of vraag een tijdelijke licentie aanhier.

Naamruimten importeren

Voordat we beginnen met coderen, moet u ervoor zorgen dat de volgende naamruimten in uw project zijn geïmporteerd:

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

Stapsgewijze handleiding

Laten we het proces nu opsplitsen in eenvoudig te volgen stappen.

Stap 1: Uw documentenmap instellen

Allereerst moeten we het pad naar uw documentenmap instellen. Dit is waar uw Word-document wordt opgeslagen.

// Het pad naar de documentenmap.
string dataDir = "YOUR DOCUMENT DIRECTORY";

Vervangen"YOUR DOCUMENT DIRECTORY" met het daadwerkelijke pad naar uw documentenmap.

Stap 2: Een nieuw document maken

Vervolgens maken we een nieuw Word-document met Aspose.Words.

Document doc = new Document();

Deze regel initialiseert een nieuw exemplaar van deDocument klasse, die een Word-document vertegenwoordigt.

Stap 3: Een taakvenster toevoegen

Nu zullen we een taakvenster aan ons document toevoegen. Taakvensters zijn handig voor het bieden van extra functionaliteiten en hulpmiddelen binnen een Word-document.

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

Hier maken we een nieuweTaskPane object en voeg het toe aan het documentWebExtensionTaskPanes verzameling.

Stap 4: Het taakvenster configureren

Om ons taakvenster zichtbaar te maken en de eigenschappen ervan in te stellen, gebruiken we de volgende code:

taskPane.DockState = TaskPaneDockState.Right;
taskPane.IsVisible = true;
taskPane.Width = 300;
  • DockState bepaalt waar het taakvenster verschijnt. In dit geval is het aan de rechterkant.
  • IsVisible zorgt ervoor dat het taakvenster zichtbaar is.
  • Width stelt de breedte van het taakvenster in.

Stap 5: Referentie voor webextensies instellen

Vervolgens stellen we de Web Extension Reference in, die de ID, versie, winkeltype en winkel bevat.

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";
  • Idis een unieke identificatie voor de webextensie.
  • Version specificeert de versie van de extensie.
  • StoreType geeft het type winkel aan (in dit geval OMEX).
  • Store specificeert de taal-/cultuurcode van de winkel.

Stap 6: Eigenschappen toevoegen aan de webextensie

U kunt eigenschappen aan uw webextensie toevoegen om het gedrag of de inhoud ervan te definiëren.

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

Hier voegen we een eigenschap toe met de naammailchimpCampaign.

Stap 7: De webextensie binden

Ten slotte voegen we bindingen toe aan onze webextensie. Met bindingen kunt u de extensie aan specifieke delen van het document koppelen.

taskPane.WebExtension.Bindings.Add(new WebExtensionBinding("UnnamedBinding_0_1506535429545", WebExtensionBindingType.Text, "194740422"));
  • UnnamedBinding_0_1506535429545 is de naam van de binding.
  • WebExtensionBindingType.Text geeft aan dat de binding van het teksttype is.
  • 194740422 is de ID van het deel van het document waaraan de extensie is gebonden.

Stap 8: Het document opslaan

Nadat u alles hebt ingesteld, slaat u uw document op.

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

Deze regel slaat het document op in de opgegeven map met de opgegeven bestandsnaam.

Stap 9: Taakvensterinformatie laden en weergeven

Om de taakvensterinformatie te verifiëren en weer te geven, laden we het document en doorlopen we de taakvensters.

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

Deze code laadt het document en drukt de provider-, versie- en catalogus-ID van elk taakvenster in de console af.

Conclusie

En dat is het! U hebt met succes een taakvenster voor webextensies toegevoegd en geconfigureerd in een Word-document met Aspose.Words voor .NET. Deze krachtige functie kan uw Word-documenten aanzienlijk verbeteren door rechtstreeks in het document extra functionaliteiten aan te bieden.

Veelgestelde vragen

Wat is een taakvenster in Word?

Een taakvenster is een interface-element dat extra hulpmiddelen en functionaliteiten biedt binnen een Word-document, waardoor de gebruikersinteractie en productiviteit worden verbeterd.

Kan ik het uiterlijk van het taakvenster aanpassen?

Ja, u kunt het uiterlijk van het taakvenster aanpassen door eigenschappen in te stellen, zoalsDockState, IsVisible , EnWidth.

Wat zijn webextensie-eigenschappen?

Eigenschappen van webextensies zijn aangepaste eigenschappen die u aan een webextensie kunt toevoegen om het gedrag of de inhoud ervan te definiëren.

Hoe koppel ik een webextensie aan een deel van het document?

U kunt een webextensie aan een deel van het document koppelen met behulp van deWebExtensionBinding klasse, waarbij het bindingstype en de doel-ID worden gespecificeerd.

Waar kan ik meer informatie vinden over Aspose.Words voor .NET?

U kunt gedetailleerde documentatie vindenhier.