Optimize 23 Words Java pages

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<Shape>) 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 >}}