เมธอด THotPDF.SetLoadedFreeTextPlainText

แปลง FreeText annotation ที่โหลดแล้วซึ่งรองรับให้เป็น plain text ชิดซ้ายอย่างชัดเจน และสร้าง normal appearance ขึ้นใหม่

การประกาศ

procedure SetLoadedFreeTextPlainText(PageIndex, AnnotationIndex: Integer;
  const AText: AnsiString; FontSize: Single = 12);

ยูนิต: HPDFDoc · ใช้ได้ตั้งแต่เวอร์ชัน 2.753.0

พารามิเตอร์

• PageIndex: ดัชนีฐานศูนย์ของหน้าที่โหลดแล้ว
• AnnotationIndex: ดัชนีฐานศูนย์ของ annotation บนหน้านั้น
• AText: ตัวอักษร ASCII ที่พิมพ์ได้ ใช้ CR, LF หรือ CR/LF สำหรับขึ้นบรรทัดใหม่แบบระบุจุด ส่วน tab, control character อื่นและข้อความ non-ASCII จะถูกปฏิเสธ
• FontSize: ขนาดแบบมีขอบเขตในหน่วย PDF point มากกว่าศูนย์และไม่เกิน 10,000 ค่าเริ่มต้น 12

การแปลง appearance

เมธอดใช้ข้อความ Helvetica สีดำและเส้นขอบสี่เหลี่ยมสีดำ คงพื้นหลัง device color ที่รองรับและเรขาคณิตเส้นขอบแบบทึบหรือเส้นประเอาไว้ และ clip ข้อความให้อยู่ในระยะ inset สองพอยต์ภายในสี่เหลี่ยมของ annotation

บรรทัดเลื่อนลง 1.2 เท่าของขนาดฟอนต์ ไม่มีการตัดคำอัตโนมัติหรือย่อขนาดให้พอดี ข้อความที่หลุดออกนอก inset จะถูก clip

การแปลงจะแทนที่ /AP อัปเดต /Contents และ /DA ตั้ง /Q เป็นศูนย์ และลบ /RC, /DS และ /AS rich text เดิม, ฟอนต์ที่เลือก, สีข้อความ, การจัดวางและสถานะ appearance จะถูกแทนที่ตั้งใจ

การเปลี่ยนแปลงของ annotation, appearance และหน้าจะถูกลงทะเบียนไว้สำหรับ incremental saving และ page render cache จะถูก invalidate การบันทึกแบบเขียนใหม่ก็คง appearance ใหม่เอาไว้

อินพุตที่รองรับและข้อผิดพลาด

annotation ต้องมีอยู่จริงและมี subtype FreeText โดยมีสี่เหลี่ยมแบบมีขอบเขตที่กว้างและสูงกว่าสี่พอยต์

callout, ผลต่างหรือ inset ของสี่เหลี่ยม, border effect, entry rotation, intent ที่ไม่ใช่ FreeText, annotation ที่ไม่ทึบ, เส้นขอบโค้งมน และสไตล์เส้นขอบอื่นนอกจากแบบทึบหรือเส้นประ จะถูกปฏิเสธด้วย EArgumentException

คอมโพเนนต์พื้นหลัง DeviceGray, DeviceRGB และ DeviceCMYK ต้องอยู่ในช่วงศูนย์ถึงหนึ่ง ความกว้างขอบและ dash pattern ต้องถูกต้อง มีขอบเขต และไม่ติดลบ ส่วน dash pattern ที่ไม่ว่างแต่เป็นศูนย์ทั้งชุดจะถูกปฏิเสธ

อินพุตที่ไม่รองรับจะถูกตรวจสอบก่อนการแทนที่ annotation หรือ appearance ของมัน

ตัวอย่าง

สำหรับเอกสารที่โหลดแล้วซึ่ง annotation แรกบนหน้าศูนย์เป็น FreeText annotation ที่รองรับ

PDF.SetLoadedFreeTextPlainText(0, 0,
  'Updated review note'#13#10'Second line', 12);

API ที่เกี่ยวข้อง

SetLoadedAnnotationContents เปลี่ยนเฉพาะข้อความ contents ที่เก็บไว้ และคง appearance เดิมเอาไว้

SetLoadedFreeTextRichText · AddLoadedFreeTextAnnotation · THotPDF · หน้าแรก