ایجاد فایل های پی دی اف برچسب گذاری شده در C#.NET

یک فایل با برچسب PDF نوعی از PDF است که از برچسب ها برای تعریف ساختار منطقی محتوا در سند استفاده می کند. برای افزایش تجربه خواندن برای کسانی که از فناوری های کمکی و صفحه خوان استفاده می کنند استفاده می شود. در یک پست قبلی، به ایجاد فایل‌های PDF در یک برنامه NET پرداختیم. در این مقاله نحوه ایجاد فایل‌های پی‌دی‌اف برچسب‌گذاری‌شده به‌صورت برنامه‌نویسی در C#.NET را نشان خواهیم داد.

C# .NET API برای ایجاد پی دی اف برچسب گذاری شده - دانلود رایگان

Aspose.PDF for .NET یک API قوی برای تولید PDF و دستکاری در برنامه های NET است. با استفاده از API، می‌توانید فایل‌های PDF با طرح‌بندی‌های ساده و پیچیده را به‌طور یکپارچه ایجاد، پردازش و تبدیل کنید. می توانید باینری های API را دانلود یا با استفاده از NuGet نصب کنید.

PM> Install-Package Aspose.PDF

یک فایل PDF برچسب گذاری شده در C#.NET ایجاد کنید

برای ایجاد عناصر ساختار در یک پی دی اف برچسب گذاری شده، Aspose.PDF برای دات نت رابط ITaggedContent را فراهم می کند. بنابراین بیایید ببینیم که چگونه از این رابط برای ایجاد یک فایل PDF برچسب گذاری شده در سی شارپ استفاده کنیم.

  • با استفاده از کلاس Document یک PDF جدید ایجاد کنید یا یک فایل موجود را بارگیری کنید.
  • مرجع TaggedContent سند را در یک شیء ITaggedContent دریافت کنید.
  • عنوان، سرصفحه و زبان را تنظیم کنید و عناصر را با استفاده از شی ITaggedContent به PDF اضافه کنید.
  • یک ParagraphElement جدید با استفاده از روش ITaggedContent.CreateParagraphElement() ایجاد کنید و متن آن را تنظیم کنید.
  • پاراگراف را با استفاده از روش ITaggedContent.RootElement.AppendChild() به سند اضافه کنید.
  • در نهایت فایل PDF را با استفاده از روش Document.Save(String) ذخیره کنید.

نمونه کد زیر نحوه ایجاد یک پی دی اف برچسب گذاری شده در سی شارپ را نشان می دهد.

// سند PDF ایجاد کنید
Document document = new Document();

// دریافت محتوا برای کار با پی دی اف برچسب‌گذاری شده
ITaggedContent taggedContent = document.TaggedContent;
var rootElement = taggedContent.RootElement;
            
// عنوان و زبان را برای سند تنظیم کنید
taggedContent.SetTitle("Tagged Pdf Document");
taggedContent.SetLanguage("en-US");

// هدر اضافه کنید
HeaderElement mainHeader = taggedContent.CreateHeaderElement();
mainHeader.SetText("Main Header");

// اضافه کردن پاراگراف
ParagraphElement paragraphElement = taggedContent.CreateParagraphElement();
paragraphElement.SetText("Lorem ipsum dolor sit amet, consectetur adipiscing elit. " +
"Aenean nec lectus ac sem faucibus imperdiet. Sed ut erat ac magna ullamcorper hendrerit. " +
"Cras pellentesque libero semper, gravida magna sed, luctus leo. Fusce lectus odio, laoreet" +
"nec ullamcorper ut, molestie eu elit. Interdum et malesuada fames ac ante ipsum primis in faucibus." +
"Aliquam lacinia sit amet elit ac consectetur. Donec cursus condimentum ligula, vitae volutpat" +
"sem tristique eget. Nulla in consectetur massa. Vestibulum vitae lobortis ante. Nulla ullamcorper" +
"pellentesque justo rhoncus accumsan. Mauris ornare eu odio non lacinia. Aliquam massa leo, rhoncus" +
"ac iaculis eget, tempus et magna. Sed non consectetur elit. Sed vulputate, quam sed lacinia luctus," +
"ipsum nibh fringilla purus, vitae posuere risus odio id massa. Cras sed venenatis lacus.");

rootElement.AppendChild(mainHeader);
rootElement.AppendChild(paragraphElement);

// PDF برچسب گذاری شده را ذخیره کنید
document.Save("tagged-pdf.pdf");

در زیر خروجی نمونه کد بالا آمده است.

ایجاد یک فایل پی دی اف برچسب گذاری شده در سی شارپ

سی شارپ با عناصر تودرتو یک پی دی اف برچسب شده ایجاد کنید

در مثال قبلی، یک پی دی اف برچسب گذاری شده ساده ایجاد کردیم که حاوی یک پاراگراف است. بیایید اکنون نگاهی به نحوه اضافه کردن عناصر تو در تو در یک PDF برچسب گذاری شده بیندازیم. مراحل زیر برای انجام این عملیات آورده شده است.

  • با استفاده از کلاس Document یک PDF جدید ایجاد کنید یا یک فایل موجود را بارگیری کنید.
  • مرجع TaggedContent سند را در یک شیء ITaggedContent دریافت کنید.
  • عنوان، سرصفحه و زبان را تنظیم کنید و عناصر را با استفاده از شی ITaggedContent به PDF اضافه کنید.
  • یک ParagraphElement جدید با استفاده از روش ITaggedContent.CreateParagraphElement() ایجاد کنید و متن آن را تنظیم کنید.
  • از کلاس SpanElement برای اضافه کردن عناصر تودرتو استفاده کنید.
  • با استفاده از روش ParagraphElement.AppendChild() عنصر تودرتو را به پاراگراف اضافه کنید.
  • پاراگراف را با استفاده از روش ITaggedContent.RootElement.AppendChild() به سند اضافه کنید.
  • در نهایت فایل PDF را با استفاده از روش Document.Save(String) ذخیره کنید.

نمونه کد زیر نحوه اضافه کردن عناصر تو در تو را در یک پی دی اف برچسب گذاری شده در سی شارپ نشان می دهد.

// سند PDF ایجاد کنید
Document document = new Document();

// دریافت محتوا برای کار با پی دی اف برچسب گذاری شده
ITaggedContent taggedContent = document.TaggedContent;
var rootElement = taggedContent.RootElement;

// عنوان و زبان را برای سند تنظیم کنید
taggedContent.SetTitle("Tagged Pdf Document");
taggedContent.SetLanguage("en-US");

// هدر اضافه کنید
HeaderElement mainHeader = taggedContent.CreateHeaderElement();
mainHeader.SetText("Main Header");

// ایجاد پاراگراف
ParagraphElement paragraphWithQuotes = taggedContent.CreateParagraphElement();
paragraphWithQuotes.StructureTextState.Font = FontRepository.FindFont("Calibri");
paragraphWithQuotes.StructureTextState.MarginInfo = new MarginInfo(10, 5, 10, 5);

// عنصر span را اضافه کنید
SpanElement spanElement1 = taggedContent.CreateSpanElement();
spanElement1.SetText("Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean nec lectus ac sem faucibus imperdiet. Sed ut erat ac magna ullamcorper hendrerit. Cras pellentesque libero semper, gravida magna sed, luctus leo. Fusce lectus odio, laoreet nec ullamcorper ut, molestie eu elit. Interdum et malesuada fames ac ante ipsum primis in faucibus. Aliquam lacinia sit amet elit ac consectetur. Donec cursus condimentum ligula, vitae volutpat sem tristique eget. Nulla in consectetur massa. Vestibulum vitae lobortis ante. Nulla ullamcorper pellentesque justo rhoncus accumsan. Mauris ornare eu odio non lacinia. Aliquam massa leo, rhoncus ac iaculis eget, tempus et magna. Sed non consectetur elit. ");
QuoteElement quoteElement = taggedContent.CreateQuoteElement();
quoteElement.SetText("Sed vulputate, quam sed lacinia luctus, ipsum nibh fringilla purus, vitae posuere risus odio id massa.");
quoteElement.StructureTextState.FontStyle = FontStyles.Bold | FontStyles.Italic;
SpanElement spanElement2 = taggedContent.CreateSpanElement();
spanElement2.SetText(" Sed non consectetur elit.");

// الحاق به پاراگراف
paragraphWithQuotes.AppendChild(spanElement1);
paragraphWithQuotes.AppendChild(quoteElement);
paragraphWithQuotes.AppendChild(spanElement2);

// به عنصر ریشه اضافه کنید
rootElement.AppendChild(mainHeader);
rootElement.AppendChild(paragraphWithQuotes);

// PDF برچسب گذاری شده را ذخیره کنید
document.Save("tagged-pdf-nested-elements.pdf");

اسکرین شات زیر پی دی اف برچسب گذاری شده را با عناصر تو در تو نشان می دهد.

ایجاد یک PDF برچسب گذاری شده با عناصر تودرتو در سی شارپ

استایل دادن به ساختار متن در یک پی دی اف برچسب گذاری شده در سی شارپ

همچنین می‌توانید با تنظیم سبک فونت، خانواده، اندازه، و غیره، یک استایل را به متن در یک PDF برچسب‌گذاری شده اعمال کنید. 25 و ForegroundColor ویژگی های کلاس StructureTextState. نمونه کد زیر نحوه اعمال استایل متن را در یک پی دی اف برچسب گذاری شده در سی شارپ نشان می دهد.

// سند PDF ایجاد کنید
Document document = new Document();

// دریافت محتوا برای کار با پی دی اف برچسب گذاری شده
ITaggedContent taggedContent = document.TaggedContent;
var rootElement = taggedContent.RootElement;

// عنوان و زبان را برای سند تنظیم کنید
taggedContent.SetTitle("Tagged Pdf Document");
taggedContent.SetLanguage("en-US");

// هدر اضافه کنید
HeaderElement mainHeader = taggedContent.CreateHeaderElement();
mainHeader.SetText("Main Header");

// ایجاد پاراگراف
ParagraphElement paragraphWithQuotes = taggedContent.CreateParagraphElement();
taggedContent.RootElement.AppendChild(paragraphWithQuotes);

// یک ظاهر طراحی کنید
paragraphWithQuotes.StructureTextState.FontSize = 18F;
paragraphWithQuotes.StructureTextState.ForegroundColor = Color.Red;
paragraphWithQuotes.StructureTextState.FontStyle = FontStyles.Italic;
            
// متن اضافه کنید
paragraphWithQuotes.SetText("Red italic text.");

// PDF برچسب گذاری شده را ذخیره کنید
document.Save("tagged-pdf-text-styling.pdf");

C# به تصویر کشیدن عناصر ساختار در یک پی دی اف برچسب گذاری شده

برای نشان دادن عناصر ساختار، Aspose.PDF برای دات نت کلاس IllustrationElement را ارائه می کند. نمونه کد زیر نحوه استفاده از این کلاس را برای نشان دادن عناصر ساختار در یک پی دی اف برچسب گذاری شده نشان می دهد.

// سند PDF ایجاد کنید
Document document = new Document();

// دریافت محتوا برای کار با پی دی اف برچسب گذاری شده
ITaggedContent taggedContent = document.TaggedContent;
var rootElement = taggedContent.RootElement;

// عنوان و زبان را برای سند تنظیم کنید
taggedContent.SetTitle("Tagged Pdf Document");
taggedContent.SetLanguage("en-US");

IllustrationElement figure1 = taggedContent.CreateFigureElement();
taggedContent.RootElement.AppendChild(figure1);
figure1.AlternativeText = "Figure One";
figure1.Title = "Image 1";
figure1.SetTag("Fig1");
figure1.SetImage("aspose_pdf.png");

// PDF برچسب گذاری شده را ذخیره کنید
document.Save("tagged-pdf-illustrating-structure.pdf");

C# API برای ایجاد PDF برچسب گذاری شده - مجوز رایگان دریافت کنید

برای استفاده از Aspose.PDF برای دات نت بدون محدودیت ارزیابی، می توانید یک مجوز موقت رایگان دریافت کنید.

نتیجه

در این مقاله با نحوه ایجاد فایل های پی دی اف برچسب گذاری شده در سی شارپ آشنا شدید. علاوه بر این، نحوه ایجاد عناصر تو در تو، اعمال یک ظاهر به متن، و نشان دادن عناصر ساختار در یک پی دی اف برچسب‌گذاری شده را به صورت برنامه‌ریزی دیده‌اید. علاوه بر این، می‌توانید با استفاده از مستندات درباره .NET PDF API بیشتر کاوش کنید. در صورت داشتن هرگونه سوال یا سوال، می توانید از طریق [تالار گفتمان31 ما با ما تماس بگیرید.

همچنین ببینید