Web Extension-taakvensters gebruiken

Invoering

Welkom bij deze diepgaande tutorial over het gebruik van Web Extension Task Panes in een Word-document met Aspose.Words voor .NET. Als u ooit uw Word-documenten wilde verbeteren met interactieve taakvensters, bent u hier aan het juiste adres. Deze gids leidt u door elke stap om dit naadloos te bereiken.

Vereisten

Voordat we beginnen, willen we er zeker van zijn dat je alles hebt wat je nodig hebt:

  • Aspose.Words voor .NET: U kunt het downloadenhier.
  • .NET-ontwikkelomgeving: Visual Studio of een andere IDE naar keuze.
  • Basiskennis van C#: Hiermee kunt u de codevoorbeelden beter volgen.
  • Licentie voor Aspose.Words: U kunt er één kopenhier of een tijdelijke licentie krijgenhier.

Naamruimten importeren

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

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

Stap-voor-stap 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 behulp van 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 gaan we een taakvenster toevoegen aan ons document. Taakvensters zijn handig om extra functionaliteiten en tools te bieden binnen een Word-document.

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

Hier creëren 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 stelt in 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: Webextensiereferentie instellen

Vervolgens stellen we de Web Extension Reference in, met daarin de ID, versie, winkeltype en winkel.

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 geeft de versie van de extensie aan.
  • 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

Tot slot voegen we bindingen toe aan onze webextensie. Bindingen stellen u in staat om de extensie te linken aan specifieke delen van het document.

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 gekoppeld.

Stap 8: Het document opslaan

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

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

Met deze regel wordt het document opgeslagen in de opgegeven map met de opgegeven bestandsnaam.

Stap 9: Taakvensterinformatie laden en weergeven

Om de informatie in het taakvenster 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}\";");
}

Met deze code wordt het document geladen en worden de provider, versie en catalogus-ID van elk taakvenster in de console afgedrukt.

Conclusie

En dat is alles! U hebt met succes een Web Extension Task Pane toegevoegd en geconfigureerd in een Word-document met Aspose.Words voor .NET. Deze krachtige functie kan uw Word-documenten aanzienlijk verbeteren door extra functionaliteiten direct in het document 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 interactie en productiviteit van de gebruiker wordt 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?

Gedetailleerde documentatie vindt u hierhier.