คำอธิบาย PDF

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

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

การติดตั้ง SDK

Aspose.PDF Cloud SDK for Java เป็น API การเขียนโปรแกรมที่ช่วยให้โปรแกรมเมอร์ Java สามารถสร้าง จัดการ และแปลงเอกสาร PDF ที่มีอยู่เป็น [รูปแบบเอกสารที่รองรับ] อื่นๆ ได้8 Cloud SDK พร้อมให้ดาวน์โหลดได้จาก Maven และ GitHub จากนั้นเพิ่มรายละเอียดต่อไปนี้ในไฟล์ pom.xml เพื่อดาวน์โหลดและใช้ Aspose.Pdf.jar ในโปรเจ็กต์ Maven build ของคุณ

<repositories>
 <repository>
        <id>aspose-cloud</id>
        <name>artifact.aspose-cloud-releases</name>
        <url>https://artifact.aspose.cloud/repo</url>
    </repository>   
</repositories>
<dependencies>
 <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-pdf-cloud</artifactId>
        <version>21.1.0</version>
        <scope>compile</scope>
    </dependency>
 </dependencies>

สำหรับข้อมูลเพิ่มเติม โปรดไปที่ วิธีติดตั้ง Aspose.Cloud SDK

นอกจากนี้ โปรดทราบว่าเพื่อให้แน่ใจว่าผู้ใช้มีความเป็นส่วนตัวและมีความสมบูรณ์ของข้อมูล API ของเราทั้งหมดจึงสามารถเข้าถึงได้โดยบุคคลที่ได้รับอนุญาตเท่านั้น ดังนั้น คุณต้องไปที่ Aspose.Cloud Dashboard ก่อน และหากคุณมีบัญชี GitHub หรือ Google ให้ลงทะเบียนเพียงเท่านี้ มิฉะนั้น ให้คลิกที่ปุ่ม Create a new Account และระบุข้อมูลที่จำเป็น จากนั้นเข้าสู่ระบบแดชบอร์ดโดยใช้ข้อมูลรับรอง และขยายส่วนแอปพลิเคชันจากแดชบอร์ด จากนั้นเลื่อนลงไปที่ส่วนข้อมูลรับรองไคลเอนต์เพื่อดูรายละเอียดรหัสไคลเอนต์และความลับไคลเอนต์

การขีดฆ่าข้อความโดยใช้ Java

บางครั้ง เราต้องทำเครื่องหมายเนื้อหาบางส่วนในเอกสารว่าล้าสมัยโดยไม่ต้องลบออกจากเอกสาร เครื่องหมายขีดทับ (หรือเรียกอีกอย่างว่าขีดฆ่า) จะแสดงเป็นคำที่มีเส้นแนวนอนลากผ่านตรงกลาง เครื่องหมายนี้หมายความว่าข้อความไม่ถูกต้องหรือล้าสมัย และเพิ่งถูกลบหรือทำเครื่องหมายไว้ว่าเป็นเช่นนั้น เราสามารถตั้งค่าคำอธิบายประกอบขีดทับได้โดยใช้คุณสมบัติ strikethroughSettings คุณสมบัติ strikethroughSettings ใช้เพื่อตั้งค่าสี ความทึบ ผู้แต่ง หัวเรื่อง วันที่แก้ไข และคุณสมบัติ isLocked ของคำอธิบายประกอบขีดทับ

// รับ ClientID และ ClientSecret จาก https://dashboard.aspose.cloud/
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// สร้างอินสแตนซ์ PdfApi
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// อินพุตเอกสาร PDF
String sourcePDF = "PdfWithTable.pdf";	        
			        
int pageNumber = 1;
// สร้างพื้นที่สี่เหลี่ยมผืนผ้าสำหรับคำอธิบายประกอบ  
Rectangle rect = new Rectangle()
    .LLX(200.)
    .LLY(380.)
    .URX(250.)
    .URY(375.);

List<AnnotationFlags> flags = new ArrayList<>();
flags.add(AnnotationFlags.DEFAULT);

List<Point> points = new ArrayList<>();
points.add(new Point().X(132.).Y(380.)); // Top-Left edge of the Strike Through line
points.add(new Point().X(95.).Y(10.));	// Top-Right edge of the strike through line
points.add(new Point().X(130.).Y(25.));
points.add(new Point().X(130.).Y(10.));

StrikeOutAnnotation annotation = new StrikeOutAnnotation();
annotation.setName("Name");
annotation.setRect(rect);
annotation.setFlags(flags);
annotation.setHorizontalAlignment(HorizontalAlignment.CENTER);
annotation.setRichText("Rich Text");
annotation.setSubject("Subj");
annotation.setZindex(1);
annotation.setTitle("Title");
annotation.setQuadPoints(points);
annotation.setModified("05/22/2021 00:00:00.000 AM");
			        

List<StrikeOutAnnotation> annotations = new ArrayList<>();
annotations.add(annotation);

AsposeResponse response = pdfApi.postPageStrikeOutAnnotations(sourcePDF, pageNumber, annotations, null, null);
assertEquals(200, (int)response.getCode());

เพิ่มคำอธิบายเน้นข้อความ

การเน้นเนื้อหาใน PDF เป็นสิ่งสำคัญ เพราะช่วยให้เราสามารถดึงความสนใจไปที่ข้อมูลสำคัญภายในเอกสารได้ การเน้นข้อความมีประสิทธิผลเพราะเป็นการขอให้ผู้อ่านเลือกส่วนที่สำคัญก่อน จากนั้นจึงให้วิธีที่มีประสิทธิภาพในการตรวจสอบข้อมูลนั้นในภายหลัง Cloud API ของเรามีความสามารถในการเน้นเนื้อหาภายในเอกสาร PDF ด้านล่างนี้คือขั้นตอนในการเพิ่มคำอธิบายประกอบการเน้นข้อความในไฟล์ PDF

  • ก่อนอื่น ให้สร้างอินสแตนซ์ของ PdfApi โดยระบุรายละเอียด ClientSecret และ ClientId
  • เราสร้างอินสแตนซ์ไฟล์เพื่อโหลดไฟล์ PDF จากระบบภายในเครื่อง จากนั้นเรียกใช้เมธอด uploadFile(…) ของคลาส PdfApi เพื่ออัปโหลดเอกสารไปยังที่เก็บข้อมูลบนคลาวด์
  • ตอนนี้สร้างอินสแตนซ์ของคลาส Rectangle เพื่อระบุพื้นที่สี่เหลี่ยมผืนผ้าที่สามารถเพิ่มคำอธิบายประกอบได้
  • จากนั้นสร้าง ArrayList ชนิด Point เพื่อเก็บข้อมูลเกี่ยวกับจุดที่จะวาด HighlightAnnotation
  • สร้างอ็อบเจ็กต์ของคลาส HighlightAnnotation และตั้งค่าชื่อ, ภูมิภาคสี่เหลี่ยมผืนผ้า, เรื่อง, ชื่อเรื่อง, QuadPoints, วันที่แก้ไขคำอธิบายประกอบ
  • ขั้นตอนถัดไปคือการสร้างรายการประเภท HighlightAnnotation และเพิ่มวัตถุ HighlightAnnotation ที่สร้างขึ้นด้านบนลงในรายการนี้
  • ในที่สุด เรียกวิธี postPageHighlightAnnotations(…) ของคลาส PdfApi และส่ง PDF แหล่งที่มา หมายเลขหน้า และรายการคำอธิบายประกอบเป็นอาร์กิวเมนต์
เน้นการแสดงตัวอย่างคำอธิบาย

รูปภาพ 1:- เน้นคำอธิบายในไฟล์ PDF

คุณสามารถดาวน์โหลดไฟล์ตัวอย่างที่ใช้ในตัวอย่างข้างต้นได้จากลิงค์ต่อไปนี้

วิธีการเพิ่มคำอธิบายบรรทัด

API ยังช่วยให้คุณเพิ่มคำอธิบายบรรทัดในเอกสาร PDF ได้เช่นเดียวกับการเพิ่มคำอธิบายขีดฆ่าและเน้นข้อความ เรามีคลาสชื่อ LineAnnotation เพื่อตอบสนองความต้องการนี้ ด้านล่างนี้คือรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการตอบสนองความต้องการนี้

  • ก่อนอื่น ให้สร้างอินสแตนซ์ของ PdfApi โดยระบุรายละเอียด ClientSecret และ ClientId
  • นอกจากนี้ เรายังสร้างอินสแตนซ์ไฟล์เพื่อโหลดไฟล์ PDF จากระบบภายในเครื่อง จากนั้นเรียกใช้เมธอด uploadFile(…) ของคลาส PdfApi เพื่ออัปโหลดเอกสารไปยังที่เก็บข้อมูลบนคลาวด์ ในกรณีที่ไฟล์พร้อมใช้งานบนที่เก็บข้อมูลบนคลาวด์แล้ว เราก็สามารถใช้ไฟล์นั้นได้
  • คุณสมบัติการเริ่มต้นวัตถุที่เหลือจะเหมือนกับที่กล่าวไว้ข้างต้นสำหรับ HighlithAnnotation ยกเว้นว่าเราจำเป็นต้องสร้างวัตถุของคลาส LineAnnotation และกำหนดจุดเริ่มต้นและจุดสิ้นสุดของบรรทัดโดยใช้เมธอด setStarting(…) และ setEnding(…)
// รับ ClientID และ ClientSecret จาก https://dashboard.aspose.cloud/
String clientId = "7042694c-5251-4aba-83c9-e81e7518724f";
String clientSecret = "db246d4742e8cd22e7266c9391992689";
				
// สร้างอินสแตนซ์ PdfApi
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// อินพุตเอกสาร PDF
String sourcePDF = "PdfWithTable.pdf";	        
			    
// โหลดไฟล์จากระบบภายในเครื่อง
File file = new File("/Users/nayyershahbaz/Downloads/" + sourcePDF);

// อัพโหลดไฟล์ไปยังที่เก็บข้อมูลบนคลาวด์
FilesUploadResult uploadResponse = pdfApi.uploadFile(sourcePDF, file, null);

// หมายเลขหน้าที่จะเพิ่มคำอธิบาย				
int pageNumber = 1;

// สร้างพื้นที่สี่เหลี่ยมผืนผ้าสำหรับคำอธิบายประกอบ  
Rectangle rect = new Rectangle()
    .LLX(100.)
    .LLY(500.)
    .URX(400.)
    .URY(510.);

// สร้างรายการวัตถุของชนิด AnnotationFlags
List<AnnotationFlags> flags = new ArrayList<>();
flags.add(AnnotationFlags.DEFAULT);

// สร้างวัตถุคำอธิบายบรรทัด
LineAnnotation annotation = new LineAnnotation();

annotation.setName("Name");
annotation.setRect(rect);
annotation.setFlags(flags);
annotation.setRichText("Rich Text");
annotation.setSubject("Subj");
annotation.setTitle("Title");

// กำหนดจุดเริ่มต้นของเส้น
annotation.setStarting(new Point().X(100.).Y(100.));
// กำหนดจุดสิ้นสุดของเส้น
annotation.setEnding(new Point().X(20.).Y(680.));

// สร้างอินสแตนซ์สีสำหรับ staleblue
Color color = new Color();
color.setA(0x00);
color.setR(0x6A);
color.setG(0x5A);
color.setB(0xCD);
// ตั้งค่าสีคำอธิบายประกอบ
annotation.interiorColor(color);

// กำหนดวันที่แก้ไขคำอธิบาย			      
annotation.setModified("05/22/2021 00:00:00.000 AM");
			        
// สร้างรายการตัวอย่างของคำอธิบายบรรทัด
List<LineAnnotation> annotations = new ArrayList<>();
// เพิ่มวัตถุ LineAnnotation ลงในรายการ Line Annotations
annotations.add(annotation);

// เรียกใช้เมธอด API เพื่อเพิ่มคำอธิบายบรรทัดลงในไฟล์ PDF
AsposeResponse response = pdfApi.postPageLineAnnotations(sourcePDF, pageNumber, annotations, null, null);

การเพิ่มคำอธิบายวงกลมใน PDF

คำอธิบายวงกลมมักใช้ในเอกสาร PDF และ API รองรับประเภทคำอธิบายนี้ได้เป็นอย่างดี หากต้องการเพิ่มคำอธิบายวงกลม โปรดลองใช้คลาส CircleAnnotation สามารถใช้โค้ดที่ระบุไว้ด้านล่างเพื่อตอบสนองความต้องการนี้ได้

// รับ ClientID และ ClientSecret จาก https://dashboard.aspose.cloud/
String clientId = "7042694c-5251-4aba-83c9-e81e7518724f";
String clientSecret = "db246d4742e8cd22e7266c9391992689";
				
// สร้างอินสแตนซ์ PdfApi
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// อินพุตเอกสาร PDF
String sourcePDF = "PdfWithTable.pdf";	        
			    
// โหลดไฟล์จากระบบภายในเครื่อง
File file = new File("/Users/nayyershahbaz/Downloads/" + sourcePDF);

// อัพโหลดไฟล์ไปยังที่เก็บข้อมูลบนคลาวด์
FilesUploadResult uploadResponse = pdfApi.uploadFile(sourcePDF, file, null);
// หมายเลขหน้าที่จะเพิ่มคำอธิบาย				
int pageNumber = 1;

// สร้างพื้นที่สี่เหลี่ยมผืนผ้าสำหรับคำอธิบายประกอบ  
Rectangle rect = new Rectangle()
    .LLX(100.)
    .LLY(700.)
    .URX(300.)
    .URY(500.);

// สร้างรายการวัตถุของชนิด AnnotationFlags
List<AnnotationFlags> flags = new ArrayList<>();
flags.add(AnnotationFlags.DEFAULT);

// สร้างวัตถุเน้นคำอธิบาย
CircleAnnotation annotation = new CircleAnnotation();
annotation.setName("Name");
annotation.setRect(rect);
annotation.setFlags(flags);
annotation.setRichText("Rich Text");
annotation.setSubject("Subj");
annotation.setTitle("Title");

// สร้างอินสแตนซ์สีสำหรับ staleblue
Color color = new Color();
color.setR(0xC7);
color.setG(0xE2);
color.setB(0x6f);
// ตั้งค่าสีคำอธิบายประกอบ
annotation.interiorColor(color);

// กำหนดวันที่แก้ไขคำอธิบาย			      
annotation.setModified("05/22/2021 00:00:00.000 AM");
			        
// สร้างรายการตัวอย่างของไฮไลต์คำอธิบายประกอบ
List<CircleAnnotation> annotations = new ArrayList<>();

// เพิ่มวัตถุ CircleAnnotation ลงในรายการ Circle Annotations
annotations.add(annotation);

// เรียกใช้เมธอด API เพื่อเพิ่มคำอธิบายวงกลมลงในไฟล์ PDF
AsposeResponse response = pdfApi.postPageCircleAnnotations(sourcePDF, pageNumber, annotations, null, null);
คำอธิบายวงกลมใน PDF

รูปภาพ 2:- คำอธิบายวงกลมในไฟล์ PDF

สามารถดาวน์โหลดเอกสาร PDF อินพุตและ PDF ผลลัพธ์ดังแสดงด้านบนได้จากลิงก์ต่อไปนี้:

เคล็ดลับด่วน

ใช้ [แอปพลิเคชันคำอธิบายประกอบ PDF] ออนไลน์ฟรีของเรา 20 เพื่อลบคำอธิบายประกอบทั้งหมดออกจาก PDF ของคุณด้วยคลิกเดียว

บทสรุป

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

โปรดทราบว่าเราพยายามอย่างเต็มที่ในการให้บริการลูกค้าด้วยวิธีที่ดีที่สุดเสมอ และยินดีรับฟังคำติชมและข้อเสนอแนะของลูกค้า ดังนั้น หากคุณพบปัญหาใดๆ ในขณะใช้ API หรือมีคำถามที่เกี่ยวข้อง โปรดติดต่อเราผ่าน ฟอรัมสนับสนุนฟรี

บทความที่เกี่ยวข้อง

เราขอแนะนำให้เยี่ยมชมลิงก์ต่อไปนี้เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับ: