Ορισμός ιδιότητας Callout σε αρχείο PDF

Εισαγωγή

Η δημιουργία επαγγελματικών και οπτικά ελκυστικών εγγράφων PDF απαιτεί συχνά την προσθήκη σχολιασμών που τραβούν την προσοχή σε συγκεκριμένο περιεχόμενο. Ένας τέτοιος σχολιασμός είναι το callout, το οποίο μοιάζει με αυτά τα συννεφάκια ομιλίας που βλέπετε στα κόμικ. Βοηθούν στην αποσαφήνιση ή τονισμό του κειμένου στο PDF σας. Το Aspose.PDF για .NET καθιστά απίστευτα εύκολη την προσθήκη τέτοιων σχολιασμών στα έγγραφά σας και σε αυτό το σεμινάριο, θα δούμε πώς να ορίσετε την ιδιότητα προώθησης σε ένα αρχείο PDF χρησιμοποιώντας αυτήν την ισχυρή βιβλιοθήκη. Είτε είστε έμπειρος προγραμματιστής είτε μόλις ξεκινάτε, στο τέλος αυτού του οδηγού, θα έχετε ξεκάθαρη κατανόηση του τρόπου εργασίας με μηνύματα προώθησης σε αρχεία PDF.

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

Πριν βουτήξουμε στον κώδικα, ας καλύψουμε τα βασικά που χρειάζεστε για να ξεκινήσετε.

  1. Aspose.PDF για .NET: Βεβαιωθείτε ότι έχετε εγκαταστήσει τη βιβλιοθήκη Aspose.PDF για .NET. Μπορείτε να το κατεβάσετε απόεδώ.
  2. IDE: Ένα περιβάλλον ανάπτυξης όπως το Visual Studio.
  3. .NET Framework: Βεβαιωθείτε ότι έχετε εγκαταστήσει το .NET στον υπολογιστή σας.
  4. Προσωρινή άδεια: Εάν θέλετε να δοκιμάσετε τις πλήρεις δυνατότητες του Aspose.PDF χωρίς περιορισμούς, λάβετε έναπροσωρινή άδεια.

Εισαγωγή πακέτων

Πριν ξεκινήσετε τη σύνταξη του κώδικα, πρέπει να εισαγάγετε τα απαραίτητα πακέτα που θα σας επιτρέψουν να εργαστείτε με αρχεία PDF και σχολιασμούς.

using Aspose.Pdf.Annotations;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Text;

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

Βήμα 1: Αρχικοποιήστε το έγγραφο PDF

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

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

// Αρχικοποιήστε ένα νέο έγγραφο PDF
Document doc = new Document();

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

Βήμα 2: Προσθέστε μια νέα σελίδα στο έγγραφο

Ένα έγγραφο PDF μπορεί να έχει πολλές σελίδες και σε αυτό το βήμα, θα προσθέσουμε μια νέα σελίδα στο έγγραφό μας. Αυτή η σελίδα θα είναι όπου θα τοποθετηθεί ο σχολιασμός επεξήγησης.

//Προσθέστε μια νέα σελίδα στο έγγραφο
Page page = doc.Pages.Add();

ΟPages.Add()μέθοδος χρησιμοποιείται για την προσθήκη μιας νέας σελίδας στοdoc αντικείμενο. Η νέα σελίδα αποθηκεύεται στοpage μεταβλητή, την οποία θα χρησιμοποιήσουμε αργότερα κατά την προσθήκη του σχολιασμού.

Βήμα 3: Ορίστε την προεπιλεγμένη εμφάνιση

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

// Ορίστε την προεπιλεγμένη εμφάνιση για τον σχολιασμό
DefaultAppearance da = new DefaultAppearance();
da.TextColor = System.Drawing.Color.Red;
da.FontSize = 10;

Δημιουργούμε αDefaultAppearance αντικείμενο που καθορίζει το χρώμα του κειμένου και το μέγεθος της γραμματοσειράς. Εδώ, το κείμενο θα είναι κόκκινο και το μέγεθος της γραμματοσειράς έχει οριστεί σε 10. Αυτή η εμφάνιση θα εφαρμοστεί στον σχολιασμό επεξήγησης.

Βήμα 4: Δημιουργήστε τον σχολιασμό ελεύθερου κειμένου

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

// Δημιουργήστε ένα FreeTextAnnotation με ένα μήνυμα προώθησης
FreeTextAnnotation fta = new FreeTextAnnotation(page, new Rectangle(422.25, 645.75, 583.5, 702.75), da);
fta.Intent = FreeTextIntent.FreeTextCallout;
fta.EndingStyle = LineEnding.OpenArrow;

Δημιουργούμε αFreeTextAnnotation αντικείμενο με συγκεκριμένες συντεταγμένες, καθορίζοντας τη θέση του στη σελίδα. ΟIntent έχει οριστεί σεFreeTextCallout , υποδεικνύοντας ότι πρόκειται για σχολιασμό επεξήγησης. ΟEndingStyle έχει οριστεί σεOpenArrowπου σημαίνει ότι η γραμμή προώθησης θα τελειώνει με ένα ανοιχτό βέλος.

Βήμα 5: Καθορίστε τα σημεία γραμμής προώθησης

Ένας σχολιασμός επεξήγησης έχει μια γραμμή που δείχνει την περιοχή ενδιαφέροντος. Εδώ, θα ορίσουμε τα σημεία που απαρτίζουν αυτή τη γραμμή.

// Καθορίστε τα σημεία για τη γραμμή επεξήγησης
fta.Callout = new Point[]
{
    new Point(428.25, 651.75), 
    new Point(462.75, 681.375), 
    new Point(474, 681.375)
};

ΟCallout Η ιδιοκτησία είναι μια σειρά απόPoint αντικείμενα, καθένα από τα οποία αντιπροσωπεύει μια συντεταγμένη στη σελίδα. Αυτά τα σημεία καθορίζουν τη διαδρομή της γραμμής προώθησης, δίνοντάς της την κλασική εμφάνιση με συννεφάκι ομιλίας.

Βήμα 6: Προσθέστε τον σχολιασμό στη σελίδα

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

// Προσθέστε τον σχολιασμό στη σελίδα
page.Annotations.Add(fta);

ΟAnnotations.Add() Η μέθοδος χρησιμοποιείται για την τοποθέτηση του σχολιασμού στη σελίδα που δημιουργήσαμε νωρίτερα. Αυτό το βήμα “σχεδιάζει” αποτελεσματικά το μήνυμα στη σελίδα PDF.

Βήμα 7: Ορίστε το περιεχόμενο εμπλουτισμένου κειμένου

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

// Ορίστε το πλούσιο κείμενο για τον σχολιασμό
fta.RichText = "<body xmlns=\"http://www.w3.org/1999/xhtml\" xmlns:xfa=\"http://www.xfa.org/schema/xfa-data/1.0/\" xfa:APIVersion=\"Acrobat:11.0.23\" xfa:spec=\"2.0.2\" style=\"color:#FF0000;font-weight:normal;font-style:normal;font-stretch:normal\"><p dir=\"ltr\"> <span style=\"font-size:9.0pt;font-family:Helvetica\">Αυτό είναι ένα δείγμα</span></p></body>";

ΟRichText Η ιδιότητα έχει οριστεί με περιεχόμενο HTML. Αυτό επιτρέπει τη λεπτομερή μορφοποίηση εντός του μηνύματος, όπως τον καθορισμό μεγέθους γραμματοσειράς, χρώματος και στυλ.

Βήμα 8: Αποθηκεύστε το έγγραφο PDF

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

// Αποθηκεύστε το έγγραφο
doc.Save(dataDir + "SetCalloutProperty.pdf");

ΟSave() μέθοδος αποθηκεύει το έγγραφο στον καθορισμένο κατάλογο με το όνομα αρχείου “SetCalloutProperty.pdf”. Αυτό το βήμα ολοκληρώνει τη διαδικασία δημιουργίας PDF.

Σύναψη

Και ορίστε το! Μόλις δημιουργήσατε ένα έγγραφο PDF με σχολιασμό επεξήγησης χρησιμοποιώντας το Aspose.PDF για .NET. Αυτός ο σχολιασμός μπορεί να είναι απίστευτα χρήσιμος για την επισήμανση ή την επεξήγηση συγκεκριμένων τμημάτων του εγγράφου σας. Το Aspose.PDF προσφέρει ένα ισχυρό API που κάνει τη διαχείριση PDF απλή και ευέλικτη. Είτε προσθέτετε σχολιασμούς, είτε μετατρέπετε έγγραφα είτε χειρίζεστε πολύπλοκες εργασίες PDF, το Aspose.PDF σας καλύπτει.

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

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

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

Είναι δυνατή η προσθήκη πολλών μηνυμάτων σε μια σελίδα;

Ναι, μπορείτε να προσθέσετε όσες επεξηγήσεις χρειάζεται επαναλαμβάνοντας τα βήματα για κάθε σχολιασμό.

Πώς μπορώ να αλλάξω τη θέση του μηνύματος προώθησης;

Απλώς τροποποιήστε τις συντεταγμένες στοRectangle καιCallout ιδιότητες για επανατοποθέτηση του σχολιασμού.

Μπορώ να προσθέσω άλλους τύπους σχολιασμών χρησιμοποιώντας το Aspose.PDF;

Ναι, το Aspose.PDF υποστηρίζει διάφορους τύπους σχολιασμού, συμπεριλαμβανομένων των επισημάνσεων, των γραμματοσήμων και των συνημμένων αρχείων.

Περιορίζεται το περιεχόμενο εμπλουτισμένου κειμένου σε HTML;

ΟRichText Η ιδιότητα υποστηρίζει ένα υποσύνολο HTML, επιτρέποντάς σας να συμπεριλάβετε κείμενο με στυλ και βασική μορφοποίηση.

Διορθώστε τη σελίδα Ορισμός μορφοποίησης σχολιασμού ελεύθερου κειμένου