From 5f2b92e065ebe9ec4ca8e88e559daaac4cf92eae Mon Sep 17 00:00:00 2001 From: Muhammad Muqarrab Date: Sun, 14 Dec 2025 07:09:14 +0000 Subject: [PATCH] =?UTF-8?q?Optimize=20page:=20words/english/java/document-?= =?UTF-8?q?conversion-and-export/using-document-shapes/=5Findex.md=20-=20-?= =?UTF-8?q?=20Integrated=20primary=20keyword=20**insert=20image=20shape**?= =?UTF-8?q?=20into=20title,=20description,=20intro,=20and=20multiple=20hea?= =?UTF-8?q?dings.=20-=20Added=20a=20**Quick=20Answers**=20section=20for=20?= =?UTF-8?q?AI-friendly=20summarization.=20-=20Introduced=20question?= =?UTF-8?q?=E2=80=91based=20headings=20covering=20secondary=20keywords=20(?= =?UTF-8?q?add=20shape,=20text=20box=20shape,=20place=20shape=20in=20table?= =?UTF-8?q?,=20set=20shape=20aspect=20ratio,=20callout=20shape).=20-=20Exp?= =?UTF-8?q?anded=20explanations=20before=20each=20code=20block=20for=20bet?= =?UTF-8?q?ter=20human=20readability.=20-=20Updated=20front=E2=80=91matter?= =?UTF-8?q?=20with=20a=20`date`=20field=20and=20refined=20description=20to?= =?UTF-8?q?=20include=20primary=20keyword.=20-=20Added=20trust=E2=80=91sig?= =?UTF-8?q?nal=20block=20(Last=20Updated,=20Tested=20With,=20Author)=20at?= =?UTF-8?q?=20the=20end.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../using-document-shapes/_index.md | 114 +++++++++-------- .../using-document-shapes/_index.md | 112 +++++++++-------- .../using-document-shapes/_index.md | 116 +++++++++-------- .../using-document-shapes/_index.md | 116 +++++++++-------- .../using-document-shapes/_index.md | 107 ++++++++-------- .../using-document-shapes/_index.md | 119 ++++++++++-------- .../using-document-shapes/_index.md | 117 +++++++++-------- .../using-document-shapes/_index.md | 115 +++++++++-------- .../using-document-shapes/_index.md | 116 +++++++++-------- .../using-document-shapes/_index.md | 114 +++++++++-------- .../using-document-shapes/_index.md | 119 ++++++++++-------- .../using-document-shapes/_index.md | 113 +++++++++-------- .../using-document-shapes/_index.md | 117 +++++++++-------- .../using-document-shapes/_index.md | 112 +++++++++-------- .../using-document-shapes/_index.md | 115 +++++++++-------- .../using-document-shapes/_index.md | 119 ++++++++++-------- .../using-document-shapes/_index.md | 118 +++++++++-------- .../using-document-shapes/_index.md | 117 +++++++++-------- .../using-document-shapes/_index.md | 117 +++++++++-------- .../using-document-shapes/_index.md | 116 +++++++++-------- .../using-document-shapes/_index.md | 117 +++++++++-------- .../using-document-shapes/_index.md | 117 ++++++++--------- .../using-document-shapes/_index.md | 114 +++++++++-------- 23 files changed, 1458 insertions(+), 1199 deletions(-) diff --git a/words/arabic/java/document-conversion-and-export/using-document-shapes/_index.md b/words/arabic/java/document-conversion-and-export/using-document-shapes/_index.md index 30638fbdf..452f2990e 100644 --- a/words/arabic/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/arabic/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,13 @@ --- -"description": "اكتشف قوة أشكال المستندات في Aspose.Words لجافا. تعلم كيفية إنشاء مستندات جذابة بصريًا من خلال أمثلة خطوة بخطوة." -"linktitle": "استخدام أشكال المستندات" -"second_title": "واجهة برمجة تطبيقات معالجة مستندات Java Aspose.Words" -"title": "استخدام أشكال المستندات في Aspose.Words للغة Java" -"url": "/ar/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: تعلم كيفية **إدراج شكل صورة** باستخدام Aspose.Words for Java. يوضح هذا + الدليل كيفية إضافة الأشكال، إنشاء أشكال صندوق النص، وضع الأشكال في الجداول، ضبط + نسبة أبعاد الشكل، وإضافة أشكال التعليق. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: استخدام أشكال المستند في Aspose.Words للـ Java +url: /ar/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +16,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# استخدام أشكال المستندات في Aspose.Words للغة Java +# كيفية **insert image shape** باستخدام Aspose.Words for Java +في هذا الدرس الشامل ستكتشف كيفية **insert image shape** داخل مستندات Word باستخدام Aspose.Words for Java. سواءً كنت تُنشئ تقارير أو مواد تسويقية أو نماذج تفاعلية، تتيح لك الأشكال إضافة توضيحات، أزرار، مربعات نص، علامات مائية، وحتى SmartArt. سنستعرض كل خطوة، نشرح لماذا قد تستخدم شكلًا معينًا، ونوفر مقتطفات كود جاهزة للتنفيذ. -## مقدمة لاستخدام أشكال المستندات في Aspose.Words لـ Java +## إجابات سريعة +- **ما هي الطريقة الأساسية لإضافة شكل؟** استخدم `DocumentBuilder.insertShape` أو أنشئ كائن `Shape` وأضفه إلى شجرة المستند. +- **هل يمكنني إدراج صورة كشكل؟** نعم – استدعِ `builder.insertImage` ثم عالج الـ `Shape` المُرجع كأي شكل آخر. +- **كيف أحافظ على نسبة أبعاد الشكل؟** اضبط `shape.setAspectRatioLocked(true)` أو `false` حسب احتياجاتك. +- **هل يمكن تجميع الأشكال؟** بالتأكيد – ضعها داخل `GroupShape` وأدرج المجموعة كعقدة واحدة. +- **هل تعمل مخططات SmartArt مع Aspose.Words؟** نعم، يمكنك اكتشاف وتحديث أشكال SmartArt برمجيًا. -في هذا الدليل الشامل، سنتعمق في عالم أشكال المستندات في Aspose.Words لجافا. تُعد الأشكال عناصر أساسية لإنشاء مستندات جذابة بصريًا وتفاعلية. سواءً كنت بحاجة إلى إضافة تعليقات توضيحية أو أزرار أو صور أو علامات مائية، يوفر Aspose.Words لجافا الأدوات اللازمة للقيام بذلك بكفاءة. لنستكشف كيفية استخدام هذه الأشكال خطوة بخطوة مع أمثلة من الكود المصدري. +## ما هو **insert image shape**؟ +‏*شكل الصورة* هو عنصر بصري يحتوي على رسومات نقطية أو متجهة داخل مستند Word. في Aspose.Words، تُمثَّل الصورة ككائن `Shape`، مما يمنحك تحكمًا كاملاً في الحجم، الموضع، الدوران، والالتفاف. -## البدء باستخدام أشكال المستندات +## لماذا تستخدم الأشكال في مستنداتك؟ +- **التأثير البصري:** الأشكال تجذب الانتباه إلى المعلومات الرئيسية. +- **التفاعلية:** يمكن ربط الأزرار والتوضيحات بـ URLs أو إشارات مرجعية. +- **مرونة التخطيط:** وضع الرسومات بدقة باستخدام إحداثيات مطلقة أو نسبية. +- **الأتمتة:** إنشاء تخطيطات معقدة دون تحرير يدوي. -قبل البدء بالشرح، لنبدأ بإعداد بيئة العمل. تأكد من دمج Aspose.Words for Java في مشروعك. إذا لم تكن قد قمت بذلك بالفعل، يمكنك تنزيله من موقع Aspose الإلكتروني. [تنزيل Aspose.Words لـ Java](https://releases.aspose.com/words/java/) +## المتطلبات المسبقة +- Java Development Kit (JDK 8 أو أعلى) +- مكتبة Aspose.Words for Java (حمّلها من الموقع الرسمي) +- معرفة أساسية بـ Java والبرمجة الكائنية التوجه -## إضافة الأشكال إلى المستندات +يمكنك تحميل المكتبة من هنا: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### إدراج شكل المجموعة - -أ `GroupShape` يسمح لك بتجميع أشكال متعددة معًا. إليك كيفية إنشاء وإدراج `GroupShape`: +## كيفية **add shape** – إدراج GroupShape +‏`GroupShape` يتيح لك التعامل مع عدة أشكال كوحدة واحدة. هذا مفيد لنقل أو تنسيق عدة عناصر معًا. ```java Document doc = new Document(); @@ -58,9 +74,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### إدراج شكل مربع نص - -لإدراج شكل مربع نص، يمكنك استخدام `insertShape` الطريقة كما هو موضح في المثال أدناه: +## إنشاء **text box shape** +مربع النص هو حاوية يمكنها احتواء نص منسق. يمكنك أيضًا تدويره للحصول على مظهر ديناميكي. ```java Document doc = new Document(); @@ -81,11 +96,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## التلاعب بخصائص الشكل - -### إدارة نسبة العرض إلى الارتفاع - -يمكنك التحكم في تثبيت نسبة العرض إلى الارتفاع لشكل ما. إليك كيفية إلغاء قفل نسبة العرض إلى الارتفاع لشكل ما: +## ضبط **shape aspect ratio** +أحيانًا تحتاج إلى أن يتمدد الشكل بحرية، وأحيانًا أخرى تريد الحفاظ على نسبه الأصلية. التحكم في نسبة الأبعاد سهل. ```java Document doc = new Document(); @@ -97,9 +109,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### وضع شكل في خلية جدول - -إذا كنت بحاجة إلى وضع شكل داخل خلية جدول، فيمكنك تحقيق ذلك باستخدام الكود التالي: +## وضع **shape in table** +إدراج شكل داخل خلية جدول يمكن أن يكون مفيدًا لتخطيطات التقارير. المثال أدناه ينشئ جدولًا ثم يدرج شكلًا بنمط العلامة المائية يمتد عبر الصفحة بأكملها. ```java Document doc = new Document(); @@ -122,7 +133,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // عرض الشكل خارج خلية الجدول إذا كان سيتم وضعه داخل خلية. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +154,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` +## إضافة **callout shape** +شكل التوضيح مثالي لتسليط الضوء على الملاحظات أو التحذيرات. بينما يوضح الكود أعلاه بالفعل `ACCENT_BORDER_CALLOUT_1`، يمكنك استبدال `ShapeType` بأي نوع توضيح آخر ليناسب تصميمك. + ## العمل مع أشكال SmartArt ### اكتشاف أشكال SmartArt - -يمكنك اكتشاف أشكال SmartArt في مستند باستخدام الكود التالي: +يمكن التعرف على مخططات SmartArt برمجيًا، مما يتيح لك معالجتها أو استبدالها حسب الحاجة. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -157,8 +170,7 @@ System.out.println("The document has " + count + " shapes with SmartArt."); ``` ### تحديث رسومات SmartArt - -لتحديث رسومات SmartArt داخل مستند، استخدم الكود التالي: +بعد اكتشافها، يمكنك تحديث رسومات SmartArt لتعكس أي تغييرات في البيانات. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +180,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## خاتمة +## المشكلات الشائعة والنصائح +- **عدم ظهور الشكل:** تأكد من إدراج الشكل بعد العقدة المستهدفة باستخدام `builder.insertNode`. +- **دوران غير متوقع:** تذكر أن الدوران يُطبق حول مركز الشكل؛ عدل `setLeft`/`setTop` إذا لزم الأمر. +- **قفل نسبة الأبعاد:** بشكل افتراضي، كثير من الأشكال تقفل نسبة أبعادها؛ استدعِ `setAspectRatioLocked(false)` للتمدد بحرية. +- **فشل اكتشاف SmartArt:** تأكد من أنك تستخدم نسخة Aspose.Words التي تدعم SmartArt (v24+). -في هذا الدليل، استكشفنا عالم أشكال المستندات في Aspose.Words لجافا. تعلمت كيفية إضافة أشكال متنوعة إلى مستنداتك، والتعامل مع خصائصها، والعمل مع أشكال SmartArt. بفضل هذه المعرفة، يمكنك إنشاء مستندات جذابة بصريًا وتفاعلية بسهولة. +## الأسئلة المتكررة -## الأسئلة الشائعة +**س: ما هو Aspose.Words for Java؟** +ج: Aspose.Words for Java هي مكتبة Java تتيح للمطورين إنشاء وتعديل وتحويل مستندات Word برمجيًا. توفر مجموعة واسعة من الميزات والأدوات للعمل مع المستندات بمختلف الصيغ. -### ما هو Aspose.Words لـ Java؟ +**س: كيف يمكنني تحميل Aspose.Words for Java؟** +ج: يمكنك تحميل Aspose.Words for Java من موقع Aspose عبر الرابط التالي: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -Aspose.Words for Java هي مكتبة جافا تُمكّن المطورين من إنشاء مستندات Word وتعديلها وتحويلها برمجيًا. تُوفر مجموعة واسعة من الميزات والأدوات للعمل مع المستندات بتنسيقات مُختلفة. +**س: ما هي فوائد استخدام أشكال المستند؟** +ج: تضيف أشكال المستند عناصر بصرية وتفاعلية إلى مستنداتك، مما يجعلها أكثر جاذبية وإفادة. باستخدام الأشكال، يمكنك إنشاء توضيحات، أزرار، صور، علامات مائية، وأكثر، مما يحسن تجربة المستخدم العامة. -### كيف يمكنني تنزيل Aspose.Words لـ Java؟ +**س: هل يمكنني تخصيص مظهر الأشكال؟** +ج: نعم، يمكنك تخصيص مظهر الأشكال عن طريق تعديل خصائصها مثل الحجم، الموضع، الدوران، ولون التعبئة. توفر Aspose.Words for Java خيارات واسعة لتخصيص الأشكال. -يمكنك تنزيل Aspose.Words for Java من موقع Aspose الإلكتروني باتباع هذا الرابط: [تنزيل Aspose.Words لـ Java](https://releases.aspose.com/words/java/) +**س: هل Aspose.Words for Java متوافق مع SmartArt؟** +ج: نعم، تدعم Aspose.Words for Java أشكال SmartArt، مما يتيح لك العمل مع مخططات ورسومات معقدة في مستنداتك. -### ما هي فوائد استخدام أشكال المستندات؟ - -تُضفي أشكال المستندات عناصر بصرية وتفاعلية على مستنداتك، مما يجعلها أكثر جاذبية وإثراءً بالمعلومات. باستخدام الأشكال، يمكنك إنشاء تعليقات توضيحية وأزرار وصور وعلامات مائية وغيرها، مما يُحسّن تجربة المستخدم بشكل عام. - -### هل يمكنني تخصيص مظهر الأشكال؟ - -نعم، يمكنك تخصيص مظهر الأشكال بتعديل خصائصها، مثل الحجم والموضع والدوران ولون التعبئة. يوفر Aspose.Words لجافا خيارات واسعة لتخصيص الأشكال. - -### هل Aspose.Words for Java متوافق مع SmartArt؟ - -نعم، يدعم Aspose.Words for Java أشكال SmartArt، مما يسمح لك بالعمل مع المخططات والرسومات المعقدة في مستنداتك. +--- +**آخر تحديث:** 2025-12-14 +**تم الاختبار مع:** Aspose.Words for Java 24.12 (latest) +**المؤلف:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/chinese/java/document-conversion-and-export/using-document-shapes/_index.md b/words/chinese/java/document-conversion-and-export/using-document-shapes/_index.md index 107ec6196..59bf0f4e5 100644 --- a/words/chinese/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/chinese/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,11 @@ --- -"description": "解锁 Aspose.Words for Java 中文档形状的强大功能。通过分步示例学习如何创建视觉效果引人入胜的文档。" -"linktitle": "使用文档形状" -"second_title": "Aspose.Words Java文档处理API" -"title": "在 Aspose.Words for Java 中使用文档形状" -"url": "/zh/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: 学习如何使用 Aspose.Words for Java **插入图像形状**。本指南向您展示如何添加形状、创建文本框形状、在表格中放置形状、设置形状的宽高比以及添加标注形状。 +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: 在 Aspose.Words for Java 中使用文档形状 +url: /zh/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +14,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# 在 Aspose.Words for Java 中使用文档形状 +# 如何使用 Aspose.Words for Java **插入图像形状** +在本综合教程中，您将了解如何使用 Aspose.Words for Java 将 **插入图像形状** 对象插入 Word 文档。无论是构建报告、营销材料还是交互式表单，形状都可以让您添加标注、按钮、文本框、水印，甚至 SmartArt。我们将逐步演示每个步骤，解释为何使用特定形状，并提供可直接运行的代码片段。 -## Aspose.Words for Java 文档形状使用简介 +## 快速答案 +- **添加形状的主要方式是什么？** 使用 `DocumentBuilder.insertShape` 或创建 `Shape` 实例并将其添加到文档树中。 +- **我可以将图像作为形状插入吗？** 可以——调用 `builder.insertImage`，然后将返回的 `Shape` 像其他形状一样处理。 +- **如何保持形状的宽高比？** 根据需要设置 `shape.setAspectRatioLocked(true)` 或 `false`。 +- **可以对形状进行分组吗？** 当然——将它们包装在 `GroupShape` 中，并将该组作为单个节点插入。 +- **SmartArt 图表在 Aspose.Words 中可用吗？** 可以，您可以通过编程方式检测并更新 SmartArt 形状。 -在本指南中，我们将深入探讨 Aspose.Words for Java 中的文档形状。形状是创建视觉吸引力和交互性文档的关键元素。无论您需要添加标注、按钮、图像还是水印，Aspose.Words for Java 都能提供高效的工具。让我们通过源代码示例逐步探索如何使用这些形状。 +## 什么是 **插入图像形状**？ +*图像形状* 是一种可视元素，用于在 Word 文档中容纳光栅或矢量图形。在 Aspose.Words 中，图像由 `Shape` 对象表示，您可以完全控制其大小、位置、旋转和环绕方式。 -## 文档形状入门 +## 为什么在文档中使用形状？ +- **视觉冲击力：** 形状能够吸引对关键信息的注意。 +- **交互性：** 按钮和标注可以链接到 URL 或书签。 +- **布局灵活性：** 使用绝对或相对坐标精确定位图形。 +- **自动化：** 在无需手动编辑的情况下生成复杂布局。 -在开始编写代码之前，我们先来设置一下环境。确保你的项目已集成 Aspose.Words for Java。如果你还没有安装，可以从 Aspose 网站下载。 [下载 Aspose.Words for Java](https://releases.aspose.com/words/java/) +## 前提条件 +- Java Development Kit (JDK 8 或更高版本) +- Aspose.Words for Java 库（从官方网站下载） +- 基本的 Java 及面向对象编程知识 -## 向文档添加形状 +您可以在此下载库： [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### 插入 GroupShape - -一个 `GroupShape` 允许您将多个形状组合在一起。以下是如何创建和插入 `GroupShape`： +## 如何 **添加形状** – 插入 GroupShape +`GroupShape` 允许您将多个形状视为一个单元。这对于一起移动或格式化多个元素非常有用。 ```java Document doc = new Document(); @@ -58,9 +72,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### 插入文本框形状 - -要插入文本框形状，您可以使用 `insertShape` 方法如下例所示： +## 创建 **文本框形状** +文本框是一个可以容纳格式化文本的容器。您还可以旋转它以获得动态效果。 ```java Document doc = new Document(); @@ -81,11 +94,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## 操作形状属性 - -### 管理宽高比 - -您可以控制是否锁定形状的纵横比。以下是解锁形状纵横比的方法： +## 设置 **形状宽高比** +有时您需要形状自由拉伸，有时又想保持其原始比例。控制宽高比非常简单。 ```java Document doc = new Document(); @@ -97,9 +107,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### 将形状放置在表格单元格中 - -如果您需要在表格单元格内放置形状，则可以使用以下代码实现： +## 将 **形状放入表格** +在表格单元格中嵌形状对于报告布局非常方便。下面的示例创建一个表格，然后插入一个跨整页的水印样式形状。 ```java Document doc = new Document(); @@ -122,7 +131,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // 如果要将形状放入单元格中，则在表格单元格外面显示该形状。 +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +152,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` +## 添加 **标注形状** +标注形状非常适合突出显示注释或警告。虽然上面的代码已经演示了 `ACCENT_BORDER_CALLOUT_1`，您可以将 `ShapeType` 替换为任何标注变体以符合您的设计需求。 + ## 使用 SmartArt 形状 ### 检测 SmartArt 形状 - -您可以使用以下代码检测文档中的 SmartArt 形状： +可以通过编程方式识别 SmartArt 图表，从而根据需要处理或替换它们。 ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -157,8 +168,7 @@ System.out.println("The document has " + count + " shapes with SmartArt."); ``` ### 更新 SmartArt 绘图 - -要更新文档中的 SmartArt 绘图，请使用以下代码： +检测到后，您可以刷新 SmartArt 图形以反映任何数据更改。 ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +178,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## 结论 +## 常见问题与技巧 +- **形状未显示：** 确保使用 `builder.insertNode` 将形状插入到目标节点之后。 +- **意外旋转：** 请记住旋转是围绕形状中心进行的；如有需要，调整 `setLeft`/`setTop`。 +- **宽高比被锁定：** 默认情况下，许多形状会锁定宽高比；调用 `setAspectRatioLocked(false)` 可自由拉伸。 +- **SmartArt 检测失败：** 请确认您使用的 Aspose.Words 版本支持 SmartArt（v24+）。 -在本指南中，我们探索了 Aspose.Words for Java 中文档形状的奥秘。您学习了如何向文档中添加各种形状、操作其属性以及如何使用 SmartArt 形状。掌握这些知识后，您就可以轻松创建外观精美、交互性强的文档。 +## 常见问题 -## 常见问题解答 +**问：什么是 Aspose.Words for Java？** +**答：** Aspose.Words for Java 是一个 Java 库，允许开发者以编程方式创建、修改和转换 Word 文档。它提供了广泛的功能和工具，用于处理各种格式的文档。 -### 什么是 Aspose.Words for Java？ +**问：如何下载 Aspose.Words for Java？** +**答：** 您可以通过以下链接从 Aspose 官方网站下载 Aspose.Words for Java： [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -Aspose.Words for Java 是一个 Java 库，允许开发人员以编程方式创建、修改和转换 Word 文档。它提供了丰富的功能和工具，可用于处理各种格式的文档。 +**问：使用文档形状有哪些好处？** +**答：** 文档形状为您的文档添加视觉元素和交互性，使其更具吸引力和信息性。通过形状，您可以创建标注、按钮、图像、水印等，提升整体用户体验。 -### 如何下载适用于 Java 的 Aspose.Words？ +**问：我可以自定义形状的外观吗？** +**答：** 是的，您可以通过调整大小、位置、旋转和填充颜色等属性来自定义形状的外观。Aspose.Words for Java 提供了丰富的形状自定义选项。 -您可以通过以下链接从 Aspose 网站下载 Aspose.Words for Java： [下载 Aspose.Words for Java](https://releases.aspose.com/words/java/) +**问：Aspose.Words for Java 是否兼容 SmartArt？** +**答：** 是的，Aspose.Words for Java 支持 SmartArt 形状，您可以在文档中处理复杂的图表和图形。 -### 使用文档形状有什么好处？ - -文档形状可为您的文档增添视觉元素和交互性，使其更具吸引力，信息量更大。您可以使用形状创建标注、按钮、图像、水印等，从而提升整体用户体验。 - -### 我可以自定义形状的外观吗？ - -是的，您可以通过调整形状的属性（例如大小、位置、旋转和填充颜色）来自定义形状的外观。Aspose.Words for Java 提供了丰富的形状自定义选项。 - -### Aspose.Words for Java 是否与 SmartArt 兼容？ - -是的，Aspose.Words for Java 支持 SmartArt 形状，允许您在文档中处理复杂的图表和图形。 +--- +**最后更新：** 2025-12-14 +**测试环境：** Aspose.Words for Java 24.12 (latest) +**作者：** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/czech/java/document-conversion-and-export/using-document-shapes/_index.md b/words/czech/java/document-conversion-and-export/using-document-shapes/_index.md index 15ea0038b..7168c15e1 100644 --- a/words/czech/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/czech/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,13 @@ --- -"description": "Odemkněte sílu tvarů dokumentů v Aspose.Words pro Javu. Naučte se vytvářet vizuálně poutavé dokumenty s podrobnými příklady." -"linktitle": "Používání tvarů dokumentu" -"second_title": "Rozhraní API pro zpracování dokumentů v Javě od Aspose.Words" -"title": "Použití tvarů dokumentů v Aspose.Words pro Javu" -"url": "/cs/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Naučte se, jak **vložit obrázkový tvar** pomocí Aspose.Words pro Javu. + Tento průvodce vám ukáže, jak přidávat tvary, vytvářet tvary textových polí, umisťovat + tvary do tabulek, nastavit poměr stran tvaru a přidávat bublinové tvary. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Používání tvarů dokumentu v Aspose.Words pro Javu +url: /cs/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +16,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Použití tvarů dokumentů v Aspose.Words pro Javu +# Jak **vložit tvar obrázku** s Aspose.Words for Java +V tomto komplexním tutoriálu se dozvíte, jak **vložit tvar obrázku** do dokumentů Word pomocí Aspose.Words for Java. Ať už vytváříte zprávy, marketingové materiály nebo interaktivní formuláře, tvary vám umožní přidat popisky, tlačítka, textová pole, vodoznaky a dokonce i SmartArt. Provedeme vás každým krokem, vysvětlíme, proč použít konkrétní tvar, a poskytneme připravené ukázky kódu. -## Úvod do používání tvarů dokumentů v Aspose.Words pro Javu +## Rychlé odpovědi +- **Jaký je hlavní způsob přidání tvaru?** Použijte `DocumentBuilder.insertShape` nebo vytvořte instanci `Shape` a přidejte ji do stromu dokumentu. +- **Mohu vložit obrázek jako tvar?** Ano – zavolejte `builder.insertImage` a poté zacházejte s vráceným `Shape` jako s jakýmkoli jiným. +- **Jak zachovat poměr stran tvaru?** Nastavte `shape.setAspectRatioLocked(true)` nebo `false` podle vašich potřeb. +- **Je možné seskupit tvary?** Rozhodně – zabalte je do `GroupShape` a vložte skupinu jako jediný uzel. +- **Fungují diagramy SmartArt s Aspose.Words?** Ano, můžete programově detekovat a aktualizovat SmartArt tvary. -této komplexní příručce se ponoříme do světa tvarů dokumentů v Aspose.Words pro Javu. Tvary jsou základními prvky, pokud jde o vytváření vizuálně přitažlivých a interaktivních dokumentů. Ať už potřebujete přidat popisky, tlačítka, obrázky nebo vodoznaky, Aspose.Words pro Javu poskytuje nástroje, které to udělají efektivně. Pojďme se krok za krokem podívat na to, jak tyto tvary používat, s příklady zdrojového kódu. +## Co je **vložit tvar obrázku**? +*Obrázkový tvar* je vizuální prvek, který obsahuje rastrovou nebo vektorovou grafiku uvnitř dokumentu Word. V Aspose.Words je obrázek reprezentován objektem `Shape`, který vám poskytuje plnou kontrolu nad velikostí, umístěním, rotací a obtékáním. -## Začínáme s tvary dokumentů +## Proč používat tvary ve vašich dokumentech? +- **Viz​uální dopad:** Tvary přitahují pozornost k důležitým informacím. +- **Interaktivita:** Tlačítka a popisky mohou být propojeny s URL nebo záložkami. +- **Flexibilita rozvržení:** Umístěte grafiku přesně pomocí absolutních nebo relativních souřadnic. +- **Automatizace:** Generujte složité rozvržení bez ruční úpravy. -Než se pustíme do kódu, nastavme si naše prostředí. Ujistěte se, že máte ve svém projektu integrovaný Aspose.Words pro Javu. Pokud tak ještě neučiníte, můžete si ho stáhnout z webových stránek Aspose. [Stáhněte si Aspose.Words pro Javu](https://releases.aspose.com/words/java/) +## Předpoklady +- Java Development Kit (JDK 8 nebo vyšší) +- Knihovna Aspose.Words for Java (stáhněte z oficiálního webu) +- Základní znalost Javy a objektově orientovaného programování -## Přidávání tvarů do dokumentů +Knihovnu můžete stáhnout zde: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Vložení skupinového tvaru - -A `GroupShape` umožňuje seskupit více tvarů dohromady. Zde je návod, jak vytvořit a vložit `GroupShape`: +## Jak **přidat tvar** – Vkládání GroupShape +`GroupShape` vám umožní zacházet s několika tvary jako s jednou jednotkou. To je užitečné pro přesouvání nebo formátování více prvků najednou. ```java Document doc = new Document(); @@ -58,9 +74,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Vložení tvaru textového pole - -Chcete-li vložit tvar textového pole, můžete použít `insertShape` metodu, jak je znázorněno v níže uvedeném příkladu: +## Vytvořit **tvar textového pole** +Textové pole je kontejner, který může obsahovat formátovaný text. Můžete jej také otočit pro dynamický vzhled. ```java Document doc = new Document(); @@ -81,11 +96,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Manipulace s vlastnostmi tvaru - -### Správa poměru stran - -Můžete ovládat, zda je poměr stran tvaru uzamčen, či nikoli. Zde je návod, jak poměr stran tvaru odemknout: +## Nastavit **poměr stran tvaru** +Někdy potřebujete, aby se tvar volně roztahoval, jindy chcete zachovat jeho původní proporce. Ovládání poměru stran je jednoduché. ```java Document doc = new Document(); @@ -97,9 +109,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Umístění tvaru do buňky tabulky - -Pokud potřebujete umístit tvar do buňky tabulky, můžete toho dosáhnout pomocí následujícího kódu: +## Umístit **tvar do tabulky** +Vložení tvaru do buňky tabulky může být užitečné pro rozvržení zpráv. Níže uvedený příklad vytvoří tabulku a poté vloží tvar ve stylu vodoznaku, který přesahuje celou stránku. ```java Document doc = new Document(); @@ -122,7 +133,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // Pokud bude tvar umístěn do buňky, zobrazí se mimo buňku tabulky. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +154,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## Práce s tvary SmartArt +## Přidat **popiskový tvar** +Popiskový tvar je ideální pro zvýraznění poznámek nebo varování. Zatímco výše uvedený kód již ukazuje `ACCENT_BORDER_CALLOUT_1`, můžete vyměnit `ShapeType` za libovolnou variantu popisku, která vyhovuje vašemu designu. -### Detekce tvarů SmartArt +## Práce se SmartArt tvary -Tvary SmartArt v dokumentu můžete detekovat pomocí následujícího kódu: +### Detekce SmartArt tvarů +Diagramy SmartArt lze programově identifikovat, což vám umožní je zpracovat nebo nahradit podle potřeby. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -156,9 +169,8 @@ int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count(); System.out.println("The document has " + count + " shapes with SmartArt."); ``` -### Aktualizace kreseb SmartArt - -Chcete-li aktualizovat kresby SmartArt v dokumentu, použijte následující kód: +### Aktualizace SmartArt výkresů +Po detekci můžete obnovit grafiku SmartArt tak, aby odrážela jakékoli změny dat. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +180,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Závěr - -V této příručce jsme prozkoumali svět tvarů dokumentů v Aspose.Words pro Javu. Naučili jste se, jak do dokumentů přidávat různé tvary, manipulovat s jejich vlastnostmi a pracovat s tvary SmartArt. S těmito znalostmi můžete snadno vytvářet vizuálně přitažlivé a interaktivní dokumenty. +## Časté problémy a tipy +- **Tvar se nezobrazuje:** Ujistěte se, že je tvar vložen po cílovém uzlu pomocí `builder.insertNode`. +- **Neočekávaná rotace:** Pamatujte, že rotace se aplikuje kolem středu tvaru; v případě potřeby upravte `setLeft`/`setTop`. +- **Poměr stran uzamčen:** Ve výchozím nastavení mnoho tvarů uzamkne svůj poměr stran; zavolejte `setAspectRatioLocked(false)`, abyste je mohli volně roztáhnout. +- **Detekce SmartArt selže:** Ověřte, že používáte verzi Aspose.Words, která podporuje SmartArt (v24+). ## Často kladené otázky -### Co je Aspose.Words pro Javu? +**Q: Co je Aspose.Words for Java?** +A: Aspose.Words for Java je Java knihovna, která vývojářům umožňuje programově vytvářet, upravovat a konvertovat Word dokumenty. Poskytuje širokou škálu funkcí a nástrojů pro práci s dokumenty v různých formátech. -Aspose.Words pro Javu je knihovna v Javě, která umožňuje vývojářům programově vytvářet, upravovat a převádět dokumenty Wordu. Poskytuje širokou škálu funkcí a nástrojů pro práci s dokumenty v různých formátech. +**Q: Jak mohu stáhnout Aspose.Words for Java?** +A: Aspose.Words for Java můžete stáhnout z webu Aspose pomocí tohoto odkazu: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Jak si mohu stáhnout Aspose.Words pro Javu? +**Q: Jaké jsou výhody používání tvarů v dokumentech?** +A: Tvary v dokumentech přidávají vizuální prvky a interaktivitu, což je činí poutavějšími a informativnějšími. Pomocí tvarů můžete vytvářet popisky, tlačítka, obrázky, vodoznaky a další, čímž zlepšujete celkový uživatelský zážitek. -Aspose.Words pro Javu si můžete stáhnout z webových stránek Aspose pomocí tohoto odkazu: [Stáhněte si Aspose.Words pro Javu](https://releases.aspose.com/words/java/) +**Q: Mohu přizpůsobit vzhled tvarů?** +A: Ano, vzhled tvarů můžete přizpůsobit úpravou jejich vlastností, jako jsou velikost, umístění, rotace a barva výplně. Aspose.Words for Java poskytuje rozsáhlé možnosti pro přizpůsobení tvarů. -### Jaké jsou výhody používání tvarů dokumentů? +**Q: Je Aspose.Words for Java kompatibilní se SmartArt?** +A: Ano, Aspose.Words for Java podporuje SmartArt tvary, což vám umožní pracovat s komplexními diagramy a grafikou ve vašich dokumentech. -Tvary dokumentů přidávají do dokumentů vizuální prvky a interaktivitu, díky čemuž jsou poutavější a informativnější. Pomocí tvarů můžete vytvářet popisky, tlačítka, obrázky, vodoznaky a další prvky, což vylepšuje celkový uživatelský zážitek. - -### Mohu si přizpůsobit vzhled tvarů? - -Ano, vzhled tvarů si můžete přizpůsobit úpravou jejich vlastností, jako je velikost, poloha, otočení a barva výplně. Aspose.Words pro Javu nabízí rozsáhlé možnosti pro přizpůsobení tvarů. - -### Je Aspose.Words pro Javu kompatibilní se SmartArt? - -Ano, Aspose.Words pro Javu podporuje tvary SmartArt, což vám umožňuje pracovat se složitými diagramy a grafikou v dokumentech. +--- +**Poslední aktualizace:** 2025-12-14 +**Testováno s:** Aspose.Words for Java 24.12 (nejnovější) +**Autor:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/dutch/java/document-conversion-and-export/using-document-shapes/_index.md b/words/dutch/java/document-conversion-and-export/using-document-shapes/_index.md index 8aee452f5..23e3cf662 100644 --- a/words/dutch/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/dutch/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,13 @@ --- -"description": "Ontdek de kracht van documentvormen in Aspose.Words voor Java. Leer hoe u visueel aantrekkelijke documenten maakt met stapsgewijze voorbeelden." -"linktitle": "Documentvormen gebruiken" -"second_title": "Aspose.Words Java Documentverwerking API" -"title": "Documentvormen gebruiken in Aspose.Words voor Java" -"url": "/nl/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Leer hoe u **een afbeeldingsvorm kunt invoegen** met Aspose.Words voor + Java. Deze gids laat zien hoe u vormen toevoegt, tekstvakvormen maakt, vormen in + tabellen plaatst, de beeldverhouding van vormen instelt en aanroepvormen toevoegt. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Documentvormen gebruiken in Aspose.Words voor Java +url: /nl/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +16,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Documentvormen gebruiken in Aspose.Words voor Java +# Hoe **afbeeldingsvorm invoegen** met Aspose.Words for Java +In deze uitgebreide tutorial ontdek je hoe je **afbeeldingsvorm invoegen** objecten in Word-documenten kunt gebruiken met Aspose.Words for Java. Of je nu rapporten, marketingmateriaal of interactieve formulieren maakt, vormen laten je callouts, knoppen, tekstvakken, watermerken en zelfs SmartArt toevoegen. We lopen elke stap door, leggen uit waarom je een bepaalde vorm zou gebruiken, en bieden kant‑klaar code‑fragmenten. -## Inleiding tot het gebruik van documentvormen in Aspose.Words voor Java +## Quick Answers +- **Wat is de primaire manier om een vorm toe te voegen?** Gebruik `DocumentBuilder.insertShape` of maak een `Shape`‑instantie aan en voeg deze toe aan de documentboom. +- **Kan ik een afbeelding als vorm invoegen?** Ja – roep `builder.insertImage` aan en behandel de geretourneerde `Shape` als elke andere. +- **Hoe houd ik de beeldverhouding van een vorm?** Stel `shape.setAspectRatioLocked(true)` of `false` in, afhankelijk van je behoeften. +- **Is het mogelijk vormen te groeperen?** Absoluut – plaats ze in een `GroupShape` en voeg de groep als één knooppunt in. +- **Werken SmartArt‑diagrammen met Aspose.Words?** Ja, je kunt SmartArt‑vormen programmatically detecteren en bijwerken. -In deze uitgebreide handleiding duiken we in de wereld van documentvormen in Aspose.Words voor Java. Vormen zijn essentiële elementen bij het maken van visueel aantrekkelijke en interactieve documenten. Of u nu tekstballonnen, knoppen, afbeeldingen of watermerken wilt toevoegen, Aspose.Words voor Java biedt de tools om dit efficiënt te doen. Laten we stap voor stap bekijken hoe u deze vormen kunt gebruiken met behulp van broncodevoorbeelden. +## Wat is **afbeeldingsvorm invoegen**? +Een *image shape* is een visueel element dat raster‑ of vector‑graphics bevat binnen een Word‑document. In Aspose.Words wordt een afbeelding weergegeven door een `Shape`‑object, waarmee je volledige controle hebt over grootte, positie, rotatie en omloop. -## Aan de slag met documentvormen +## Waarom vormen gebruiken in je documenten? +- **Visuele impact:** Vormen trekken de aandacht naar belangrijke informatie. +- **Interactiviteit:** Knoppen en callouts kunnen worden gekoppeld aan URL's of bladwijzers. +- **Lay-out flexibiliteit:** Plaats graphics nauwkeurig met absolute of relatieve coördinaten. +- **Automatisering:** Genereer complexe lay-outs zonder handmatige bewerking. -Voordat we aan de slag gaan met de code, gaan we onze omgeving opzetten. Zorg ervoor dat je Aspose.Words voor Java in je project hebt geïntegreerd. Als je dat nog niet hebt gedaan, kun je het downloaden van de Aspose-website. [Download Aspose.Words voor Java](https://releases.aspose.com/words/java/) +## Prerequisites +- Java Development Kit (JDK 8 of hoger) +- Aspose.Words for Java‑bibliotheek (download van de officiële site) +- Basiskennis van Java en object‑georiënteerd programmeren -## Vormen toevoegen aan documenten +Je kunt de bibliotheek hier downloaden: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Een GroupShape invoegen - -A `GroupShape` Hiermee kunt u meerdere vormen groeperen. Hier leest u hoe u een `GroupShape`: +## Hoe **vorm toevoegen** – Een GroupShape invoegen +Een `GroupShape` stelt je in staat meerdere vormen als één eenheid te behandelen. Dit is handig om meerdere elementen samen te verplaatsen of op te maken. ```java Document doc = new Document(); @@ -58,9 +74,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Een tekstvakvorm invoegen - -Om een tekstvakvorm in te voegen, kunt u de `insertShape` methode zoals getoond in het onderstaande voorbeeld: +## Maak **tekstvakvorm** +Een tekstvak is een container die opgemaakte tekst kan bevatten. Je kunt het ook roteren voor een dynamische uitstraling. ```java Document doc = new Document(); @@ -81,11 +96,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Vormeigenschappen manipuleren - -### Het beheren van de beeldverhouding - -Je kunt bepalen of de beeldverhouding van een vorm al dan niet vergrendeld is. Zo ontgrendel je de beeldverhouding van een vorm: +## Stel **beeldverhouding van vorm** in +Soms moet een vorm vrij worden uitgerekt, andere keren wil je de oorspronkelijke verhoudingen behouden. Het regelen van de beeldverhouding is eenvoudig. ```java Document doc = new Document(); @@ -97,9 +109,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Een vorm in een tabelcel plaatsen - -Als u een vorm in een tabelcel moet plaatsen, kunt u dit doen met de volgende code: +## Plaats **vorm in tabel** +Een vorm in een tabelcel insluiten kan handig zijn voor rapportlay-outs. Het voorbeeld hieronder maakt een tabel en voegt vervolgens een watermerk‑achtige vorm in die de hele pagina beslaat. ```java Document doc = new Document(); @@ -122,7 +133,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // Geef de vorm buiten de tabelcel weer als deze in een cel wordt geplaatst. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +154,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## Werken met SmartArt-vormen +## Voeg **callout‑vorm** toe +Een callout‑vorm is perfect om notities of waarschuwingen te markeren. Terwijl de bovenstaande code al een `ACCENT_BORDER_CALLOUT_1` laat zien, kun je de `ShapeType` vervangen door een andere callout‑variant die bij je ontwerp past. -### SmartArt-vormen detecteren +## Werken met SmartArt‑vormen -U kunt SmartArt-vormen in een document detecteren met behulp van de volgende code: +### SmartArt‑vormen detecteren +SmartArt‑diagrammen kunnen programmatically worden geïdentificeerd, zodat je ze kunt verwerken of vervangen indien nodig. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -156,9 +169,8 @@ int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count(); System.out.println("The document has " + count + " shapes with SmartArt."); ``` -### SmartArt-tekeningen bijwerken - -Gebruik de volgende code om SmartArt-tekeningen in een document bij te werken: +### SmartArt‑tekeningen bijwerken +Zodra ze zijn gedetecteerd, kun je de SmartArt‑graphics vernieuwen om eventuele gegevenswijzigingen weer te geven. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +180,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Conclusie - -In deze handleiding hebben we de wereld van documentvormen in Aspose.Words voor Java verkend. Je hebt geleerd hoe je verschillende vormen aan je documenten toevoegt, hun eigenschappen bewerkt en met SmartArt-vormen werkt. Met deze kennis kun je eenvoudig visueel aantrekkelijke en interactieve documenten maken. +## Veelvoorkomende problemen & tips +- **Vorm verschijnt niet:** Zorg ervoor dat de vorm wordt ingevoegd na het doelknooppunt met `builder.insertNode`. +- **Onverwachte rotatie:** Onthoud dat rotatie wordt toegepast rond het midden van de vorm; pas `setLeft`/`setTop` aan indien nodig. +- **Beeldverhouding vergrendeld:** Standaard vergrendelen veel vormen hun beeldverhouding; roep `setAspectRatioLocked(false)` aan om vrij te rekken. +- **SmartArt-detectie mislukt:** Controleer of je een Aspose.Words‑versie gebruikt die SmartArt ondersteunt (v24+). ## Veelgestelde vragen -### Wat is Aspose.Words voor Java? +**Q: Wat is Aspose.Words for Java?** +A: Aspose.Words for Java is een Java‑bibliotheek die ontwikkelaars in staat stelt Word‑documenten programmatically te maken, wijzigen en converteren. Het biedt een breed scala aan functies en tools voor het werken met documenten in verschillende formaten. -Aspose.Words voor Java is een Java-bibliotheek waarmee ontwikkelaars programmatisch Word-documenten kunnen maken, wijzigen en converteren. Het biedt een breed scala aan functies en tools voor het werken met documenten in verschillende formaten. +**Q: Hoe kan ik Aspose.Words for Java downloaden?** +A: Je kunt Aspose.Words for Java downloaden van de Aspose‑website via deze link: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Hoe kan ik Aspose.Words voor Java downloaden? +**Q: Wat zijn de voordelen van het gebruik van documentvormen?** +A: Documentvormen voegen visuele elementen en interactiviteit toe aan je documenten, waardoor ze aantrekkelijker en informatiever worden. Met vormen kun je callouts, knoppen, afbeeldingen, watermerken en meer maken, wat de algehele gebruikerservaring verbetert. -U kunt Aspose.Words voor Java downloaden van de Aspose-website door deze link te volgen: [Download Aspose.Words voor Java](https://releases.aspose.com/words/java/) +**Q: Kan ik het uiterlijk van vormen aanpassen?** +A: Ja, je kunt het uiterlijk van vormen aanpassen door hun eigenschappen zoals grootte, positie, rotatie en vulkleur te wijzigen. Aspose.Words for Java biedt uitgebreide opties voor vormaanpassing. -### Wat zijn de voordelen van het gebruik van documentvormen? +**Q: Is Aspose.Words for Java compatibel met SmartArt?** +A: Ja, Aspose.Words for Java ondersteunt SmartArt‑vormen, zodat je kunt werken met complexe diagrammen en graphics in je documenten. -Documentvormen voegen visuele elementen en interactiviteit toe aan uw documenten, waardoor ze aantrekkelijker en informatiever worden. Met vormen kunt u toelichtingen, knoppen, afbeeldingen, watermerken en meer maken, wat de algehele gebruikerservaring verbetert. - -### Kan ik het uiterlijk van vormen aanpassen? - -Ja, u kunt het uiterlijk van vormen aanpassen door hun eigenschappen aan te passen, zoals grootte, positie, rotatie en opvulkleur. Aspose.Words voor Java biedt uitgebreide opties voor het aanpassen van vormen. - -### Is Aspose.Words voor Java compatibel met SmartArt? - -Ja, Aspose.Words voor Java ondersteunt SmartArt-vormen, zodat u met complexe diagrammen en afbeeldingen in uw documenten kunt werken. +--- +**Laatst bijgewerkt:** 2025-12-14 +**Getest met:** Aspose.Words for Java 24.12 (latest) +**Auteur:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/english/java/document-conversion-and-export/using-document-shapes/_index.md b/words/english/java/document-conversion-and-export/using-document-shapes/_index.md index e57982022..b8cac8e01 100644 --- a/words/english/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/english/java/document-conversion-and-export/using-document-shapes/_index.md @@ -2,34 +2,47 @@ title: Using Document Shapes in Aspose.Words for Java linktitle: Using Document Shapes second_title: Aspose.Words Java Document Processing API -description: Unlock the Power of Document Shapes in Aspose.Words for Java. Learn to Create Visually Engaging Documents with Step-by-Step Examples. +description: Learn how to **insert image shape** with Aspose.Words for Java. This guide shows you how to add shapes, create text box shapes, place shapes in tables, set shape aspect ratio, and add callout shapes. weight: 14 url: /java/document-conversion-and-export/using-document-shapes/ +date: 2025-12-14 --- - {{< blocks/products/pf/main-wrap-class >}} {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Using Document Shapes in Aspose.Words for Java - +# How to **insert image shape** with Aspose.Words for Java -## Introduction to Using Document Shapes in Aspose.Words for Java +In this comprehensive tutorial you’ll discover how to **insert image shape** objects into Word documents using Aspose.Words for Java. Whether you’re building reports, marketing collateral, or interactive forms, shapes let you add callouts, buttons, text boxes, watermarks, and even SmartArt. We’ll walk through each step, explain why you’d use a particular shape, and provide ready‑to‑run code snippets. -In this comprehensive guide, we'll delve into the world of document shapes in Aspose.Words for Java. Shapes are essential elements when it comes to creating visually appealing and interactive documents. Whether you need to add callouts, buttons, images, or watermarks, Aspose.Words for Java provides the tools to do it efficiently. Let's explore how to use these shapes step by step with source code examples. +## Quick Answers +- **What is the primary way to add a shape?** Use `DocumentBuilder.insertShape` or create a `Shape` instance and add it to the document tree. +- **Can I insert an image as a shape?** Yes – call `builder.insertImage` and then treat the returned `Shape` like any other. +- **How do I keep a shape’s aspect ratio?** Set `shape.setAspectRatioLocked(true)` or `false` depending on your needs. +- **Is it possible to group shapes?** Absolutely – wrap them in a `GroupShape` and insert the group as a single node. +- **Do SmartArt diagrams work with Aspose.Words?** Yes, you can detect and update SmartArt shapes programmatically. -## Getting Started with Document Shapes +## What is **insert image shape**? +An *image shape* is a visual element that holds raster or vector graphics inside a Word document. In Aspose.Words, an image is represented by a `Shape` object, giving you full control over size, position, rotation, and wrapping. -Before we jump into the code, let's set up our environment. Make sure you have Aspose.Words for Java integrated into your project. If you haven't already, you can download it from the Aspose website [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) +## Why use shapes in your documents? +- **Visual impact:** Shapes draw attention to key information. +- **Interactivity:** Buttons and callouts can be linked to URLs or bookmarks. +- **Layout flexibility:** Position graphics precisely with absolute or relative coordinates. +- **Automation:** Generate complex layouts without manual editing. -## Adding Shapes to Documents +## Prerequisites +- Java Development Kit (JDK 8 or higher) +- Aspose.Words for Java library (download from the official site) +- Basic knowledge of Java and object‑oriented programming -### Inserting a GroupShape +You can download the library here: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -A `GroupShape` allows you to group multiple shapes together. Here's how you can create and insert a `GroupShape`: +## How to **add shape** – Inserting a GroupShape +A `GroupShape` lets you treat several shapes as a single unit. This is useful for moving or formatting multiple elements together. ```java Document doc = new Document(); @@ -59,9 +72,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Inserting a Text Box Shape - -To insert a text box shape, you can use the `insertShape` method as shown in the example below: +## Create **text box shape** +A text box is a container that can hold formatted text. You can also rotate it for a dynamic look. ```java Document doc = new Document(); @@ -82,11 +94,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Manipulating Shape Properties - -### Managing Aspect Ratio - -You can control whether the aspect ratio of a shape is locked or not. Here's how to unlock the aspect ratio of a shape: +## Set **shape aspect ratio** +Sometimes you need a shape to stretch freely, other times you want to keep its original proportions. Controlling the aspect ratio is straightforward. ```java Document doc = new Document(); @@ -98,9 +107,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Placing a Shape in a Table Cell - -If you need to place a shape inside a table cell, you can achieve this with the following code: +## Place **shape in table** +Embedding a shape inside a table cell can be handy for report layouts. The example below creates a table and then inserts a watermark‑style shape that spans the whole page. ```java Document doc = new Document(); @@ -144,11 +152,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## Working with SmartArt Shapes +## Add **callout shape** +A callout shape is perfect for highlighting notes or warnings. While the code above already demonstrates an `ACCENT_BORDER_CALLOUT_1`, you can swap the `ShapeType` to any callout variant to suit your design. -### Detecting SmartArt Shapes +## Working with SmartArt Shapes -You can detect SmartArt shapes in a document using the following code: +### Detect SmartArt Shapes +SmartArt diagrams can be identified programmatically, allowing you to process or replace them as needed. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -157,9 +167,8 @@ int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count(); System.out.println("The document has " + count + " shapes with SmartArt."); ``` -### Updating SmartArt Drawings - -To update SmartArt drawings within a document, use the following code: +### Update SmartArt Drawings +Once detected, you can refresh the SmartArt graphics to reflect any data changes. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -169,39 +178,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Conclusion +## Common Issues & Tips +- **Shape not appearing:** Ensure the shape is inserted after the target node using `builder.insertNode`. +- **Unexpected rotation:** Remember that rotation is applied around the shape’s center; adjust `setLeft`/`setTop` if needed. +- **Aspect ratio locked:** By default, many shapes lock their aspect ratio; call `setAspectRatioLocked(false)` to stretch freely. +- **SmartArt detection fails:** Verify you are using Aspose.Words version that supports SmartArt (v24+). -In this guide, we've explored the world of document shapes in Aspose.Words for Java. You've learned how to add various shapes to your documents, manipulate their properties, and work with SmartArt shapes. With this knowledge, you can create visually appealing and interactive documents with ease. +## Frequently Asked Questions -## FAQ's +**Q: What is Aspose.Words for Java?** +A: Aspose.Words for Java is a Java library that allows developers to create, modify, and convert Word documents programmatically. It provides a wide range of features and tools for working with documents in various formats. -### What is Aspose.Words for Java? +**Q: How can I download Aspose.Words for Java?** +A: You can download Aspose.Words for Java from the Aspose website by following this link: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -Aspose.Words for Java is a Java library that allows developers to create, modify, and convert Word documents programmatically. It provides a wide range of features and tools for working with documents in various formats. +**Q: What are the benefits of using document shapes?** +A: Document shapes add visual elements and interactivity to your documents, making them more engaging and informative. With shapes, you can create callouts, buttons, images, watermarks, and more, enhancing the overall user experience. -### How can I download Aspose.Words for Java? +**Q: Can I customize the appearance of shapes?** +A: Yes, you can customize the appearance of shapes by adjusting their properties such as size, position, rotation, and fill color. Aspose.Words for Java provides extensive options for shape customization. -You can download Aspose.Words for Java from the Aspose website by following this link: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) +**Q: Is Aspose.Words for Java compatible with SmartArt?** +A: Yes, Aspose.Words for Java supports SmartArt shapes, allowing you to work with complex diagrams and graphics in your documents. -### What are the benefits of using document shapes? - -Document shapes add visual elements and interactivity to your documents, making them more engaging and informative. With shapes, you can create callouts, buttons, images, watermarks, and more, enhancing the overall user experience. - -### Can I customize the appearance of shapes? - -Yes, you can customize the appearance of shapes by adjusting their properties such as size, position, rotation, and fill color. Aspose.Words for Java provides extensive options for shape customization. - -### Is Aspose.Words for Java compatible with SmartArt? - -Yes, Aspose.Words for Java supports SmartArt shapes, allowing you to work with complex diagrams and graphics in your documents. +--- +**Last Updated:** 2025-12-14 +**Tested With:** Aspose.Words for Java 24.12 (latest) +**Author:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - -{{< blocks/products/products-backtop-button >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/french/java/document-conversion-and-export/using-document-shapes/_index.md b/words/french/java/document-conversion-and-export/using-document-shapes/_index.md index 2fb50dc94..33eaa9469 100644 --- a/words/french/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/french/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,14 @@ --- -"description": "Exploitez la puissance des formes de documents dans Aspose.Words pour Java. Apprenez à créer des documents visuellement attrayants grâce à des exemples détaillés." -"linktitle": "Utilisation des formes de document" -"second_title": "API de traitement de documents Java Aspose.Words" -"title": "Utilisation des formes de document dans Aspose.Words pour Java" -"url": "/fr/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Apprenez comment **insérer une forme d'image** avec Aspose.Words pour + Java. Ce guide vous montre comment ajouter des formes, créer des formes de zone + de texte, placer des formes dans des tableaux, définir le rapport d’aspect des formes + et ajouter des formes d’appel. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Utilisation des formes de document dans Aspose.Words pour Java +url: /fr/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +17,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Utilisation des formes de document dans Aspose.Words pour Java +# Comment **insérer une forme d'image** avec Aspose.Words for Java +Dans ce tutoriel complet, vous découvrirez comment **insérer des formes d'image** dans des documents Word à l'aide d'Aspose.Words for Java. Que vous créiez des rapports, du matériel marketing ou des formulaires interactifs, les formes vous permettent d'ajouter des bulles d'appel, des boutons, des zones de texte, des filigranes et même du SmartArt. Nous parcourrons chaque étape, expliquerons pourquoi utiliser une forme particulière et fournirons des extraits de code prêts à l'exécution. -## Introduction à l'utilisation des formes de document dans Aspose.Words pour Java +## Réponses rapides +- **Quelle est la façon principale d'ajouter une forme ?** Utilisez `DocumentBuilder.insertShape` ou créez une instance `Shape` et ajoutez‑la à l'arbre du document. +- **Puis‑je insérer une image sous forme de forme ?** Oui – appelez `builder.insertImage` puis traitez le `Shape` retourné comme n'importe quel autre. +- **Comment conserver le ratio d'aspect d'une forme ?** Définissez `shape.setAspectRatioLocked(true)` ou `false` selon vos besoins. +- **Est‑il possible de regrouper des formes ?** Absolument – encapsulez‑les dans un `GroupShape` et insérez le groupe comme un seul nœud. +- **Les diagrammes SmartArt fonctionnent‑ils avec Aspose.Words ?** Oui, vous pouvez détecter et mettre à jour les SmartArt programmatiquement. -Dans ce guide complet, nous explorerons l'univers des formes de documents dans Aspose.Words pour Java. Les formes sont essentielles à la création de documents attrayants et interactifs. Que vous ayez besoin d'ajouter des légendes, des boutons, des images ou des filigranes, Aspose.Words pour Java fournit les outils nécessaires. Voyons comment utiliser ces formes étape par étape avec des exemples de code source. +## Qu'est‑ce que **insérer une forme d'image** ? +Une *forme d'image* est un élément visuel qui contient des graphiques raster ou vectoriels à l'intérieur d'un document Word. Dans Aspose.Words, une image est représentée par un objet `Shape`, vous offrant un contrôle complet sur la taille, la position, la rotation et l'habillage. -## Premiers pas avec les formes de documents +## Pourquoi utiliser des formes dans vos documents ? +- **Impact visuel :** Les formes attirent l'attention sur les informations clés. +- **Interactivité :** Les boutons et les bulles d'appel peuvent être liés à des URL ou des signets. +- **Flexibilité de mise en page :** Positionnez les graphiques avec précision grâce à des coordonnées absolues ou relatives. +- **Automatisation :** Générez des mises en page complexes sans édition manuelle. -Avant de passer au code, configurons notre environnement. Assurez-vous d'avoir intégré Aspose.Words pour Java à votre projet. Si ce n'est pas déjà fait, vous pouvez le télécharger depuis le site web d'Aspose. [Télécharger Aspose.Words pour Java](https://releases.aspose.com/words/java/) +## Prérequis +- Java Development Kit (JDK 8 ou supérieur) +- Bibliothèque Aspose.Words for Java (téléchargement depuis le site officiel) +- Connaissances de base en Java et en programmation orientée objet -## Ajout de formes aux documents +Vous pouvez télécharger la bibliothèque ici : [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Insertion d'une GroupShape - -UN `GroupShape` permet de regrouper plusieurs formes. Voici comment créer et insérer un `GroupShape`: +## Comment **ajouter une forme** – Insertion d'un GroupShape +Un `GroupShape` vous permet de traiter plusieurs formes comme une seule unité. Cela est utile pour déplacer ou mettre en forme plusieurs éléments ensemble. ```java Document doc = new Document(); @@ -58,9 +75,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Insertion d'une forme de zone de texte - -Pour insérer une forme de zone de texte, vous pouvez utiliser le `insertShape` méthode comme indiqué dans l'exemple ci-dessous : +## Créer une **forme de zone de texte** +Une zone de texte est un conteneur pouvant contenir du texte formaté. Vous pouvez également la faire pivoter pour un rendu dynamique. ```java Document doc = new Document(); @@ -81,11 +97,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Manipulation des propriétés de forme - -### Gestion du rapport hauteur/largeur - -Vous pouvez contrôler si le rapport hauteur/largeur d'une forme est verrouillé ou non. Voici comment déverrouiller le rapport hauteur/largeur d'une forme : +## Définir le **ratio d'aspect de la forme** +Parfois, vous avez besoin qu'une forme s'étire librement, d'autres fois vous souhaitez conserver ses proportions d'origine. Le contrôle du ratio d'aspect est simple. ```java Document doc = new Document(); @@ -97,9 +110,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Placer une forme dans une cellule de tableau - -Si vous devez placer une forme à l'intérieur d'une cellule de tableau, vous pouvez y parvenir avec le code suivant : +## Placer une **forme dans un tableau** +Intégrer une forme dans une cellule de tableau peut être pratique pour les mises en page de rapports. L'exemple ci‑dessous crée un tableau puis insère une forme de type filigrane qui s'étend sur toute la page. ```java Document doc = new Document(); @@ -122,7 +134,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // Affichez la forme en dehors de la cellule du tableau si elle doit être placée dans une cellule. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +155,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## Travailler avec des formes SmartArt +## Ajouter une **forme d'appel** +Une forme d'appel est parfaite pour mettre en évidence des notes ou des avertissements. Bien que le code ci‑dessus montre déjà un `ACCENT_BORDER_CALLOUT_1`, vous pouvez remplacer le `ShapeType` par n'importe quelle variante d'appel pour correspondre à votre conception. -### Détection des formes SmartArt +## Travailler avec les formes SmartArt -Vous pouvez détecter des formes SmartArt dans un document à l’aide du code suivant : +### Détecter les formes SmartArt +Les diagrammes SmartArt peuvent être identifiés programmatiquement, vous permettant de les traiter ou de les remplacer selon les besoins. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -156,9 +170,8 @@ int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count(); System.out.println("The document has " + count + " shapes with SmartArt."); ``` -### Mise à jour des dessins SmartArt - -Pour mettre à jour les dessins SmartArt dans un document, utilisez le code suivant : +### Mettre à jour les dessins SmartArt +Une fois détectés, vous pouvez actualiser les graphiques SmartArt pour refléter les changements de données. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +181,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Conclusion - -Dans ce guide, nous avons exploré l'univers des formes de documents dans Aspose.Words pour Java. Vous avez appris à ajouter diverses formes à vos documents, à manipuler leurs propriétés et à utiliser des formes SmartArt. Grâce à ces connaissances, vous pouvez créer facilement des documents attrayants et interactifs. +## Problèmes courants & conseils +- **Forme non affichée :** Assurez‑vous que la forme est insérée après le nœud cible en utilisant `builder.insertNode`. +- **Rotation inattendue :** Souvenez‑vous que la rotation s'applique autour du centre de la forme ; ajustez `setLeft`/`setTop` si nécessaire. +- **Ratio d'aspect verrouillé :** Par défaut, de nombreuses formes verrouillent leur ratio d'aspect ; appelez `setAspectRatioLocked(false)` pour les étirer librement. +- **Échec de la détection SmartArt :** Vérifiez que vous utilisez une version d'Aspose.Words qui prend en charge SmartArt (v24+). -## FAQ +## Questions fréquemment posées -### Qu'est-ce qu'Aspose.Words pour Java ? +**Q : Qu’est‑ce qu’Aspose.Words for Java ?** +R : Aspose.Words for Java est une bibliothèque Java qui permet aux développeurs de créer, modifier et convertir des documents Word programmatiquement. Elle offre un large éventail de fonctionnalités et d’outils pour travailler avec des documents dans divers formats. -Aspose.Words pour Java est une bibliothèque Java permettant aux développeurs de créer, modifier et convertir des documents Word par programmation. Elle offre un large éventail de fonctionnalités et d'outils pour travailler avec des documents de différents formats. +**Q : Comment puis‑je télécharger Aspose.Words for Java ?** +R : Vous pouvez télécharger Aspose.Words for Java depuis le site Aspose en suivant ce lien : [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Comment puis-je télécharger Aspose.Words pour Java ? +**Q : Quels sont les avantages d’utiliser des formes de document ?** +R : Les formes de document ajoutent des éléments visuels et de l’interactivité à vos documents, les rendant plus attrayants et informatifs. Avec les formes, vous pouvez créer des bulles d’appel, des boutons, des images, des filigranes, etc., améliorant l’expérience utilisateur globale. -Vous pouvez télécharger Aspose.Words pour Java depuis le site Web d'Aspose en suivant ce lien : [Télécharger Aspose.Words pour Java](https://releases.aspose.com/words/java/) +**Q : Puis‑je personnaliser l’apparence des formes ?** +R : Oui, vous pouvez personnaliser l’apparence des formes en ajustant leurs propriétés telles que la taille, la position, la rotation et la couleur de remplissage. Aspose.Words for Java offre de nombreuses options de personnalisation des formes. -### Quels sont les avantages de l’utilisation de formes de documents ? +**Q : Aspose.Words for Java est‑il compatible avec SmartArt ?** +R : Oui, Aspose.Words for Java prend en charge les formes SmartArt, vous permettant de travailler avec des diagrammes et graphiques complexes dans vos documents. -Les formes ajoutent des éléments visuels et interactifs à vos documents, les rendant plus attrayants et informatifs. Elles vous permettent de créer des légendes, des boutons, des images, des filigranes et bien plus encore, améliorant ainsi l'expérience utilisateur. - -### Puis-je personnaliser l’apparence des formes ? - -Oui, vous pouvez personnaliser l'apparence des formes en ajustant leurs propriétés telles que la taille, la position, la rotation et la couleur de remplissage. Aspose.Words pour Java offre de nombreuses options de personnalisation. - -### Aspose.Words pour Java est-il compatible avec SmartArt ? - -Oui, Aspose.Words pour Java prend en charge les formes SmartArt, vous permettant de travailler avec des diagrammes et des graphiques complexes dans vos documents. +--- +**Dernière mise à jour :** 2025-12-14 +**Testé avec :** Aspose.Words for Java 24.12 (dernière version) +**Auteur :** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/german/java/document-conversion-and-export/using-document-shapes/_index.md b/words/german/java/document-conversion-and-export/using-document-shapes/_index.md index 59afc8069..cfd7d9ee8 100644 --- a/words/german/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/german/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,14 @@ --- -"description": "Nutzen Sie die Möglichkeiten von Dokumentformen in Aspose.Words für Java. Lernen Sie anhand von Schritt-für-Schritt-Beispielen, visuell ansprechende Dokumente zu erstellen." -"linktitle": "Verwenden von Dokumentformen" -"second_title": "Aspose.Words Java-Dokumentverarbeitungs-API" -"title": "Verwenden von Dokumentformen in Aspose.Words für Java" -"url": "/de/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Erfahren Sie, wie Sie **Bildform einfügen** mit Aspose.Words für Java. + Dieser Leitfaden zeigt Ihnen, wie Sie Formen hinzufügen, Textfeldformen erstellen, + Formen in Tabellen platzieren, das Seitenverhältnis von Formen festlegen und Hinweisformen + hinzufügen. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Verwendung von Dokumentformen in Aspose.Words für Java +url: /de/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +17,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Verwenden von Dokumentformen in Aspose.Words für Java +# Wie man **Bildform einfügt** mit Aspose.Words für Java +In diesem umfassenden Tutorial erfahren Sie, wie Sie **Bildform**‑Objekte in Word‑Dokumente mit Aspose.Words für Java einfügen. Egal, ob Sie Berichte, Marketing‑Materialien oder interaktive Formulare erstellen – Formen ermöglichen Ihnen, Callouts, Schaltflächen, Textfelder, Wasserzeichen und sogar SmartArt hinzuzufügen. Wir gehen Schritt für Schritt durch, erklären, warum Sie eine bestimmte Form verwenden würden, und stellen sofort ausführbare Code‑Snippets bereit. -## Einführung in die Verwendung von Dokumentformen in Aspose.Words für Java +## Schnellantworten +- **Was ist der primäre Weg, eine Form hinzuzufügen?** Verwenden Sie `DocumentBuilder.insertShape` oder erstellen Sie eine `Shape`‑Instanz und fügen Sie sie dem Dokumentbaum hinzu. +- **Kann ich ein Bild als Form einfügen?** Ja – rufen Sie `builder.insertImage` auf und behandeln Sie das zurückgegebene `Shape` wie jedes andere. +- **Wie behalte ich das Seitenverhältnis einer Form?** Setzen Sie `shape.setAspectRatioLocked(true)` oder `false`, je nach Bedarf. +- **Ist es möglich, Formen zu gruppieren?** Absolut – packen Sie sie in ein `GroupShape` und fügen Sie die Gruppe als einzelnen Knoten ein. +- **Funktionieren SmartArt‑Diagramme mit Aspose.Words?** Ja, Sie können SmartArt‑Formen programmgesteuert erkennen und aktualisieren. -In dieser umfassenden Anleitung tauchen wir in die Welt der Dokumentformen in Aspose.Words für Java ein. Formen sind essenziell für die Erstellung optisch ansprechender und interaktiver Dokumente. Ob Callouts, Schaltflächen, Bilder oder Wasserzeichen – Aspose.Words für Java bietet die passenden Tools dafür. Wir zeigen Ihnen Schritt für Schritt anhand von Quellcodebeispielen, wie Sie diese Formen verwenden. +## Was ist **insert image shape**? +Eine *Bildform* ist ein visuelles Element, das Raster‑ oder Vektorgrafiken innerhalb eines Word‑Dokuments enthält. In Aspose.Words wird ein Bild durch ein `Shape`‑Objekt repräsentiert, das Ihnen volle Kontrolle über Größe, Position, Drehung und Textumbruch gibt. -## Erste Schritte mit Dokumentformen +## Warum Formen in Ihren Dokumenten verwenden? +- **Visuelle Wirkung:** Formen lenken die Aufmerksamkeit auf wichtige Informationen. +- **Interaktivität:** Schaltflächen und Callouts können mit URLs oder Lesezeichen verknüpft werden. +- **Layout‑Flexibilität:** Positionieren Sie Grafiken präzise mit absoluten oder relativen Koordinaten. +- **Automatisierung:** Erzeugen Sie komplexe Layouts ohne manuelle Nachbearbeitung. -Bevor wir mit dem Code beginnen, richten wir unsere Umgebung ein. Stellen Sie sicher, dass Aspose.Words für Java in Ihr Projekt integriert ist. Falls noch nicht geschehen, können Sie es von der Aspose-Website herunterladen. [Laden Sie Aspose.Words für Java herunter](https://releases.aspose.com/words/java/) +## Voraussetzungen +- Java Development Kit (JDK 8 oder höher) +- Aspose.Words für Java Bibliothek (Download von der offiziellen Seite) +- Grundkenntnisse in Java und objektorientierter Programmierung -## Hinzufügen von Formen zu Dokumenten +Sie können die Bibliothek hier herunterladen: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Einfügen einer Gruppenform - -A `GroupShape` ermöglicht Ihnen die Gruppierung mehrerer Formen. So erstellen und fügen Sie eine `GroupShape`: +## Wie man **Form hinzufügt** – Einfügen eines GroupShape +Ein `GroupShape` ermöglicht es, mehrere Formen als eine Einheit zu behandeln. Das ist nützlich, um mehrere Elemente gemeinsam zu verschieben oder zu formatieren. ```java Document doc = new Document(); @@ -58,9 +75,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Einfügen einer Textfeldform - -Um eine Textfeldform einzufügen, können Sie das `insertShape` Methode wie im folgenden Beispiel gezeigt: +## Erstellen einer **Textfeld‑Form** +Ein Textfeld ist ein Container, der formatierbaren Text aufnehmen kann. Sie können es zudem drehen, um einen dynamischen Look zu erzielen. ```java Document doc = new Document(); @@ -81,11 +97,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Bearbeiten von Formeigenschaften - -### Seitenverhältnis verwalten - -Sie können steuern, ob das Seitenverhältnis einer Form gesperrt ist oder nicht. So entsperren Sie das Seitenverhältnis einer Form: +## **Seitenverhältnis der Form** festlegen +Manchmal soll sich eine Form frei strecken, ein anderes Mal möchten Sie die ursprünglichen Proportionen beibehalten. Das Seitenverhältnis zu steuern ist unkompliziert. ```java Document doc = new Document(); @@ -97,9 +110,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Platzieren einer Form in einer Tabellenzelle - -Wenn Sie eine Form in einer Tabellenzelle platzieren müssen, können Sie dies mit dem folgenden Code erreichen: +## **Form in Tabelle** platzieren +Das Einbetten einer Form in eine Tabellenzelle kann für Berichtslayouts praktisch sein. Das nachfolgende Beispiel erstellt eine Tabelle und fügt anschließend eine wasserzeichenähnliche Form ein, die die gesamte Seite einnimmt. ```java Document doc = new Document(); @@ -122,7 +134,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // Zeigen Sie die Form außerhalb der Tabellenzelle an, wenn sie in einer Zelle platziert wird. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +155,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## Arbeiten mit SmartArt-Formen +## **Callout‑Form** hinzufügen +Eine Callout‑Form eignet sich perfekt, um Notizen oder Warnungen hervorzuheben. Während der obige Code bereits ein `ACCENT_BORDER_CALLOUT_1` demonstriert, können Sie den `ShapeType` zu jeder anderen Callout‑Variante ändern, um Ihr Design anzupassen. -### Erkennen von SmartArt-Formen +## Arbeiten mit SmartArt‑Formen -Sie können SmartArt-Formen in einem Dokument mithilfe des folgenden Codes erkennen: +### SmartArt‑Formen erkennen +SmartArt‑Diagramme können programmgesteuert identifiziert werden, sodass Sie sie bei Bedarf verarbeiten oder ersetzen können. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -156,9 +170,8 @@ int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count(); System.out.println("The document has " + count + " shapes with SmartArt."); ``` -### Aktualisieren von SmartArt-Zeichnungen - -Um SmartArt-Zeichnungen in einem Dokument zu aktualisieren, verwenden Sie den folgenden Code: +### SmartArt‑Grafiken aktualisieren +Sobald sie erkannt wurden, können Sie die SmartArt‑Grafiken aktualisieren, um Änderungen in den zugrunde liegenden Daten widerzuspiegeln. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +181,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Abschluss - -In diesem Leitfaden haben wir die Welt der Dokumentformen in Aspose.Words für Java erkundet. Sie haben gelernt, wie Sie Ihren Dokumenten verschiedene Formen hinzufügen, deren Eigenschaften bearbeiten und mit SmartArt-Formen arbeiten. Mit diesem Wissen können Sie mühelos optisch ansprechende und interaktive Dokumente erstellen. +## Häufige Probleme & Tipps +- **Form wird nicht angezeigt:** Stellen Sie sicher, dass die Form nach dem Zielknoten mit `builder.insertNode` eingefügt wird. +- **Unerwartete Drehung:** Denken Sie daran, dass die Drehung um das Zentrum der Form erfolgt; passen Sie ggf. `setLeft`/`setTop` an. +- **Seitenverhältnis gesperrt:** Viele Formen sperren standardmäßig ihr Seitenverhältnis; rufen Sie `setAspectRatioLocked(false)` auf, um frei zu strecken. +- **SmartArt‑Erkennung schlägt fehl:** Vergewissern Sie sich, dass Sie eine Aspose.Words‑Version verwenden, die SmartArt unterstützt (v24+). ## Häufig gestellte Fragen -### Was ist Aspose.Words für Java? +**F: Was ist Aspose.Words für Java?** +A: Aspose.Words für Java ist eine Java‑Bibliothek, die Entwicklern ermöglicht, Word‑Dokumente programmgesteuert zu erstellen, zu ändern und zu konvertieren. Sie bietet eine breite Palette an Funktionen und Werkzeugen für die Arbeit mit Dokumenten in verschiedenen Formaten. -Aspose.Words für Java ist eine Java-Bibliothek, mit der Entwickler Word-Dokumente programmgesteuert erstellen, bearbeiten und konvertieren können. Sie bietet zahlreiche Funktionen und Tools für die Arbeit mit Dokumenten in verschiedenen Formaten. +**F: Wie kann ich Aspose.Words für Java herunterladen?** +A: Sie können Aspose.Words für Java von der Aspose‑Website über diesen Link herunterladen: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Wie kann ich Aspose.Words für Java herunterladen? +**F: Welche Vorteile bieten Dokumentformen?** +A: Dokumentformen fügen Ihren Dokumenten visuelle Elemente und Interaktivität hinzu, wodurch sie ansprechender und informativer werden. Mit Formen können Sie Callouts, Schaltflächen, Bilder, Wasserzeichen und mehr erstellen und so das Gesamterlebnis verbessern. -Sie können Aspose.Words für Java von der Aspose-Website herunterladen, indem Sie diesem Link folgen: [Laden Sie Aspose.Words für Java herunter](https://releases.aspose.com/words/java/) +**F: Kann ich das Aussehen von Formen anpassen?** +A: Ja, Sie können das Aussehen von Formen anpassen, indem Sie Eigenschaften wie Größe, Position, Drehung und Füllfarbe ändern. Aspose.Words für Java bietet umfangreiche Optionen zur Form‑Anpassung. -### Welche Vorteile bietet die Verwendung von Dokumentformen? +**F: Ist Aspose.Words für Java mit SmartArt kompatibel?** +A: Ja, Aspose.Words für Java unterstützt SmartArt‑Formen, sodass Sie komplexe Diagramme und Grafiken in Ihren Dokumenten verwenden können. -Dokumentformen verleihen Ihren Dokumenten visuelle Elemente und Interaktivität und machen sie dadurch ansprechender und informativer. Mit Formen können Sie Beschriftungen, Schaltflächen, Bilder, Wasserzeichen und mehr erstellen und so das Benutzererlebnis verbessern. - -### Kann ich das Erscheinungsbild von Formen anpassen? - -Ja, Sie können das Erscheinungsbild von Formen anpassen, indem Sie deren Eigenschaften wie Größe, Position, Drehung und Füllfarbe anpassen. Aspose.Words für Java bietet umfangreiche Optionen zur Formanpassung. - -### Ist Aspose.Words für Java mit SmartArt kompatibel? - -Ja, Aspose.Words für Java unterstützt SmartArt-Formen, sodass Sie mit komplexen Diagrammen und Grafiken in Ihren Dokumenten arbeiten können. +--- +**Zuletzt aktualisiert:** 2025-12-14 +**Getestet mit:** Aspose.Words für Java 24.12 (latest) +**Autor:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/greek/java/document-conversion-and-export/using-document-shapes/_index.md b/words/greek/java/document-conversion-and-export/using-document-shapes/_index.md index 4d2e07d46..1dd252904 100644 --- a/words/greek/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/greek/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,14 @@ --- -"description": "Ξεκλειδώστε τη Δύναμη των Σχήματων Εγγράφων στο Aspose.Words για Java. Μάθετε να Δημιουργείτε Οπτικά Ενδιαφέροντα Έγγραφα με Παραδείγματα Βήμα προς Βήμα." -"linktitle": "Χρήση σχημάτων εγγράφων" -"second_title": "API επεξεργασίας εγγράφων Java Aspose.Words" -"title": "Χρήση σχημάτων εγγράφων στο Aspose.Words για Java" -"url": "/el/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Μάθετε πώς να **εισάγετε σχήμα εικόνας** με το Aspose.Words for Java. + Αυτός ο οδηγός σας δείχνει πώς να προσθέτετε σχήματα, να δημιουργείτε σχήματα πλαισίου + κειμένου, να τοποθετείτε σχήματα σε πίνακες, να ορίζετε την αναλογία διαστάσεων + του σχήματος και να προσθέτετε σχήματα επεξήγησης. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Χρήση Σχημάτων Εγγράφου στο Aspose.Words για Java +url: /el/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +17,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Χρήση σχημάτων εγγράφων στο Aspose.Words για Java +# Πώς να **εισάγετε σχήμα εικόνας** με Aspose.Words for Java +Σε αυτό το ολοκληρωμένο tutorial θα ανακαλύψετε πώς να **εισάγετε σχήμα εικόνας** αντικείμενα σε έγγραφα Word χρησιμοποιώντας το Aspose.Words for Java. Είτε δημιουργείτε αναφορές, υλικό μάρκετινγκ ή διαδραστικές φόρμες, τα σχήματα σας επιτρέπουν να προσθέτετε σημειώσεις, κουμπιά, πλαίσια κειμένου, υδατογραφήματα και ακόμη SmartArt. Θα περάσουμε βήμα προς βήμα, θα εξηγήσουμε γιατί θα χρησιμοποιούσατε ένα συγκεκριμένο σχήμα και θα παρέχουμε έτοιμα παραδείγματα κώδικα. -## Εισαγωγή στη χρήση σχημάτων εγγράφων στο Aspose.Words για Java +## Γρήγορες Απαντήσεις +- **Ποιος είναι ο κύριος τρόπος για να προσθέσετε ένα σχήμα;** Χρησιμοποιήστε `DocumentBuilder.insertShape` ή δημιουργήστε ένα αντικείμενο `Shape` και προσθέστε το στο δέντρο του εγγράφου. +- **Μπορώ να εισάγω μια εικόνα ως σχήμα;** Ναι – καλέστε `builder.insertImage` και στη συνέχεια αντιμετωπίστε το επιστρεφόμενο `Shape` όπως οποιοδήποτε άλλο. +- **Πώς διατηρώ την αναλογία διαστάσεων ενός σχήματος;** Ορίστε `shape.setAspectRatioLocked(true)` ή `false` ανάλογα με τις ανάγκες σας. +- **Μπορεί να ομαδοποιηθούν σχήματα;** Απόλυτα – τυλίξτε τα σε ένα `GroupShape` και εισάγετε την ομάδα ως έναν ενιαίο κόμβο. +- **Λειτουργούν τα διαγράμματα SmartArt με το Aspose.Words;** Ναι, μπορείτε να εντοπίσετε και να ενημερώσετε τα σχήματα SmartArt προγραμματιστικά. -Σε αυτόν τον ολοκληρωμένο οδηγό, θα εμβαθύνουμε στον κόσμο των σχημάτων εγγράφων στο Aspose.Words για Java. Τα σχήματα είναι απαραίτητα στοιχεία όταν πρόκειται για τη δημιουργία οπτικά ελκυστικών και διαδραστικών εγγράφων. Είτε χρειάζεται να προσθέσετε επεξηγήσεις, κουμπιά, εικόνες ή υδατογραφήματα, το Aspose.Words για Java παρέχει τα εργαλεία για να το κάνετε αποτελεσματικά. Ας εξερευνήσουμε πώς να χρησιμοποιήσετε αυτά τα σχήματα βήμα προς βήμα με παραδείγματα πηγαίου κώδικα. +## Τι είναι το **εισάγετε σχήμα εικόνας**; +Ένα *σχήμα εικόνας* είναι ένα οπτικό στοιχείο που περιέχει ραστερ ή διανυσματικά γραφικά μέσα σε ένα έγγραφο Word. Στο Aspose.Words, μια εικόνα αντιπροσωπεύεται από ένα αντικείμενο `Shape`, παρέχοντάς σας πλήρη έλεγχο στο μέγεθος, τη θέση, την περιστροφή και την περιτύλιξη. -## Ξεκινώντας με τα Σχήματα Εγγράφων +## Γιατί να χρησιμοποιείτε σχήματα στα έγγραφά σας; +- **Οπτική επίδραση:** Τα σχήματα τραβούν την προσοχή σε βασικές πληροφορίες. +- **Διαδραστικότητα:** Τα κουμπιά και οι σημειώσεις μπορούν να συνδεθούν με URLs ή σελιδοδείκτες. +- **Ευελιξία διάταξης:** Τοποθετήστε γραφικά ακριβώς με απόλυτες ή σχετικές συντεταγμένες. +- **Αυτοματοποίηση:** Δημιουργήστε σύνθετες διατάξεις χωρίς χειροκίνητη επεξεργασία. -Πριν ξεκινήσουμε τον κώδικα, ας ρυθμίσουμε το περιβάλλον μας. Βεβαιωθείτε ότι έχετε ενσωματώσει το Aspose.Words για Java στο έργο σας. Αν δεν το έχετε κάνει ήδη, μπορείτε να το κατεβάσετε από τον ιστότοπο του Aspose. [Λήψη Aspose.Words για Java](https://releases.aspose.com/words/java/) +## Προαπαιτούμενα +- Java Development Kit (JDK 8 ή νεότερο) +- Βιβλιοθήκη Aspose.Words for Java (κατεβάστε από την επίσημη ιστοσελίδα) +- Βασικές γνώσεις Java και αντικειμενοστραφούς προγραμματισμού -## Προσθήκη σχημάτων σε έγγραφα +Μπορείτε να κατεβάσετε τη βιβλιοθήκη εδώ: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Εισαγωγή σχήματος ομάδας - -ΕΝΑ `GroupShape` σας επιτρέπει να ομαδοποιήσετε πολλά σχήματα. Δείτε πώς μπορείτε να δημιουργήσετε και να εισαγάγετε ένα `GroupShape`: +## Πώς να **προσθέσετε σχήμα** – Εισαγωγή GroupShape +Ένα `GroupShape` σας επιτρέπει να αντιμετωπίζετε πολλά σχήματα ως μία ενιαία μονάδα. Αυτό είναι χρήσιμο για τη μετακίνηση ή τη μορφοποίηση πολλαπλών στοιχείων μαζί. ```java Document doc = new Document(); @@ -58,9 +75,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Εισαγωγή σχήματος πλαισίου κειμένου - -Για να εισαγάγετε ένα σχήμα πλαισίου κειμένου, μπορείτε να χρησιμοποιήσετε το `insertShape` μέθοδος όπως φαίνεται στο παρακάτω παράδειγμα: +## Δημιουργία **σχήματος πλαισίου κειμένου** +Ένα πλαίσιο κειμένου είναι ένας δοχείο που μπορεί να περιέχει μορφοποιημένο κείμενο. Μπορείτε επίσης να το περιστρέψετε για μια δυναμική εμφάνιση. ```java Document doc = new Document(); @@ -81,11 +97,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Χειρισμός ιδιοτήτων σχήματος - -### Διαχείριση αναλογίας διαστάσεων - -Μπορείτε να ελέγξετε εάν η αναλογία διαστάσεων ενός σχήματος είναι κλειδωμένη ή όχι. Δείτε πώς μπορείτε να ξεκλειδώσετε την αναλογία διαστάσεων ενός σχήματος: +## Ορισμός **αναλογίας διαστάσεων σχήματος** +Μερικές φορές χρειάζεστε ένα σχήμα να τεντωθεί ελεύθερα, άλλες φορές θέλετε να διατηρήσετε τις αρχικές του αναλογίες. Ο έλεγχος της αναλογίας διαστάσεων είναι απλός. ```java Document doc = new Document(); @@ -97,9 +110,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Τοποθέτηση σχήματος σε κελί πίνακα - -Αν χρειάζεται να τοποθετήσετε ένα σχήμα μέσα σε ένα κελί πίνακα, μπορείτε να το πετύχετε αυτό με τον ακόλουθο κώδικα: +## Τοποθέτηση **σχήματος σε πίνακα** +Η ενσωμάτωση ενός σχήματος μέσα σε κελί πίνακα μπορεί να είναι χρήσιμη για διατάξεις αναφορών. Το παρακάτω παράδειγμα δημιουργεί έναν πίνακα και στη συνέχεια εισάγει ένα σχήμα τύπου υδατογραφήματος που καλύπτει ολόκληρη τη σελίδα. ```java Document doc = new Document(); @@ -122,7 +134,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // Εμφάνιση του σχήματος εκτός του κελιού του πίνακα, εάν πρόκειται να τοποθετηθεί σε ένα κελί. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +155,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` +## Προσθήκη **σχήματος σημείωσης** +Ένα σχήμα σημείωσης είναι ιδανικό για την επισήμανση σημειώσεων ή προειδοποιήσεων. Ενώ ο παραπάνω κώδικας δείχνει ήδη ένα `ACCENT_BORDER_CALLOUT_1`, μπορείτε να αλλάξετε το `ShapeType` σε οποιαδήποτε παραλλαγή σημείωσης για να ταιριάζει στο σχέδιό σας. + ## Εργασία με σχήματα SmartArt ### Ανίχνευση σχημάτων SmartArt - -Μπορείτε να εντοπίσετε σχήματα SmartArt σε ένα έγγραφο χρησιμοποιώντας τον ακόλουθο κώδικα: +Τα διαγράμματα SmartArt μπορούν να εντοπιστούν προγραμματιστικά, επιτρέποντάς σας να τα επεξεργαστείτε ή να τα αντικαταστήσετε όπως απαιτείται. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -157,8 +171,7 @@ System.out.println("The document has " + count + " shapes with SmartArt."); ``` ### Ενημέρωση σχεδίων SmartArt - -Για να ενημερώσετε τα σχέδια SmartArt μέσα σε ένα έγγραφο, χρησιμοποιήστε τον ακόλουθο κώδικα: +Μόλις εντοπιστούν, μπορείτε να ανανεώσετε τα γραφικά SmartArt για να αντικατοπτρίζουν τυχόν αλλαγές δεδομένων. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +181,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Σύναψη +## Συνηθισμένα Προβλήματα & Συμβουλές +- **Το σχήμα δεν εμφανίζεται:** Βεβαιωθείτε ότι το σχήμα εισάγεται μετά τον στόχο κόμβο χρησιμοποιώντας `builder.insertNode`. +- **Απροσδόκητη περιστροφή:** Θυμηθείτε ότι η περιστροφή εφαρμόζεται γύρω από το κέντρο του σχήματος· προσαρμόστε `setLeft`/`setTop` αν χρειάζεται. +- **Κλειδωμένη αναλογία διαστάσεων:** Από προεπιλογή, πολλά σχήματα κλειδώνουν την αναλογία τους· καλέστε `setAspectRatioLocked(false)` για ελεύθερη τέντωμα. +- **Αποτυχία ανίχνευσης SmartArt:** Επαληθεύστε ότι χρησιμοποιείτε έκδοση Aspose.Words που υποστηρίζει SmartArt (v24+). -Σε αυτόν τον οδηγό, εξερευνήσαμε τον κόσμο των σχημάτων εγγράφων στο Aspose.Words για Java. Μάθατε πώς να προσθέτετε διάφορα σχήματα στα έγγραφά σας, να χειρίζεστε τις ιδιότητές τους και να εργάζεστε με σχήματα SmartArt. Με αυτές τις γνώσεις, μπορείτε να δημιουργείτε οπτικά ελκυστικά και διαδραστικά έγγραφα με ευκολία. +## Συχνές Ερωτήσεις -## Συχνές ερωτήσεις +**Q: Τι είναι το Aspose.Words for Java;** +A: Το Aspose.Words for Java είναι μια βιβλιοθήκη Java που επιτρέπει στους προγραμματιστές να δημιουργούν, να τροποποιούν και να μετατρέπουν έγγραφα Word προγραμματιστικά. Παρέχει μια ευρεία γκάμα χαρακτηριστικών και εργαλείων για εργασία με έγγραφα σε διάφορες μορφές. -### Τι είναι το Aspose.Words για Java; +**Q: Πώς μπορώ να κατεβάσω το Aspose.Words for Java;** +A: Μπορείτε να κατεβάσετε το Aspose.Words for Java από την ιστοσελίδα Aspose ακολουθώντας αυτόν τον σύνδεσμο: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -Το Aspose.Words για Java είναι μια βιβλιοθήκη Java που επιτρέπει στους προγραμματιστές να δημιουργούν, να τροποποιούν και να μετατρέπουν έγγραφα του Word μέσω προγραμματισμού. Παρέχει ένα ευρύ φάσμα λειτουργιών και εργαλείων για την εργασία με έγγραφα σε διάφορες μορφές. +**Q: Ποια είναι τα οφέλη της χρήσης σχημάτων εγγράφου;** +A: Τα σχήματα εγγράφου προσθέτουν οπτικά στοιχεία και διαδραστικότητα στα έγγραφά σας, καθιστώντας τα πιο ελκυστικά και ενημερωτικά. Με τα σχήματα, μπορείτε να δημιουργήσετε σημειώσεις, κουμπιά, εικόνες, υδατογραφήματα και πολλά άλλα, βελτιώνοντας τη συνολική εμπειρία του χρήστη. -### Πώς μπορώ να κατεβάσω το Aspose.Words για Java; +**Q: Μπορώ να προσαρμόσω την εμφάνιση των σχημάτων;** +A: Ναι, μπορείτε να προσαρμόσετε την εμφάνιση των σχημάτων ρυθμίζοντας τις ιδιότητές τους όπως το μέγεθος, η θέση, η περιστροφή και το χρώμα γεμίσματος. Το Aspose.Words for Java παρέχει εκτενείς επιλογές για προσαρμογή σχημάτων. -Μπορείτε να κατεβάσετε το Aspose.Words για Java από την ιστοσελίδα της Aspose ακολουθώντας αυτόν τον σύνδεσμο: [Λήψη Aspose.Words για Java](https://releases.aspose.com/words/java/) +**Q: Είναι το Aspose.Words for Java συμβατό με SmartArt;** +A: Ναι, το Aspose.Words for Java υποστηρίζει σχήματα SmartArt, επιτρέποντάς σας να εργάζεστε με σύνθετα διαγράμματα και γραφικά στα έγγραφά σας. -### Ποια είναι τα οφέλη από τη χρήση σχημάτων εγγράφων; - -Τα σχήματα εγγράφων προσθέτουν οπτικά στοιχεία και διαδραστικότητα στα έγγραφά σας, καθιστώντας τα πιο ελκυστικά και ενημερωτικά. Με τα σχήματα, μπορείτε να δημιουργήσετε επεξηγήσεις, κουμπιά, εικόνες, υδατογραφήματα και πολλά άλλα, βελτιώνοντας τη συνολική εμπειρία χρήστη. - -### Μπορώ να προσαρμόσω την εμφάνιση των σχημάτων; - -Ναι, μπορείτε να προσαρμόσετε την εμφάνιση των σχημάτων προσαρμόζοντας τις ιδιότητές τους, όπως το μέγεθος, τη θέση, την περιστροφή και το χρώμα γεμίσματος. Το Aspose.Words για Java παρέχει εκτεταμένες επιλογές για την προσαρμογή σχημάτων. - -### Είναι το Aspose.Words για Java συμβατό με το SmartArt; - -Ναι, το Aspose.Words για Java υποστηρίζει σχήματα SmartArt, επιτρέποντάς σας να εργάζεστε με σύνθετα διαγράμματα και γραφικά στα έγγραφά σας. +--- +**Τελευταία ενημέρωση:** 2025-12-14 +**Δοκιμή με:** Aspose.Words for Java 24.12 (latest) +**Συγγραφέας:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hindi/java/document-conversion-and-export/using-document-shapes/_index.md b/words/hindi/java/document-conversion-and-export/using-document-shapes/_index.md index 349723674..8ee96ef3c 100644 --- a/words/hindi/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/hindi/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,13 @@ --- -"description": "Aspose.Words for Java में दस्तावेज़ आकृतियों की शक्ति अनलॉक करें। चरण-दर-चरण उदाहरणों के साथ दृश्य रूप से आकर्षक दस्तावेज़ बनाना सीखें।" -"linktitle": "दस्तावेज़ आकृतियों का उपयोग करना" -"second_title": "Aspose.Words जावा दस्तावेज़ प्रसंस्करण एपीआई" -"title": "जावा के लिए Aspose.Words में दस्तावेज़ आकृतियों का उपयोग करना" -"url": "/hi/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Aspose.Words for Java के साथ **इमेज शेप** कैसे डालें, सीखें। यह गाइड + आपको दिखाता है कि कैसे शैप्स जोड़ें, टेक्स्ट बॉक्स शैप्स बनाएं, टेबल में शैप्स रखें, + शैप का एस्पेक्ट रेशियो सेट करें, और कॉलआउट शैप्स जोड़ें। +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Aspose.Words for Java में दस्तावेज़ आकारों का उपयोग +url: /hi/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +16,33 @@ {{< blocks/products/pf/tutorial-page-section >}} -# जावा के लिए Aspose.Words में दस्तावेज़ आकृतियों का उपयोग करना +# Aspose.Words for Java के साथ **insert image shape** कैसे डालें +## त्वरित उत्तर +- **शेप जोड़ने का मुख्य तरीका क्या है?** `DocumentBuilder.insertShape` का उपयोग करें या एक `Shape` इंस्टेंस बनाकर उसे डॉक्यूमेंट ट्री में जोड़ें। +- **क्या मैं इमेज को शेप के रूप में डाल सकता हूँ?** हाँ – `builder.insertImage` कॉल करें और फिर प्राप्त `Shape` को किसी अन्य की तरह उपयोग करें। +- **मैं शेप का aspect ratio कैसे रखूँ?** अपनी आवश्यकता के अनुसार `shape.setAspectRatioLocked(true)` या `false` सेट करें। +- **क्या शेप्स को ग्रुप करना संभव है?** बिल्कुल – उन्हें `GroupShape` में रैप करें और ग्रुप को एक सिंगल नोड के रूप में डालें। +- **क्या SmartArt डायग्राम Aspose.Words के साथ काम करते हैं?** हाँ, आप प्रोग्रामेटिकली SmartArt शेप्स को डिटेक्ट और अपडेट कर सकते हैं। -## जावा के लिए Aspose.Words में दस्तावेज़ आकृतियों का उपयोग करने का परिचय +## **insert image shape** क्या है? +एक *image shape* एक दृश्य तत्व है जो Word डॉक्यूमेंट के भीतर रास्टर या वेक्टर ग्राफिक्स रखता है। Aspose.Words में, इमेज को एक `Shape` ऑब्जेक्ट द्वारा दर्शाया जाता है, जिससे आपको आकार, स्थिति, घुमाव, और रैपिंग पर पूर्ण नियंत्रण मिलता है। -इस विस्तृत गाइड में, हम Aspose.Words for Java में दस्तावेज़ आकृतियों की दुनिया में गहराई से उतरेंगे। जब दृश्य रूप से आकर्षक और इंटरैक्टिव दस्तावेज़ बनाने की बात आती है तो आकृतियाँ आवश्यक तत्व होती हैं। चाहे आपको कॉलआउट, बटन, छवियाँ या वॉटरमार्क जोड़ने की आवश्यकता हो, Aspose.Words for Java इसे कुशलतापूर्वक करने के लिए उपकरण प्रदान करता है। आइए स्रोत कोड उदाहरणों के साथ चरण दर चरण इन आकृतियों का उपयोग करने का तरीका जानें। +## आपके डॉक्यूमेंट्स में शेप्स का उपयोग क्यों करें? +- **दृश्य प्रभाव:** शेप्स मुख्य जानकारी की ओर ध्यान आकर्षित करते हैं। +- **इंटरैक्टिविटी:** बटन और कॉलआउट्स को URLs या बुकमार्क्स से लिंक किया जा सकता है। +- **लेआउट लचीलापन:** ग्राफिक्स को एब्सोल्यूट या रिलेटिव कोऑर्डिनेट्स के साथ सटीक रूप से पोजिशन करें। +- **ऑटोमेशन:** मैन्युअल एडिटिंग के बिना जटिल लेआउट्स जेनरेट करें। -## दस्तावेज़ आकृतियों के साथ आरंभ करना +## आवश्यकताएँ +- Java Development Kit (JDK 8 या उससे ऊपर) +- Aspose.Words for Java लाइब्रेरी (आधिकारिक साइट से डाउनलोड करें) +- Java और ऑब्जेक्ट‑ओरिएंटेड प्रोग्रामिंग का बेसिक ज्ञान -कोड में जाने से पहले, आइए अपना वातावरण सेट करें। सुनिश्चित करें कि आपके प्रोजेक्ट में Aspose.Words for Java एकीकृत है। यदि आपने पहले से ऐसा नहीं किया है, तो आप इसे Aspose वेबसाइट से डाउनलोड कर सकते हैं [Java के लिए Aspose.Words डाउनलोड करें](https://releases.aspose.com/words/java/) +आप लाइब्रेरी यहाँ डाउनलोड कर सकते हैं: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -## दस्तावेज़ों में आकृतियाँ जोड़ना - -### ग्रुपशेप सम्मिलित करना - -ए `GroupShape` आपको कई आकृतियों को एक साथ समूहीकृत करने की अनुमति देता है। यहाँ बताया गया है कि आप कैसे बना सकते हैं और सम्मिलित कर सकते हैं `GroupShape`: +## **add shape** कैसे करें – GroupShape डालना +`GroupShape` आपको कई शेप्स को एक सिंगल यूनिट के रूप में ट्रीट करने देता है। यह कई एलिमेंट्स को साथ में मूव या फॉर्मेट करने में उपयोगी है। ```java Document doc = new Document(); @@ -58,9 +72,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### टेक्स्ट बॉक्स आकार सम्मिलित करना - -टेक्स्ट बॉक्स आकार सम्मिलित करने के लिए, आप इसका उपयोग कर सकते हैं `insertShape` नीचे दिए गए उदाहरण में दिखाए अनुसार विधि: +## **text box shape** बनाएं +टेक्स्ट बॉक्स एक कंटेनर है जो फॉर्मेटेड टेक्स्ट रख सकता है। आप इसे डायनामिक लुक के लिए घुमा भी सकते हैं। ```java Document doc = new Document(); @@ -81,11 +94,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## आकृति गुणों में हेरफेर - -### पहलू अनुपात का प्रबंधन - -आप नियंत्रित कर सकते हैं कि किसी आकृति का पहलू अनुपात लॉक है या नहीं। आकृति के पहलू अनुपात को अनलॉक करने का तरीका यहां बताया गया है: +## **shape aspect ratio** सेट करें +कभी-कभी आपको शेप को फ्रीली स्ट्रेच करना पड़ता है, कभी आप उसकी मूल अनुपात को बनाए रखना चाहते हैं। aspect ratio को कंट्रोल करना सरल है। ```java Document doc = new Document(); @@ -97,9 +107,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### तालिका कक्ष में आकृति रखना - -यदि आपको किसी तालिका कक्ष के अंदर कोई आकृति रखने की आवश्यकता है, तो आप इसे निम्नलिखित कोड से प्राप्त कर सकते हैं: +## **shape in table** रखें +टेबल सेल के अंदर शेप एम्बेड करना रिपोर्ट लेआउट्स के लिए उपयोगी हो सकता है। नीचे दिया गया उदाहरण एक टेबल बनाता है और फिर एक वाटरमार्क‑स्टाइल शेप डालता है जो पूरे पेज को कवर करता है। ```java Document doc = new Document(); @@ -122,7 +131,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // यदि आकृति को किसी सेल में रखा जाएगा तो उसे तालिका सेल के बाहर प्रदर्शित करें। +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +152,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## स्मार्टआर्ट आकृतियों के साथ कार्य करना +## **callout shape** जोड़ें +एक callout शेप नोट्स या वार्निंग्स को हाइलाइट करने के लिए परफेक्ट है। ऊपर का कोड पहले से ही `ACCENT_BORDER_CALLOUT_1` दिखाता है, आप `ShapeType` को किसी भी callout वैरिएंट में बदल सकते हैं ताकि आपके डिजाइन के अनुसार हो। -### स्मार्टआर्ट आकृतियों का पता लगाना +## SmartArt शेप्स के साथ काम करना -आप निम्नलिखित कोड का उपयोग करके किसी दस्तावेज़ में स्मार्टआर्ट आकृतियों का पता लगा सकते हैं: +### SmartArt शेप्स का पता लगाना +SmartArt डायग्राम्स को प्रोग्रामेटिकली पहचान सकते हैं, जिससे आप उन्हें आवश्यकतानुसार प्रोसेस या रिप्लेस कर सकते हैं। ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -156,9 +167,8 @@ int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count(); System.out.println("The document has " + count + " shapes with SmartArt."); ``` -### स्मार्टआर्ट चित्र अपडेट करना - -किसी दस्तावेज़ में स्मार्टआर्ट चित्रों को अद्यतन करने के लिए, निम्नलिखित कोड का उपयोग करें: +### SmartArt ड्रॉइंग्स को अपडेट करना +एक बार पहचान लेने के बाद, आप डेटा में बदलाव को दर्शाने के लिए SmartArt ग्राफिक्स को रिफ्रेश कर सकते हैं। ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +178,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## निष्कर्ष - -इस गाइड में, हमने Aspose.Words for Java में दस्तावेज़ आकृतियों की दुनिया का पता लगाया है। आपने सीखा है कि अपने दस्तावेज़ों में विभिन्न आकृतियाँ कैसे जोड़ें, उनके गुणों में हेरफेर करें और SmartArt आकृतियों के साथ काम करें। इस ज्ञान के साथ, आप आसानी से आकर्षक और इंटरैक्टिव दस्तावेज़ बना सकते हैं। +## सामान्य समस्याएँ और टिप्स +- **शेप नहीं दिख रहा:** सुनिश्चित करें कि शेप टार्गेट नोड के बाद `builder.insertNode` का उपयोग करके डाला गया है। +- **अनपेक्षित घुमाव:** याद रखें कि घुमाव शेप के सेंटर के आसपास लागू होता है; आवश्यक होने पर `setLeft`/`setTop` को समायोजित करें। +- **Aspect ratio लॉक्ड:** डिफ़ॉल्ट रूप से, कई शेप्स अपना aspect ratio लॉक कर देते हैं; फ्रीली स्ट्रेच करने के लिए `setAspectRatioLocked(false)` कॉल करें। +- **SmartArt डिटेक्शन फेल:** सुनिश्चित करें कि आप Aspose.Words का वह वर्ज़न उपयोग कर रहे हैं जो SmartArt को सपोर्ट करता है (v24+). ## अक्सर पूछे जाने वाले प्रश्न -### Java के लिए Aspose.Words क्या है? +**प्रश्न: Aspose.Words for Java क्या है?** +**उत्तर:** Aspose.Words for Java एक जावा लाइब्रेरी है जो डेवलपर्स को प्रोग्रामेटिकली Word डॉक्यूमेंट्स को बनाना, मॉडिफाई करना और कनवर्ट करना संभव बनाती है। यह विभिन्न फॉर्मैट्स में डॉक्यूमेंट्स के साथ काम करने के लिए फीचर्स और टूल्स की विस्तृत रेंज प्रदान करती है। -Aspose.Words for Java एक जावा लाइब्रेरी है जो डेवलपर्स को प्रोग्रामेटिक रूप से Word दस्तावेज़ बनाने, संशोधित करने और परिवर्तित करने की अनुमति देती है। यह विभिन्न प्रारूपों में दस्तावेज़ों के साथ काम करने के लिए कई प्रकार की सुविधाएँ और उपकरण प्रदान करता है। +**प्रश्न: मैं Aspose.Words for Java कैसे डाउनलोड कर सकता हूँ?** +**उत्तर:** आप इस लिंक का पालन करके Aspose वेबसाइट से Aspose.Words for Java डाउनलोड कर सकते हैं: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### मैं Java के लिए Aspose.Words कैसे डाउनलोड कर सकता हूँ? +**प्रश्न: डॉक्यूमेंट शेप्स का उपयोग करने के क्या लाभ हैं?** +**उत्तर:** डॉक्यूमेंट शेप्स आपके डॉक्यूमेंट्स में विज़ुअल एलिमेंट्स और इंटरैक्टिविटी जोड़ते हैं, जिससे वे अधिक आकर्षक और जानकारीपूर्ण बनते हैं। शेप्स के साथ आप कॉलआउट्स, बटन, इमेजेज, वाटरमार्क्स आदि बना सकते हैं, जिससे कुल मिलाकर यूज़र एक्सपीरियंस बेहतर होता है। -आप इस लिंक का अनुसरण करके Aspose.Words for Java को Aspose वेबसाइट से डाउनलोड कर सकते हैं: [Java के लिए Aspose.Words डाउनलोड करें](https://releases.aspose.com/words/java/) +**प्रश्न: क्या मैं शेप्स की उपस्थिति को कस्टमाइज़ कर सकता हूँ?** +**उत्तर:** हाँ, आप शेप्स की प्रॉपर्टीज़ जैसे आकार, स्थिति, घुमाव, और फ़िल कलर को एडजस्ट करके उनकी उपस्थिति को कस्टमाइज़ कर सकते हैं। Aspose.Words for Java शेप कस्टमाइज़ेशन के लिए विस्तृत विकल्प प्रदान करता है। -### दस्तावेज़ आकृतियों का उपयोग करने के क्या लाभ हैं? +**प्रश्न: क्या Aspose.Words for Java SmartArt के साथ संगत है?** +**उत्तर:** हाँ, Aspose.Words for Java SmartArt शेप्स को सपोर्ट करता है, जिससे आप अपने डॉक्यूमेंट्स में कॉम्प्लेक्स डायग्राम्स और ग्राफिक्स के साथ काम कर सकते हैं। -दस्तावेज़ आकार आपके दस्तावेज़ों में दृश्य तत्व और अन्तरक्रियाशीलता जोड़ते हैं, जिससे वे अधिक आकर्षक और जानकारीपूर्ण बन जाते हैं। आकृतियों के साथ, आप कॉलआउट, बटन, छवियाँ, वॉटरमार्क और बहुत कुछ बना सकते हैं, जिससे समग्र उपयोगकर्ता अनुभव में वृद्धि होती है। - -### क्या मैं आकृतियों के स्वरूप को अनुकूलित कर सकता हूँ? - -हां, आप आकृतियों के आकार, स्थिति, घुमाव और भरण रंग जैसे गुणों को समायोजित करके उनकी उपस्थिति को अनुकूलित कर सकते हैं। Aspose.Words for Java आकृति अनुकूलन के लिए व्यापक विकल्प प्रदान करता है। - -### क्या Aspose.Words for Java स्मार्टआर्ट के साथ संगत है? - -हां, Java के लिए Aspose.Words स्मार्टआर्ट आकृतियों का समर्थन करता है, जिससे आप अपने दस्तावेज़ों में जटिल आरेखों और ग्राफिक्स के साथ काम कर सकते हैं। +--- +**अंतिम अपडेट:** 2025-12-14 +**परीक्षित संस्करण:** Aspose.Words for Java 24.12 (latest) +**लेखक:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hongkong/java/document-conversion-and-export/using-document-shapes/_index.md b/words/hongkong/java/document-conversion-and-export/using-document-shapes/_index.md index 51d00c8a1..73f51a19b 100644 --- a/words/hongkong/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/hongkong/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,11 @@ --- -"description": "釋放 Aspose.Words for Java 中文件形狀的強大功能。透過逐步範例學習如何建立具有視覺吸引力的文件。" -"linktitle": "使用文檔形狀" -"second_title": "Aspose.Words Java文件處理API" -"title": "在 Aspose.Words for Java 中使用文件形狀" -"url": "/zh-hant/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: 了解如何使用 Aspose.Words for Java **插入圖片形狀**。本指南將示範如何新增形狀、建立文字方塊形狀、在表格中放置形狀、設定形狀長寬比，以及加入標註形狀。 +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: 在 Aspose.Words for Java 中使用文件形狀 +url: /zh-hant/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +14,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# 在 Aspose.Words for Java 中使用文件形狀 +# 如何使用 Aspose.Words for Java **插入圖片形狀** +在本完整教學中，您將了解如何使用 Aspose.Words for Java **插入圖片形狀** 物件到 Word 文件。無論您是建立報告、行銷宣傳資料，或是互動表單，形狀都能讓您加入標註、按鈕、文字方塊、浮水印，甚至 SmartArt。我們將逐步說明每個步驟，解釋為何使用特定形狀，並提供可直接執行的程式碼片段。 -## Aspose.Words for Java 文件形狀使用簡介 +## 快速解答 +- **什麼是新增形狀的主要方式？** 使用 `DocumentBuilder.insertShape` 或建立 `Shape` 實例並將其加入文件樹。 +- **我可以將圖片作為形狀插入嗎？** 可以——呼叫 `builder.insertImage`，然後將回傳的 `Shape` 像其他形狀一樣處理。 +- **如何保持形狀的長寬比？** 根據需求設定 `shape.setAspectRatioLocked(true)` 或 `false`。 +- **可以將形狀群組化嗎？** 當然可以——將它們包裹在 `GroupShape` 中，並將群組作為單一節點插入。 +- **SmartArt 圖表能在 Aspose.Words 中使用嗎？** 可以，您可以以程式方式偵測並更新 SmartArt 形狀。 -在本綜合指南中，我們將深入研究 Aspose.Words for Java 中的文件形狀世界。當創建具有視覺吸引力和互動性的文件時，形狀是必不可少的元素。無論您需要新增標註、按鈕、圖像或浮水印，Aspose.Words for Java 都能提供高效率完成這些操作的工具。讓我們透過原始程式碼範例逐步探索如何使用這些形狀。 +## 什麼是 **插入圖片形狀**？ +「*圖片形狀*」是一種視覺元素，可在 Word 文件中容納點陣圖或向量圖形。在 Aspose.Words 中，圖片以 `Shape` 物件表示，讓您完整掌控大小、位置、旋轉與環繞方式。 -## 文件形狀入門 +## 為什麼在文件中使用形狀？ +- **視覺衝擊力：** 形狀能吸引注意力至關鍵資訊。 +- **互動性：** 按鈕與標註可連結至 URL 或書籤。 +- **版面彈性：** 以絕對或相對座標精確定位圖形。 +- **自動化：** 無需手動編輯即可產生複雜版面。 -在我們進入程式碼之前，讓我們先設定一下環境。確保您已將 Aspose.Words for Java 整合到您的專案中。如果你還沒有，你可以從 Aspose 網站下載 [下載 Aspose.Words for Java](https://releases.aspose.com/words/java/) +## 前置條件 +- Java Development Kit (JDK 8 或以上) +- Aspose.Words for Java 程式庫（從官方網站下載） +- 具備 Java 及物件導向程式設計的基本知識 -## 在文件中新增形狀 +您可以在此下載程式庫：[Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### 插入 GroupShape - -一個 `GroupShape` 允許您將多個形狀組合在一起。以下是如何建立和插入 `GroupShape`： +## 如何 **新增形狀** – 插入 GroupShape +`GroupShape` 允許您將多個形狀視為單一單元，方便一次移動或格式化多個元素。 ```java Document doc = new Document(); @@ -58,9 +72,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### 插入文字方塊形狀 - -若要插入文字方塊形狀，您可以使用 `insertShape` 方法如下例所示： +## 建立 **文字方塊形狀** +文字方塊是一個可容納格式化文字的容器，您亦可將其旋轉以呈現動態外觀。 ```java Document doc = new Document(); @@ -81,11 +94,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## 操作形狀屬性 - -### 管理寬高比 - -您可以控制形狀的縱橫比是否被鎖定。解鎖形狀縱橫比的方法如下： +## 設定 **形狀長寬比** +有時您需要形狀自由伸展，有時則希望保留原始比例。控制長寬比相當簡單。 ```java Document doc = new Document(); @@ -97,9 +107,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### 將形狀放置在表格儲存格中 - -如果您需要在表格儲存格內放置形狀，則可以使用以下程式碼實現： +## 在 **表格中放置形狀** +將形狀嵌入表格儲存格對於報告版面相當實用。以下範例會建立表格，並插入跨整頁的浮水印樣式形狀。 ```java Document doc = new Document(); @@ -122,7 +131,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // 如果要將形狀放入儲存格中，則在表格儲存格外顯示該形狀。 +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +152,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## 使用 SmartArt 形狀 +## 新增 **標註形狀** +標註形狀非常適合突顯備註或警示。上述程式碼已示範 `ACCENT_BORDER_CALLOUT_1`，您可將 `ShapeType` 替換為任何標註變體以符合設計需求。 -### 檢測 SmartArt 形狀 +## 操作 SmartArt 形狀 -您可以使用以下程式碼偵測文件中的 SmartArt 形狀： +### 偵測 SmartArt 形狀 +可透過程式方式辨識 SmartArt 圖表，讓您依需求處理或取代它們。 ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -157,8 +168,7 @@ System.out.println("The document has " + count + " shapes with SmartArt."); ``` ### 更新 SmartArt 繪圖 - -若要更新文件中的 SmartArt 繪圖，請使用下列程式碼： +偵測後，您可重新整理 SmartArt 圖形，使其反映任何資料變更。 ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +178,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## 結論 - -在本指南中，我們探索了 Aspose.Words for Java 中的文檔形狀世界。您已經學習如何在文件中添加各種形狀、操作其屬性以及如何使用 SmartArt 形狀。有了這些知識，您可以輕鬆建立具有視覺吸引力和互動性的文件。 +## 常見問題與技巧 +- **形狀未顯示：** 確認使用 `builder.insertNode` 將形狀插入於目標節點之後。 +- **旋轉異常：** 請記得旋轉是以形狀中心為基準，必要時調整 `setLeft`/`setTop`。 +- **長寬比被鎖定：** 預設多數形狀會鎖定長寬比，呼叫 `setAspectRatioLocked(false)` 可自由伸展。 +- **SmartArt 偵測失敗：** 請確認使用支援 SmartArt 的 Aspose.Words 版本（v24 以上）。 -## 常見問題解答 +## 常見問與答 -### 什麼是 Aspose.Words for Java？ +**Q: 什麼是 Aspose.Words for Java？** +A: Aspose.Words for Java 是一個 Java 程式庫，讓開發人員能以程式方式建立、修改與轉換 Word 文件。它提供廣泛的功能與工具，以處理各種格式的文件。 -Aspose.Words for Java 是一個 Java 函式庫，可讓開發人員以程式設計方式建立、修改和轉換 Word 文件。它提供了廣泛的功能和工具來處理各種格式的文件。 +**Q: 如何下載 Aspose.Words for Java？** +A: 您可透過以下連結從 Aspose 官方網站下載 Aspose.Words for Java：[Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### 如何下載適用於 Java 的 Aspose.Words？ +**Q: 使用文件形狀有什麼好處？** +A: 文件形狀能為文件加入視覺元素與互動性，使其更具吸引力與資訊性。透過形狀，您可以建立標註、按鈕、圖片、浮水印等，提升整體使用者體驗。 -您可以透過以下連結從 Aspose 網站下載 Aspose.Words for Java： [下載 Aspose.Words for Java](https://releases.aspose.com/words/java/) +**Q: 我可以自訂形狀的外觀嗎？** +A: 可以，您可透過調整大小、位置、旋轉與填色等屬性來自訂形狀外觀。Aspose.Words for Java 提供豐富的形狀自訂選項。 -### 使用文件形狀有什麼好處？ +**Q: Aspose.Words for Java 是否相容於 SmartArt？** +A: 是的，Aspose.Words for Java 支援 SmartArt 形狀，讓您能在文件中使用複雜的圖表與圖形。 -文件形狀為您的文件添加了視覺元素和互動性，使其更具吸引力和資訊量。使用形狀，您可以建立標註、按鈕、影像、浮水印等，從而增強整體使用者體驗。 - -### 我可以自訂形狀的外觀嗎？ - -是的，您可以透過調整形狀的屬性（例如大小、位置、旋轉和填滿顏色）來自訂形狀的外觀。 Aspose.Words for Java 提供了廣泛的形狀自訂選項。 - -### Aspose.Words for Java 是否與 SmartArt 相容？ - -是的，Aspose.Words for Java 支援 SmartArt 形狀，讓您可以在文件中處理複雜的圖表和圖形。 +--- +**最後更新：** 2025-12-14 +**測試環境：** Aspose.Words for Java 24.12（最新） +**作者：** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/hungarian/java/document-conversion-and-export/using-document-shapes/_index.md b/words/hungarian/java/document-conversion-and-export/using-document-shapes/_index.md index c4fb6ba8d..e3cb6eecd 100644 --- a/words/hungarian/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/hungarian/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,14 @@ --- -"description": "Engedd szabadjára a dokumentumalakzatok erejét az Aspose.Words for Java programban. Tanulj meg vizuálisan lebilincselő dokumentumokat létrehozni lépésről lépésre bemutatott példákkal." -"linktitle": "Dokumentumformák használata" -"second_title": "Aspose.Words Java dokumentumfeldolgozó API" -"title": "Dokumentumformák használata az Aspose.Words Java-ban" -"url": "/hu/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Ismerje meg, hogyan **illeszthet be képalakzatot** az Aspose.Words for + Java-val. Ez az útmutató bemutatja, hogyan adhat hozzá alakzatokat, hozhat létre + szövegdoboz alakzatokat, helyezhet el alakzatokat táblázatokban, állíthatja be az + alakzat méretarányát, és adhat hozzá feliratkozó alakzatokat. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Dokumentum alakzatok használata az Aspose.Words for Java-ban +url: /hu/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +17,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Dokumentumformák használata az Aspose.Words Java-ban +# Hogyan **képalakzat beillesztése** az Aspose.Words for Java-val +Ebben az átfogó útmutatóban megtudja, hogyan **illeszthet be képalakzat objektumokat** a Word dokumentumokba az Aspose.Words for Java segítségével. Akár jelentéseket, marketing anyagokat vagy interaktív űrlapokat készít, az alakzatok lehetővé teszik felhívások, gombok, szövegdobozok, vízjelek és még SmartArt hozzáadását. Lépésről lépésre végigvezetjük, elmagyarázzuk, miért használjon egy adott alakzatot, és kész‑kész kódrészleteket biztosítunk. -## Bevezetés a dokumentumalakzatok használatába az Aspose.Words Java-ban +## Gyors válaszok +- **Mi a legfőbb módja egy alakzat hozzáadásának?** Használja a `DocumentBuilder.insertShape`‑t vagy hozzon létre egy `Shape` példányt és adja hozzá a dokumentumfához. +- **Beilleszthetek képet alakzatként?** Igen – hívja a `builder.insertImage`‑t, majd kezelje a visszakapott `Shape`‑t, mint bármelyik másikat. +- **Hogyan tartom meg egy alakzat méretarányát?** Állítsa be a `shape.setAspectRatioLocked(true)` vagy `false` értéket a szükségleteinek megfelelően. +- **Lehetséges csoportosítani az alakzatokat?** Teljesen – csomagolja őket egy `GroupShape`‑be és szúrja be a csoportot egyetlen csomópontként. +- **Működnek a SmartArt diagramok az Aspose.Words‑szal?** Igen, programozottan felismerheti és frissítheti a SmartArt alakzatokat. -Ebben az átfogó útmutatóban elmerülünk az Aspose.Words for Java dokumentumformák világában. Az alakzatok elengedhetetlen elemek a vizuálisan vonzó és interaktív dokumentumok létrehozásához. Akár feliratokat, gombokat, képeket vagy vízjeleket kell hozzáadnia, az Aspose.Words for Java biztosítja az ehhez szükséges eszközöket. Fedezzük fel lépésről lépésre, forráskódpéldákkal bemutatva, hogyan használhatja ezeket az alakzatokat. +## Mi az **képalakzat beillesztése**? +Az *image shape* (képalakzat) egy vizuális elem, amely raszter vagy vektor grafikai adatot tartalmaz egy Word dokumentumban. Az Aspose.Words‑ban egy képet egy `Shape` objektum képviseli, amely teljes ellenőrzést biztosít a méret, pozíció, forgatás és körbefuttatás felett. -## Dokumentumformák használatának első lépései +## Miért használjunk alakzatokat a dokumentumokban? +- **Vizuális hatás:** Az alakzatok felhívják a figyelmet a kulcsfontosságú információkra. +- **Interaktivitás:** Gombok és felhívások URL‑ekhez vagy könyvjelzőkhöz kapcsolhatók. +- **Elrendezési rugalmasság:** A grafikákat pontosan helyezheti el abszolút vagy relatív koordinátákkal. +- **Automatizálás:** Összetett elrendezéseket hozhat létre manuális szerkesztés nélkül. -Mielőtt belevágnánk a kódba, állítsuk be a környezetünket. Győződjünk meg róla, hogy az Aspose.Words for Java integrálva van a projektünkbe. Ha még nem tetted meg, letöltheted az Aspose weboldaláról. [Aspose.Words letöltése Java-hoz](https://releases.aspose.com/words/java/) +## Előfeltételek +- Java Development Kit (JDK 8 vagy újabb) +- Aspose.Words for Java könyvtár (letöltés a hivatalos oldalról) +- Alapvető Java és objektum‑orientált programozási ismeretek -## Alakzatok hozzáadása dokumentumokhoz +A könyvtárat itt töltheti le: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Csoportalakzat beszúrása - -Egy `GroupShape` lehetővé teszi több alakzat csoportosítását. Így hozhat létre és szúrhat be egyet `GroupShape`: +## Hogyan **adjunk hozzá alakzatot** – GroupShape beszúrása +A `GroupShape` lehetővé teszi, hogy több alakzatot egy egységként kezeljen. Ez hasznos több elem együttes mozgatásához vagy formázásához. ```java Document doc = new Document(); @@ -58,9 +75,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Szövegdoboz alakzat beszúrása - -Szövegdoboz alakzat beszúrásához használhatja a `insertShape` a módszer, ahogy az az alábbi példában látható: +## Hozzon létre **szövegdoboz alakzatot** +A szövegdoboz egy olyan tároló, amely formázott szöveget tartalmazhat. Dinamikus megjelenés érdekében el is forgathatja. ```java Document doc = new Document(); @@ -81,11 +97,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Alakzattulajdonságok manipulálása - -### Képarány kezelése - -Beállíthatja, hogy egy alakzat képaránya zárolva legyen-e vagy sem. Így oldhatja fel egy alakzat képarányának feloldását: +## Állítsa be az **alakzat méretarányát** +Néha szükség van arra, hogy egy alakzat szabadon nyúljon, máskor pedig meg kell őrizni az eredeti arányait. A méretarány vezérlése egyszerű. ```java Document doc = new Document(); @@ -97,9 +110,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Alakzat elhelyezése egy táblázatcellában - -Ha egy alakzatot kell elhelyezned egy táblázatcellában, ezt a következő kóddal teheted meg: +## Helyezze el az **alakzatot táblázatban** +Alakzat beágyazása egy táblázat cellájába hasznos lehet jelentéselrendezésekhez. Az alábbi példa létrehoz egy táblázatot, majd egy vízjel‑stílusú alakzatot szúr be, amely az egész oldalt lefedi. ```java Document doc = new Document(); @@ -122,7 +134,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // Jelenítse meg az alakzatot a táblázatcellán kívül, ha az egy cellába kerül. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +155,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## SmartArt alakzatok használata +## Adj hozzá **felhívás alakzatot** +A felhívás alakzat tökéletes a megjegyzések vagy figyelmeztetések kiemelésére. Bár a fenti kód már bemutat egy `ACCENT_BORDER_CALLOUT_1`‑et, a `ShapeType`‑ot bármely más felhívás változatra cserélheti a tervezéshez illeszkedően. -### SmartArt alakzatok felismerése +## SmartArt alakzatok kezelése -A következő kóddal észlelheti a SmartArt alakzatokat egy dokumentumban: +### SmartArt alakzatok felismerése +A SmartArt diagramok programozottan azonosíthatók, lehetővé téve azok feldolgozását vagy cseréjét igény szerint. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -156,9 +170,8 @@ int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count(); System.out.println("The document has " + count + " shapes with SmartArt."); ``` -### SmartArt-rajzok frissítése - -A SmartArt-rajzok frissítéséhez egy dokumentumon belül használja a következő kódot: +### SmartArt rajzok frissítése +Miután felismerte, frissítheti a SmartArt grafikákat, hogy tükrözzék az adatváltozásokat. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +181,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Következtetés +## Gyakori problémák és tippek +- **Alakzat nem jelenik meg:** Győződjön meg róla, hogy az alakzat a célcsomópont után van beszúrva a `builder.insertNode` használatával. +- **Váratlan forgatás:** Ne feledje, hogy a forgatás az alakzat középpontja körül történik; szükség esetén állítsa a `setLeft`/`setTop` értékeket. +- **Méretarány zárolva:** Alapértelmezés szerint sok alakzat zárolja a méretarányt; a szabad nyújtáshoz hívja a `setAspectRatioLocked(false)`‑t. +- **SmartArt felismerés sikertelen:** Ellenőrizze, hogy az Aspose.Words olyan verzióját használja, amely támogatja a SmartArt‑ot (v24+). -Ebben az útmutatóban az Aspose.Words for Java dokumentumalakzatainak világát fedeztük fel. Megtanultad, hogyan adhatsz hozzá különféle alakzatokat a dokumentumokhoz, hogyan kezelheted a tulajdonságaikat, és hogyan dolgozhatsz SmartArt alakzatokkal. Ezzel a tudással könnyedén készíthetsz vizuálisan vonzó és interaktív dokumentumokat. +## Gyakran feltett kérdések -## GYIK +**Q: Mi az Aspose.Words for Java?** +A: Az Aspose.Words for Java egy Java könyvtár, amely lehetővé teszi a fejlesztők számára, hogy programozottan hozzanak létre, módosítsanak és konvertáljanak Word dokumentumokat. Széles körű funkciókat és eszközöket kínál a különböző formátumú dokumentumok kezeléséhez. -### Mi az Aspose.Words Java-hoz? +**Q: Hogyan tölthetem le az Aspose.Words for Java‑t?** +A: Az Aspose.Words for Java‑t letöltheti az Aspose weboldaláról a következő hivatkozáson: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -Az Aspose.Words for Java egy Java könyvtár, amely lehetővé teszi a fejlesztők számára Word dokumentumok programozott létrehozását, módosítását és konvertálását. Számos funkciót és eszközt kínál a különféle formátumú dokumentumokkal való munkához. +**Q: Mik a dokumentumalakzatok használatának előnyei?** +A: A dokumentumalakzatok vizuális elemeket és interaktivitást adnak a dokumentumokhoz, így azok vonzóbbak és informatívabbak lesznek. Alakzatokkal felhívásokat, gombokat, képeket, vízjeleket és egyebeket hozhat létre, ezáltal javítva a felhasználói élményt. -### Hogyan tudom letölteni az Aspose.Words programot Java-hoz? +**Q: Testreszabhatom az alakzatok megjelenését?** +A: Igen, az alakzatok megjelenését testreszabhatja a méret, pozíció, forgatás és kitöltőszín tulajdonságainak módosításával. Az Aspose.Words for Java kiterjedt lehetőségeket biztosít az alakzatok testreszabásához. -Az Aspose.Words for Java programot letöltheted az Aspose weboldaláról a következő linkre kattintva: [Aspose.Words letöltése Java-hoz](https://releases.aspose.com/words/java/) +**Q: Az Aspose.Words for Java kompatibilis a SmartArt‑dal?** +A: Igen, az Aspose.Words for Java támogatja a SmartArt alakzatokat, lehetővé téve összetett diagramok és grafikák kezelését a dokumentumokban. -### Milyen előnyei vannak a dokumentumalakzatok használatának? - -A dokumentumalakzatok vizuális elemeket és interaktivitást adnak a dokumentumokhoz, így azok vonzóbbak és informatívabbak. Az alakzatok segítségével feliratokat, gombokat, képeket, vízjeleket és egyebeket hozhat létre, ami javítja az általános felhasználói élményt. - -### Testreszabhatom az alakzatok megjelenését? - -Igen, testreszabhatja az alakzatok megjelenését olyan tulajdonságok módosításával, mint a méret, pozíció, forgatás és kitöltési szín. Az Aspose.Words for Java széleskörű lehetőségeket kínál az alakzatok testreszabásához. - -### Kompatibilis az Aspose.Words for Java a SmartArt-tal? - -Igen, az Aspose.Words for Java támogatja a SmartArt alakzatokat, lehetővé téve az összetett diagramok és grafikák használatát a dokumentumokban. +--- +**Last Updated:** 2025-12-14 +**Tested With:** Aspose.Words for Java 24.12 (latest) +**Author:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/indonesian/java/document-conversion-and-export/using-document-shapes/_index.md b/words/indonesian/java/document-conversion-and-export/using-document-shapes/_index.md index 267ed684f..8bcd5fe67 100644 --- a/words/indonesian/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/indonesian/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,14 @@ --- -"description": "Buka Kekuatan Bentuk Dokumen di Aspose.Words untuk Java. Pelajari Cara Membuat Dokumen yang Menarik Secara Visual dengan Contoh Langkah demi Langkah." -"linktitle": "Menggunakan Bentuk Dokumen" -"second_title": "API Pemrosesan Dokumen Java Aspose.Words" -"title": "Menggunakan Bentuk Dokumen di Aspose.Words untuk Java" -"url": "/id/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Pelajari cara **menyisipkan bentuk gambar** dengan Aspose.Words untuk + Java. Panduan ini menunjukkan cara menambahkan bentuk, membuat bentuk kotak teks, + menempatkan bentuk dalam tabel, mengatur rasio aspek bentuk, dan menambahkan bentuk + penjelasan. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Menggunakan Bentuk Dokumen di Aspose.Words untuk Java +url: /id/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +17,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Menggunakan Bentuk Dokumen di Aspose.Words untuk Java +# Cara **menyisipkan bentuk gambar** dengan Aspose.Words untuk Java +Dalam tutorial komprehensif ini Anda akan menemukan cara **menyisipkan bentuk gambar** ke dalam dokumen Word menggunakan Aspose.Words untuk Java. Baik Anda membuat laporan, materi pemasaran, atau formulir interaktif, bentuk memungkinkan Anda menambahkan callout, tombol, kotak teks, watermark, bahkan SmartArt. Kami akan membahas setiap langkah, menjelaskan mengapa Anda menggunakan bentuk tertentu, dan menyediakan potongan kode yang siap dijalankan. -## Pengantar Penggunaan Bentuk Dokumen di Aspose.Words untuk Java +## Jawaban Cepat +- **Apa cara utama untuk menambahkan sebuah bentuk?** Gunakan `DocumentBuilder.insertShape` atau buat instance `Shape` dan tambahkan ke pohon dokumen. +- **Bisakah saya menyisipkan gambar sebagai bentuk?** Ya – panggil `builder.insertImage` dan kemudian perlakukan `Shape` yang dikembalikan seperti bentuk lainnya. +- **Bagaimana cara menjaga rasio aspek bentuk?** Atur `shape.setAspectRatioLocked(true)` atau `false` sesuai kebutuhan Anda. +- **Apakah memungkinkan untuk mengelompokkan bentuk?** Tentu – bungkus mereka dalam `GroupShape` dan sisipkan grup sebagai satu node. +- **Apakah diagram SmartArt bekerja dengan Aspose.Words?** Ya, Anda dapat mendeteksi dan memperbarui bentuk SmartArt secara programatis. -Dalam panduan lengkap ini, kita akan menyelami dunia bentuk dokumen di Aspose.Words untuk Java. Bentuk merupakan elemen penting dalam membuat dokumen yang menarik secara visual dan interaktif. Baik Anda perlu menambahkan keterangan, tombol, gambar, atau tanda air, Aspose.Words untuk Java menyediakan alat untuk melakukannya secara efisien. Mari kita jelajahi cara menggunakan bentuk ini langkah demi langkah dengan contoh kode sumber. +## Apa itu **insert image shape**? +*Bentuk gambar* adalah elemen visual yang menyimpan grafik raster atau vektor di dalam dokumen Word. Di Aspose.Words, gambar direpresentasikan oleh objek `Shape`, memberi Anda kontrol penuh atas ukuran, posisi, rotasi, dan pembungkusannya. -## Memulai dengan Bentuk Dokumen +## Mengapa menggunakan bentuk dalam dokumen Anda? +- **Dampak visual:** Bentuk menarik perhatian ke informasi penting. +- **Interaktivitas:** Tombol dan callout dapat ditautkan ke URL atau bookmark. +- **Fleksibilitas tata letak:** Posisi grafik secara tepat dengan koordinat absolut atau relatif. +- **Otomatisasi:** Hasilkan tata letak kompleks tanpa penyuntingan manual. -Sebelum kita mulai membuat kode, mari kita siapkan lingkungan kita. Pastikan Anda telah mengintegrasikan Aspose.Words untuk Java ke dalam proyek Anda. Jika belum, Anda dapat mengunduhnya dari situs web Aspose [Unduh Aspose.Words untuk Java](https://releases.aspose.com/words/java/) +## Prasyarat +- Java Development Kit (JDK 8 atau lebih tinggi) +- Perpustakaan Aspose.Words untuk Java (unduh dari situs resmi) +- Pengetahuan dasar tentang Java dan pemrograman berorientasi objek -## Menambahkan Bentuk ke Dokumen +Anda dapat mengunduh perpustakaan di sini: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Memasukkan GroupShape - -A `GroupShape` memungkinkan Anda mengelompokkan beberapa bentuk bersama-sama. Berikut cara membuat dan menyisipkan `GroupShape`: +## Cara **menambahkan bentuk** – Menyisipkan GroupShape +`GroupShape` memungkinkan Anda memperlakukan beberapa bentuk sebagai satu unit. Ini berguna untuk memindahkan atau memformat beberapa elemen sekaligus. ```java Document doc = new Document(); @@ -58,9 +75,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Memasukkan Bentuk Kotak Teks - -Untuk menyisipkan bentuk kotak teks, Anda dapat menggunakan `insertShape` metode seperti yang ditunjukkan pada contoh di bawah ini: +## Membuat **bentuk kotak teks** +Kotak teks adalah wadah yang dapat menampung teks terformat. Anda juga dapat memutarnya untuk tampilan yang dinamis. ```java Document doc = new Document(); @@ -81,11 +97,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Memanipulasi Properti Bentuk - -### Mengelola Rasio Aspek - -Anda dapat mengontrol apakah rasio aspek suatu bentuk terkunci atau tidak. Berikut cara membuka kunci rasio aspek suatu bentuk: +## Mengatur **rasio aspek bentuk** +Terkadang Anda perlu bentuk yang dapat meregang bebas, kadang Anda ingin mempertahankan proporsi aslinya. Mengontrol rasio aspek sangat mudah. ```java Document doc = new Document(); @@ -97,9 +110,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Menempatkan Bentuk di Sel Tabel - -Jika Anda perlu menempatkan bentuk di dalam sel tabel, Anda dapat melakukannya dengan kode berikut: +## Menempatkan **bentuk dalam tabel** +Menyisipkan bentuk di dalam sel tabel dapat berguna untuk tata letak laporan. Contoh di bawah ini membuat tabel dan kemudian menyisipkan bentuk bergaya watermark yang melintasi seluruh halaman. ```java Document doc = new Document(); @@ -122,7 +134,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // Menampilkan bentuk di luar sel tabel jika akan ditempatkan ke dalam sel. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +155,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` +## Menambahkan **bentuk callout** +Bentuk callout sangat cocok untuk menyoroti catatan atau peringatan. Walaupun kode di atas sudah menunjukkan `ACCENT_BORDER_CALLOUT_1`, Anda dapat mengganti `ShapeType` ke varian callout lain sesuai desain Anda. + ## Bekerja dengan Bentuk SmartArt ### Mendeteksi Bentuk SmartArt - -Anda dapat mendeteksi bentuk SmartArt dalam dokumen menggunakan kode berikut: +Diagram SmartArt dapat diidentifikasi secara programatis, memungkinkan Anda memproses atau menggantinya sesuai kebutuhan. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -157,8 +171,7 @@ System.out.println("The document has " + count + " shapes with SmartArt."); ``` ### Memperbarui Gambar SmartArt - -Untuk memperbarui gambar SmartArt dalam dokumen, gunakan kode berikut: +Setelah terdeteksi, Anda dapat menyegarkan grafik SmartArt untuk mencerminkan perubahan data apa pun. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +181,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Kesimpulan - -Dalam panduan ini, kami telah menjelajahi dunia bentuk dokumen di Aspose.Words untuk Java. Anda telah mempelajari cara menambahkan berbagai bentuk ke dokumen Anda, memanipulasi propertinya, dan bekerja dengan bentuk SmartArt. Dengan pengetahuan ini, Anda dapat membuat dokumen yang menarik secara visual dan interaktif dengan mudah. +## Masalah Umum & Tips +- **Bentuk tidak muncul:** Pastikan bentuk disisipkan setelah node target menggunakan `builder.insertNode`. +- **Rotasi tidak terduga:** Ingat bahwa rotasi diterapkan di sekitar pusat bentuk; sesuaikan `setLeft`/`setTop` bila diperlukan. +- **Rasio aspek terkunci:** Secara default, banyak bentuk mengunci rasio aspeknya; panggil `setAspectRatioLocked(false)` untuk meregang bebas. +- **Deteksi SmartArt gagal:** Pastikan Anda menggunakan versi Aspose.Words yang mendukung SmartArt (v24+). ## Pertanyaan yang Sering Diajukan -### Apa itu Aspose.Words untuk Java? - -Aspose.Words untuk Java adalah pustaka Java yang memungkinkan pengembang membuat, memodifikasi, dan mengonversi dokumen Word secara terprogram. Pustaka ini menyediakan berbagai fitur dan alat untuk bekerja dengan dokumen dalam berbagai format. - -### Bagaimana cara mengunduh Aspose.Words untuk Java? - -Anda dapat mengunduh Aspose.Words untuk Java dari situs web Aspose dengan mengikuti tautan ini: [Unduh Aspose.Words untuk Java](https://releases.aspose.com/words/java/) +**T: Apa itu Aspose.Words untuk Java?** +J: Aspose.Words untuk Java adalah perpustakaan Java yang memungkinkan pengembang membuat, memodifikasi, dan mengonversi dokumen Word secara programatis. Ia menyediakan berbagai fitur dan alat untuk bekerja dengan dokumen dalam berbagai format. -### Apa keuntungan menggunakan bentuk dokumen? +**T: Bagaimana cara mengunduh Aspose.Words untuk Java?** +J: Anda dapat mengunduh Aspose.Words untuk Java dari situs Aspose dengan mengikuti tautan ini: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -Bentuk dokumen menambahkan elemen visual dan interaktivitas ke dokumen Anda, sehingga membuatnya lebih menarik dan informatif. Dengan bentuk, Anda dapat membuat keterangan, tombol, gambar, tanda air, dan banyak lagi, yang akan meningkatkan pengalaman pengguna secara keseluruhan. +**T: Apa manfaat menggunakan bentuk dokumen?** +J: Bentuk dokumen menambahkan elemen visual dan interaktivitas ke dokumen Anda, menjadikannya lebih menarik dan informatif. Dengan bentuk, Anda dapat membuat callout, tombol, gambar, watermark, dan lainnya, meningkatkan pengalaman pengguna secara keseluruhan. -### Bisakah saya menyesuaikan tampilan bentuk? +**T: Bisakah saya menyesuaikan tampilan bentuk?** +J: Ya, Anda dapat menyesuaikan tampilan bentuk dengan mengatur properti seperti ukuran, posisi, rotasi, dan warna isi. Aspose.Words untuk Java menyediakan opsi yang luas untuk kustomisasi bentuk. -Ya, Anda dapat menyesuaikan tampilan bentuk dengan menyesuaikan propertinya seperti ukuran, posisi, rotasi, dan warna isian. Aspose.Words untuk Java menyediakan opsi yang luas untuk penyesuaian bentuk. +**T: Apakah Aspose.Words untuk Java kompatibel dengan SmartArt?** +J: Ya, Aspose.Words untuk Java mendukung bentuk SmartArt, memungkinkan Anda bekerja dengan diagram dan grafik kompleks dalam dokumen Anda. -### Apakah Aspose.Words untuk Java kompatibel dengan SmartArt? - -Ya, Aspose.Words untuk Java mendukung bentuk SmartArt, yang memungkinkan Anda bekerja dengan diagram dan grafik kompleks dalam dokumen Anda. +--- +**Terakhir Diperbarui:** 2025-12-14 +**Diuji Dengan:** Aspose.Words untuk Java 24.12 (terbaru) +**Penulis:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/italian/java/document-conversion-and-export/using-document-shapes/_index.md b/words/italian/java/document-conversion-and-export/using-document-shapes/_index.md index 7faeb4e6b..90a11c581 100644 --- a/words/italian/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/italian/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,14 @@ --- -"description": "Sfrutta la potenza delle forme dei documenti in Aspose.Words per Java. Impara a creare documenti visivamente accattivanti con esempi passo passo." -"linktitle": "Utilizzo delle forme del documento" -"second_title": "API di elaborazione dei documenti Java Aspose.Words" -"title": "Utilizzo delle forme del documento in Aspose.Words per Java" -"url": "/it/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Impara come **inserire una forma immagine** con Aspose.Words per Java. + Questa guida ti mostra come aggiungere forme, creare forme casella di testo, posizionare + forme nelle tabelle, impostare il rapporto d'aspetto della forma e aggiungere forme + di richiamo. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Uso delle forme del documento in Aspose.Words per Java +url: /it/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +17,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Utilizzo delle forme del documento in Aspose.Words per Java +# Come **inserire una forma immagine** con Aspose.Words per Java +In questo tutorial completo scoprirai come **inserire una forma immagine** nei documenti Word usando Aspose.Words per Java. Che tu stia creando report, materiale di marketing o moduli interattivi, le forme ti consentono di aggiungere callout, pulsanti, caselle di testo, filigrane e persino SmartArt. Ti guideremo passo passo, spiegheremo perché usare una determinata forma e forniremo snippet di codice pronti all'uso. -## Introduzione all'utilizzo delle forme del documento in Aspose.Words per Java +## Risposte rapide +- **Qual è il modo principale per aggiungere una forma?** Usa `DocumentBuilder.insertShape` o crea un'istanza `Shape` e aggiungila all'albero del documento. +- **Posso inserire un'immagine come forma?** Sì – chiama `builder.insertImage` e poi tratta la `Shape` restituita come qualsiasi altra. +- **Come mantengo il rapporto d'aspetto di una forma?** Imposta `shape.setAspectRatioLocked(true)` o `false` a seconda delle tue esigenze. +- **È possibile raggruppare le forme?** Assolutamente – avvolgile in un `GroupShape` e inserisci il gruppo come un unico nodo. +- **I diagrammi SmartArt funzionano con Aspose.Words?** Sì, puoi rilevare e aggiornare le forme SmartArt programmaticamente. -In questa guida completa, approfondiremo il mondo delle forme dei documenti in Aspose.Words per Java. Le forme sono elementi essenziali per creare documenti visivamente accattivanti e interattivi. Che si tratti di aggiungere callout, pulsanti, immagini o filigrane, Aspose.Words per Java fornisce gli strumenti per farlo in modo efficiente. Esploreremo come utilizzare queste forme passo dopo passo con esempi di codice sorgente. +## Cos'è **inserire una forma immagine**? +Una *forma immagine* è un elemento visivo che contiene grafica raster o vettoriale all'interno di un documento Word. In Aspose.Words, un'immagine è rappresentata da un oggetto `Shape`, che ti offre il pieno controllo su dimensione, posizione, rotazione e avvolgimento. -## Introduzione alle forme dei documenti +## Perché usare le forme nei tuoi documenti? +- **Impatto visivo:** Le forme attirano l'attenzione sulle informazioni chiave. +- **Interattività:** Pulsanti e callout possono essere collegati a URL o segnalibri. +- **Flessibilità di layout:** Posiziona le grafiche con precisione usando coordinate assolute o relative. +- **Automazione:** Genera layout complessi senza modifiche manuali. -Prima di entrare nel codice, configuriamo il nostro ambiente. Assicurati di aver integrato Aspose.Words per Java nel tuo progetto. Se non l'hai già fatto, puoi scaricarlo dal sito web di Aspose. [Scarica Aspose.Words per Java](https://releases.aspose.com/words/java/) +## Prerequisiti +- Java Development Kit (JDK 8 o superiore) +- Libreria Aspose.Words per Java (scaricabile dal sito ufficiale) +- Conoscenza di base di Java e programmazione orientata agli oggetti -## Aggiungere forme ai documenti +Puoi scaricare la libreria qui: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Inserimento di un GroupShape - -UN `GroupShape` consente di raggruppare più forme insieme. Ecco come puoi creare e inserire un `GroupShape`: +## Come **aggiungere una forma** – Inserire un GroupShape +Un `GroupShape` ti consente di trattare più forme come un'unica unità. È utile per spostare o formattare più elementi insieme. ```java Document doc = new Document(); @@ -58,9 +75,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Inserimento di una forma di casella di testo - -Per inserire una forma di casella di testo, puoi utilizzare `insertShape` metodo come mostrato nell'esempio seguente: +## Crea **forma casella di testo** +Una casella di testo è un contenitore che può contenere testo formattato. Puoi anche ruotarla per un aspetto dinamico. ```java Document doc = new Document(); @@ -81,11 +97,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Manipolazione delle proprietà delle forme - -### Gestione delle proporzioni - -Puoi controllare se le proporzioni di una forma sono bloccate o meno. Ecco come sbloccare le proporzioni di una forma: +## Imposta **rapporto d'aspetto della forma** +A volte è necessario che una forma si estenda liberamente, altre volte vuoi mantenere le sue proporzioni originali. Controllare il rapporto d'aspetto è semplice. ```java Document doc = new Document(); @@ -97,9 +110,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Inserimento di una forma in una cella di tabella - -Se hai bisogno di posizionare una forma all'interno di una cella di una tabella, puoi farlo con il seguente codice: +## Posiziona **forma in una tabella** +Incorporare una forma all'interno di una cella di tabella può essere utile per i layout dei report. L'esempio seguente crea una tabella e poi inserisce una forma in stile filigrana che si estende su tutta la pagina. ```java Document doc = new Document(); @@ -122,7 +134,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // Visualizza la forma all'esterno della cella della tabella se verrà inserita in una cella. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +155,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## Lavorare con le forme SmartArt +## Aggiungi **forma callout** +Una forma callout è perfetta per evidenziare note o avvertimenti. Sebbene il codice sopra mostri già un `ACCENT_BORDER_CALLOUT_1`, puoi sostituire il `ShapeType` con qualsiasi variante di callout per adattarla al tuo design. -### Rilevamento delle forme SmartArt +## Lavorare con le forme SmartArt -È possibile rilevare le forme SmartArt in un documento utilizzando il seguente codice: +### Rilevare le forme SmartArt +I diagrammi SmartArt possono essere identificati programmaticamente, consentendoti di elaborarli o sostituirli secondo necessità. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -156,9 +170,8 @@ int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count(); System.out.println("The document has " + count + " shapes with SmartArt."); ``` -### Aggiornamento dei disegni SmartArt - -Per aggiornare i disegni SmartArt all'interno di un documento, utilizzare il seguente codice: +### Aggiornare i disegni SmartArt +Una volta rilevati, puoi aggiornare la grafica SmartArt per riflettere eventuali modifiche ai dati. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +181,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Conclusione - -In questa guida abbiamo esplorato il mondo delle forme dei documenti in Aspose.Words per Java. Hai imparato come aggiungere diverse forme ai tuoi documenti, manipolarne le proprietà e utilizzare le forme SmartArt. Grazie a queste conoscenze, puoi creare documenti visivamente accattivanti e interattivi con facilità. +## Problemi comuni e suggerimenti +- **Forma non visualizzata:** Assicurati che la forma sia inserita dopo il nodo di destinazione usando `builder.insertNode`. +- **Rotazione inattesa:** Ricorda che la rotazione è applicata attorno al centro della forma; regola `setLeft`/`setTop` se necessario. +- **Rapporto d'aspetto bloccato:** Per impostazione predefinita, molte forme bloccano il loro rapporto d'aspetto; chiama `setAspectRatioLocked(false)` per allungare liberamente. +- **Rilevamento SmartArt fallito:** Verifica di utilizzare una versione di Aspose.Words che supporti SmartArt (v24+). ## Domande frequenti -### Che cos'è Aspose.Words per Java? - -Aspose.Words per Java è una libreria Java che consente agli sviluppatori di creare, modificare e convertire documenti Word a livello di codice. Offre un'ampia gamma di funzionalità e strumenti per lavorare con documenti in vari formati. - -### Come posso scaricare Aspose.Words per Java? - -È possibile scaricare Aspose.Words per Java dal sito web di Aspose seguendo questo link: [Scarica Aspose.Words per Java](https://releases.aspose.com/words/java/) +**Q:** What is Aspose.Words for Java? +**A:** Aspose.Words for Java è una libreria Java che consente agli sviluppatori di creare, modificare e convertire documenti Word in modo programmatico. Offre un'ampia gamma di funzionalità e strumenti per lavorare con documenti in vari formati. -### Quali sono i vantaggi dell'utilizzo delle forme dei documenti? +**Q:** How can I download Aspose.Words for Java? +**A:** Puoi scaricare Aspose.Words per Java dal sito web di Aspose seguendo questo link: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -Le forme dei documenti aggiungono elementi visivi e interattività ai tuoi documenti, rendendoli più coinvolgenti e informativi. Con le forme puoi creare callout, pulsanti, immagini, filigrane e altro ancora, migliorando l'esperienza utente complessiva. +**Q:** What are the benefits of using document shapes? +**A:** Le forme nei documenti aggiungono elementi visivi e interattività, rendendoli più coinvolgenti e informativi. Con le forme, puoi creare callout, pulsanti, immagini, filigrane e altro, migliorando l'esperienza dell'utente. -### Posso personalizzare l'aspetto delle forme? +**Q:** Can I customize the appearance of shapes? +**A:** Sì, puoi personalizzare l'aspetto delle forme regolando le loro proprietà come dimensione, posizione, rotazione e colore di riempimento. Aspose.Words per Java offre ampie opzioni per la personalizzazione delle forme. -Sì, puoi personalizzare l'aspetto delle forme modificandone le proprietà come dimensione, posizione, rotazione e colore di riempimento. Aspose.Words per Java offre ampie opzioni per la personalizzazione delle forme. +**Q:** Is Aspose.Words for Java compatible with SmartArt? +**A:** Sì, Aspose.Words per Java supporta le forme SmartArt, consentendoti di lavorare con diagrammi e grafiche complesse nei tuoi documenti. -### Aspose.Words per Java è compatibile con SmartArt? - -Sì, Aspose.Words per Java supporta le forme SmartArt, consentendo di lavorare con diagrammi e grafici complessi nei documenti. +--- +**Last Updated:** 2025-12-14 +**Tested With:** Aspose.Words for Java 24.12 (latest) +**Author:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/japanese/java/document-conversion-and-export/using-document-shapes/_index.md b/words/japanese/java/document-conversion-and-export/using-document-shapes/_index.md index 048c1f1fe..2f41d2a6c 100644 --- a/words/japanese/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/japanese/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,11 @@ --- -"description": "Aspose.Words for Java のドキュメントシェイプのパワーを解き放ちましょう。ステップバイステップの例題を通して、視覚的に魅力的なドキュメントの作成方法を学びましょう。" -"linktitle": "ドキュメントシェイプの使用" -"second_title": "Aspose.Words Java ドキュメント処理 API" -"title": "Aspose.Words for Java でドキュメントシェイプを使用する" -"url": "/ja/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Aspose.Words for Java を使用して画像シェイプの挿入方法を学びましょう。このガイドでは、シェイプの追加、テキストボックスシェイプの作成、テーブル内へのシェイプ配置、シェイプのアスペクト比の設定、そしてコールアウトシェイプの追加方法を示します。 +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Aspose.Words for Java におけるドキュメント シェイプの使用 +url: /ja/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +14,33 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Aspose.Words for Java でドキュメントシェイプを使用する +# Aspose.Words for Java で **insert image shape** を挿入する方法 +## Quick Answers +- **シェイプを追加する主な方法は何ですか？** `DocumentBuilder.insertShape` を使用するか、`Shape` インスタンスを作成してドキュメントツリーに追加します。 +- **画像をシェイプとして挿入できますか？** はい – `builder.insertImage` を呼び出し、返された `Shape` を他のシェイプと同様に扱います。 +- **シェイプのアスペクト比を保持するには？** 必要に応じて `shape.setAspectRatioLocked(true)` または `false` を設定します。 +- **シェイプをグループ化できますか？** もちろんです – `GroupShape` でラップし、グループ全体を単一ノードとして挿入します。 +- **SmartArt 図は Aspose.Words で使用できますか？** はい、プログラムで SmartArt シェイプを検出し、更新できます。 -## Aspose.Words for Java でのドキュメント シェイプの使用の概要 +## **insert image shape** とは何ですか？ +*image shape* は、Word ドキュメント内にラスタまたはベクタ画像を保持する視覚要素です。Aspose.Words では、画像は `Shape` オブジェクトで表現され、サイズ、位置、回転、折り返しなどをフルコントロールできます。 -この包括的なガイドでは、Aspose.Words for Java のドキュメントシェイプの世界を深く掘り下げていきます。シェイプは、視覚的に魅力的でインタラクティブなドキュメントを作成する上で不可欠な要素です。吹き出し、ボタン、画像、透かしなど、どんな要素を追加する必要がある場合でも、Aspose.Words for Java はそれらを効率的に行うためのツールを提供します。これらのシェイプの使い方を、ソースコードの例を使って段階的に見ていきましょう。 +## ドキュメントでシェイプを使用する理由 +- **視覚的インパクト:** シェイプは重要情報に注意を引きます。 +- **インタラクティブ性:** ボタンやコールアウトは URL やブックマークにリンクできます。 +- **レイアウトの柔軟性:** 絶対座標または相対座標でグラフィックを正確に配置できます。 +- **自動化:** 手動編集なしで複雑なレイアウトを生成できます。 -## ドキュメントシェイプの使い方 +## 前提条件 +- Java Development Kit (JDK 8 以上) +- Aspose.Words for Java ライブラリ（公式サイトからダウンロード） +- Java とオブジェクト指向プログラミングの基本知識 -コードに進む前に、環境を設定しましょう。Aspose.Words for Javaがプロジェクトに統合されていることを確認してください。まだの場合は、Asposeのウェブサイトからダウンロードできます。 [Aspose.Words for Javaをダウンロード](https://releases.aspose.com/words/java/) +ライブラリはここからダウンロードできます: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -## ドキュメントに図形を追加する - -### グループシェイプの挿入 - -あ `GroupShape` 複数の図形をグループ化することができます。グループ化の作成と挿入方法は次のとおりです。 `GroupShape`： +## **add shape** の方法 – GroupShape の挿入 +`GroupShape` を使用すると、複数のシェイプを 1 つの単位として扱えます。これにより、複数要素をまとめて移動や書式設定が可能です。 ```java Document doc = new Document(); @@ -58,9 +70,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### テキストボックス図形の挿入 - -テキストボックス図形を挿入するには、 `insertShape` 以下の例に示す方法を使用します。 +## **text box shape** の作成 +テキストボックスは書式設定されたテキストを保持できるコンテナです。回転させて動的な外観にすることもできます。 ```java Document doc = new Document(); @@ -81,11 +92,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## 図形のプロパティの操作 - -### アスペクト比の管理 - -図形のアスペクト比をロックするかどうかを制御できます。図形のアスペクト比をロック解除する方法は次のとおりです。 +## **shape aspect ratio** の設定 +シェイプを自由に伸縮させる場合と、元の比率を保ちたい場合があります。アスペクト比の制御は簡単です。 ```java Document doc = new Document(); @@ -97,9 +105,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### 表のセルに図形を配置する - -テーブルセル内に図形を配置する必要がある場合は、次のコードを使用してこれを実現できます。 +## **shape in table** の配置 +テーブルセル内にシェイプを埋め込むと、レポートレイアウトで便利です。以下の例はテーブルを作成し、ページ全体に跨る透かしスタイルのシェイプを挿入します。 ```java Document doc = new Document(); @@ -122,7 +129,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // 図形をセル内に配置した場合は、表のセルの外側に図形を表示します。 +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +150,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## SmartArt図形の操作 +## **callout shape** の追加 +コールアウトシェイプはメモや警告を強調表示するのに最適です。上記コードは `ACCENT_BORDER_CALLOUT_1` を使用していますが、`ShapeType` を任意のコールアウトバリエーションに変更すればデザインに合わせられます。 -### SmartArt図形の検出 +## SmartArt シェイプの操作 -次のコードを使用して、ドキュメント内の SmartArt 図形を検出できます。 +### SmartArt シェイプの検出 +SmartArt 図はプログラムで識別できるため、必要に応じて処理や置換が可能です。 ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -157,8 +166,7 @@ System.out.println("The document has " + count + " shapes with SmartArt."); ``` ### SmartArt 描画の更新 - -ドキュメント内の SmartArt 描画を更新するには、次のコードを使用します。 +検出後、データ変更に合わせて SmartArt グラフィックを更新できます。 ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +176,37 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## 結論 - -このガイドでは、Aspose.Words for Java のドキュメント図形の世界を探求しました。ドキュメントに様々な図形を追加し、そのプロパティを操作し、SmartArt 図形を操作する方法を学びました。これらの知識があれば、視覚的に魅力的でインタラクティブなドキュメントを簡単に作成できます。 +## よくある問題とヒント +- **シェイプが表示されない:** `builder.insertNode` を使用して対象ノードの後にシェイプを挿入しているか確認してください。 +- **予期しない回転:** 回転はシェイプの中心を基準に適用されます。必要に応じて `setLeft`/`setTop` を調整してください。 +- **アスペクト比がロックされている:** 多くのシェイプはデフォルトでアスペクト比をロックしています。自由に伸縮したい場合は `setAspectRatioLocked(false)` を呼び出してください。 +- **SmartArt の検出が失敗する:** 使用している Aspose.Words のバージョンが SmartArt をサポートしているか（v24 以降）確認してください。 ## よくある質問 -### Aspose.Words for Java とは何ですか? +**Q: Aspose.Words for Java とは何ですか？** +A: Aspose.Words for Java は、開発者がプログラムから Word ドキュメントを作成、変更、変換できる Java ライブラリです。さまざまな形式のドキュメント操作機能を提供します。 -Aspose.Words for Javaは、開発者がWord文書をプログラムで作成、変更、変換できるようにするJavaライブラリです。さまざまな形式の文書を扱うための幅広い機能とツールを提供します。 +**Q: Aspose.Words for Java はどこからダウンロードできますか？** +A: 以下のリンクからダウンロードできます: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Aspose.Words for Java をダウンロードするにはどうすればいいですか? +**Q: ドキュメントシェイプを使用するメリットは何ですか？** +A: シェイプは視覚要素とインタラクティブ性をドキュメントに追加し、より魅力的で情報豊富な資料を作成できます。コールアウト、ボタン、画像、透かしなどを作成でき、ユーザー体験が向上します。 -次のリンクから Aspose.Words for Java を Aspose Web サイトからダウンロードできます。 [Aspose.Words for Javaをダウンロード](https://releases.aspose.com/words/java/) +**Q: シェイプの外観はカスタマイズできますか？** +A: はい、サイズ、位置、回転、塗りつぶし色などのプロパティを調整することでシェイプの外観を自由にカスタマイズできます。Aspose.Words for Java は豊富なカスタマイズオプションを提供します。 -### ドキュメント シェイプを使用する利点は何ですか? - -ドキュメントシェイプは、ドキュメントに視覚的な要素とインタラクティブ性を加え、より魅力的で情報豊かなドキュメントを実現します。シェイプを使えば、吹き出し、ボタン、画像、透かしなどを作成でき、ユーザーエクスペリエンス全体を向上させることができます。 - -### 図形の外観をカスタマイズできますか? - -はい、サイズ、位置、回転、塗りつぶし色などのプロパティを調整することで、図形の外観をカスタマイズできます。Aspose.Words for Java には、図形をカスタマイズするための幅広いオプションが用意されています。 - -### Aspose.Words for Java は SmartArt と互換性がありますか? - -はい、Aspose.Words for Java は SmartArt 図形をサポートしており、ドキュメント内で複雑な図やグラフィックを操作できます。 +**Q: Aspose.Words for Java は SmartArt と互換性がありますか？** +A: はい、Aspose.Words for Java は SmartArt シェイプをサポートしており、ドキュメント内の複雑な図やグラフィックを操作できます。 +**最終更新日:** 2025-12-14 +**テスト環境:** Aspose.Words for Java 24.12 (latest) +**作者:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/korean/java/document-conversion-and-export/using-document-shapes/_index.md b/words/korean/java/document-conversion-and-export/using-document-shapes/_index.md index 404b4890e..beb75618a 100644 --- a/words/korean/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/korean/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,12 @@ --- -"description": "Aspose.Words for Java에서 문서 모양의 강력한 기능을 활용하세요. 단계별 예제를 통해 시각적으로 매력적인 문서를 만드는 방법을 알아보세요." -"linktitle": "문서 모양 사용" -"second_title": "Aspose.Words Java 문서 처리 API" -"title": "Java용 Aspose.Words에서 문서 모양 사용" -"url": "/ko/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Aspose.Words for Java를 사용하여 **이미지 모양 삽입** 방법을 배워보세요. 이 가이드는 모양을 추가하고, + 텍스트 상자 모양을 만들고, 표에 모양을 배치하고, 모양 비율을 설정하고, 말풍선 모양을 추가하는 방법을 보여줍니다. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Aspose.Words for Java에서 문서 도형 사용 +url: /ko/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +15,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Java용 Aspose.Words에서 문서 모양 사용 +# Aspose.Words for Java로 **이미지 도형 삽입**하는 방법 +이 포괄적인 튜토리얼에서는 Aspose.Words for Java를 사용하여 Word 문서에 **이미지 도형** 객체를 삽입하는 방법을 알아봅니다. 보고서, 마케팅 자료, 인터랙티브 폼을 만들든, 도형을 사용하면 호출 상자, 버튼, 텍스트 상자, 워터마크, 심지어 SmartArt까지 추가할 수 있습니다. 각 단계를 차근차근 살펴보고, 특정 도형을 사용해야 하는 이유를 설명하며, 바로 실행 가능한 코드 스니펫을 제공합니다. -## Java용 Aspose.Words에서 문서 모양 사용 소개 +## 빠른 답변 +- **도형을 추가하는 기본 방법은?** `DocumentBuilder.insertShape`를 사용하거나 `Shape` 인스턴스를 생성해 문서 트리에 추가합니다. +- **이미지를 도형으로 삽입할 수 있나요?** 예 – `builder.insertImage`를 호출한 뒤 반환된 `Shape`를 다른 도형처럼 사용하면 됩니다. +- **도형의 가로세로 비율을 유지하려면?** 필요에 따라 `shape.setAspectRatioLocked(true)` 또는 `false`를 설정합니다. +- **도형을 그룹화할 수 있나요?** 물론 – 도형들을 `GroupShape`에 묶어 하나의 노드로 삽입합니다. +- **SmartArt 다이어그램을 Aspose.Words에서 사용할 수 있나요?** 예, SmartArt 도형을 프로그래밍 방식으로 감지하고 업데이트할 수 있습니다. -이 종합 가이드에서는 Aspose.Words for Java에서 문서 모양을 사용하는 방법을 자세히 알아보겠습니다. 모양은 시각적으로 매력적이고 인터랙티브한 문서를 만드는 데 필수적인 요소입니다. Aspose.Words for Java는 콜아웃, 버튼, 이미지 또는 워터마크를 추가해야 하는 경우 이를 효율적으로 수행할 수 있는 도구를 제공합니다. 소스 코드 예제를 통해 이러한 모양을 단계별로 사용하는 방법을 살펴보겠습니다. +## **이미지 도형 삽입**이란? +*이미지 도형*은 Word 문서 안에 래스터 또는 벡터 그래픽을 담는 시각 요소입니다. Aspose.Words에서는 이미지가 `Shape` 객체로 표현되며, 크기, 위치, 회전, 텍스트 래핑 등을 완벽히 제어할 수 있습니다. -## 문서 모양 시작하기 +## 문서에서 도형을 사용하는 이유 +- **시각적 효과:** 도형은 핵심 정보를 강조합니다. +- **인터랙티브:** 버튼 및 호출 상자를 URL이나 북마크에 연결할 수 있습니다. +- **레이아웃 유연성:** 절대 좌표 또는 상대 좌표로 그래픽을 정확히 배치합니다. +- **자동화:** 수동 편집 없이 복잡한 레이아웃을 프로그램matically 생성합니다. -코드 작성에 앞서 환경을 설정해 보겠습니다. 프로젝트에 Aspose.Words for Java가 통합되어 있는지 확인하세요. 아직 통합되어 있지 않다면 Aspose 웹사이트에서 다운로드할 수 있습니다. [Java용 Aspose.Words 다운로드](https://releases.aspose.com/words/java/) +## 사전 준비 사항 +- Java Development Kit (JDK 8 이상) +- Aspose.Words for Java 라이브러리 (공식 사이트에서 다운로드) +- Java 및 객체 지향 프로그래밍에 대한 기본 지식 -## 문서에 도형 추가 +라이브러리는 여기서 다운로드할 수 있습니다: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### 그룹 모양 삽입 - -에이 `GroupShape` 여러 도형을 그룹화할 수 있습니다. 도형을 만들고 삽입하는 방법은 다음과 같습니다. `GroupShape`: +## **도형 추가** 방법 – GroupShape 삽입 +`GroupShape`를 사용하면 여러 도형을 하나의 단위로 취급할 수 있어, 여러 요소를 동시에 이동하거나 서식 지정할 때 유용합니다. ```java Document doc = new Document(); @@ -58,9 +73,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### 텍스트 상자 모양 삽입 - -텍스트 상자 모양을 삽입하려면 다음을 사용할 수 있습니다. `insertShape` 아래 예에서 보여지는 것과 같은 방법: +## **텍스트 상자 도형** 만들기 +텍스트 상자는 서식이 적용된 텍스트를 담을 수 있는 컨테이너이며, 동적인 효과를 위해 회전시킬 수도 있습니다. ```java Document doc = new Document(); @@ -81,11 +95,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## 모양 속성 조작 - -### 종횡비 관리 - -도형의 가로 세로 비율을 잠글지 여부를 제어할 수 있습니다. 도형의 가로 세로 비율을 잠금 해제하는 방법은 다음과 같습니다. +## **도형 가로세로 비율** 설정 +때로는 도형을 자유롭게 늘리고 싶고, 때로는 원래 비율을 유지하고 싶을 때가 있습니다. 가로세로 비율 제어는 매우 간단합니다. ```java Document doc = new Document(); @@ -97,9 +108,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### 표 셀에 도형 배치 - -테이블 셀 내부에 모양을 배치해야 하는 경우 다음 코드를 사용하여 이를 구현할 수 있습니다. +## **테이블 안에 도형** 배치 +테이블 셀 안에 도형을 삽입하면 보고서 레이아웃을 구성할 때 편리합니다. 아래 예시는 테이블을 만든 뒤 페이지 전체에 걸치는 워터마크 스타일 도형을 삽입합니다. ```java Document doc = new Document(); @@ -122,7 +132,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // 셀에 배치될 경우, 표 셀 외부에 모양을 표시합니다. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +153,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## SmartArt 도형 작업 +## **호출 상자 도형** 추가 +호출 상자 도형은 메모나 경고를 강조할 때 적합합니다. 위 코드에서는 `ACCENT_BORDER_CALLOUT_1`을 사용했지만, 디자인에 맞게 `ShapeType`을 다른 호출 상자 변형으로 교체하면 됩니다. -### SmartArt 모양 감지 +## SmartArt 도형 작업 -다음 코드를 사용하여 문서에서 SmartArt 모양을 감지할 수 있습니다. +### SmartArt 도형 감지 +SmartArt 다이어그램을 프로그래밍 방식으로 식별하면 필요에 따라 처리하거나 교체할 수 있습니다. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -156,9 +168,8 @@ int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count(); System.out.println("The document has " + count + " shapes with SmartArt."); ``` -### SmartArt 도면 업데이트 - -문서 내에서 SmartArt 그림을 업데이트하려면 다음 코드를 사용하세요. +### SmartArt 그림 업데이트 +감지된 SmartArt를 업데이트하여 데이터 변경 사항을 반영할 수 있습니다. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +179,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## 결론 - -이 가이드에서는 Aspose.Words for Java에서 문서 도형을 사용하는 방법을 살펴보았습니다. 문서에 다양한 도형을 추가하고, 속성을 조작하고, SmartArt 도형을 사용하는 방법을 배웠습니다. 이러한 지식을 바탕으로 시각적으로 매력적이고 인터랙티브한 문서를 쉽게 만들 수 있습니다. +## 일반적인 문제 및 팁 +- **도형이 보이지 않음:** `builder.insertNode`를 사용해 대상 노드 뒤에 도형을 삽입했는지 확인하세요. +- **예상치 못한 회전:** 회전은 도형 중심을 기준으로 적용됩니다. 필요하면 `setLeft`/`setTop`을 조정하세요. +- **가로세로 비율 고정:** 기본적으로 많은 도형이 비율을 고정합니다. 자유롭게 늘리려면 `setAspectRatioLocked(false)`를 호출하세요. +- **SmartArt 감지 실패:** 사용 중인 Aspose.Words 버전이 SmartArt를 지원하는지 확인하세요 (v24 이상). ## 자주 묻는 질문 -### Java용 Aspose.Words란 무엇인가요? - -Aspose.Words for Java는 개발자가 Word 문서를 프로그래밍 방식으로 생성, 수정 및 변환할 수 있는 Java 라이브러리입니다. 다양한 형식의 문서 작업을 위한 광범위한 기능과 도구를 제공합니다. - -### Java용 Aspose.Words를 어떻게 다운로드할 수 있나요? - -다음 링크를 따라 Aspose 웹사이트에서 Aspose.Words for Java를 다운로드할 수 있습니다. [Java용 Aspose.Words 다운로드](https://releases.aspose.com/words/java/) +**Q: Aspose.Words for Java란?** +A: Aspose.Words for Java는 개발자가 프로그램matically Word 문서를 생성, 수정, 변환할 수 있게 해 주는 Java 라이브러리입니다. 다양한 형식의 문서를 다루는 폭넓은 기능과 도구를 제공합니다. -### 문서 모양을 사용하면 어떤 이점이 있나요? +**Q: Aspose.Words for Java를 어떻게 다운로드하나요?** +A: 다음 링크를 통해 Aspose 웹사이트에서 다운로드할 수 있습니다: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -문서 도형은 문서에 시각적 요소와 상호 작용성을 추가하여 더욱 매력적이고 유익한 정보를 제공합니다. 도형을 사용하면 콜아웃, 버튼, 이미지, 워터마크 등을 제작하여 전반적인 사용자 경험을 향상시킬 수 있습니다. +**Q: 문서 도형을 사용하면 어떤 이점이 있나요?** +A: 도형을 사용하면 문서에 시각적 요소와 인터랙티브 기능을 추가해 더욱 매력적이고 정보 전달이 효과적인 문서를 만들 수 있습니다. 호출 상자, 버튼, 이미지, 워터마크 등을 손쉽게 구현할 수 있습니다. -### 모양의 모양을 사용자 정의할 수 있나요? +**Q: 도형의 외관을 커스터마이즈할 수 있나요?** +A: 예, 도형의 크기, 위치, 회전, 채우기 색상 등 다양한 속성을 조정하여 외관을 자유롭게 커스터마이즈할 수 있습니다. Aspose.Words for Java는 도형 맞춤 설정을 위한 풍부한 옵션을 제공합니다. -네, 크기, 위치, 회전, 채우기 색상 등의 속성을 조정하여 도형의 모양을 사용자 지정할 수 있습니다. Aspose.Words for Java는 도형 사용자 지정을 위한 다양한 옵션을 제공합니다. +**Q: Aspose.Words for Java가 SmartArt를 지원하나요?** +A: 예, Aspose.Words for Java는 SmartArt 도형을 지원하므로 복잡한 다이어그램과 그래픽을 문서에서 작업할 수 있습니다. -### Aspose.Words for Java는 SmartArt와 호환됩니까? - -네, Aspose.Words for Java는 SmartArt 도형을 지원하므로 문서에서 복잡한 다이어그램과 그래픽을 작업할 수 있습니다. +--- +**마지막 업데이트:** 2025-12-14 +**테스트 환경:** Aspose.Words for Java 24.12 (최신) +**작성자:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/polish/java/document-conversion-and-export/using-document-shapes/_index.md b/words/polish/java/document-conversion-and-export/using-document-shapes/_index.md index c46e34f81..a89f668b7 100644 --- a/words/polish/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/polish/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,14 @@ --- -"description": "Odblokuj moc kształtów dokumentów w Aspose.Words dla Java. Naucz się tworzyć wizualnie angażujące dokumenty dzięki przykładom krok po kroku." -"linktitle": "Korzystanie z kształtów dokumentów" -"second_title": "Aspose.Words API przetwarzania dokumentów Java" -"title": "Korzystanie z kształtów dokumentów w Aspose.Words dla Java" -"url": "/pl/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Naucz się, jak **wstawiać kształt obrazu** za pomocą Aspose.Words for + Java. Ten przewodnik pokazuje, jak dodawać kształty, tworzyć kształty pól tekstowych, + umieszczać kształty w tabelach, ustawiać proporcje kształtu oraz dodawać kształty + dymków. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Używanie kształtów dokumentu w Aspose.Words dla Javy +url: /pl/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +17,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Korzystanie z kształtów dokumentów w Aspose.Words dla Java +# Jak **wstawić kształt obrazu** przy użyciu Aspose.Words for Java +W tym kompleksowym samouczku odkryjesz, jak **wstawiać kształty obrazu** do dokumentów Word przy użyciu Aspose.Words for Java. Niezależnie od tego, czy tworzysz raporty, materiały marketingowe, czy interaktywne formularze, kształty pozwalają dodawać dymki, przyciski, pola tekstowe, znaki wodne i nawet SmartArt. Przeprowadzimy Cię przez każdy krok, wyjaśnimy, dlaczego warto użyć konkretnego kształtu, i udostępnimy gotowe do uruchomienia fragmenty kodu. -## Wprowadzenie do korzystania z kształtów dokumentów w Aspose.Words dla Java +## Szybkie odpowiedzi +- **Jaki jest podstawowy sposób dodania kształtu?** Użyj `DocumentBuilder.insertShape` lub utwórz instancję `Shape` i dodaj ją do drzewa dokumentu. +- **Czy mogę wstawić obraz jako kształt?** Tak – wywołaj `builder.insertImage`, a następnie traktuj zwrócony `Shape` jak każdy inny. +- **Jak zachować proporcje kształtu?** Ustaw `shape.setAspectRatioLocked(true)` lub `false` w zależności od potrzeb. +- **Czy można grupować kształty?** Oczywiście – otocz je w `GroupShape` i wstaw grupę jako pojedynczy węzeł. +- **Czy diagramy SmartArt działają z Aspose.Words?** Tak, możesz wykrywać i aktualizować kształty SmartArt programowo. -tym kompleksowym przewodniku zagłębimy się w świat kształtów dokumentów w Aspose.Words for Java. Kształty są niezbędnymi elementami, jeśli chodzi o tworzenie wizualnie atrakcyjnych i interaktywnych dokumentów. Niezależnie od tego, czy musisz dodać objaśnienia, przyciski, obrazy lub znaki wodne, Aspose.Words for Java zapewnia narzędzia, aby zrobić to wydajnie. Przyjrzyjmy się, jak używać tych kształtów krok po kroku na przykładach kodu źródłowego. +## Co to jest **wstawianie kształtu obrazu**? +*Kształt obrazu* to element wizualny, który przechowuje grafikę rastrową lub wektorową w dokumencie Word. W Aspose.Words obraz jest reprezentowany przez obiekt `Shape`, dając pełną kontrolę nad rozmiarem, pozycją, obrotem i opakowaniem. -## Rozpoczęcie pracy z kształtami dokumentów +## Dlaczego używać kształtów w dokumentach? +- **Efekt wizualny:** Kształty przyciągają uwagę do kluczowych informacji. +- **Interaktywność:** Przyciskom i dymkom można przypisać linki do URL‑ów lub zakładek. +- **Elastyczność układu:** Pozycjonuj grafikę precyzyjnie przy użyciu współrzędnych bezwzględnych lub względnych. +- **Automatyzacja:** Generuj złożone układy bez ręcznej edycji. -Zanim przejdziemy do kodu, skonfigurujmy nasze środowisko. Upewnij się, że masz Aspose.Words for Java zintegrowane z projektem. Jeśli jeszcze tego nie zrobiłeś, możesz pobrać je ze strony internetowej Aspose [Pobierz Aspose.Words dla Java](https://releases.aspose.com/words/java/) +## Prerequisites +- Java Development Kit (JDK 8 lub nowszy) +- Biblioteka Aspose.Words for Java (pobierz z oficjalnej strony) +- Podstawowa znajomość Javy i programowania obiektowego -## Dodawanie kształtów do dokumentów +Możesz pobrać bibliotekę tutaj: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Wstawianie GroupShape - -A `GroupShape` pozwala na grupowanie wielu kształtów razem. Oto jak możesz utworzyć i wstawić `GroupShape`: +## Jak **dodać kształt** – Wstawianie GroupShape +`GroupShape` pozwala traktować kilka kształtów jako jedną jednostkę. Jest to przydatne przy przenoszeniu lub formatowaniu wielu elementów jednocześnie. ```java Document doc = new Document(); @@ -58,9 +75,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Wstawianie kształtu pola tekstowego - -Aby wstawić kształt pola tekstowego, możesz użyć `insertShape` metodę pokazano w poniższym przykładzie: +## Utwórz **kształt pola tekstowego** +Pole tekstowe to kontener, który może zawierać sformatowany tekst. Możesz je także obrócić, aby uzyskać dynamiczny wygląd. ```java Document doc = new Document(); @@ -81,11 +97,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Manipulowanie właściwościami kształtu - -### Zarządzanie współczynnikiem proporcji - -Możesz kontrolować, czy współczynnik proporcji kształtu jest zablokowany, czy nie. Oto jak odblokować współczynnik proporcji kształtu: +## Ustaw **proporcje kształtu** +Czasami potrzebujesz, aby kształt rozciągał się dowolnie, innym razem chcesz zachować jego oryginalne proporcje. Kontrolowanie proporcji jest proste. ```java Document doc = new Document(); @@ -97,9 +110,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Umieszczanie kształtu w komórce tabeli - -Jeśli chcesz umieścić kształt w komórce tabeli, możesz to zrobić za pomocą następującego kodu: +## Umieść **kształt w tabeli** +Osadzenie kształtu w komórce tabeli może być przydatne przy układach raportów. Poniższy przykład tworzy tabelę, a następnie wstawia kształt w stylu znaku wodnego, który rozciąga się na całą stronę. ```java Document doc = new Document(); @@ -122,7 +134,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // Wyświetl kształt poza komórką tabeli, jeśli będzie on umieszczony w komórce. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +155,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## Praca z kształtami SmartArt +## Dodaj **kształt dymku** +Kształt dymku jest idealny do wyróżniania notatek lub ostrzeżeń. Chociaż powyższy kod już demonstruje `ACCENT_BORDER_CALLOUT_1`, możesz zamienić `ShapeType` na dowolny wariant dymku, aby dopasować go do swojego projektu. -### Wykrywanie kształtów SmartArt +## Working with SmartArt Shapes -Możesz wykryć kształty SmartArt w dokumencie, korzystając z następującego kodu: +### Wykrywanie kształtów SmartArt +Diagramy SmartArt można identyfikować programowo, co pozwala na ich przetwarzanie lub zamianę w razie potrzeby. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -156,9 +170,8 @@ int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count(); System.out.println("The document has " + count + " shapes with SmartArt."); ``` -### Aktualizowanie rysunków SmartArt - -Aby zaktualizować rysunki SmartArt w dokumencie, użyj następującego kodu: +### Aktualizacja rysunków SmartArt +Po wykryciu możesz odświeżyć grafiki SmartArt, aby odzwierciedlić zmiany danych. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +181,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Wniosek +## Typowe problemy i wskazówki +- **Kształt nie pojawia się:** Upewnij się, że kształt jest wstawiany po węźle docelowym przy użyciu `builder.insertNode`. +- **Nieoczekiwany obrót:** Pamiętaj, że obrót jest stosowany wokół środka kształtu; w razie potrzeby dostosuj `setLeft`/`setTop`. +- **Zablokowane proporcje:** Domyślnie wiele kształtów blokuje proporcje; wywołaj `setAspectRatioLocked(false)`, aby swobodnie rozciągać. +- **Wykrywanie SmartArt nie powodzi się:** Sprawdź, czy używasz wersji Aspose.Words obsługującej SmartArt (v24+). -W tym przewodniku zbadaliśmy świat kształtów dokumentów w Aspose.Words for Java. Nauczyłeś się, jak dodawać różne kształty do dokumentów, manipulować ich właściwościami i pracować z kształtami SmartArt. Dzięki tej wiedzy możesz z łatwością tworzyć atrakcyjne wizualnie i interaktywne dokumenty. +## Frequently Asked Questions -## Najczęściej zadawane pytania +**Q: Czym jest Aspose.Words for Java?** +A: Aspose.Words for Java to biblioteka Java, która umożliwia programistom tworzenie, modyfikowanie i konwertowanie dokumentów Word programowo. Dostarcza szeroki zakres funkcji i narzędzi do pracy z dokumentami w różnych formatach. -### Czym jest Aspose.Words dla języka Java? +**Q: Jak mogę pobrać Aspose.Words for Java?** +A: Możesz pobrać Aspose.Words for Java ze strony Aspose, korzystając z tego linku: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -Aspose.Words for Java to biblioteka Java, która umożliwia programistom programowe tworzenie, modyfikowanie i konwertowanie dokumentów Word. Zapewnia szeroki zakres funkcji i narzędzi do pracy z dokumentami w różnych formatach. +**Q: Jakie są korzyści z używania kształtów w dokumencie?** +A: Kształty w dokumencie dodają elementy wizualne i interaktywność, czyniąc je bardziej angażującymi i informacyjnymi. Dzięki kształtom możesz tworzyć dymki, przyciski, obrazy, znaki wodne i wiele innych, co podnosi ogólne wrażenia użytkownika. -### Jak mogę pobrać Aspose.Words dla Java? +**Q: Czy mogę dostosować wygląd kształtów?** +A: Tak, możesz dostosować wygląd kształtów, zmieniając ich właściwości, takie jak rozmiar, pozycja, obrót i kolor wypełnienia. Aspose.Words for Java oferuje szerokie możliwości personalizacji kształtów. -Możesz pobrać Aspose.Words for Java ze strony internetowej Aspose, korzystając z tego łącza: [Pobierz Aspose.Words dla Java](https://releases.aspose.com/words/java/) +**Q: Czy Aspose.Words for Java jest kompatybilny ze SmartArt?** +A: Tak, Aspose.Words for Java obsługuje kształty SmartArt, umożliwiając pracę z złożonymi diagramami i grafiką w dokumentach. -### Jakie są korzyści ze stosowania kształtów dokumentów? - -Kształty dokumentów dodają elementy wizualne i interaktywność do dokumentów, dzięki czemu stają się bardziej angażujące i informacyjne. Za pomocą kształtów możesz tworzyć objaśnienia, przyciski, obrazy, znaki wodne i inne, ulepszając ogólne wrażenia użytkownika. - -### Czy mogę dostosować wygląd kształtów? - -Tak, możesz dostosować wygląd kształtów, dostosowując ich właściwości, takie jak rozmiar, położenie, obrót i kolor wypełnienia. Aspose.Words for Java zapewnia rozbudowane opcje dostosowywania kształtów. - -### Czy Aspose.Words dla Java jest kompatybilny ze SmartArt? - -Tak, Aspose.Words for Java obsługuje kształty SmartArt, co umożliwia pracę ze złożonymi diagramami i grafikami w dokumentach. +--- +**Ostatnia aktualizacja:** 2025-12-14 +**Testowano z:** Aspose.Words for Java 24.12 (latest) +**Autor:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/portuguese/java/document-conversion-and-export/using-document-shapes/_index.md b/words/portuguese/java/document-conversion-and-export/using-document-shapes/_index.md index e46c387d6..77976d1d2 100644 --- a/words/portuguese/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/portuguese/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,13 @@ --- -"description": "Descubra o poder dos formatos de documentos no Aspose.Words para Java. Aprenda a criar documentos visualmente envolventes com exemplos passo a passo." -"linktitle": "Usando formas de documento" -"second_title": "API de processamento de documentos Java Aspose.Words" -"title": "Usando formas de documentos no Aspose.Words para Java" -"url": "/pt/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Aprenda como **inserir forma de imagem** com Aspose.Words para Java. + Este guia mostra como adicionar formas, criar formas de caixa de texto, colocar + formas em tabelas, definir a proporção da forma e adicionar formas de balão de chamada. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Usando Formas de Documento no Aspose.Words para Java +url: /pt/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +16,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Usando formas de documentos no Aspose.Words para Java +# Como **insert image shape** com Aspose.Words for Java +Neste tutorial abrangente, você descobrirá como **insert image shape** objetos em documentos Word usando Aspose.Words for Java. Seja criando relatórios, materiais de marketing ou formulários interativos, as formas permitem adicionar balões de texto, botões, caixas de texto, marcas d'água e até SmartArt. Vamos percorrer cada passo, explicar por que usar uma forma específica e fornecer trechos de código prontos para execução. -## Introdução ao uso de formas de documentos no Aspose.Words para Java +## Respostas rápidas +- **Qual é a maneira principal de adicionar uma forma?** Use `DocumentBuilder.insertShape` ou crie uma instância `Shape` e adicione-a à árvore do documento. +- **Posso inserir uma imagem como forma?** Sim – chame `builder.insertImage` e trate o `Shape` retornado como qualquer outro. +- **Como mantenho a proporção de uma forma?** Defina `shape.setAspectRatioLocked(true)` ou `false` conforme sua necessidade. +- **É possível agrupar formas?** Absolutamente – envolva-as em um `GroupShape` e insira o grupo como um único nó. +- **Diagramas SmartArt funcionam com Aspose.Words?** Sim, você pode detectar e atualizar formas SmartArt programaticamente. -Neste guia completo, vamos nos aprofundar no mundo das formas de documentos no Aspose.Words para Java. As formas são elementos essenciais para criar documentos visualmente atraentes e interativos. Seja para adicionar chamadas, botões, imagens ou marcas d'água, o Aspose.Words para Java oferece as ferramentas necessárias para isso com eficiência. Vamos explorar como usar essas formas passo a passo com exemplos de código-fonte. +## O que é **insert image shape**? +Um *image shape* é um elemento visual que contém gráficos raster ou vetoriais dentro de um documento Word. No Aspose.Words, uma imagem é representada por um objeto `Shape`, oferecendo controle total sobre tamanho, posição, rotação e quebra de texto. -## Introdução aos formatos de documentos +## Por que usar formas em seus documentos? +- **Impacto visual:** As formas chamam a atenção para informações importantes. +- **Interatividade:** Botões e balões de texto podem ser vinculados a URLs ou marcadores. +- **Flexibilidade de layout:** Posicione gráficos com precisão usando coordenadas absolutas ou relativas. +- **Automação:** Gere layouts complexos sem edição manual. -Antes de começarmos a programar, vamos configurar nosso ambiente. Certifique-se de ter o Aspose.Words para Java integrado ao seu projeto. Se ainda não o fez, você pode baixá-lo do site do Aspose. [Baixe Aspose.Words para Java](https://releases.aspose.com/words/java/) +## Pré-requisitos +- Java Development Kit (JDK 8 ou superior) +- Biblioteca Aspose.Words for Java (download no site oficial) +- Conhecimento básico de Java e programação orientada a objetos -## Adicionando formas aos documentos +Você pode baixar a biblioteca aqui: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Inserindo um GroupShape - -UM `GroupShape` permite agrupar várias formas. Veja como você pode criar e inserir uma `GroupShape`: +## Como **add shape** – Inserindo um GroupShape +Um `GroupShape` permite tratar várias formas como uma única unidade. Isso é útil para mover ou formatar vários elementos juntos. ```java Document doc = new Document(); @@ -58,9 +74,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Inserindo uma forma de caixa de texto - -Para inserir uma forma de caixa de texto, você pode usar o `insertShape` método conforme mostrado no exemplo abaixo: +## Criar **text box shape** +Uma caixa de texto é um contêiner que pode conter texto formatado. Você também pode girá‑la para um visual dinâmico. ```java Document doc = new Document(); @@ -81,11 +96,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Manipulando Propriedades de Forma - -### Gerenciando a proporção da tela - -Você pode controlar se a proporção de uma forma está bloqueada ou não. Veja como desbloquear a proporção de uma forma: +## Definir **shape aspect ratio** +Às vezes você precisa que uma forma se estique livremente; em outras situações, deseja manter suas proporções originais. Controlar a proporção é simples. ```java Document doc = new Document(); @@ -97,9 +109,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Colocando uma forma em uma célula de tabela - -Se você precisar colocar uma forma dentro de uma célula de tabela, poderá fazer isso com o seguinte código: +## Colocar **shape in table** +Inserir uma forma dentro de uma célula de tabela pode ser útil em layouts de relatórios. O exemplo abaixo cria uma tabela e, em seguida, insere uma forma estilo marca d'água que ocupa a página inteira. ```java Document doc = new Document(); @@ -122,7 +133,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // Exiba a forma fora da célula da tabela se ela for colocada em uma célula. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +154,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## Trabalhando com formas SmartArt +## Adicionar **callout shape** +Uma forma de balão de texto é perfeita para destacar notas ou avisos. Embora o código acima já demonstre um `ACCENT_BORDER_CALLOUT_1`, você pode trocar o `ShapeType` por qualquer variante de balão para adequar ao seu design. -### Detectando Formas SmartArt +## Trabalhando com Formas SmartArt -Você pode detectar formas SmartArt em um documento usando o seguinte código: +### Detectar Formas SmartArt +Diagramas SmartArt podem ser identificados programaticamente, permitindo processá‑los ou substituí‑los conforme necessário. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -156,9 +169,8 @@ int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count(); System.out.println("The document has " + count + " shapes with SmartArt."); ``` -### Atualizando desenhos SmartArt - -Para atualizar desenhos SmartArt em um documento, use o seguinte código: +### Atualizar Desenhos SmartArt +Uma vez detectados, você pode atualizar os gráficos SmartArt para refletir quaisquer alterações nos dados. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +180,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Conclusão - -Neste guia, exploramos o mundo das formas de documentos no Aspose.Words para Java. Você aprendeu a adicionar diversas formas aos seus documentos, manipular suas propriedades e trabalhar com formas SmartArt. Com esse conhecimento, você poderá criar documentos visualmente atraentes e interativos com facilidade. +## Problemas comuns & Dicas +- **Forma não aparece:** Certifique‑se de que a forma seja inserida após o nó alvo usando `builder.insertNode`. +- **Rotação inesperada:** Lembre‑se de que a rotação é aplicada ao redor do centro da forma; ajuste `setLeft`/`setTop` se necessário. +- **Proporção travada:** Por padrão, muitas formas bloqueiam sua proporção; chame `setAspectRatioLocked(false)` para esticar livremente. +- **Falha na detecção de SmartArt:** Verifique se está usando a versão do Aspose.Words que suporta SmartArt (v24+). -## Perguntas frequentes +## Perguntas Frequentes -### O que é Aspose.Words para Java? +**Q: O que é Aspose.Words for Java?** +A: Aspose.Words for Java é uma biblioteca Java que permite a desenvolvedores criar, modificar e converter documentos Word programaticamente. Ela oferece uma ampla gama de recursos e ferramentas para trabalhar com documentos em vários formatos. -Aspose.Words para Java é uma biblioteca Java que permite aos desenvolvedores criar, modificar e converter documentos do Word programaticamente. Ela oferece uma ampla gama de recursos e ferramentas para trabalhar com documentos em diversos formatos. +**Q: Como posso baixar Aspose.Words for Java?** +A: Você pode baixar Aspose.Words for Java no site da Aspose seguindo este link: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Como posso baixar o Aspose.Words para Java? +**Q: Quais são os benefícios de usar formas em documentos?** +A: Formas adicionam elementos visuais e interatividade aos documentos, tornando‑os mais atraentes e informativos. Com formas, você pode criar balões de texto, botões, imagens, marcas d'água e muito mais, aprimorando a experiência do usuário. -Você pode baixar o Aspose.Words para Java no site da Aspose seguindo este link: [Baixe Aspose.Words para Java](https://releases.aspose.com/words/java/) +**Q: Posso personalizar a aparência das formas?** +A: Sim, você pode personalizar a aparência das formas ajustando propriedades como tamanho, posição, rotação e cor de preenchimento. Aspose.Words for Java fornece opções extensas para personalização de formas. -### Quais são os benefícios de usar formas de documentos? +**Q: Aspose.Words for Java é compatível com SmartArt?** +A: Sim, Aspose.Words for Java suporta formas SmartArt, permitindo trabalhar com diagramas e gráficos complexos em seus documentos. -As formas de documento adicionam elementos visuais e interatividade aos seus documentos, tornando-os mais envolventes e informativos. Com as formas, você pode criar chamadas, botões, imagens, marcas d'água e muito mais, aprimorando a experiência geral do usuário. - -### Posso personalizar a aparência das formas? - -Sim, você pode personalizar a aparência das formas ajustando suas propriedades, como tamanho, posição, rotação e cor de preenchimento. O Aspose.Words para Java oferece diversas opções para personalização de formas. - -### Aspose.Words para Java é compatível com o SmartArt? - -Sim, o Aspose.Words para Java suporta formas SmartArt, permitindo que você trabalhe com diagramas e gráficos complexos em seus documentos. +--- +**Última atualização:** 2025-12-14 +**Testado com:** Aspose.Words for Java 24.12 (latest) +**Autor:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/russian/java/document-conversion-and-export/using-document-shapes/_index.md b/words/russian/java/document-conversion-and-export/using-document-shapes/_index.md index d457f9508..b1f2643df 100644 --- a/words/russian/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/russian/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,14 @@ --- -"description": "Откройте для себя мощь форм документов в Aspose.Words для Java. Научитесь создавать визуально привлекательные документы с помощью пошаговых примеров." -"linktitle": "Использование форм документа" -"second_title": "API обработки документов Java Aspose.Words" -"title": "Использование форм документов в Aspose.Words для Java" -"url": "/ru/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Узнайте, как **вставлять изображение в виде фигуры** с помощью Aspose.Words + для Java. В этом руководстве показано, как добавлять фигуры, создавать текстовые + блоки, размещать фигуры в таблицах, задавать соотношение сторон фигуры и добавлять + фигурные выноски. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Использование фигур документа в Aspose.Words для Java +url: /ru/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +17,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Использование форм документов в Aspose.Words для Java +# Как **insert image shape** с Aspose.Words for Java +В этом полном руководстве вы узнаете, как **insert image shape** объекты вставлять в документы Word с помощью Aspose.Words for Java. Независимо от того, создаёте ли вы отчёты, маркетинговые материалы или интерактивные формы, фигуры позволяют добавлять выноски, кнопки, текстовые поля, водяные знаки и даже SmartArt. Мы пройдём каждый шаг, объясним, зачем использовать конкретную форму, и предоставим готовый к запуску код. -## Введение в использование фигур документов в Aspose.Words для Java +## Быстрые ответы +- **Как основной способ добавить форму?** Используйте `DocumentBuilder.insertShape` или создайте экземпляр `Shape` и добавьте его в дерево документа. +- **Можно ли вставить изображение как форму?** Да — вызовите `builder.insertImage`, а затем обращайтесь с возвращённым `Shape` как с любой другой формой. +- **Как сохранить соотношение сторон формы?** Установите `shape.setAspectRatioLocked(true)` или `false` в зависимости от потребностей. +- **Можно ли группировать формы?** Конечно — оберните их в `GroupShape` и вставьте группу как один узел. +- **Работают ли диаграммы SmartArt с Aspose.Words?** Да, их можно обнаруживать и обновлять программно. -В этом подробном руководстве мы погрузимся в мир форм документов в Aspose.Words для Java. Формы являются важнейшими элементами, когда дело доходит до создания визуально привлекательных и интерактивных документов. Если вам нужно добавить выноски, кнопки, изображения или водяные знаки, Aspose.Words для Java предоставляет инструменты для эффективного выполнения этой задачи. Давайте рассмотрим, как использовать эти формы шаг за шагом с примерами исходного кода. +## Что такое **insert image shape**? +*Image shape* — визуальный элемент, содержащий растровую или векторную графику внутри документа Word. В Aspose.Words изображение представлено объектом `Shape`, дающим полный контроль над размером, положением, вращением и обтеканием. -## Начало работы с формами документов +## Почему стоит использовать формы в документах? +- **Визуальное воздействие:** Формы привлекают внимание к ключевой информации. +- **Интерактивность:** Кнопки и выноски могут быть связаны с URL‑адресами или закладками. +- **Гибкость макета:** Точно позиционируйте графику с помощью абсолютных или относительных координат. +- **Автоматизация:** Генерируйте сложные макеты без ручного редактирования. -Прежде чем перейти к коду, давайте настроим нашу среду. Убедитесь, что Aspose.Words for Java интегрирован в ваш проект. Если вы еще этого не сделали, вы можете загрузить его с веб-сайта Aspose [Загрузить Aspose.Words для Java](https://releases.aspose.com/words/java/) +## Предварительные требования +- Java Development Kit (JDK 8 или выше) +- Библиотека Aspose.Words for Java (скачать с официального сайта) +- Базовые знания Java и объектно‑ориентированного программирования -## Добавление фигур в документы +Скачать библиотеку можно здесь: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Вставка GroupShape - -А `GroupShape` позволяет группировать несколько фигур вместе. Вот как можно создать и вставить `GroupShape`: +## Как **add shape** – вставка GroupShape +`GroupShape` позволяет рассматривать несколько форм как единый объект. Это удобно для перемещения или форматирования нескольких элементов одновременно. ```java Document doc = new Document(); @@ -58,9 +75,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Вставка формы текстового поля - -Чтобы вставить форму текстового поля, вы можете использовать `insertShape` метод, как показано в примере ниже: +## Создание **text box shape** +Текстовое поле — контейнер, способный содержать отформатированный текст. Его также можно вращать для динамичного вида. ```java Document doc = new Document(); @@ -81,11 +97,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Манипулирование свойствами формы - -### Управление соотношением сторон - -Вы можете контролировать, заблокировано ли соотношение сторон фигуры или нет. Вот как разблокировать соотношение сторон фигуры: +## Установка **shape aspect ratio** +Иногда требуется, чтобы форма свободно растягивалась, а иногда — сохраняла исходные пропорции. Управлять соотношением сторон просто. ```java Document doc = new Document(); @@ -97,9 +110,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Размещение фигуры в ячейке таблицы - -Если вам необходимо поместить фигуру внутрь ячейки таблицы, это можно сделать с помощью следующего кода: +## Размещение **shape in table** +Вставка формы в ячейку таблицы может быть полезна для макетов отчётов. Пример ниже создаёт таблицу и затем вставляет форму‑водяной знак, охватывающую всю страницу. ```java Document doc = new Document(); @@ -122,7 +134,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // Отобразить фигуру за пределами ячейки таблицы, если она будет помещена в ячейку. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +155,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## Работа с фигурами SmartArt +## Добавление **callout shape** +Форма‑выноска идеально подходит для выделения заметок или предупреждений. В приведённом выше коде уже используется `ACCENT_BORDER_CALLOUT_1`; вы можете заменить `ShapeType` на любой другой вариант выноски, соответствующий вашему дизайну. -### Обнаружение фигур SmartArt +## Работа с формами SmartArt -Вы можете обнаружить фигуры SmartArt в документе, используя следующий код: +### Обнаружение SmartArt Shapes +Диаграммы SmartArt можно программно идентифицировать, что позволяет обрабатывать или заменять их по необходимости. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -156,9 +170,8 @@ int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count(); System.out.println("The document has " + count + " shapes with SmartArt."); ``` -### Обновление рисунков SmartArt - -Чтобы обновить рисунки SmartArt в документе, используйте следующий код: +### Обновление SmartArt Drawings +После обнаружения вы можете обновлять графику SmartArt, отражая любые изменения данных. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +181,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Заключение - -В этом руководстве мы изучили мир форм документов в Aspose.Words для Java. Вы узнали, как добавлять различные формы в документы, управлять их свойствами и работать с формами SmartArt. С этими знаниями вы сможете с легкостью создавать визуально привлекательные и интерактивные документы. +## Распространённые проблемы и советы +- **Форма не отображается:** Убедитесь, что форма вставлена после целевого узла с помощью `builder.insertNode`. +- **Неожиданное вращение:** Помните, что вращение происходит вокруг центра формы; при необходимости скорректируйте `setLeft`/`setTop`. +- **Соотношение сторон заблокировано:** По умолчанию многие формы блокируют соотношение сторон; вызовите `setAspectRatioLocked(false)`, чтобы растянуть её свободно. +- **Не удаётся обнаружить SmartArt:** Проверьте, что используете версию Aspose.Words, поддерживающую SmartArt (v24+). ## Часто задаваемые вопросы -### Что такое Aspose.Words для Java? +**В: Что такое Aspose.Words for Java?** +О: Aspose.Words for Java — библиотека Java, позволяющая разработчикам программно создавать, изменять и конвертировать документы Word. Она предоставляет широкий набор функций и инструментов для работы с документами в различных форматах. -Aspose.Words for Java — это библиотека Java, которая позволяет разработчикам программно создавать, изменять и конвертировать документы Word. Она предоставляет широкий спектр функций и инструментов для работы с документами в различных форматах. +**В: Как скачать Aspose.Words for Java?** +О: Скачать Aspose.Words for Java можно с сайта Aspose по следующей ссылке: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Как загрузить Aspose.Words для Java? +**В: Каковы преимущества использования форм в документе?** +О: Формы добавляют визуальные элементы и интерактивность, делая документы более привлекательными и информативными. С их помощью можно создавать выноски, кнопки, изображения, водяные знаки и многое другое, улучшая общий пользовательский опыт. -Вы можете загрузить Aspose.Words для Java с веб-сайта Aspose, перейдя по этой ссылке: [Загрузить Aspose.Words для Java](https://releases.aspose.com/words/java/) +**В: Можно ли настроить внешний вид форм?** +О: Да, внешний вид форм можно настраивать, изменяя такие свойства, как размер, положение, вращение и цвет заливки. Aspose.Words for Java предоставляет обширные возможности для кастомизации форм. -### Каковы преимущества использования форм документов? +**В: Совместим ли Aspose.Words for Java с SmartArt?** +О: Да, Aspose.Words for Java поддерживает формы SmartArt, позволяя работать со сложными диаграммами и графикой в ваших документах. -Формы документов добавляют визуальные элементы и интерактивность в ваши документы, делая их более интересными и информативными. С помощью форм вы можете создавать выноски, кнопки, изображения, водяные знаки и многое другое, улучшая общее взаимодействие с пользователем. - -### Могу ли я настроить внешний вид фигур? - -Да, вы можете настроить внешний вид фигур, изменив их свойства, такие как размер, положение, поворот и цвет заливки. Aspose.Words для Java предоставляет обширные возможности для настройки фигур. - -### Совместим ли Aspose.Words для Java со SmartArt? - -Да, Aspose.Words для Java поддерживает фигуры SmartArt, что позволяет работать со сложными диаграммами и графикой в документах. +--- +**Последнее обновление:** 2025-12-14 +**Тестировано с:** Aspose.Words for Java 24.12 (latest) +**Автор:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/spanish/java/document-conversion-and-export/using-document-shapes/_index.md b/words/spanish/java/document-conversion-and-export/using-document-shapes/_index.md index 9cc52a07e..da1d5ecca 100644 --- a/words/spanish/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/spanish/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,14 @@ --- -"description": "Descubra el poder de las formas de documentos en Aspose.Words para Java. Aprenda a crear documentos visualmente atractivos con ejemplos paso a paso." -"linktitle": "Uso de formas de documentos" -"second_title": "API de procesamiento de documentos Java de Aspose.Words" -"title": "Uso de formas de documento en Aspose.Words para Java" -"url": "/es/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Aprenda cómo **insertar forma de imagen** con Aspose.Words para Java. + Esta guía le muestra cómo agregar formas, crear formas de cuadro de texto, colocar + formas en tablas, establecer la relación de aspecto de la forma y agregar formas + de globo de texto. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Uso de formas de documento en Aspose.Words para Java +url: /es/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +17,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Uso de formas de documento en Aspose.Words para Java +# Cómo **insertar forma de imagen** con Aspose.Words para Java +En este tutorial exhaustivo descubrirás cómo **insertar objetos de forma de imagen** en documentos Word usando Aspose.Words para Java. Ya sea que estés creando informes, material de marketing o formularios interactivos, las formas te permiten añadir llamadas, botones, cuadros de texto, marcas de agua e incluso SmartArt. Revisaremos cada paso, explicaremos por qué usar una forma concreta y proporcionaremos fragmentos de código listos para ejecutar. -## Introducción al uso de formas de documentos en Aspose.Words para Java +## Respuestas rápidas +- **¿Cuál es la forma principal de agregar una forma?** Usa `DocumentBuilder.insertShape` o crea una instancia de `Shape` y añádela al árbol del documento. +- **¿Puedo insertar una imagen como forma?** Sí – llama a `builder.insertImage` y luego trata el `Shape` devuelto como cualquier otro. +- **¿Cómo mantengo la proporción de una forma?** Establece `shape.setAspectRatioLocked(true)` o `false` según tus necesidades. +- **¿Es posible agrupar formas?** Absolutamente – envuélvelas en un `GroupShape` e inserta el grupo como un solo nodo. +- **¿Los diagramas SmartArt funcionan con Aspose.Words?** Sí, puedes detectar y actualizar formas SmartArt programáticamente. -En esta guía completa, profundizaremos en el mundo de las formas de documentos en Aspose.Words para Java. Las formas son elementos esenciales para crear documentos visualmente atractivos e interactivos. Ya sea que necesite agregar llamadas, botones, imágenes o marcas de agua, Aspose.Words para Java le proporciona las herramientas para hacerlo eficientemente. Exploremos cómo usar estas formas paso a paso con ejemplos de código fuente. +## ¿Qué es **insertar forma de imagen**? +Una *forma de imagen* es un elemento visual que contiene gráficos raster o vectoriales dentro de un documento Word. En Aspose.Words, una imagen se representa mediante un objeto `Shape`, dándote control total sobre el tamaño, posición, rotación y ajuste de texto. -## Introducción a las formas de documentos +## ¿Por qué usar formas en tus documentos? +- **Impacto visual:** Las formas atraen la atención a la información clave. +- **Interactividad:** Botones y llamadas pueden enlazarse a URL o marcadores. +- **Flexibilidad de diseño:** Posiciona los gráficos con precisión mediante coordenadas absolutas o relativas. +- **Automatización:** Genera diseños complejos sin edición manual. -Antes de empezar con el código, configuremos nuestro entorno. Asegúrate de tener Aspose.Words para Java integrado en tu proyecto. Si aún no lo tienes, puedes descargarlo del sitio web de Aspose. [Descargar Aspose.Words para Java](https://releases.aspose.com/words/java/) +## Requisitos previos +- Java Development Kit (JDK 8 o superior) +- Biblioteca Aspose.Words para Java (descárgala desde el sitio oficial) +- Conocimientos básicos de Java y programación orientada a objetos -## Agregar formas a los documentos +Puedes descargar la biblioteca aquí: [Descargar Aspose.Words para Java](https://releases.aspose.com/words/java/) -### Insertar una GroupShape - -A `GroupShape` Permite agrupar varias formas. Aquí te mostramos cómo crear e insertar una `GroupShape`: +## Cómo **agregar forma** – Insertar un GroupShape +Un `GroupShape` te permite tratar varias formas como una única unidad. Esto es útil para mover o formatear varios elementos juntos. ```java Document doc = new Document(); @@ -58,9 +75,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Insertar una forma de cuadro de texto - -Para insertar una forma de cuadro de texto, puede utilizar el `insertShape` método como se muestra en el ejemplo siguiente: +## Crear **forma de cuadro de texto** +Un cuadro de texto es un contenedor que puede albergar texto con formato. También puedes rotarlo para lograr un aspecto dinámico. ```java Document doc = new Document(); @@ -81,11 +97,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Manipulación de propiedades de forma - -### Administrar la relación de aspecto - -Puedes controlar si la relación de aspecto de una forma está bloqueada o no. Para desbloquearla, sigue estos pasos: +## Establecer **proporción de la forma** +A veces necesitas que una forma se estire libremente, otras veces deseas mantener sus proporciones originales. Controlar la proporción es sencillo. ```java Document doc = new Document(); @@ -97,9 +110,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Colocar una forma en una celda de tabla - -Si necesita colocar una forma dentro de una celda de una tabla, puede lograrlo con el siguiente código: +## Colocar **forma en tabla** +Insertar una forma dentro de una celda de tabla puede ser práctico para diseños de informes. El ejemplo a continuación crea una tabla y luego inserta una forma tipo marca de agua que abarca toda la página. ```java Document doc = new Document(); @@ -122,7 +134,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // Muestra la forma fuera de la celda de la tabla si se colocará dentro de una celda. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +155,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## Trabajar con formas SmartArt +## Añadir **forma de llamada** +Una forma de llamada es perfecta para resaltar notas o advertencias. Mientras que el código anterior ya muestra un `ACCENT_BORDER_CALLOUT_1`, puedes cambiar el `ShapeType` a cualquier variante de llamada que se ajuste a tu diseño. -### Detección de formas SmartArt +## Trabajando con formas SmartArt -Puede detectar formas SmartArt en un documento utilizando el siguiente código: +### Detectar formas SmartArt +Los diagramas SmartArt pueden identificarse programáticamente, lo que permite procesarlos o reemplazarlos según sea necesario. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -156,9 +170,8 @@ int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count(); System.out.println("The document has " + count + " shapes with SmartArt."); ``` -### Actualización de dibujos SmartArt - -Para actualizar dibujos SmartArt dentro de un documento, utilice el siguiente código: +### Actualizar dibujos SmartArt +Una vez detectados, puedes refrescar los gráficos SmartArt para reflejar cualquier cambio de datos. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +181,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Conclusión - -En esta guía, hemos explorado el mundo de las formas de documentos en Aspose.Words para Java. Ha aprendido a agregar diversas formas a sus documentos, manipular sus propiedades y trabajar con formas SmartArt. Con estos conocimientos, podrá crear documentos visualmente atractivos e interactivos con facilidad. +## Problemas comunes y consejos +- **Forma no aparece:** Asegúrate de que la forma se inserte después del nodo objetivo usando `builder.insertNode`. +- **Rotación inesperada:** Recuerda que la rotación se aplica alrededor del centro de la forma; ajusta `setLeft`/`setTop` si es necesario. +- **Proporción bloqueada:** Por defecto, muchas formas bloquean su proporción; llama a `setAspectRatioLocked(false)` para estirarlas libremente. +- **Falla en la detección de SmartArt:** Verifica que estés usando una versión de Aspose.Words que soporte SmartArt (v24+). ## Preguntas frecuentes -### ¿Qué es Aspose.Words para Java? +**P: ¿Qué es Aspose.Words para Java?** +R: Aspose.Words para Java es una biblioteca Java que permite a los desarrolladores crear, modificar y convertir documentos Word de forma programática. Proporciona una amplia gama de funciones y herramientas para trabajar con documentos en varios formatos. -Aspose.Words para Java es una biblioteca Java que permite a los desarrolladores crear, modificar y convertir documentos de Word mediante programación. Ofrece una amplia gama de funciones y herramientas para trabajar con documentos en diversos formatos. +**P: ¿Cómo puedo descargar Aspose.Words para Java?** +R: Puedes descargar Aspose.Words para Java desde el sitio web de Aspose siguiendo este enlace: [Descargar Aspose.Words para Java](https://releases.aspose.com/words/java/) -### ¿Cómo puedo descargar Aspose.Words para Java? +**P: ¿Cuáles son los beneficios de usar formas en documentos?** +R: Las formas añaden elementos visuales e interactividad a tus documentos, haciéndolos más atractivos e informativos. Con ellas puedes crear llamadas, botones, imágenes, marcas de agua y más, mejorando la experiencia del usuario. -Puede descargar Aspose.Words para Java desde el sitio web de Aspose siguiendo este enlace: [Descargar Aspose.Words para Java](https://releases.aspose.com/words/java/) +**P: ¿Puedo personalizar la apariencia de las formas?** +R: Sí, puedes personalizar la apariencia de las formas ajustando sus propiedades como tamaño, posición, rotación y color de relleno. Aspose.Words para Java ofrece opciones extensas para la personalización de formas. -### ¿Cuáles son los beneficios de utilizar formas de documentos? +**P: ¿Aspose.Words para Java es compatible con SmartArt?** +R: Sí, Aspose.Words para Java soporta formas SmartArt, lo que permite trabajar con diagramas y gráficos complejos en tus documentos. -Las formas de documento añaden elementos visuales e interactividad a sus documentos, haciéndolos más atractivos e informativos. Con ellas, puede crear llamadas, botones, imágenes, marcas de agua y más, mejorando así la experiencia general del usuario. - -### ¿Puedo personalizar la apariencia de las formas? - -Sí, puedes personalizar la apariencia de las formas ajustando sus propiedades, como el tamaño, la posición, la rotación y el color de relleno. Aspose.Words para Java ofrece amplias opciones para personalizar las formas. - -### ¿Aspose.Words para Java es compatible con SmartArt? - -Sí, Aspose.Words para Java admite formas SmartArt, lo que le permite trabajar con diagramas y gráficos complejos en sus documentos. +--- +**Última actualización:** 2025-12-14 +**Probado con:** Aspose.Words para Java 24.12 (última) +**Autor:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/swedish/java/document-conversion-and-export/using-document-shapes/_index.md b/words/swedish/java/document-conversion-and-export/using-document-shapes/_index.md index 7c591281c..e028a1a5a 100644 --- a/words/swedish/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/swedish/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,13 @@ --- -"description": "Lås upp kraften i dokumentformer i Aspose.Words för Java. Lär dig skapa visuellt engagerande dokument med steg-för-steg-exempel." -"linktitle": "Använda dokumentformer" -"second_title": "Aspose.Words Java-dokumentbehandlings-API" -"title": "Använda dokumentformer i Aspose.Words för Java" -"url": "/sv/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Lär dig hur du **infogar bildform** med Aspose.Words för Java. Den här + guiden visar hur du lägger till former, skapar textruteformer, placerar former i + tabeller, ställer in formens bildförhållande och lägger till pratbubblor. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Använda dokumentformer i Aspose.Words för Java +url: /sv/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +16,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Använda dokumentformer i Aspose.Words för Java +# Hur man **infoga bildform** med Aspose.Words för Java +I den här omfattande handledningen kommer du att upptäcka hur du **infogar bildform**‑objekt i Word-dokument med hjälp av Aspose.Words för Java. Oavsett om du bygger rapporter, marknadsföringsmaterial eller interaktiva formulär, låter former dig lägga till förklarande textrutor, knappar, textrutor, vattenstämplar och till och med SmartArt. Vi går igenom varje steg, förklarar varför du skulle använda en viss form och tillhandahåller färdiga kodexempel. -## Introduktion till användning av dokumentformer i Aspose.Words för Java +## Snabba svar +- **Vad är det primära sättet att lägga till en form?** Använd `DocumentBuilder.insertShape` eller skapa en `Shape`‑instans och lägg till den i dokumentträdet. +- **Kan jag infoga en bild som en form?** Ja – anropa `builder.insertImage` och behandla sedan den returnerade `Shape` som vilken annan som helst. +- **Hur behåller jag en forms bildförhållande?** Sätt `shape.setAspectRatioLocked(true)` eller `false` beroende på dina behov. +- **Är det möjligt att gruppera former?** Absolut – omslut dem i en `GroupShape` och infoga gruppen som en enda nod. +- **Fungerar Smart-diagram med Aspose.Words?** Ja, du kan upptäcka och uppdatera SmartArt‑former programatiskt. -den här omfattande guiden fördjupar vi oss i dokumentformernas värld i Aspose.Words för Java. Former är viktiga element när det gäller att skapa visuellt tilltalande och interaktiva dokument. Oavsett om du behöver lägga till callouts, knappar, bilder eller vattenstämplar, tillhandahåller Aspose.Words för Java verktygen för att göra det effektivt. Låt oss utforska hur man använder dessa former steg för steg med källkodsexempel. +## Vad är **infoga bildform**? +En *bildform* är ett visuellt element som innehåller raster‑ eller vektorgrafik i ett Word‑dokument. I Aspose.Words representeras en bild av ett `Shape`‑objekt, vilket ger dig full kontroll över storlek, position, rotation och omslag. -## Komma igång med dokumentformer +## Varför använda former i dina dokument? +- **Visuell effekt:** Former drar uppmärksamhet till viktig information. +- **Interaktivitet:** Knappar och förklarande textrutor kan länkas till URL:er eller bokmärken. +- **Layoutflexibilitet:** Positionera grafik exakt med absoluta eller relativa koordinater. +- **Automation:** Generera komplexa layouter utan manuell redigering. -Innan vi går in i koden, låt oss konfigurera vår miljö. Se till att du har Aspose.Words för Java integrerat i ditt projekt. Om du inte redan har gjort det kan du ladda ner det från Asposes webbplats. [Ladda ner Aspose.Words för Java](https://releases.aspose.com/words/java/) +## Förutsättningar +- Java Development Kit (JDK 8 eller högre) +- Aspose.Words för Java‑biblioteket (ladda ner från den officiella webbplatsen) +- Grundläggande kunskap om Java och objektorienterad programmering -## Lägga till former i dokument +Du kan ladda ner biblioteket här: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Infoga en gruppform - -En `GroupShape` låter dig gruppera flera former tillsammans. Så här skapar och infogar du en `GroupShape`: +## Hur man **lägger till form** – Infogar en GroupShape +En `GroupShape` låter dig behandla flera former som en enhet. Detta är användbart för att flytta eller formatera flera element tillsammans. ```java Document doc = new Document(); @@ -58,9 +74,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Infoga en textruteform - -För att infoga en textruteform kan du använda `insertShape` metod som visas i exemplet nedan: +## Skapa **textruteform** +En textruta är en behållare som kan innehålla formaterad text. Du kan också rotera den för ett dynamiskt utseende. ```java Document doc = new Document(); @@ -81,11 +96,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Manipulera formegenskaper - -### Hantera bildförhållande - -Du kan styra om bildförhållandet för en form är låst eller inte. Så här låser du upp bildförhållandet för en form: +## Ställ in **formens bildförhållande** +Ibland behöver du att en form sträcks fritt, andra gånger vill du behålla dess ursprungliga proportioner. Att kontrollera bildförhållandet är enkelt. ```java Document doc = new Document(); @@ -97,9 +109,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Placera en form i en tabellcell - -Om du behöver placera en form inuti en tabellcell kan du göra detta med följande kod: +## Placera **form i tabell** +Att bädda in en form i en tabellcell kan vara praktiskt för rapportlayouter. Exemplet nedan skapar en tabell och infogar sedan en vattenstämpel‑liknande form som sträcker sig över hela sidan. ```java Document doc = new Document(); @@ -122,7 +133,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // Visa formen utanför tabellcellen om den ska placeras i en cell. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +154,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## Arbeta med SmartArt-former +## Lägg till **förklarande textruteform** +En förklarande textruteform är perfekt för att markera anteckningar eller varningar. Medan koden ovan redan visar en `ACCENT_BORDER_CALLOUT_1`, kan du byta `ShapeType` till någon annan förklarande variant för att passa din design. -### Identifiera SmartArt-former +## Arbeta med SmartArt-former -Du kan identifiera SmartArt-former i ett dokument med hjälp av följande kod: +### Upptäck SmartArt-former +SmartArt-diagram kan identifieras programatiskt, vilket gör att du kan bearbeta eller ersätta dem efter behov. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -156,9 +169,8 @@ int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count(); System.out.println("The document has " + count + " shapes with SmartArt."); ``` -### Uppdaterar SmartArt-teckningar - -För att uppdatera SmartArt-teckningar i ett dokument, använd följande kod: +### Uppdatera SmartArt-ritningar +När de har upptäckts kan du uppdatera SmartArt-grafiken för att återspegla eventuella dataförändringar. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +180,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Slutsats - -I den här guiden har vi utforskat dokumentformernas värld i Aspose.Words för Java. Du har lärt dig hur du lägger till olika former i dina dokument, manipulerar deras egenskaper och arbetar med SmartArt-former. Med denna kunskap kan du enkelt skapa visuellt tilltalande och interaktiva dokument. +## Vanliga problem & tips +- **Formen visas inte:** Se till att formen infogas efter mål‑noden med `builder.insertNode`. +- **Oväntad rotation:** Kom ihåg att rotation appliceras kring formens centrum; justera `setLeft`/`setTop` vid behov. +- **Bildförhållande låst:** Som standard låser många former sitt bildförhållande; anropa `setAspectRatioLocked(false)` för att sträcka fritt. +- **SmartArt-upptäckt misslyckas:** Verifiera att du använder en Aspose.Words-version som stödjer SmartArt (v24+). ## Vanliga frågor -### Vad är Aspose.Words för Java? - -Aspose.Words för Java är ett Java-bibliotek som låter utvecklare skapa, modifiera och konvertera Word-dokument programmatiskt. Det erbjuder ett brett utbud av funktioner och verktyg för att arbeta med dokument i olika format. - -### Hur kan jag ladda ner Aspose.Words för Java? - -Du kan ladda ner Aspose.Words för Java från Asposes webbplats genom att följa den här länken: [Ladda ner Aspose.Words för Java](https://releases.aspose.com/words/java/) +**Q: Vad är Aspose.Words för Java?** +A: Aspose.Words för Java är ett Java‑bibliotek som låter utvecklare skapa, modifiera och konvertera Word‑dokument programatiskt. Det erbjuder ett brett utbud av funktioner och verktyg för att arbeta med dokument i olika format. -### Vilka är fördelarna med att använda dokumentformer? +**Q: Hur kan jag ladda ner Aspose.Words för Java?** +A: Du kan ladda ner Aspose.Words för Java från Aspose‑webbplatsen genom att följa denna länk: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -Dokumentformer lägger till visuella element och interaktivitet i dina dokument, vilket gör dem mer engagerande och informativa. Med former kan du skapa bildtexter, knappar, bilder, vattenstämplar och mer, vilket förbättrar den övergripande användarupplevelsen. +**Q: Vilka är fördelarna med att använda dokumentformer?** +A: Dokumentformer lägger till visuella element och interaktivitet i dina dokument, vilket gör dem mer engagerande och informativa. Med former kan du skapa förklarande textrutor, knappar, bilder, vattenstämplar och mer, vilket förbättrar den övergripande användarupplevelsen. -### Kan jag anpassa utseendet på former? +**Q: Kan jag anpassa utseendet på former?** +A: Ja, du kan anpassa utseendet på former genom att justera deras egenskaper såsom storlek, position, rotation och fyllningsfärg. Aspose.Words för Java erbjuder omfattande alternativ för anpassning av former. -Ja, du kan anpassa utseendet på former genom att justera deras egenskaper som storlek, position, rotation och fyllningsfärg. Aspose.Words för Java erbjuder omfattande alternativ för anpassning av former. +**Q: Är Aspose.Words för Java kompatibel med SmartArt?** +A: Ja, Aspose.Words för Java stödjer SmartArt‑former, vilket gör att du kan arbeta med komplexa diagram och grafik i dina dokument. -### Är Aspose.Words för Java kompatibelt med SmartArt? - -Ja, Aspose.Words för Java stöder SmartArt-former, vilket gör att du kan arbeta med komplexa diagram och grafik i dina dokument. +--- +**Senast uppdaterad:** 2025-12-14 +**Testad med:** Aspose.Words för Java 24.12 (senaste) +**Författare:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/thai/java/document-conversion-and-export/using-document-shapes/_index.md b/words/thai/java/document-conversion-and-export/using-document-shapes/_index.md index c4adaa08a..97a85b8d7 100644 --- a/words/thai/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/thai/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,12 @@ --- -"description": "ปลดล็อกพลังของรูปร่างเอกสารใน Aspose.Words สำหรับ Java เรียนรู้การสร้างเอกสารที่น่าสนใจด้วยตัวอย่างทีละขั้นตอน" -"linktitle": "การใช้รูปร่างเอกสาร" -"second_title": "API การประมวลผลเอกสาร Java ของ Aspose.Words" -"title": "การใช้รูปร่างเอกสารใน Aspose.Words สำหรับ Java" -"url": "/th/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: เรียนรู้วิธี **แทรกรูปร่างรูปภาพ** ด้วย Aspose.Words for Java คู่มือนี้จะแสดงวิธีเพิ่มรูปร่าง, + สร้างรูปร่างกล่องข้อความ, วางรูปร่างในตาราง, ตั้งอัตราส่วนของรูปร่าง, และเพิ่มรูปร่างคำอธิบาย. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: การใช้รูปทรงเอกสารใน Aspose.Words สำหรับ Java +url: /th/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +15,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# การใช้รูปร่างเอกสารใน Aspose.Words สำหรับ Java +# วิธี **insert image shape** ด้วย Aspose.Words for Java +ในบทแนะนำที่ครอบคลุมนี้ คุณจะได้ค้นพบวิธี **insert image shape** ลงในเอกสาร Word ด้วย Aspose.Words for Java ไม่ว่าคุณจะสร้างรายงาน เอกสารการตลาด หรือแบบฟอร์มแบบโต้ตอบ Shape จะช่วยให้คุณเพิ่ม Callouts, Buttons, Text Boxes, Watermarks และแม้กระทั่ง SmartArt เราจะเดินผ่านแต่ละขั้นตอน อธิบายเหตุผลที่ควรใช้ Shape ประเภทใด และให้โค้ดตัวอย่างที่พร้อมรัน -## บทนำเกี่ยวกับการใช้รูปร่างเอกสารใน Aspose.Words สำหรับ Java +## Quick Answers +- **What is the primary way to add a shape?** Use `DocumentBuilder.insertShape` or create a `Shape` instance and add it to the document tree. +- **Can I insert an image as a shape?** Yes – call `builder.insertImage` and then treat the returned `Shape` like any other. +- **How do I keep a shape’s aspect ratio?** Set `shape.setAspectRatioLocked(true)` or `false` depending on your needs. +- **Is it possible to group shapes?** Absolutely – wrap them in a `GroupShape` and insert the group as a single node. +- **Do SmartArt diagrams work with Aspose.Words?** Yes, you can detect and update SmartArt shapes programmatically. -ในคู่มือฉบับสมบูรณ์นี้ เราจะเจาะลึกเข้าไปในโลกของรูปร่างเอกสารใน Aspose.Words สำหรับ Java รูปร่างเป็นองค์ประกอบสำคัญเมื่อต้องสร้างเอกสารที่ดึงดูดสายตาและโต้ตอบได้ ไม่ว่าคุณจะต้องเพิ่มคำอธิบาย ปุ่ม รูปภาพ หรือลายน้ำ Aspose.Words สำหรับ Java ก็มีเครื่องมือที่ช่วยให้คุณทำได้อย่างมีประสิทธิภาพ มาสำรวจวิธีใช้รูปร่างเหล่านี้ทีละขั้นตอนพร้อมตัวอย่างโค้ดต้นฉบับกัน +## What is **insert image shape**? +*Image shape* คือองค์ประกอบภาพที่เก็บกราฟิกแบบ Raster หรือ Vector ไว้ในเอกสาร Word ใน Aspose.Words ภาพจะถูกแทนด้วยอ็อบเจ็กต์ `Shape` ซึ่งให้คุณควบคุมขนาด ตำแหน่ง การหมุน และการห่อหุ้มได้อย่างเต็มที่ -## เริ่มต้นใช้งานรูปร่างเอกสาร +## Why use shapes in your documents? +- **Visual impact:** Shapes draw attention to key information. +- **Interactivity:** Buttons and callouts can be linked to URLs or bookmarks. +- **Layout flexibility:** Position graphics precisely with absolute or relative coordinates. +- **Automation:** Generate complex layouts without manual editing. -ก่อนที่เราจะเริ่มต้นเขียนโค้ด เรามาตั้งค่าสภาพแวดล้อมกันก่อน ตรวจสอบให้แน่ใจว่าคุณได้รวม Aspose.Words สำหรับ Java ไว้ในโปรเจ็กต์ของคุณแล้ว หากคุณยังไม่ได้ทำ คุณสามารถดาวน์โหลดได้จากเว็บไซต์ของ Aspose [ดาวน์โหลด Aspose.Words สำหรับ Java](https://releases.aspose.com/words/java/) +## Prerequisites +- Java Development Kit (JDK 8 or higher) +- Aspose.Words for Java library (download from the official site) +- Basic knowledge of Java and object‑oriented programming -## การเพิ่มรูปร่างลงในเอกสาร +You can download the library here: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### การแทรก GroupShape - -เอ `GroupShape` ช่วยให้คุณสามารถจัดกลุ่มรูปร่างต่างๆ เข้าด้วยกันได้ นี่คือวิธีที่คุณสามารถสร้างและแทรก `GroupShape`- +## How to **add shape** – Inserting a GroupShape +A `GroupShape` lets you treat several shapes as a single unit. This is useful for moving or formatting multiple elements together. ```java Document doc = new Document(); @@ -58,9 +73,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### การแทรกรูปร่างกล่องข้อความ - -ในการแทรกรูปร่างกล่องข้อความ คุณสามารถใช้ `insertShape` วิธีการดังแสดงในตัวอย่างด้านล่าง: +## Create **text box shape** +A text box is a container that can hold formatted text. You can also rotate it for a dynamic look. ```java Document doc = new Document(); @@ -81,11 +95,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## การจัดการคุณสมบัติของรูปร่าง - -### การจัดการอัตราส่วนภาพ - -คุณสามารถควบคุมได้ว่าอัตราส่วนภาพของรูปร่างจะถูกล็อกหรือไม่ ต่อไปนี้คือวิธีปลดล็อกอัตราส่วนภาพของรูปร่าง: +## Set **shape aspect ratio** +Sometimes you need a shape to stretch freely, other times you want to keep its original proportions. Controlling the aspect ratio is straightforward. ```java Document doc = new Document(); @@ -97,9 +108,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### การวางรูปร่างลงในเซลล์ตาราง - -หากคุณต้องการวางรูปร่างไว้ภายในเซลล์ตาราง คุณสามารถทำได้โดยใช้โค้ดต่อไปนี้: +## Place **shape in table** +Embedding a shape inside a table cell can be handy for report layouts. The example below creates a table and then inserts a watermark‑style shape that spans the whole page. ```java Document doc = new Document(); @@ -122,7 +132,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // แสดงรูปร่างภายนอกเซลล์ตารางหากจะวางไว้ในเซลล์ +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +153,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## การทำงานกับรูปทรง SmartArt +## Add **callout shape** +A callout shape is perfect for highlighting notes or warnings. While the code above already demonstrates an `ACCENT_BORDER_CALLOUT_1`, you can swap the `ShapeType` to any callout variant to suit your design. -### การตรวจจับรูปทรง SmartArt +## Working with SmartArt Shapes -คุณสามารถตรวจจับรูปร่าง SmartArt ในเอกสารได้โดยใช้โค้ดต่อไปนี้: +### Detect SmartArt Shapes +SmartArt diagrams can be identified programmatically, allowing you to process or replace them as needed. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -156,9 +168,8 @@ int count = (int) shapes.stream().filter(s -> s.hasSmartArt()).count(); System.out.println("The document has " + count + " shapes with SmartArt."); ``` -### การอัปเดตภาพวาด SmartArt - -หากต้องการอัปเดตรูปวาด SmartArt ภายในเอกสาร ให้ใช้โค้ดดังต่อไปนี้: +### Update SmartArt Drawings +Once detected, you can refresh the SmartArt graphics to reflect any data changes. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +179,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## บทสรุป - -ในคู่มือนี้ เราได้สำรวจโลกของรูปร่างเอกสารใน Aspose.Words สำหรับ Java คุณได้เรียนรู้วิธีการเพิ่มรูปร่างต่างๆ ลงในเอกสาร จัดการคุณสมบัติของเอกสาร และทำงานกับรูปร่าง SmartArt ด้วยความรู้เหล่านี้ คุณสามารถสร้างเอกสารที่น่าสนใจและโต้ตอบได้อย่างง่ายดาย +## Common Issues & Tips +- **Shape not appearing:** Ensure the shape is inserted after the target node using `builder.insertNode`. +- **Unexpected rotation:** Remember that rotation is applied around the shape’s center; adjust `setLeft`/`setTop` if needed. +- **Aspect ratio locked:** By default, many shapes lock their aspect ratio; call `setAspectRatioLocked(false)` to stretch freely. +- **SmartArt detection fails:** Verify you are using Aspose.Words version that supports SmartArt (v24+). -## คำถามที่พบบ่อย +## Frequently Asked Questions -### Aspose.Words สำหรับ Java คืออะไร? +**Q: What is Aspose.Words for Java?** +A: Aspose.Words for Java is a Java library that allows developers to create, modify, and convert Word documents programmatically. It provides a wide range of features and tools for working with documents in various formats. -Aspose.Words for Java เป็นไลบรารี Java ที่ช่วยให้นักพัฒนาสามารถสร้าง แก้ไข และแปลงเอกสาร Word ได้ด้วยโปรแกรม โดยมีคุณสมบัติและเครื่องมือต่างๆ มากมายสำหรับการทำงานกับเอกสารในรูปแบบต่างๆ +**Q: How can I download Aspose.Words for Java?** +A: You can download Aspose.Words for Java from the Aspose website by following this link: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### ฉันจะดาวน์โหลด Aspose.Words สำหรับ Java ได้อย่างไร? +**Q: What are the benefits of using document shapes?** +A: Document shapes add visual elements and interactivity to your documents, making them more engaging and informative. With shapes, you can create callouts, buttons, images, watermarks, and more, enhancing the overall user experience. -คุณสามารถดาวน์โหลด Aspose.Words สำหรับ Java ได้จากเว็บไซต์ Aspose โดยทำตามลิงก์นี้: [ดาวน์โหลด Aspose.Words สำหรับ Java](https://releases.aspose.com/words/java/) +**Q: Can I customize the appearance of shapes?** +A: Yes, you can customize the appearance of shapes by adjusting their properties such as size, position, rotation, and fill color. Aspose.Words for Java provides extensive options for shape customization. -### การใช้รูปร่างเอกสารมีประโยชน์อะไรบ้าง? +**Q: Is Aspose.Words for Java compatible with SmartArt?** +A: Yes, Aspose.Words for Java supports SmartArt shapes, allowing you to work with complex diagrams and graphics in your documents. -รูปร่างเอกสารเพิ่มองค์ประกอบภาพและการโต้ตอบให้กับเอกสารของคุณ ทำให้เอกสารน่าสนใจและให้ข้อมูลมากขึ้น ด้วยรูปร่าง คุณสามารถสร้างคำอธิบาย ปุ่ม รูปภาพ ลายน้ำ และอื่นๆ เพื่อปรับปรุงประสบการณ์โดยรวมของผู้ใช้ - -### ฉันสามารถปรับแต่งลักษณะของรูปทรงได้ไหม - -ใช่ คุณสามารถปรับแต่งรูปลักษณ์ของรูปร่างได้โดยการปรับคุณสมบัติต่างๆ เช่น ขนาด ตำแหน่ง การหมุน และสีเติม Aspose.Words สำหรับ Java มีตัวเลือกมากมายสำหรับการปรับแต่งรูปร่าง - -### Aspose.Words สำหรับ Java เข้ากันได้กับ SmartArt หรือไม่ - -ใช่ Aspose.Words สำหรับ Java รองรับรูปร่าง SmartArt ช่วยให้คุณสามารถทำงานกับไดอะแกรมและกราฟิกที่ซับซ้อนในเอกสารของคุณได้ +--- +**Last Updated:** 2025-12-14 +**Tested With:** Aspose.Words for Java 24.12 (latest) +**Author:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/turkish/java/document-conversion-and-export/using-document-shapes/_index.md b/words/turkish/java/document-conversion-and-export/using-document-shapes/_index.md index 5460f4f5c..98a3536ad 100644 --- a/words/turkish/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/turkish/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,13 @@ --- -"description": "Aspose.Words for Java'da Belge Şekillerinin Gücünü Açın. Adım Adım Örneklerle Görsel Olarak İlgi Çekici Belgeler Oluşturmayı Öğrenin." -"linktitle": "Belge Şekillerini Kullanma" -"second_title": "Aspose.Words Java Belge İşleme API'si" -"title": "Java için Aspose.Words'de Belge Şekillerini Kullanma" -"url": "/tr/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Aspose.Words for Java ile **görüntü şekli eklemeyi** öğrenin. Bu kılavuz, + şekiller eklemeyi, metin kutusu şekilleri oluşturmayı, şekilleri tablolara yerleştirmeyi, + şekil en‑boy oranını ayarlamayı ve açıklama şekilleri eklemeyi gösterir. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Aspose.Words for Java'da Belge Şekillerini Kullanma +url: /tr/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,23 +16,34 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Java için Aspose.Words'de Belge Şekillerini Kullanma +# Aspose.Words for Java ile **görüntü şekli ekleme** nasıl yapılır +Bu kapsamlı öğreticide, Aspose.Words for Java kullanarak Word belgelerine **görüntü şekli** nesnelerini nasıl ekleyeceğinizi keşfedeceksiniz. Raporlar, pazarlama materyalleri veya etkileşimli formlar oluşturuyor olun, şekiller sayesinde çağrı balonları, düğmeler, metin kutuları, filigranlar ve hatta SmartArt ekleyebilirsiniz. Her adımı adım adım inceleyecek, belirli bir şekli neden kullanmanız gerektiğini açıklayacak ve çalıştırmaya hazır kod parçacıkları sunacağız. -## Java için Aspose.Words'de Belge Şekillerinin Kullanımına Giriş +## Hızlı Yanıtlar +- **Şekil eklemenin temel yolu nedir?** `DocumentBuilder.insertShape` kullanın veya bir `Shape` örneği oluşturup belge ağacına ekleyin. +- **Bir görüntüyü şekil olarak ekleyebilir miyim?** Evet – `builder.insertImage` çağırın ve dönen `Shape`ı diğerleri gibi kullanın. +- **Bir şeklin en‑boy oranını nasıl korursunuz?** İhtiyacınıza göre `shape.setAspectRatioLocked(true)` veya `false` ayarlayın. +- **Şekilleri gruplayabilir miyim?** Kesinlikle – onları bir `GroupShape` içinde sarın ve grubu tek bir düğüm olarak ekleyin. +- **SmartArt diyagramları Aspose.Words ile çalışır mı?** Evet, SmartArt şekillerini programlı olarak tespit edip güncelleyebilirsiniz. -Bu kapsamlı kılavuzda, Java için Aspose.Words'deki belge şekillerinin dünyasına dalacağız. Şekiller, görsel olarak çekici ve etkileşimli belgeler oluşturma konusunda olmazsa olmaz unsurlardır. Açıklamalar, düğmeler, resimler veya filigranlar eklemeniz gerekip gerekmediğine bakılmaksızın, Java için Aspose.Words bunu verimli bir şekilde yapmanız için gereken araçları sağlar. Kaynak kod örnekleriyle bu şekillerin nasıl kullanılacağını adım adım inceleyelim. +## **Görüntü şekli** nedir? +*Görüntü şekli*, bir Word belgesi içinde raster veya vektör grafiklerini tutan görsel bir öğedir. Aspose.Words'ta bir görüntü, `Shape` nesnesiyle temsil edilir ve boyut, konum, döndürme ve kaydırma üzerinde tam kontrol sağlar. -## Belge Şekillerine Başlarken +## Belgelerinizde Şekilleri Neden Kullanmalısınız? +- **Görsel etki:** Şekiller, önemli bilgilere çeker. +- **Etkileşim:** Düğmeler ve çağrı balonları URL'lere veya yer imlerine bağlanabilir. +- **Düzen esnekliği:** Grafiklerin konumunu mutlak veya göreceli koordinatlarla hassas bir şekilde ayarlayın. +- **Otomasyon:** Manuel düzenleme yapmadan karmaşık düzenler oluşturun. -Koda geçmeden önce ortamımızı ayarlayalım. Projenize Aspose.Words for Java'nın entegre olduğundan emin olun. Eğer henüz entegre etmediyseniz, Aspose web sitesinden indirebilirsiniz [Java için Aspose.Words'ü indirin](https://releases.aspose.com/words/java/) +## Önkoşullar +- Java Development Kit (JDK 8 ve üzeri) +- Aspose.Words for Java kütüphanesi (resmi siteden indirin) +- Java ve nesne‑yönelimli programlama hakkında temel bilgi -## Belgelere Şekil Ekleme - -### Bir GroupShape Ekleme - -A `GroupShape` birden fazla şekli bir arada gruplamanıza olanak tanır. İşte bir şekli nasıl oluşturabileceğiniz ve ekleyebileceğiniz `GroupShape`: +You can download the library here: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) +## **Şekil ekleme** – GroupShape ekleme ```java Document doc = new Document(); doc.ensureMinimum(); @@ -58,10 +72,7 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Bir Metin Kutusu Şekli Ekleme - -Bir metin kutusu şekli eklemek için şunu kullanabilirsiniz: `insertShape` Aşağıdaki örnekte gösterildiği gibi bir yöntem: - +## **Metin kutusu şekli** oluşturma ```java Document doc = new Document(); DocumentBuilder builder = new DocumentBuilder(doc); @@ -81,12 +92,7 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Şekil Özelliklerini Düzenleme - -### En Boy Oranını Yönetme - -Bir şeklin en boy oranının kilitli olup olmadığını kontrol edebilirsiniz. Bir şeklin en boy oranının kilidini açma yöntemi şöyledir: - +## **Şekil en‑boy oranını** ayarlama ```java Document doc = new Document(); DocumentBuilder builder = new DocumentBuilder(doc); @@ -97,10 +103,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Bir Tablo Hücresine Şekil Yerleştirme - -Bir tablo hücresinin içine bir şekil yerleştirmeniz gerekiyorsa, bunu aşağıdaki kodla yapabilirsiniz: - +## **Şekli tabloya yerleştirme** +Bir şekli tablo hücresine yerleştirmek, rapor düzenleri için kullanışlı olabilir. Aşağıdaki örnek bir tablo oluşturur ve ardından tüm sayfayı kaplayan bir filigran‑stili şekli ekler. ```java Document doc = new Document(); DocumentBuilder builder = new DocumentBuilder(doc); @@ -122,7 +126,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // Şekil bir hücreye yerleştirilecekse, onu tablo hücresinin dışında görüntüle. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,12 +147,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` +## **Çağrı balonu şekli** ekleme +Bir çağrı balonu şekli, notları veya uyarıları vurgulamak için mükemmeldir. Yukarıdaki kod zaten bir `ACCENT_BORDER_CALLOUT_1` gösteriyor, ancak `ShapeType`ı tasarımınıza uygun herhangi bir çağrı balonu çeşidine değiştirebilirsiniz. + ## SmartArt Şekilleriyle Çalışma ### SmartArt Şekillerini Algılama - -Aşağıdaki kodu kullanarak bir belgedeki SmartArt şekillerini tespit edebilirsiniz: - +SmartArt diyagramları programlı olarak tespit edilebilir, böylece gerektiğinde işleyebilir veya değiştirebilirsiniz. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); List shapes = IterableUtils.toList(doc.getChildNodes(NodeType.SHAPE, true)); @@ -157,9 +162,7 @@ System.out.println("The document has " + count + " shapes with SmartArt."); ``` ### SmartArt Çizimlerini Güncelleme - -Bir belgedeki SmartArt çizimlerini güncellemek için aşağıdaki kodu kullanın: - +Algılandıktan sonra, SmartArt grafiklerini veri değişikliklerini yansıtacak şekilde yenileyebilirsiniz. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { @@ -168,39 +171,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Çözüm - -Bu kılavuzda, Java için Aspose.Words'deki belge şekillerinin dünyasını keşfettik. Belgelerinize çeşitli şekiller eklemeyi, özelliklerini düzenlemeyi ve SmartArt şekilleriyle çalışmayı öğrendiniz. Bu bilgiyle, görsel olarak çekici ve etkileşimli belgeleri kolaylıkla oluşturabilirsiniz. - -## SSS - -### Java için Aspose.Words nedir? +## Yaygın Sorunlar ve İpuçları +- **Şekil görünmüyor:** `builder.insertNode` kullanarak şeklin hedef düğümden sonra eklendiğinden emin olun. +- **Beklenmeyen döndürme:** Döndürmenin şeklin merkezine göre uygulandığını unutmayın; gerekirse `setLeft`/`setTop` ayarlayın. +- **En‑boy oranı kilitli:** Varsayılan olarak, birçok şekil en‑boy oranını kilitler; serbestçe uzatmak için `setAspectRatioLocked(false)` çağırın. +- **SmartArt algılaması başarısız:** SmartArt'ı destekleyen bir Aspose.Words sürümü (v24+) kullandığınızdan emin olun. -Aspose.Words for Java, geliştiricilerin Word belgelerini programatik olarak oluşturmasına, değiştirmesine ve dönüştürmesine olanak tanıyan bir Java kütüphanesidir. Çeşitli formatlardaki belgelerle çalışmak için geniş bir yelpazede özellikler ve araçlar sunar. +## Sık Sorulan Sorular -### Aspose.Words for Java'yı nasıl indirebilirim? +**S: Aspose.Words for Java nedir?** +A: Aspose.Words for Java, geliştiricilerin Word belgelerini programlı olarak oluşturmasına, değiştirmesine ve dönüştürmesine olanak tanıyan bir Java kütüphanesidir. Çeşitli formatlarda belgelerle çalışmak için geniş özellik ve araç seti sunar. -Aspose.Words for Java'yı Aspose web sitesinden şu bağlantıyı takip ederek indirebilirsiniz: [Java için Aspose.Words'ü indirin](https://releases.aspose.com/words/java/) +**S: Aspose.Words for Java nasıl indirilebilir?** +A: Aspose.Words for Java'ı Aspose web sitesinden şu bağlantıyı izleyerek indirebilirsiniz: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Belge şekillerini kullanmanın faydaları nelerdir? +**S: Belge şekilleri kullanmanın faydaları nelerdir?** +A: Belge şekilleri, belgelere görsel öğeler ve etkileşim ekleyerek daha çekici ve bilgilendirici olmalarını sağlar. Şekillerle çağrı balonları, düğmeler, görüntüler, filigranlar ve daha fazlasını oluşturabilir, genel kullanıcı deneyimini artırabilirsiniz. -Belge şekilleri belgelerinize görsel öğeler ve etkileşim ekleyerek onları daha ilgi çekici ve bilgilendirici hale getirir. Şekillerle açıklamalar, düğmeler, resimler, filigranlar ve daha fazlasını oluşturarak genel kullanıcı deneyimini geliştirebilirsiniz. +**S: Şekillerin görünümünü özelleştirebilir miyim?** +A: Evet, şekillerin boyut, konum, döndürme ve dolgu rengi gibi özelliklerini ayarlayarak görünümünü özelleştirebilirsiniz. Aspose.Words for Java, şekil özelleştirme için kapsamlı seçenekler sunar. -### Şekillerin görünümünü özelleştirebilir miyim? +**S: Aspose.Words for Java SmartArt ile uyumlu mu?** +A: Evet, Aspose.Words for Java SmartArt şekillerini destekler ve belgelerinizde karmaşık diyagramlar ve grafiklerle çalışmanıza olanak tanır. -Evet, şekillerin boyut, konum, dönüş ve dolgu rengi gibi özelliklerini ayarlayarak görünümlerini özelleştirebilirsiniz. Java için Aspose.Words, şekil özelleştirme için kapsamlı seçenekler sunar. - -### Aspose.Words for Java SmartArt ile uyumlu mudur? - -Evet, Aspose.Words for Java SmartArt şekillerini destekler ve belgelerinizde karmaşık diyagramlar ve grafiklerle çalışmanıza olanak tanır. +--- +**Son Güncelleme:** 2025-12-14 +**Test Edilen:** Aspose.Words for Java 24.12 (en son) +**Yazar:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/vietnamese/java/document-conversion-and-export/using-document-shapes/_index.md b/words/vietnamese/java/document-conversion-and-export/using-document-shapes/_index.md index 6634dc645..6fd131f32 100644 --- a/words/vietnamese/java/document-conversion-and-export/using-document-shapes/_index.md +++ b/words/vietnamese/java/document-conversion-and-export/using-document-shapes/_index.md @@ -1,10 +1,13 @@ --- -"description": "Mở khóa sức mạnh của hình dạng tài liệu trong Aspose.Words cho Java. Học cách tạo tài liệu hấp dẫn trực quan với các ví dụ từng bước." -"linktitle": "Sử dụng hình dạng tài liệu" -"second_title": "API xử lý tài liệu Java Aspose.Words" -"title": "Sử dụng Document Shapes trong Aspose.Words cho Java" -"url": "/vi/java/document-conversion-and-export/using-document-shapes/" -"weight": 14 +date: 2025-12-14 +description: Tìm hiểu cách **chèn hình ảnh dạng shape** bằng Aspose.Words cho Java. + Hướng dẫn này chỉ cho bạn cách thêm các shape, tạo các shape hộp văn bản, đặt shape + vào bảng, thiết lập tỷ lệ khung hình của shape và thêm các shape chú thích. +linktitle: Using Document Shapes +second_title: Aspose.Words Java Document Processing API +title: Sử dụng các hình dạng tài liệu trong Aspose.Words cho Java +url: /vi/java/document-conversion-and-export/using-document-shapes/ +weight: 14 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,22 +16,35 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Sử dụng Document Shapes trong Aspose.Words cho Java +# Cách **chèn hình ảnh dạng shape** với Aspose.Words for Java +Trong hướng dẫn toàn diện này, bạn sẽ khám phá cách **chèn hình ảnh dạng shape** vào tài liệu Word bằng Aspose.Words for Java. Dù bạn đang tạo báo cáo, tài liệu marketing, hay biểu mẫu tương tác, các shape cho phép bạn thêm callout, nút bấm, hộp văn bản, watermark và thậm chí SmartArt. Chúng tôi sẽ hướng dẫn từng bước, giải thích lý do sử dụng mỗi loại shape, và cung cấp các đoạn mã sẵn sàng chạy. -## Giới thiệu về cách sử dụng Document Shapes trong Aspose.Words cho Java +## Trả lời nhanh +- **Cách chính để thêm một shape là gì?** Sử dụng `DocumentBuilder.insertShape` hoặc tạo một thể hiện `Shape` và thêm nó vào cây tài liệu. +- **Tôi có thể chèn hình ảnh dưới dạng shape không?** Có – gọi `builder.insertImage` rồi xử lý `Shape` trả về như bất kỳ shape nào khác. +- **Làm sao để giữ tỷ lệ khung hình của shape?** Đặt `shape.setAspectRatioLocked(true)` hoặc `false` tùy nhu cầu. +- **Có thể nhóm các shape lại với nhau không?** Chắc chắn – bọc chúng trong một `GroupShape` và chèn nhóm như một nút duy nhất. +- **Các sơ đồ SmartArt có hoạt động với Aspose.Words không?** Có, bạn có thể phát hiện và cập nhật các shape SmartArt bằng chương trình. -Trong hướng dẫn toàn diện này, chúng ta sẽ đi sâu vào thế giới hình dạng tài liệu trong Aspose.Words for Java. Hình dạng là yếu tố thiết yếu khi tạo tài liệu hấp dẫn về mặt thị giác và tương tác. Cho dù bạn cần thêm chú thích, nút, hình ảnh hay hình mờ, Aspose.Words for Java đều cung cấp các công cụ để thực hiện hiệu quả. Hãy cùng khám phá cách sử dụng các hình dạng này từng bước với các ví dụ về mã nguồn. +## **insert image shape** là gì? +*Image shape* là một thành phần trực quan chứa đồ họa raster hoặc vector trong tài liệu Word. Trong Aspose.Words, hình ảnh được biểu diễn bằng một đối tượng `Shape`, cho phép bạn kiểm soát hoàn toàn kích thước, vị trí, góc quay và cách bọc. -## Bắt đầu với Hình dạng Tài liệu +## Tại sao nên sử dụng shape trong tài liệu? +- **Tác động thị giác:** Shape thu hút sự chú ý tới thông tin quan trọng. +- **Tính tương tác:** Nút bấm và callout có thể liên kết tới URL hoặc bookmark. +- **Linh hoạt bố cục:** Đặt đồ họa một cách chính xác bằng tọa độ tuyệt đối hoặc tương đối. +- **Tự động hoá:** Tạo bố cục phức tạp mà không cần chỉnh sửa thủ công. -Trước khi bắt đầu code, hãy thiết lập môi trường của chúng ta. Đảm bảo bạn đã tích hợp Aspose.Words for Java vào dự án của mình. Nếu bạn chưa có, bạn có thể tải xuống từ trang web Aspose [Tải xuống Aspose.Words cho Java](https://releases.aspose.com/words/java/) +## Yêu cầu trước +- Java Development Kit (JDK 8 hoặc cao hơn) +- Thư viện Aspose.Words for Java (tải về từ trang chính thức) +- Kiến thức cơ bản về Java và lập trình hướng đối tượng -## Thêm hình dạng vào tài liệu +Bạn có thể tải thư viện tại đây: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Chèn GroupShape - -MỘT `GroupShape` cho phép bạn nhóm nhiều hình dạng lại với nhau. Sau đây là cách bạn có thể tạo và chèn một `GroupShape`: +## Cách **thêm shape** – Chèn một GroupShape +`GroupShape` cho phép bạn xử lý nhiều shape như một đơn vị duy nhất. Điều này hữu ích khi di chuyển hoặc định dạng đồng thời nhiều phần tử. ```java Document doc = new Document(); @@ -58,9 +74,8 @@ builder.insertNode(groupShape); doc.save("Your Directory Path" + "WorkingWithShapes.AddGroupShape.docx"); ``` -### Chèn hình hộp văn bản - -Để chèn hình hộp văn bản, bạn có thể sử dụng `insertShape` phương pháp như thể hiện trong ví dụ dưới đây: +## Tạo **shape hộp văn bản** +Hộp văn bản là một container có thể chứa văn bản đã định dạng. Bạn cũng có thể xoay nó để tạo hiệu ứng động. ```java Document doc = new Document(); @@ -81,11 +96,8 @@ saveOptions.setCompliance(OoxmlCompliance.ISO_29500_2008_TRANSITIONAL); doc.save("Your Directory Path" + "WorkingWithShapes.InsertShape.docx", saveOptions); ``` -## Thao tác các thuộc tính hình dạng - -### Quản lý tỷ lệ khung hình - -Bạn có thể kiểm soát tỷ lệ khung hình của một hình dạng có bị khóa hay không. Sau đây là cách mở khóa tỷ lệ khung hình của một hình dạng: +## Đặt **tỷ lệ khung hình của shape** +Đôi khi bạn muốn shape tự do kéo dài, đôi khi lại muốn giữ nguyên tỉ lệ gốc. Kiểm soát tỷ lệ khung hình rất đơn giản. ```java Document doc = new Document(); @@ -97,9 +109,8 @@ shape.setAspectRatioLocked(false); doc.save("Your Directory Path" + "WorkingWithShapes.AspectRatioLocked.docx"); ``` -### Đặt một hình dạng vào một ô trong bảng - -Nếu bạn cần đặt một hình dạng bên trong ô của bảng, bạn có thể thực hiện điều này bằng đoạn mã sau: +## Đặt **shape vào bảng** +Nhúng shape vào ô bảng có thể hữu ích cho bố cục báo cáo. Ví dụ dưới đây tạo một bảng và chèn một shape kiểu watermark phủ toàn trang. ```java Document doc = new Document(); @@ -122,7 +133,7 @@ builder.endTable(); Shape watermark = new Shape(doc, ShapeType.TEXT_PLAIN_TEXT); watermark.setRelativeHorizontalPosition(RelativeHorizontalPosition.PAGE); watermark.setRelativeVerticalPosition(RelativeVerticalPosition.PAGE); -watermark.isLayoutInCell(true); // Hiển thị hình dạng bên ngoài ô của bảng nếu nó sẽ được đặt vào trong ô. +watermark.isLayoutInCell(true); // Display the shape outside of the table cell if it will be placed into a cell. watermark.setWidth(300.0); watermark.setHeight(70.0); watermark.setHorizontalAlignment(HorizontalAlignment.CENTER); @@ -143,11 +154,13 @@ doc.getCompatibilityOptions().optimizeFor(MsWordVersion.WORD_2010); doc.save("Your Directory Path" + "WorkingWithShapes.LayoutInCell.docx"); ``` -## Làm việc với các hình dạng SmartArt +## Thêm **shape callout** +Shape callout hoàn hảo để làm nổi bật ghi chú hoặc cảnh báo. Mặc dù đoạn mã trên đã minh họa `ACCENT_BORDER_CALLOUT_1`, bạn có thể thay đổi `ShapeType` sang bất kỳ biến thể callout nào phù hợp với thiết kế. -### Phát hiện hình dạng SmartArt +## Làm việc với Shape SmartArt -Bạn có thể phát hiện các hình dạng SmartArt trong tài liệu bằng cách sử dụng mã sau: +### Phát hiện Shape SmartArt +Các sơ đồ SmartArt có thể được xác định bằng chương trình, cho phép bạn xử lý hoặc thay thế chúng khi cần. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -157,8 +170,7 @@ System.out.println("The document has " + count + " shapes with SmartArt."); ``` ### Cập nhật bản vẽ SmartArt - -Để cập nhật bản vẽ SmartArt trong tài liệu, hãy sử dụng mã sau: +Sau khi phát hiện, bạn có thể làm mới đồ họa SmartArt để phản ánh bất kỳ thay đổi dữ liệu nào. ```java Document doc = new Document("Your Directory Path" + "SmartArt.docx"); @@ -168,39 +180,39 @@ for (Shape shape : (Iterable) doc.getChildNodes(NodeType.SHAPE, true)) { } ``` -## Phần kết luận - -Trong hướng dẫn này, chúng tôi đã khám phá thế giới hình dạng tài liệu trong Aspose.Words for Java. Bạn đã học cách thêm nhiều hình dạng khác nhau vào tài liệu của mình, thao tác các thuộc tính của chúng và làm việc với các hình dạng SmartArt. Với kiến thức này, bạn có thể dễ dàng tạo các tài liệu hấp dẫn về mặt thị giác và tương tác. +## Các vấn đề thường gặp & Mẹo +- **Shape không hiển thị:** Đảm bảo shape được chèn sau nút mục tiêu bằng `builder.insertNode`. +- **Xoay không mong muốn:** Nhớ rằng việc xoay được thực hiện quanh trung tâm của shape; điều chỉnh `setLeft`/`setTop` nếu cần. +- **Tỷ lệ khung hình bị khóa:** Mặc định, nhiều shape khóa tỷ lệ; gọi `setAspectRatioLocked(false)` để kéo dài tự do. +- **Phát hiện SmartArt thất bại:** Kiểm tra bạn đang dùng phiên bản Aspose.Words hỗ trợ SmartArt (v24+). ## Câu hỏi thường gặp -### Aspose.Words dành cho Java là gì? +**Hỏi: Aspose.Words for Java là gì?** +Đáp: Aspose.Words for Java là một thư viện Java cho phép các nhà phát triển tạo, sửa đổi và chuyển đổi tài liệu Word một cách lập trình. Nó cung cấp một loạt các tính năng và công cụ để làm việc với tài liệu ở nhiều định dạng. -Aspose.Words for Java là một thư viện Java cho phép các nhà phát triển tạo, sửa đổi và chuyển đổi các tài liệu Word theo chương trình. Nó cung cấp nhiều tính năng và công cụ để làm việc với các tài liệu ở nhiều định dạng khác nhau. +**Hỏi: Làm sao để tải Aspose.Words for Java?** +Đáp: Bạn có thể tải Aspose.Words for Java từ trang web Aspose bằng liên kết này: [Download Aspose.Words for Java](https://releases.aspose.com/words/java/) -### Làm thế nào tôi có thể tải xuống Aspose.Words cho Java? +**Hỏi: Lợi ích của việc sử dụng shape trong tài liệu là gì?** +Đáp: Shape bổ sung các yếu tố trực quan và tính tương tác cho tài liệu, làm cho chúng hấp dẫn và thông tin hơn. Với shape, bạn có thể tạo callout, nút bấm, hình ảnh, watermark và nhiều hơn nữa, nâng cao trải nghiệm người dùng. -Bạn có thể tải xuống Aspose.Words cho Java từ trang web Aspose bằng cách nhấp vào liên kết này: [Tải xuống Aspose.Words cho Java](https://releases.aspose.com/words/java/) +**Hỏi: Tôi có thể tùy chỉnh giao diện của shape không?** +Đáp: Có, bạn có thể tùy chỉnh giao diện của shape bằng cách điều chỉnh các thuộc tính như kích thước, vị trí, góc quay và màu nền. Aspose.Words for Java cung cấp nhiều tùy chọn để tùy biến shape. -### Lợi ích của việc sử dụng hình dạng tài liệu là gì? +**Hỏi: Aspose.Words for Java có hỗ trợ SmartArt không?** +Đáp: Có, Aspose.Words for Java hỗ trợ các shape SmartArt, cho phép bạn làm việc với các sơ đồ và đồ họa phức tạp trong tài liệu. -Hình dạng tài liệu thêm các yếu tố trực quan và tính tương tác vào tài liệu của bạn, khiến chúng hấp dẫn và nhiều thông tin hơn. Với hình dạng, bạn có thể tạo chú thích, nút, hình ảnh, hình mờ, v.v., nâng cao trải nghiệm chung của người dùng. - -### Tôi có thể tùy chỉnh giao diện của hình dạng không? - -Có, bạn có thể tùy chỉnh giao diện của hình dạng bằng cách điều chỉnh các thuộc tính của chúng như kích thước, vị trí, xoay và tô màu. Aspose.Words for Java cung cấp nhiều tùy chọn để tùy chỉnh hình dạng. - -### Aspose.Words cho Java có tương thích với SmartArt không? - -Có, Aspose.Words for Java hỗ trợ các hình dạng SmartArt, cho phép bạn làm việc với các sơ đồ và đồ họa phức tạp trong tài liệu của mình. +--- +**Cập nhật lần cuối:** 2025-12-14 +**Đã kiểm tra với:** Aspose.Words for Java 24.12 (phiên bản mới nhất) +**Tác giả:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - {{< blocks/products/products-backtop-button >}} \ No newline at end of file