การแสดงผลรูปร่างแยกต่างหากจากเอกสาร

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

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

ประเภทรูปร่างในAspose.Words

เนื้อหาทั้งหมดในเลเยอร์การวาดรูปเอกสารจะแสดงโดยโหนดShapeหรือGroupShapeในโมดูลออบเจกต์เอกสารAspose.Words(DOM) เนื้อหาดังกล่าวสามารถเป็นกล่องข้อความ,ภาพ,AutoShapes,OLEวัตถุฯลฯ บางฟิลด์จะถูกนำเข้าเป็นรูปร่างเช่นฟิลด์INCLUDEPICTURE.

รูปภาพธรรมดาจะแสดงโดยโหนด Shape ของ ShapeType.Image โหนดรูปร่างนี้ไม่มีโหนดย่อย แต่ข้อมูลรูปภาพที่อยู่ในโหนดรูปร่างนี้สามารถเข้าถึงได้โดยคุณสมบัติ Shape.ImageData ในทางกลับกัน รูปร่างสามารถประกอบด้วยโหนดย่อยจำนวนมากได้ ตัวอย่างเช่น รูปร่างของกล่องข้อความซึ่งแสดงโดยคุณสมบัติ ShapeType.TextBox สามารถประกอบด้วยโหนดจำนวนมาก เช่น Paragraph และ Table รูปร่างส่วนใหญ่สามารถรวมโหนดระดับบล็อก Paragraph และ Table ได้ ซึ่งเป็นโหนดเดียวกับที่ปรากฏในเนื้อหาหลัก รูปร่างมักจะเป็นส่วนหนึ่งของย่อหน้าบางย่อหน้า ซึ่งอาจรวมโดยตรงในบรรทัดหรือยึดกับ Paragraph, แต่ “ลอย” อยู่ที่ใดก็ได้ในหน้าเอกสาร.

เอกสารยังสามารถประกอบด้วยรูปร่างที่จัดกลุ่มเข้าด้วยกัน การจัดกลุ่มสามารถเปิดใช้งานได้ในMicrosoft Wordโดยการเลือกหลายวัตถุและคลิก"กลุ่ม"ในเมนูคลิกขวา.

ในAspose.Wordsกลุ่มของรูปร่างเหล่านี้จะแสดงโดยโหนดGroupShape สามารถเรียกใช้เหล่านี้ในลักษณะเดียวกับเพื่อให้ทั้งกลุ่มภาพ.

รูปแบบDOCXสามารถประกอบด้วยรูปภาพประเภทพิเศษเช่นไดอะแกรมหรือแผนภูมิ รูปร่างเหล่านี้ยังถูกแสดงผ่านโหนดShapeในAspose.Wordsซึ่งมีวิธีการที่คล้ายกันสำหรับการแสดงผลเป็นรูปภ โดยการออกแบบรูปร่างไม่สามารถมีรูปร่างอื่นเป็นเด็กเว้นแต่รูปร่างที่เป็นภาพ(ShapeType.Image) ตัวอย่างเช่นMicrosoft Wordไม่อนุญาตให้คุณแทรกกล่องข้อความภายในกล่องข้อความอื่น.

ประเภทรูปร่างที่อธิบายข้างต้นมีวิธีการพิเศษเพื่อแสดงรูปร่างผ่านคลาสของShapeRenderer อินสแตนซ์ของShapeRendererคลาสถูกดึงสำหรับShapeหรือGroupShapeผ่านวิธีการGetShapeRendererหรือโดยการส่งผ่านShapeไปยังตัวสร้างของShapeRenderer คลาสนี้ให้การเข้าถึงสมาชิกซึ่งอนุญาตให้แสดงรูปร่างดังต่อไปนี้:

• แฟ้มบนดิสก์โดยใช้วิธีการโอเวอร์โหลดSave
• สตรีมโดยใช้วิธีการโอเวอร์โหลดSave
• วัตถุกราฟิกโดยใช้วิธีการRenderToSizeและRenderToScale

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

การแสดงผลไปยังแฟ้มหรือสตรีม

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

รูปร่างสามารถส่งออกในรูปแบบภาพใดๆที่ระบุไว้ในการแจงนับSaveFormat เช่นJPEGโดยระบุการแจงนับSaveFormat.Jpegหรือเป็นภาพเวกเตอร์เช่นEMFโดยการระบุSaveFormat.Emf.

ตัวอย่างโค้ดด้านล่างแสดงการแสดงผลรูปร่างเป็นEMFรูปภาพแยกต่างหากจากเอกสารและบันทึกลงในดิสก์:

ตัวอย่างโค้ดด้านล่างแสดงการแสดงผลรูปร่างเป็นJPEGรูปภาพแยกต่างหากจากเอกสารและบันทึกลงในสตรีม:

คลาสImageSaveOptionsช่วยให้คุณสามารถระบุตัวเลือกต่างๆที่ควบคุมวิธีการแสดงผลภาพ ฟังก์ชันที่อธิบายข้างต้นสามารถใช้ได้ในลักษณะเดียวกันกับGroupShapeและShapeโหนด.

การแสดงผลไปยังออบเจกต์Graphics

การเรนเดอร์โดยตรงไปยังอ็อบเจ็กต์ Graphics ช่วยให้คุณสามารถกำหนดค่าและสถานะของคุณเองสำหรับอ็อบเจ็กต์ Graphics ได้ สถานการณ์ทั่วไปเกี่ยวข้องกับการเรนเดอร์รูปร่างโดยตรงไปยังอ็อบเจ็กต์ Graphics ที่ดึงมาจากฟอร์ม Windows หรือบิตแมป เมื่อเรนเดอร์โหนด Shape การตั้งค่าจะส่งผลต่อลักษณะรูปร่าง ตัวอย่างเช่น คุณสามารถหมุนหรือปรับขนาดรูปร่างได้โดยใช้เมธอด RotateTransform หรือ ScaleTransform สำหรับอ็อบเจ็กต์ Graphics.

ตัวอย่างด้านล่างแสดงวิธีแสดงรูปร่างให้กับออบเจกต์Graphicsแยกต่างหากจากเอกสารและใช้กา:

ในทำนองเดียวกันกับวิธีการRenderToSizeวิธีการRenderToSizeที่สืบทอดมาจากNodeRendererBaseจะเป็นประโยชน์สำหรับการสร้างภาพขนาดย่อของเนื้อหาเอกสาร ขนาดรูปร่างที่ระบุผ่านตัวสร้าง วิธีRenderToSizeจะยอมรับวัตถุGraphicsพิกัดและพิกัดของตำแหน่งของภาพและขนาดของภาพ(ความกว้างและความสูง)ที่จะวาดลงบนวัตถุGraphics.

Shapeสามารถแสดงผลในระดับหนึ่งโดยใช้วิธีการShapeRenderer.RenderToScaleที่สืบทอดมาจากคลาสของNodeRendererBase นี้จะคล้ายกับวิธีการDocument.RenderToScaleที่ยอมรับพารามิเตอร์หลักเดียวกัน ความแตกต่างระหว่างสองวิธีนี้คือด้วยวิธีการShapeRenderer.RenderToScaleแทนที่จะเป็นขนาดตัวอักษรคุณเลือกค่าลอยที่ ถ้าค่าลอยเท่ากับ1.0ทำให้รูปร่างแสดงผลที่ 100%ของขนาดเดิม ค่าลอยตัวของ0.5จะลดขนาดภาพลงครึ่งหนึ่ง.

การแสดงผลรูปภาพรูปร่าง

คลาสShapeแสดงถึงวัตถุในเลเยอร์รูปวาดเช่นAutoShapeกล่องข้อความแบบอิสระOLEวัตถุควบคุมแอคทีฟเอ็กซ์ ใช้ชั้นเรียนShapeคุณสามารถสร้างหรือปรับเปลี่ยนรูปร่างในเอกสารMicrosoft Word คุณสมบัติที่สำคัญของรูปร่างคือShapeType รูปร่างของชนิดที่แตกต่างกันสามารถมีความสามารถที่แตกต่างกันในเอกสารคำ ตัวอย่างเช่นรูปภาพและOLEรูปทรงเท่านั้นที่สามารถมีรูปภาพภายในได้ในขณะที่รูปทรงส่วนให.

ตัวอย่างต่อไปนี้แสดงวิธีการแสดงผลอิมเมจรูปร่างไปยังอิมเมจJPEGแยกต่างหากจากเอกสา:

ดึงขนาดรูปร่าง

คลาสShapeRendererยังให้ฟังก์ชันเพื่อดึงขนาดของรูปร่างเป็นพิกเซลผ่านวิธีการGetSizeInPixels เมธอดนี้ยอมรับพารามิเตอร์ลอย(เดี่ยว)สองตัว-สเกลและDPIซึ่งใช้ในการคำนวณขนาดรูปร่างเมื่ วิธีการส่งคืนออบเจกต์Sizeซึ่งมีความกว้างและความสูงของขนาดที่คำนวณ นี้จะมีประโยชน์เมื่อจำเป็นต้องทราบขนาดของรูปร่างที่แสดงผลล่วงหน้าตัวอย่างเช่นเมื่อ.

ตัวอย่างด้านล่างแสดงวิธีการสร้างบิตแมปใหม่และวัตถุกราฟิกที่มีความกว้างและความสู:

เมื่อใช้วิธีการRenderToSizeหรือRenderToScaleขนาดภาพที่แสดงผลจะถูกส่งกลับไปยังออบเจกต์SizeF นี้สามารถกำหนดให้ตัวแปรและใช้ในกรณีที่จำเป็น.

คุณสมบัติSizeInPointsจะส่งคืนขนาดรูปร่างที่วัดเป็นจุด(ดูShapeRenderer) ผลลัพธ์คือSizeFวัตถุที่มีความกว้างและความสูง.