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


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

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

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

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

รูปภาพธรรมดาจะแสดงโดยโหนด **Shape** ของ [ShapeType.Image](https://reference.aspose.com/words/java/com.aspose.words/shapetype/#IMAGE) โหนดรูปร่างนี้ไม่มีโหนดย่อย แต่ข้อมูลรูปภาพที่อยู่ในโหนดรูปร่างนี้สามารถเข้าถึงได้โดยคุณสมบัติ [Shape.ImageData](https://reference.aspose.com/words/java/com.aspose.words/shape/#getImageData) ในทางกลับกัน รูปร่างสามารถประกอบด้วยโหนดย่อยจำนวนมากได้ ตัวอย่างเช่น รูปร่างของกล่องข้อความซึ่งแสดงโดยคุณสมบัติ [ShapeType.TextBox](https://reference.aspose.com/words/java/com.aspose.words/shapetype/#TEXT-BOX) สามารถประกอบด้วยโหนดจำนวนมาก เช่น [Paragraph](https://reference.aspose.com/words/java/com.aspose.words/paragraph/) และ [Table](https://reference.aspose.com/words/java/com.aspose.words/table/) รูปร่างส่วนใหญ่สามารถรวมโหนดระดับบล็อก **Paragraph** และ **Table** ได้ ซึ่งเป็นโหนดเดียวกับที่ปรากฏในเนื้อหาหลัก รูปร่างมักจะเป็นส่วนหนึ่งของย่อหน้าบางย่อหน้า ซึ่งอาจรวมโดยตรงในบรรทัดหรือยึดกับ **Paragraph,** แต่ "ลอย" อยู่ที่ใดก็ได้ในหน้าเอกสาร.

![rendering-shapes-separately-from-a-document-aspose-words-java-1](/words/java/rendering-shapes-separately-from-a-document/rendering-shapes-separately-from-a-document-1.png)

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

![rendering-shapes-separately-from-a-document-aspose-words-java-2](/words/java/rendering-shapes-separately-from-a-document/rendering-shapes-separately-from-a-document-2.png)

ในAspose.Wordsกลุ่มของรูปร่างเหล่านี้จะแสดงโดยโหนด[GroupShape](https://reference.aspose.com/words/java/com.aspose.words/groupshape/) สามารถเรียกใช้เหล่านี้ในลักษณะเดียวกับเพื่อให้ทั้งกลุ่มภาพ.

![rendering-shapes-separately-from-a-document-aspose-words-java-3](/words/java/rendering-shapes-separately-from-a-document/rendering-shapes-separately-from-a-document-3.png)

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

ประเภทรูปร่างที่อธิบายข้างต้นมีวิธีการพิเศษเพื่อแสดงรูปร่างผ่านคลาสของ[ShapeRenderer](https://reference.aspose.com/words/java/com.aspose.words/shaperenderer/) อินสแตนซ์ของ**ShapeRenderer**คลาสถูกดึงสำหรับ**Shape**หรือ**GroupShape**ผ่านวิธีการ**GetShapeRenderer**หรือโดยการส่งผ่าน**Shape**ไปยังตัวสร้างของ**ShapeRenderer** คลาสนี้ให้การเข้าถึงสมาชิกซึ่งอนุญาตให้แสดงรูปร่างดังต่อไปนี้:

- แฟ้มบนดิสก์โดยใช้วิธีการโอเวอร์โหลด[Save](https://reference.aspose.com/words/java/com.aspose.words/shaperenderer/#save-java.lang.String-com.aspose.words.ImageSaveOptions)
- สตรีมโดยใช้วิธีการโอเวอร์โหลด[Save](https://reference.aspose.com/words/java/com.aspose.words/shaperenderer/#save-java.io.OutputStream-com.aspose.words.ImageSaveOptions)
- วัตถุกราฟิกโดยใช้วิธีการ[RenderToSize](https://reference.aspose.com/words/java/com.aspose.words/shaperenderer/#renderToSize-java.awt.Graphics2D-float-float-float-float)และ[RenderToScale](https://reference.aspose.com/words/java/com.aspose.words/shaperenderer/#renderToScale-java.awt.Graphics2D-float-float-float)

{{% alert color="primary" %}}

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

{{% /alert %}}

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

วิธีการ[Save](https://reference.aspose.com/words/java/com.aspose.words/shaperenderer/#save-java.lang.String-com.aspose.words.ImageSaveOptions)ให้โอเวอร์โหลดที่ทำให้รูปร่างโดยตรงกับแฟ้มหรือสตรีม ทั้งสองโอเวอร์โหลดยอมรับอินสแตนซ์ของ[ImageSaveOptions](https://reference.aspose.com/words/java/com.aspose.words/imagesaveoptions/)คลาสซึ่งจะช่วยให้การกำหนดตัวเลือกสำหรับก นี้ทำงานในลักษณะเดียวกับวิธีการ[Document.Save](https://reference.aspose.com/words/java/com.aspose.words/document/#save-java.io.OutputStream-com.aspose.words.SaveOptions) แม้ว่าพารามิเตอร์นี้จำเป็นต้องใช้คุณสามารถส่งผ่านค่าโมฆะโดยระบุว่าไม่มีอ็อพชันแบบก.

รูปร่างสามารถส่งออกในรูปแบบภาพใดๆที่ระบุไว้ในการแจงนับ[SaveFormat](https://reference.aspose.com/words/java/com.aspose.words/saveformat/) เช่นJPEGโดยระบุการแจงนับ[SaveFormat.Jpeg](https://reference.aspose.com/words/java/com.aspose.words/saveformat/#JPEG)หรือเป็นภาพเวกเตอร์เช่นEMFโดยการระบุ[SaveFormat.Emf](https://reference.aspose.com/words/java/com.aspose.words/saveformat/#EMF).

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

{{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-rendering_printing-RenderShapes-RenderShapeToDisk.java" >}}

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

{{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-rendering_printing-RenderShapes-RenderShapeToStream.java" >}}

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

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

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

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

{{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-rendering_printing-RenderShapes-RenderShapeToGraphics.java" >}}

ในทำนองเดียวกันกับวิธีการ[RenderToSize](https://reference.aspose.com/words/java/com.aspose.words/document/#renderToSize-int-java.awt.Graphics2D-float-float-float-float)วิธีการ[RenderToSize](https://reference.aspose.com/words/java/com.aspose.words/document/#renderToSize-int-java.awt.Graphics2D-float-float-float-float)ที่สืบทอดมาจาก[NodeRendererBase](https://reference.aspose.com/words/java/com.aspose.words/noderendererbase/)จะเป็นประโยชน์สำหรับการสร้างภาพขนาดย่อของเนื้อหาเอกสาร ขนาดรูปร่างที่ระบุผ่านตัวสร้าง วิธี**RenderToSize**จะยอมรับวัตถุ**Graphics**พิกัดและพิกัดของตำแหน่งของภาพและขนาดของภาพ(ความกว้างและความสูง)ที่จะวาดลงบนวัตถุ**Graphics**.

**Shape**สามารถแสดงผลในระดับหนึ่งโดยใช้วิธีการ[ShapeRenderer.RenderToScale](https://reference.aspose.com/words/java/com.aspose.words/shaperenderer/#renderToScale-java.awt.Graphics2D-float-float-float)ที่สืบทอดมาจากคลาสของ[NodeRendererBase](https://reference.aspose.com/words/java/com.aspose.words/noderendererbase/) นี้จะคล้ายกับวิธีการ[Document.RenderToScale](https://reference.aspose.com/words/java/com.aspose.words/shaperenderer/#renderToScale-java.awt.Graphics2D-float-float-float)ที่ยอมรับพารามิเตอร์หลักเดียวกัน ความแตกต่างระหว่างสองวิธีนี้คือด้วยวิธีการ**ShapeRenderer.RenderToScale**แทนที่จะเป็นขนาดตัวอักษรคุณเลือกค่าลอยที่ ถ้าค่าลอยเท่ากับ1.0ทำให้รูปร่างแสดงผลที่ 100%ของขนาดเดิม ค่าลอยตัวของ0.5จะลดขนาดภาพลงครึ่งหนึ่ง.

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

คลาส[Shape](https://reference.aspose.com/words/java/com.aspose.words/shape/)แสดงถึงวัตถุในเลเยอร์รูปวาดเช่นAutoShapeกล่องข้อความแบบอิสระOLEวัตถุควบคุมแอคทีฟเอ็กซ์ ใช้ชั้นเรียน**Shape**คุณสามารถสร้างหรือปรับเปลี่ยนรูปร่างในเอกสารMicrosoft Word คุณสมบัติที่สำคัญของรูปร่างคือ[ShapeType](https://reference.aspose.com/words/java/com.aspose.words/shapetype/) รูปร่างของชนิดที่แตกต่างกันสามารถมีความสามารถที่แตกต่างกันในเอกสารคำ ตัวอย่างเช่นรูปภาพและOLEรูปทรงเท่านั้นที่สามารถมีรูปภาพภายในได้ในขณะที่รูปทรงส่วนให.

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

{{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-rendering_printing-RenderShapes-RenderShapeImage.java" >}}

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

คลาส[ShapeRenderer](https://reference.aspose.com/words/java/com.aspose.words/shaperenderer/)ยังให้ฟังก์ชันเพื่อดึงขนาดของรูปร่างเป็นพิกเซลผ่านวิธีการ[GetSizeInPixels](https://reference.aspose.com/words/java/com.aspose.words/noderendererbase/#getSizeInPixels-float-float) เมธอดนี้ยอมรับพารามิเตอร์ลอย(เดี่ยว)สองตัว-สเกลและDPIซึ่งใช้ในการคำนวณขนาดรูปร่างเมื่ วิธีการส่งคืนออบเจกต์[Size](https://reference.aspose.com/words/java/com.aspose.words/noderendererbase/#getSizeInPixels-float-float)ซึ่งมีความกว้างและความสูงของขนาดที่คำนวณ นี้จะมีประโยชน์เมื่อจำเป็นต้องทราบขนาดของรูปร่างที่แสดงผลล่วงหน้าตัวอย่างเช่นเมื่อ.

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

{{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-rendering_printing-RenderShapes-FindShapeSizes.java" >}}

เมื่อใช้วิธีการ**RenderToSize**หรือ**RenderToScale**ขนาดภาพที่แสดงผลจะถูกส่งกลับไปยังออบเจกต์[SizeF](https://reference.aspose.com/words/java/com.aspose.words/noderendererbase/#renderToScale-java.awt.Graphics2D-float-float-float) นี้สามารถกำหนดให้ตัวแปรและใช้ในกรณีที่จำเป็น.

คุณสมบัติ**SizeInPoints**จะส่งคืนขนาดรูปร่างที่วัดเป็นจุด(ดู[ShapeRenderer](https://reference.aspose.com/words/java/com.aspose.words/shaperenderer/)) ผลลัพธ์คือ`SizeF`วัตถุที่มีความกว้างและความสูง.