ความกว้างของเส้นคำอธิบาย lnk

การแนะนำ

เมื่อทำงานกับเอกสาร PDF การเพิ่มคำอธิบายประกอบสามารถเป็นวิธีที่มีประสิทธิภาพในการเน้นข้อมูลหรือเพิ่มองค์ประกอบแบบโต้ตอบลงในไฟล์ของคุณ คำอธิบายประกอบดังกล่าวอย่างหนึ่งคือ Ink Annotation ซึ่งช่วยให้คุณวาดเส้นฟรีฟอร์มบน PDF ของคุณได้ แต่จะเกิดอะไรขึ้นหากคุณต้องการปรับแต่งลักษณะของเส้นเหล่านี้ โดยเฉพาะความกว้างของเส้น ในบทช่วยสอนนี้ เราจะแนะนำคุณเกี่ยวกับขั้นตอนการตั้งค่าความกว้างของเส้นสำหรับคำอธิบายประกอบแบบหมึกโดยใช้ Aspose.PDF สำหรับ .NET

ข้อกำหนดเบื้องต้น

ก่อนจะเจาะลึกโค้ด เรามาตรวจสอบกันก่อนว่าคุณได้ตั้งค่าทุกอย่างให้สามารถปฏิบัติตามบทช่วยสอนนี้ได้อย่างราบรื่น:

  1. Aspose.PDF สำหรับ .NET: ตรวจสอบให้แน่ใจว่าคุณได้ติดตั้งไลบรารี Aspose.PDF สำหรับ .NET แล้ว คุณสามารถดาวน์โหลดได้จากหน้าดาวน์โหลด หรือติดตั้งผ่าน NuGet Package Manager ใน Visual Studio
  2. สภาพแวดล้อมการพัฒนา: บทช่วยสอนนี้ถือว่าคุณกำลังทำงานในสภาพแวดล้อมการพัฒนา .NET เช่น Visual Studio
  3. ความรู้พื้นฐานเกี่ยวกับ C#: ความเข้าใจพื้นฐานเกี่ยวกับ C# จะช่วยให้คุณปฏิบัติตามขั้นตอนการเขียนโค้ดได้
  4. เอกสาร PDF: ใช้เอกสาร PDF ที่มีอยู่หรือสร้างเอกสารใหม่สำหรับบทช่วยสอนนี้

การนำเข้าเนมสเปซที่จำเป็น

ก่อนที่คุณจะเริ่มเขียนโค้ด โปรดแน่ใจว่าได้นำเข้าเนมสเปซที่จำเป็นในโปรเจ็กต์ของคุณ:

using System.IO;
using Aspose.Pdf.Annotations;
using Aspose.Pdf;
using Aspose.Pdf.Facades;
using System;
using System.Collections;
using System.Collections.Generic;

เนมสเปซเหล่านี้ให้คลาสและวิธีการที่จำเป็นในการจัดการเอกสาร PDF การทำงานกับคำอธิบายประกอบ และจัดการองค์ประกอบกราฟิก

ตอนนี้เรามีข้อกำหนดเบื้องต้นแล้ว มาแบ่งกระบวนการตั้งค่าความกว้างของเส้นคำอธิบายหมึกออกเป็นขั้นตอนที่ชัดเจนและจัดการได้

ขั้นตอนที่ 1: เริ่มต้นเอกสาร PDF

ขั้นแรก เราต้องสร้างหรือเปิดเอกสาร PDF สำหรับบทช่วยสอนนี้ เราจะสร้างเอกสาร PDF ใหม่ตั้งแต่ต้น

// เริ่มต้นเอกสาร PDF
string dataDir = "YOUR DOCUMENT DIRECTORY"; // ระบุไดเรกทอรีเอกสารของคุณ
Document doc = new Document();
doc.Pages.Add(); // เพิ่มหน้าว่างลงในเอกสาร

ที่นี่เราจะเริ่มต้นใหม่Document วัตถุซึ่งแสดงถึงไฟล์ PDF ของเรา จากนั้นเราจะเพิ่มหน้าว่างลงในเอกสารนี้เพื่อใช้งาน

ขั้นตอนที่ 2: สร้างคำอธิบายหมึก

ต่อไปเราจะสร้างคำอธิบายหมึกเอง ซึ่งเกี่ยวข้องกับการกำหนดจุดที่ประกอบเป็นเส้นหมึก

// สร้างคำอธิบายหมึก
IList<Point[]> inkList = new List<Point[]>();
LineInfo lineInfo = new LineInfo();
lineInfo.VerticeCoordinate = new float[] { 55, 55, 70, 70, 70, 90, 150, 60 };
lineInfo.Visibility = true;
lineInfo.LineColor = Color.Red;
lineInfo.LineWidth = 2;

ในขั้นตอนนี้เราจะกำหนดLineInfo วัตถุซึ่งเก็บพิกัดของเส้นหมึก การมองเห็น สี และความกว้างของเส้นเริ่มต้นVerticeCoordinate อาร์เรย์ประกอบด้วยพิกัด X และ Y ของแต่ละจุดในจังหวะ

ขั้นตอนที่ 3: แปลงพิกัดเป็นจุด

ตอนนี้ เราต้องแปลงพิกัดเหล่านี้เป็นจุดที่สามารถใช้โดย Ink Annotation ได้

// แปลงพิกัดเป็นจุด
int length = lineInfo.VerticeCoordinate.Length / 2;
Aspose.Pdf.Point[] gesture = new Aspose.Pdf.Point[length];
for (int i = 0; i < length; i++)
{
    gesture[i] = new Aspose.Pdf.Point(lineInfo.VerticeCoordinate[2 * i], lineInfo.VerticeCoordinate[2 * i + 1]);
}

inkList.Add(gesture);

ลูปนี้จะประมวลผลอาร์เรย์พิกัด โดยแปลงพิกัดแต่ละคู่ให้เป็นPoint วัตถุซึ่งจะถูกเพิ่มเข้าไปในของเราinkList.

ขั้นตอนที่ 4: เพิ่มคำอธิบายหมึกลงในหน้า PDF

เมื่อเตรียมจุดต่างๆ เสร็จเรียบร้อยแล้ว ตอนนี้เราสามารถสร้างคำอธิบายหมึกและเพิ่มลงในหน้า PDF ได้

// เพิ่มคำอธิบายหมึกลงในหน้า PDF
InkAnnotation a1 = new InkAnnotation(doc.Pages[1], new Aspose.Pdf.Rectangle(100, 100, 300, 300), inkList);
a1.Subject = "Test";
a1.Title = "Title";
a1.Color = Aspose.Pdf.Color.FromRgb(Color.Green);

ในขั้นตอนนี้เราจะเริ่มต้นInkAnnotationวัตถุ โดยระบุหน้า กรอบสี่เหลี่ยม และรายการจุดของเรา นอกจากนี้ เรายังกำหนดหัวเรื่อง ชื่อเรื่อง และสีของคำอธิบายประกอบอีกด้วย

ขั้นตอนที่ 5: ปรับแต่งขอบของคำอธิบายประกอบ

เพื่อปรับแต่งลักษณะที่ปรากฏของคำอธิบายเพิ่มเติม เราจะต้องแก้ไขคุณสมบัติเส้นขอบ

// ปรับแต่งขอบของคำอธิบายประกอบ
Border border = new Border(a1);
border.Width = 3;
border.Effect = BorderEffect.Cloudy;
border.Dash = new Dash(1, 1);
border.Style = BorderStyle.Solid;
doc.Pages[1].Annotations.Add(a1);

ที่นี่เราสร้างBorder วัตถุสำหรับคำอธิบายประกอบ โดยกำหนดความกว้าง เอฟเฟกต์ รูปแบบเส้นประ และสไตล์ ขั้นตอนนี้จะช่วยให้คำอธิบายประกอบโดดเด่นขึ้นเมื่อดูในหน้า PDF

ขั้นตอนที่ 6: บันทึกเอกสาร PDF

ในที่สุดหลังจากทำการเปลี่ยนแปลงที่จำเป็นทั้งหมดแล้ว ก็ถึงเวลาบันทึกเอกสาร

// บันทึกเอกสาร PDF
dataDir = dataDir + "lnkAnnotationLineWidth_out.pdf";
doc.Save(dataDir);
Console.WriteLine("\nInk annotation line width setup successfully.\nFile saved at " + dataDir);

รหัสนี้จะบันทึกเอกสาร PDF ที่แก้ไขแล้วพร้อมคำอธิบายหมึกในไดเร็กทอรีที่ระบุConsole.WriteLine คำสั่งยืนยันว่าการดำเนินการโค้ดสำเร็จ

บทสรุป

ขอแสดงความยินดี! คุณได้สร้างและปรับแต่งคำอธิบายประกอบแบบหมึกในเอกสาร PDF สำเร็จแล้วโดยใช้ Aspose.PDF สำหรับ .NET บทช่วยสอนนี้ครอบคลุมกระบวนการทั้งหมดตั้งแต่การเริ่มต้นเอกสารไปจนถึงการบันทึกไฟล์สุดท้าย ด้วยความรู้ดังกล่าว คุณสามารถสำรวจความสามารถอันมากมายของ Aspose.PDF สำหรับ .NET เพิ่มเติม และใช้เทคนิคที่คล้ายคลึงกันกับคำอธิบายประกอบประเภทอื่นๆ หรือการจัดการ PDF

คำถามที่พบบ่อย

ฉันสามารถใช้สีที่แตกต่างกันสำหรับส่วนต่างๆ ของคำอธิบายหมึกได้หรือไม่

ใช่ คุณสามารถสร้างได้หลายรายการInkAnnotation วัตถุที่มีสีต่างกันแล้วเพิ่มลงในหน้าเดียวกันหรือหน้าต่างกันใน PDF ของคุณ

ฉันจะเปลี่ยนความกว้างของเส้นแบบไดนามิกได้อย่างไร

คุณสามารถปรับเปลี่ยนได้LineWidth ทรัพย์สินของLineInfo วัตถุก่อนที่จะแปลงพิกัดเป็นจุด

เป็นไปได้ไหมที่จะทำให้คำอธิบายหมึกโปร่งใส?

ใช่ คุณสามารถปรับเปลี่ยนได้Opacity ทรัพย์สินของInkAnnotation วัตถุที่จะทำให้มันโปร่งใส

ฉันสามารถเพิ่มคำอธิบายหมึกหลายรายการลงในหน้าเดียวกันได้หรือไม่

แน่นอน! คุณสามารถเพิ่มคำอธิบายหมึกได้มากเท่าที่คุณต้องการในหน้าเดียวโดยทำซ้ำขั้นตอนนี้

ฉันจะลบคำอธิบายหมึกออกจาก PDF ได้อย่างไร

คุณสามารถลบคำอธิบายประกอบได้โดยใช้doc.Pages[1].Annotations.Delete(a1) วิธีการที่a1 เป็นวัตถุคำอธิบายประกอบของคุณ