पीडीएफ फाइल में कॉलआउट प्रॉपर्टी सेट करें

परिचय

पेशेवर और आकर्षक PDF दस्तावेज़ बनाने के लिए अक्सर ऐसे एनोटेशन जोड़ने की आवश्यकता होती है जो विशिष्ट सामग्री पर ध्यान आकर्षित करते हैं। ऐसा ही एक एनोटेशन कॉलआउट है, जो कॉमिक्स में दिखने वाले स्पीच बबल की तरह होता है। वे आपके PDF में टेक्स्ट को स्पष्ट या ज़ोर देने में मदद करते हैं। .NET के लिए Aspose.PDF आपके दस्तावेज़ों में ऐसे एनोटेशन जोड़ना अविश्वसनीय रूप से आसान बनाता है, और इस ट्यूटोरियल में, हम इस शक्तिशाली लाइब्रेरी का उपयोग करके PDF फ़ाइल में कॉलआउट प्रॉपर्टी सेट करने का तरीका बताएंगे। चाहे आप एक अनुभवी डेवलपर हों या अभी शुरुआत कर रहे हों, इस गाइड के अंत तक, आपको PDF फ़ाइलों में कॉलआउट के साथ काम करने के तरीके के बारे में स्पष्ट समझ हो जाएगी।

आवश्यक शर्तें

इससे पहले कि हम कोड में उतरें, आइए उन अनिवार्य बातों पर चर्चा करें जिनकी आपको शुरुआत करने के लिए आवश्यकता होगी।

1. .NET के लिए Aspose.PDF: सुनिश्चित करें कि आपके पास .NET के लिए Aspose.PDF लाइब्रेरी स्थापित है। आप इसे यहाँ से डाउनलोड कर सकते हैंयहाँ.
2. IDE: एक विकास वातावरण जैसे कि विजुअल स्टूडियो.
3. .NET फ्रेमवर्क: सुनिश्चित करें कि आपकी मशीन पर .NET स्थापित है।
4. अस्थायी लाइसेंस: यदि आप बिना किसी सीमा के Aspose.PDF की सभी सुविधाओं को आज़माना चाहते हैं, तो एक प्राप्त करेंअस्थायी लाइसेंस.

पैकेज आयात करें

कोड लिखना शुरू करने से पहले, आपको आवश्यक पैकेज आयात करने होंगे जो आपको पीडीएफ फाइलों और एनोटेशन के साथ काम करने की अनुमति देंगे।

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

ये आयात आपको पीडीएफ दस्तावेजों में हेरफेर करने और कॉलआउट जैसे एनोटेशन बनाने के लिए सभी आवश्यक कक्षाएं और विधियां प्रदान करेंगे।

चरण 1: पीडीएफ दस्तावेज़ को आरंभ करें

हमारी यात्रा का पहला चरण एक नया PDF दस्तावेज़ आरंभ करना है जहाँ हम अपना कॉलआउट एनोटेशन जोड़ेंगे। इसे एक खाली कैनवास सेट करने के रूप में सोचें जहाँ आप तत्व जोड़ना शुरू कर सकते हैं।

// दस्तावेज़ निर्देशिका का पथ.
string dataDir = "YOUR DOCUMENT DIRECTORY";

// एक नया PDF दस्तावेज़ आरंभ करें
Document doc = new Document();

यहाँ, हम एक नया निर्माण कर रहे हैंDocument ऑब्जेक्ट जो हमारी पीडीएफ फाइल के रूप में काम करेगा।dataDir वेरिएबल को उस डायरेक्टरी पर सेट किया जाता है जहां आप अपना कार्य पूरा होने के बाद अपनी पीडीएफ फाइल को सहेजना चाहते हैं।

चरण 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() विधि का उपयोग उस पृष्ठ पर एनोटेशन रखने के लिए किया जाता है जिसे हमने पहले बनाया था। यह चरण प्रभावी रूप से पीडीएफ पृष्ठ पर कॉलआउट को “खींचता” है।

चरण 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: पीडीएफ दस्तावेज़ सहेजें

अंत में, सब कुछ सेट करने के बाद, हमें दस्तावेज़ को सहेजना होगा। यह चरण कॉलआउट एनोटेशन के साथ पीडीएफ के निर्माण को अंतिम रूप देता है।

// दस्तावेज़ सहेजें
doc.Save(dataDir + "SetCalloutProperty.pdf");

Save() विधि दस्तावेज़ को “SetCalloutProperty.pdf” फ़ाइल नाम के साथ निर्दिष्ट निर्देशिका में सहेजती है। यह चरण हमारी पीडीएफ निर्माण प्रक्रिया को पूरा करता है।

निष्कर्ष

और अब यह हो गया! आपने अभी-अभी .NET के लिए Aspose.PDF का उपयोग करके कॉलआउट एनोटेशन के साथ एक PDF दस्तावेज़ बनाया है। यह एनोटेशन आपके दस्तावेज़ के विशिष्ट भागों को हाइलाइट करने या समझाने के लिए अविश्वसनीय रूप से उपयोगी हो सकता है। Aspose.PDF एक शक्तिशाली API प्रदान करता है जो PDF हेरफेर को सरल और लचीला बनाता है। चाहे आप एनोटेशन जोड़ रहे हों, दस्तावेज़ परिवर्तित कर रहे हों, या जटिल PDF कार्यों को संभाल रहे हों, Aspose.PDF आपके लिए है।

अक्सर पूछे जाने वाले प्रश्न

क्या मैं कॉलआउट के स्वरूप को और अधिक अनुकूलित कर सकता हूँ?

बिल्कुल! आप लाइन का रंग, मोटाई और टेक्स्ट के फ़ॉन्ट परिवार और शैली जैसे विभिन्न पहलुओं को अनुकूलित कर सकते हैं।

क्या एक ही पृष्ठ पर एकाधिक कॉलआउट जोड़ना संभव है?

हां, आप प्रत्येक एनोटेशन के लिए चरणों को दोहराकर आवश्यकतानुसार अधिक से अधिक कॉलआउट जोड़ सकते हैं।

मैं कॉलआउट की स्थिति कैसे बदलूं?

बस निर्देशांक को संशोधित करेंRectangle औरCallout एनोटेशन को पुनः स्थान देने के लिए गुण.

क्या मैं Aspose.PDF का उपयोग करके अन्य प्रकार के एनोटेशन जोड़ सकता हूँ?

हां, Aspose.PDF विभिन्न एनोटेशन प्रकारों का समर्थन करता है, जिसमें हाइलाइट्स, स्टैम्प और फ़ाइल अटैचमेंट शामिल हैं।

क्या रिच टेक्स्ट सामग्री HTML तक सीमित है?

RichText प्रॉपर्टी HTML के एक उपसमूह का समर्थन करती है, जिससे आप स्टाइलयुक्त टेक्स्ट और मूल स्वरूपण शामिल कर सकते हैं।