Χρήση παραθύρων εργασιών επέκτασης Web

Εισαγωγή

Καλώς ήρθατε σε αυτό το σε βάθος σεμινάριο σχετικά με τη χρήση των παραθύρων εργασιών επέκτασης Web σε ένα έγγραφο του Word χρησιμοποιώντας το Aspose.Words για .NET. Αν θελήσατε ποτέ να βελτιώσετε τα έγγραφά σας στο Word με διαδραστικά παράθυρα εργασιών, βρίσκεστε στο σωστό μέρος. Αυτός ο οδηγός θα σας καθοδηγήσει σε κάθε βήμα για να το πετύχετε απρόσκοπτα.

Προαπαιτούμενα

Πριν βουτήξουμε, ας βεβαιωθούμε ότι έχετε όλα όσα χρειάζεστε:

  • Aspose.Words για .NET: Μπορείτε να το κατεβάσετεεδώ.
  • .NET Development Environment: Visual Studio ή οποιοδήποτε άλλο IDE προτιμάτε.
  • Βασικές γνώσεις C#: Αυτό θα σας βοηθήσει να ακολουθήσετε μαζί με τα παραδείγματα κώδικα.
  • Άδεια χρήσης για Aspose.Words: Μπορείτε να αγοράσετε έναεδώ ή πάρτε μια προσωρινή άδειαεδώ.

Εισαγωγή χώρων ονομάτων

Πριν ξεκινήσουμε την κωδικοποίηση, βεβαιωθείτε ότι έχετε εισαγάγει τους ακόλουθους χώρους ονομάτων στο έργο σας:

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

Οδηγός βήμα προς βήμα

Τώρα, ας αναλύσουμε τη διαδικασία σε βήματα που μπορείτε να ακολουθήσετε εύκολα.

Βήμα 1: Ρύθμιση του καταλόγου εγγράφων σας

Πρώτα πράγματα πρώτα, πρέπει να ρυθμίσουμε τη διαδρομή προς τον κατάλογο των εγγράφων σας. Εδώ θα αποθηκευτεί το έγγραφο Word σας.

// Η διαδρομή προς τον κατάλογο εγγράφων.
string dataDir = "YOUR DOCUMENT DIRECTORY";

Αντικαθιστώ"YOUR DOCUMENT DIRECTORY" με την πραγματική διαδρομή προς το φάκελο των εγγράφων σας.

Βήμα 2: Δημιουργία νέου εγγράφου

Στη συνέχεια, θα δημιουργήσουμε ένα νέο έγγραφο του Word χρησιμοποιώντας το Aspose.Words.

Document doc = new Document();

Αυτή η γραμμή αρχικοποιεί μια νέα παρουσία τουDocument κλάση, η οποία αντιπροσωπεύει ένα έγγραφο του Word.

Βήμα 3: Προσθήκη παραθύρου εργασιών

Τώρα, θα προσθέσουμε ένα παράθυρο εργασιών στο έγγραφό μας. Τα παράθυρα εργασιών είναι χρήσιμα για την παροχή πρόσθετων λειτουργιών και εργαλείων σε ένα έγγραφο του Word.

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

Εδώ, δημιουργούμε ένα νέοTaskPane αντικείμενο και προσθέστε το στο έγγραφοWebExtensionTaskPanes συλλογή.

Βήμα 4: Διαμόρφωση του παραθύρου εργασιών

Για να κάνουμε ορατό το παράθυρο εργασιών μας και να ορίσουμε τις ιδιότητές του, χρησιμοποιούμε τον ακόλουθο κώδικα:

taskPane.DockState = TaskPaneDockState.Right;
taskPane.IsVisible = true;
taskPane.Width = 300;
  • DockState ορίζει πού θα εμφανίζεται το παράθυρο εργασιών. Σε αυτή την περίπτωση, είναι στα δεξιά.
  • IsVisible διασφαλίζει ότι το παράθυρο εργασιών είναι ορατό.
  • Width ορίζει το πλάτος του παραθύρου εργασιών.

Βήμα 5: Ρύθμιση αναφοράς επέκτασης ιστού

Στη συνέχεια, ρυθμίζουμε την Αναφορά επέκτασης Ιστού που περιλαμβάνει το αναγνωριστικό, την έκδοση, τον τύπο καταστήματος και το χώρο αποθήκευσης.

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είναι ένα μοναδικό αναγνωριστικό για την επέκταση ιστού.
  • Version καθορίζει την έκδοση της επέκτασης.
  • StoreType υποδεικνύει τον τύπο του καταστήματος (στην περίπτωση αυτή, OMEX).
  • Store καθορίζει τον κωδικό γλώσσας/πολιτισμού του καταστήματος.

Βήμα 6: Προσθήκη ιδιοτήτων στην επέκταση Ιστού

Μπορείτε να προσθέσετε ιδιότητες στην επέκταση ιστού σας για να καθορίσετε τη συμπεριφορά ή το περιεχόμενό της.

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

Εδώ, προσθέτουμε μια ιδιότητα με το όνομαmailchimpCampaign.

Βήμα 7: Σύνδεση της επέκτασης Web

Τέλος, προσθέτουμε συνδέσμους στην επέκταση ιστού μας. Οι δεσμεύσεις σάς επιτρέπουν να συνδέσετε την επέκταση με συγκεκριμένα μέρη του εγγράφου.

taskPane.WebExtension.Bindings.Add(new WebExtensionBinding("UnnamedBinding_0_1506535429545", WebExtensionBindingType.Text, "194740422"));
  • UnnamedBinding_0_1506535429545 είναι το όνομα του δέσιμου.
  • WebExtensionBindingType.Text υποδηλώνει ότι το δέσιμο είναι τύπου κειμένου.
  • 194740422 είναι το αναγνωριστικό του τμήματος του εγγράφου στο οποίο δεσμεύεται η επέκταση.

Βήμα 8: Αποθήκευση του εγγράφου

Αφού ρυθμίσετε τα πάντα, αποθηκεύστε το έγγραφό σας.

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

Αυτή η γραμμή αποθηκεύει το έγγραφο στον καθορισμένο κατάλογο με το συγκεκριμένο όνομα αρχείου.

Βήμα 9: Φόρτωση και εμφάνιση πληροφοριών παραθύρου εργασιών

Για να επαληθεύσουμε και να εμφανίσουμε τις πληροφορίες του παραθύρου εργασιών, φορτώνουμε το έγγραφο και επαναλαμβάνουμε τα παράθυρα εργασιών.

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

Αυτός ο κώδικας φορτώνει το έγγραφο και εκτυπώνει τον πάροχο, την έκδοση και το αναγνωριστικό καταλόγου για κάθε παράθυρο εργασιών στην κονσόλα.

Σύναψη

Και τέλος! Προσθέσατε και διαμορφώσατε με επιτυχία ένα παράθυρο εργασιών επέκτασης Web σε ένα έγγραφο του Word χρησιμοποιώντας το Aspose.Words για .NET. Αυτή η ισχυρή δυνατότητα μπορεί να βελτιώσει σημαντικά τα έγγραφά σας στο Word παρέχοντας πρόσθετες λειτουργίες απευθείας μέσα στο έγγραφο.

Συχνές ερωτήσεις

Τι είναι ένα παράθυρο εργασιών στο Word;

Το παράθυρο εργασιών είναι ένα στοιχείο διεπαφής που παρέχει πρόσθετα εργαλεία και λειτουργίες σε ένα έγγραφο του Word, βελτιώνοντας την αλληλεπίδραση και την παραγωγικότητα του χρήστη.

Μπορώ να προσαρμόσω την εμφάνιση του παραθύρου εργασιών;

Ναι, μπορείτε να προσαρμόσετε την εμφάνιση του παραθύρου εργασιών ορίζοντας ιδιότητες όπωςDockState, IsVisible , καιWidth.

Τι είναι οι ιδιότητες επέκτασης ιστού;

Οι ιδιότητες επέκτασης ιστού είναι προσαρμοσμένες ιδιότητες που μπορείτε να προσθέσετε σε μια επέκταση ιστού για να καθορίσετε τη συμπεριφορά ή το περιεχόμενό της.

Πώς συνδέω μια επέκταση Ιστού σε ένα μέρος του εγγράφου;

Μπορείτε να συνδέσετε μια επέκταση Ιστού σε ένα μέρος του εγγράφου χρησιμοποιώντας τοWebExtensionBinding κλάση, προσδιορίζοντας τον τύπο δέσμευσης και το αναγνωριστικό στόχου.

Πού μπορώ να βρω περισσότερες πληροφορίες για το Aspose.Words για .NET;

Μπορείτε να βρείτε αναλυτική τεκμηρίωσηεδώ.