الاستخدام `DocumentBuilder` إلى العناصر الواردة في الوثيقة

The DocumentBuilder يُستخدم لتعديل الوثائق. وتشرح هذه المادة وتصف كيفية أداء عدد من المهام.

وضع مجموعة من النصوص

ببساطة تمرر سلسلة النصوص التي تحتاج إلى إدخالها في الوثيقة إلى [DocumentBuilder.write](https://reference.aspose.com/words/java/com.aspose.words/documentbuilder/#write(java.lang.String)طريقة يُحدَّد إعداد النصوص بواسطة Font ملكية ويحتوي هذا الجسم على خصائص مختلفة (الاسم العنيف، وحجم الفونت، واللون، وما إلى ذلك). Some important font attributes are also represented by DocumentBuilder العقارات للسماح لك بالدخول مباشرة هذه ممتلكات بوليان Font.getBold, Font.getItalic, و Font.getUnderline.

The following code example Inserts formatted text using DocumentBuilder.

إدراج فقرة

وتدرج الوثيقة أيضاً سلسلة من النصوص في الوثيقة، ولكنها تضيف أيضاً استراحة فقرة. ويحدّد هيكل الوثائق الحالي أيضا. الحصول على وتُحدَّد الممتلكات الفوتوغرافية وصيغة الفقرة الحالية بممتلكات هيئة الأوراق المالية

ويبين المثال الرمزي التالي كيفية إدراج فقرة في الوثيقة.

إدراج جدول

الخوارزمية الأساسية لخلق طاولة باستخدام DocumentBuilder بسيط:

1 شغل الطاولة باستخدام DocumentBuilder.startTable. 1 Insert a cell using DocumentBuilder.insertCell. هذا يبدأ تلقائياً صف جديد عند الحاجة، استخدام DocumentBuilder.getCellFormat الممتلكات لتحديد شكل الخلايا. 1 محتويات الزنزانة باستخدام DocumentBuilder طرق 1 اكرر الخطين 2 و 3 حتى يكتمل الصف 1 اتصل DocumentBuilder.endRow لإنهاء الصف الحالي عند الحاجة، استخدام DocumentBuilder.RowFormat الممتلكات لتحديد شكل الصف. 1 أكرر الخطوات 2-5 حتى تكتمل الطاولة 1 اتصل DocumentBuilder.endTable لإنهاء بناء الطاولة ويرد أدناه وصف لأساليب وضع جداول الوثائق المناسبة.

بدء الجدول

استدعاء الوثائق الجدول هو الخطوة الأولى في بناء طاولة ويمكن أيضاً أن يُدعى داخل زنزانة، وفي هذه الحالة، يبدأ طاولة محروقة. الطريقة التالية للإتصال هي (وثب بويلدر)

“إرسال خلية”

(بعد أن تتصل بـ(وثب بويلدر يدرج ما يلي: سيل، تم إنشاء خلية جديدة وأي محتوى تضيفه باستخدام أساليب أخرى DocumentBuilder سيضاف الفصل إلى الزنزانة الحالية لبدء زنزانة جديدة في نفس الصف، استدعاء الوثائق. يدرج ما يلي: سيل مرة أخرى. (استخدموا (الوثيقة (بويلدر Format property to specify cell formatting. إنه يعود getCellFormat الجسم الذي يمثل كل شكل لخلية طاولة

ينتهي به المطاف

اتصل بالوثيقة انحنوا لإنهاء الصف الحالي (إذا اتصلت بـ(وثبويلدر يدرج ما يلي: الخلية بعد ذلك مباشرة، ثم يستمر الجدول على صف جديد. استخدام DocumentBuilder.RowFormat الممتلكات لتحديد شكل الصف. إنه يعود RowFormat شيء يمثل كل شكل لصف طاولة

نهاية الجدول

اتصل بالوثيقة طاولة لإنهاء الجدول الحالي This method should be called only once after DocumentBuilder. (إندرو) تم استدعائه (عندما اتصل (وثب بويلدر الجدول يُنقل الستار من الخلية الحالية إلى موقع بعد الطاولة مباشرة ويبيّن المثال التالي كيفية بناء جدول مهيأ يتضمن صفين وعمودين.

اكسر

إذا كنت تريد أن تبدأ صراحة خط جديد، الفقرة، العمود، الفرع، أو الصفحة، الاتصال الوثيقة. أدخل (بريك) مرر لهذه الطريقة نوع الكسر الذي تحتاجه لتضيفه BreakType العد ويبين المثال الرمزي التالي كيفية إدخال الصفحات إلى وثيقة.

ازرع صورة

تقدم الوثيقة عدة تحميلات زائدة DocumentBuilder.insertImage الطريقة التي تسمح لك بإضافة صورة خطية أو عائمة وإذا كانت الصورة هي مصفوفة من طراز EMF أو من طراز WMF، فإنها ستدرج في الوثيقة في شكل مصفوف. جميع الصور الأخرى سيتم تخزينها في شكل PNG. The DocumentBuilder.insert ويمكن أن تستخدم طريقة التصوير الصور من مصادر مختلفة:

-من ملف أو URL عن طريق تمرير بارامتر الخيط

  • مِنْ مجرىِ عبر مرور Stream بارامتر
  • مِنْ جسمِ ذخيرةِ بالمرور مُعْبرةِ ذرةِ
  • من صفيحة طرفية عن طريق تمرير بارامتر صفيفة
  • والآخرون

لكل من مكتب الوثائق يدرج ما يلي: طرق التصوير، هناك المزيد من الحمولات مما يسمح لك بإدخال صورة مع الخيارات التالية:

  • خط أو عائم في موقع محدد
  • النسبة المئوية للحجم أو العرف

Furthermore, the DocumentBuilder.insert طريقة التصوير تعود Shape الشيء الذي تم خلقه و إدخاله حتى تتمكن من تعديل خصائص الشيب

Inserting an Inline Image

مرر سلسلة واحدة تمثل ملفاً يحتوي على صورة لـ(وثب بويلدر) يدرج ما يلي: تخيل أن تُدرج الصورة في الوثيقة كرسوم بيانية خطية. ويبين المثال الرمزي التالي كيفية إدخال صورة خطية في موقع الضمائر في وثيقة.

Inserting a Floating (Absolutely Positioned) Image

This example inserts a floating image from a file or URL بموقع وحجم محددين.

وضع علامة كتاب

ولإدراج علامة في الوثيقة، ينبغي أن تقوموا بما يلي:

1 اتصل DocumentBuilder.startBookmark نعطيه الاسم المنشود من علامة الكتاب 1 يدرج نص علامة الكتاب باستخدام DocumentBuilder طرق 1 اتصل DocumentBuilder.endBookmark تمريرها نفس الاسم الذي استخدمته مع (وثبويلدر)

ويمكن للعلامات الكتابية أن تتداخل وتمتد على أي نطاق. لخلق معلومة كتابية صحيحة يجب أن تدعوا كل من (وثبويلدر) و (وثبلوكمارك) و (أود بوكمارك)

وسوف يتم تجاهل العلامات الكتابية البشعة أو العلامات الدفترية ذات الأسماء المزدوجة عندما يتم حفظ الوثيقة.

ويبيّن المثال الرمزي التالي كيفية إدراج علامة كتاب في وثيقة تستخدم مبني وثائق.

إدخال حقل

الحقول في Microsoft Word وتتألف الوثائق من مدونة ميدانية ونتيجة ميدانية. الرمز الميداني مثل صيغة والنتيجة الميدانية هي القيمة التي تنتجها الصيغة ويمكن أن تتضمن المدونة الميدانية أيضا مفاتيح تحويل ميدانية هي تعليمات إضافية للقيام بعمل محدد. يمكنك التحول بين عرض الرموز الميدانية والنتائج في وثيقتك Microsoft Word (أ) تُظهر الرموز الميدانية بين حمالات العجلات (ألت + واو-9) { } ) DocumentBuilder.insertField إنشاء ميادين في الوثيقة. عليك تحديد نوع ميداني، رمز ميداني وقيمة ميدانية إن لم تكن واثقاً بشأن (سينتاكس) المُحدد، فخلق الحقل Microsoft Word أولاً وبدلاً لرؤية رمزها الميداني The following code example inserts a merge field into a document using DocumentBuilder.

قذف Form الميدان

حقول الاستمارة هي حالة معينة من حقول الكلمات التي تسمح “التفاعل” مع المستخدم. حقول الاستمارة Microsoft Word تشمل صندوق النص، صندوق كومبو بوكس، وجهاز تحقق. وتوفِّر الوثيقة طرائق خاصة لإدراج كل نوع من مجالات الشكل في الوثيقة: DocumentBuilder.insertTextInput .. DocumentBuilder.insertCheckBox, و DocumentBuilder.insertComboBox. ملاحظة أنه إذا حددتم اسماً لميدان الاستمارة، فإن علامة كتابية تُنشأ تلقائياً بنفس الاسم.

Inserting a Text Input

DocumentBuilder.insertTextInput to insert a textbox into the document. ويبيّن المثال الرمزي التالي كيفية إدراج شكل مدخلات نصية في وثيقة ما.

قذف CheckBox

اتصل بـ(وثب بويلدر) تأكّدْ بوكس لإدْراج a صندوق شيك إلى الوثيقةِ. ويبيّن المثال الرمزي التالي كيفية إدراج حقل نموذجي في وثيقة.

اضافة صندوق كومبو

اتصل بـ(وثب بويلدر)ComboBox لإدراج صندوق مدمج في الوثيقة ويوضح المثال الرمزي التالي كيفية إدراج حقل في شكل صندوق كومبو في وثيقة.

Inserting Locale at Field Level

يمكن أن يحدد الزبائن محلية على المستوى الميداني الآن ويمكنها تحقيق سيطرة أفضل. المحلية يمكن ربط الأقراص بكل حقل داخل مبنى الوثائق وتوضح الأمثلة الواردة أدناه كيفية الاستفادة من هذا الخيار.

Inserting HTML

يُمكنك بسهولة أن تُدرِج خِطّة “إتش تي إل” تحتوي على شظية “إتش تي إل” أو وثيقة “إتش تي إل” كاملة في الوثيقة فقط مرر هذه الخيطه إلى “الوثيقة” يدرج ما يلي: طريقة هتمل ومن بين التنفيذات المفيدة لهذه الطريقة تخزين سلسلة HTML في قاعدة بيانات وإدخالها في الوثيقة أثناءها mail merge للحصول على المحتوى الشكلي مضافاً بدلاً من بناءه باستخدام مختلف أساليب بناء الوثائق. The following code example shows inserts HTML into a document using DocumentBuilder.

“إرسال “هايبرلينك

Use DocumentBuilder.insertHyperlink to insert a hyperlink into the document. This method accepts three parameters: text of the link to be displayed in the document, link destination (URL or a name of a bookmark inside the document), and a boolean parameter that should be true إذا URL هو اسم علامة كتاب داخل الوثيقة. (وثب بويلدر) يُدعى (هايبرلينك) داخلياً (وثب بويلدر) The method always adds trophes at the beginning and end of the URL. ملاحظة أن عليك أن تحدد الشكل الخطي لنص عرض الوصلة الفائقة Font ملكية The following code example inserts a hyperlink into a document using DocumentBuilder.

إدراج جدول المحتويات

يمكنك إدخال TOC (جدول المحتويات) الحقل في الوثيقة في الموقع الحالي بدعوة DocumentBuilder.insertTableOfContents طريقة The DocumentBuilder.insertTableOfContents method will only insert a TOC الحق في الوثيقة. من أجل بناء طاولة المحتويات وعرضها حسب عدد الصفحات Document.UpdateFieldsويجب أن تُستدعى الطريقة بعد إدخال الحقل. ويبيّن المثال الرمزي التالي كيفية إدراج جدول للمجال في وثيقة ما.

الهدف الأول

إذا كنت تريد Ole Object call DocumentBuilder.insertOleObjectAsIcon.

تحديد اسم الملف وتمديده عند إدراج موضوع أولي

حزمة الـ(أولي) هي إرث وطريقة “غير موثقة” لتخزين الأشياء المدمجة إذا كان (أولي) غير معروف مرحلة مبكرة Windows صيغ مثل Windows 3.1, 95 and 98 had Packager. تطبيق يمكن استخدامه لإدراج أي نوع من البيانات في الوثيقة. الآن، هذا الطلب مستبعد من Windows لكن (إم إس وورد) والتطبيقات الأخرى ما زالت تستخدمها لتصنيف البيانات إذا كان معالج (أولي) مفقوداً أو غير معروف الطبقة الراقية تسمح بالوصول إلى خواص التعبئة The following code example shows how to set the file name, extension and display name for OLE Package.

الحصول على الوصول إلى بيانات الجسم OLE

المثال الرمزي التالي يُظهر كيف يُصبحُ OLE بيانات أولية مستعملة OleFormat.GetRawData() الطريقة.

Insert Horizontal القاعدة في الوثيقة

ويبين المثال الرمزي التالي كيفية إدخال شكل القواعد الأفقية في وثيقة تستخدم DocumentBuilder.InsertHorizontalRule طريقة

العمل مع شابيس

Inserting Inline and Free-floating Shapes

يمكنك أن تدرج شكلاً خطياً مع نوع وحجم محددين وشكلاً مجانياً مع الموقع المحدد وحجم وغطاء النص في وثيقة تستخدم DocumentBuilder.InsertShape طريقة The DocumentBuilder.InsertShape ويسمح هذا الأسلوب بإدخال شكل DML في نموذج الوثيقة. The document must be save in the format, which support DML shapes, otherwise such nodes will be converted to VML shape, while documentving. ويبين المثال الرمزي التالي كيفية إدراج هذه الأنواع من الأشكال في الوثيقة.

Create Snip Corner Rectangle

يُمْكِنُ أَنْ تَجْعلَ a تنازل زاويةِ مِنْ خلال Aspose.Words. (الشكل هو (فردكورنر سنيبل (توبكورنر) مُخزّر، (دياغونال كورنر) مُخدّر، (توبكورنرسون) واحد مُقَرَّب، واحد مُنْزَعُ، مُجَرَّد، مُتَجَرَّدُ مُتَوَقَّدَ، وضَعَةَ دياغونالCorners. The DML shape is created using DocumentBuilder.InsertShape طريقة بهذه الأشكال ولا يمكن استخدام هذه الأنواع لخلق أشكال العنف ضد المرأة. محاولة لخلق شكل من خلال استخدام المبني العام لفئة “الشاب” يرفع استثناء “الإستعراض غير المُناسب” ويبين المثال الرمزي التالي كيفية إدراج هذه الأنواع من الأشكال في الوثيقة.

سلاسل استيراد مع ماث إكس إم إل في DOM

يمكنك استخدام LoadOptions.ConvertShapeToOfficeMath الممتلكات لتحويل الأشكال مع المعادل XML إلى أشياء الرياضيات المكتبية. وتقابل القيمة الافتراضية لهذه الممتلكات سلوكاً من نوع MS Word i.e. shapes with equation XML لا تُحوَّل إلى أغراض الرياضيات في المكتب.