تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class Document

تمثيل لمستند XML

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`addContent(content)`	`Document`	إلحاق العقدة المحدّدة بنهاية المستند
`addContent(index, content)`	`Document`	تُدرج هذه الوظيفة العقدة المحدّدة في الفهرس المحدّد بين جميع العقد التي هي عناصر ثانوية مباشرة للمستند.
`cloneContent()`	`Content[]`	تُنشئ هذه العملية نُسخًا غير مرفقة من جميع العقد التي هي عناصر فرعية مباشرة للمستند.
`detachRootElement()`	`Element`	تُزيل عقدة `Element` الجذر للمستند وتُعيدها.
`getAllContent()`	`Content[]`	تحصل على جميع العقد التي هي عناصر فرعية مباشرة للمستند.
`getContent(index)`	`Content`	تحصل على العقدة في الفهرس المحدَّد من بين جميع العقد التي هي عناصر ثانوية مباشرة للمستند.
`getContentSize()`	`Integer`	تحصل على عدد العقد التي هي عناصر فرعية مباشرة للمستند.
`getDescendants()`	`Content[]`	تحصل على جميع العقد التي هي عناصر فرعية مباشرة أو غير مباشرة للمستند، بترتيب ظهورها في المستند.
`getDocType()`	`DocType`	تحصل على `DocType` بيان المستند.
`getRootElement()`	`Element`	تحصل على عقدة `Element` الجذر للمستند.
`hasRootElement()`	`Boolean`	لتحديد ما إذا كان المستند يحتوي على عقدة `Element` جذر
`removeContent()`	`Content[]`	تزيل جميع العقد التي هي عناصر فرعية فورية للمستند.
`removeContent(content)`	`Boolean`	تزيل هذه الدالة العقدة المحدّدة إذا كانت العقدة هي عقدة فرعية مباشرة للمستند.
`removeContent(index)`	`Content`	تزيل العقدة في الفهرس المحدَّد من بين جميع العقد التي هي عناصر فرعية فورية لملف الاطّلاع.
`setDocType(docType)`	`Document`	تُستخدَم لضبط تعريف `DocType` للمستند.
`setRootElement(element)`	`Document`	تُستخدَم لضبط عقدة `Element` الجذر للمستند.

مستندات تفصيلية

`addContent(content)`

إلحاق العقدة المحدّدة بنهاية المستند يمكن أن تكون الوسيطة content عنصرًا من النوع Content أو أي عنصر عقدة يتوافق مع نوع مُدرَج في ContentType. يُرجى العلم أنّه لا يمكن أن يتضمّن المستند سوى Element عقدة فرعية واحدة، وهي العقدة Element الجذر بشكل ضمني.

المعلمات

الاسم	النوع	الوصف
`content`	`Content`	العقدة التي تريد إضافتها

الإرجاع

Document - المستند، لتسلسل العناصر

`addContent(index, content)`

تُدرج هذه الوظيفة العقدة المحدّدة في الفهرس المحدّد بين جميع العقد التي هي عناصر ثانوية مباشرة للمستند. يمكن أن تكون الوسيطة content عنصرًا من النوع Content أو أي عنصر عقدة يتوافق مع نوع مُدرَج في ContentType. يُرجى العلم أنّه لا يمكن أن يحتوي المستند على أكثر من عقدة Element فرعية واحدة، وهي بشكل ضمني عقدة Element الجذر.

المعلمات

الاسم	النوع	الوصف
`index`	`Integer`	الفهرس الذي سيتم إدراج العقدة فيه بين جميع العقد التي هي عناصر فرعية فورية للمستند
`content`	`Content`	العقدة المطلوب إدراجها

الإرجاع

Document - المستند، لتسلسل العناصر

`cloneContent()`

تُنشئ هذه العملية نُسخًا غير مرفقة من جميع العقد التي هي عناصر فرعية مباشرة للمستند.

الإرجاع

Content[]: صفيف من النُسخ غير المرتبطة لجميع العقد التي هي عناصر ثانوية مباشرة للمستند

`detachRootElement()`

تُزيل عقدة Element الجذر للمستند وتُعيدها. إذا لم يكن المستند يحتوي على عقدة جذر Element، تعرض هذه الطريقة القيمة null.

الإرجاع

Element: عقدة Element غير المُدرَجة، أو null إذا لم يكن للمستند عقدة Element جذر

`getAllContent()`

تحصل على جميع العقد التي هي عناصر فرعية مباشرة للمستند.

الإرجاع

Content[]: صفيف لجميع العقد التي هي عناصر ثانوية مباشرة للمستند

`getContent(index)`

تحصل على العقدة في الفهرس المحدَّد من بين جميع العقد التي هي عناصر ثانوية مباشرة للمستند. إذا لم تكن هناك عقدة في الفهرس المحدَّد، تعرض هذه الطريقة القيمة null.

المعلمات

الاسم	النوع	الوصف
`index`	`Integer`	فهرس العقدة بين جميع العقد التي هي عناصر ثانوية مباشرة للمستند

الإرجاع

Content: العقدة، أو null إذا لم تكن هناك عقدة في الفهرس المحدّد

`getContentSize()`

تحصل على عدد العقد التي هي عناصر فرعية مباشرة للمستند.

الإرجاع

Integer: عدد العقد التي هي عناصر فرعية فورية للمستند

`getDescendants()`

تحصل على جميع العقد التي هي عناصر فرعية مباشرة أو غير مباشرة للمستند، بترتيب ظهورها في المستند.

الإرجاع

Content[]: صفيف لجميع العقد التي تكون عناصر ثانوية مباشرة أو غير مباشرة للمستند

`getDocType()`

تحصل على DocType بيان المستند. إذا لم يتضمّن المستند عقدة DocumentType، تعرض هذه الطريقة القيمة null.

الإرجاع

DocType: عقدة DocumentType أو null إذا لم يتضمّن المستند عقدة DocumentType

`getRootElement()`

تحصل على عقدة Element الجذر للمستند. إذا لم يكن المستند يحتوي على عقدة جذر Element، تعرض هذه الطريقة القيمة null.

الإرجاع

Element: العقدة الأساسية Element أو null إذا لم يكن للمستند عقدة Element أساسية

`hasRootElement()`

لتحديد ما إذا كان المستند يحتوي على عقدة Element جذر

الإرجاع

Boolean — true إذا كان المستند يحتوي على عقدة Element الجذر، false إذا لم يكن الأمر كذلك

`removeContent()`

تزيل جميع العقد التي هي عناصر فرعية فورية للمستند.

الإرجاع

Content[]: صفيف لجميع العقد التي كانت عناصر فرعية فورية للمستند قبل إزالتها

`removeContent(content)`

تزيل هذه الدالة العقدة المحدّدة إذا كانت العقدة هي عقدة فرعية مباشرة للمستند. يمكن أن تكون الوسيطة content عنصرًا من النوع Content أو أي عنصر عقدة يتوافق مع نوع مدرَج في ContentType.

المعلمات

الاسم	النوع	الوصف
`content`	`Content`	العقدة المطلوب إزالتها

الإرجاع

Boolean — true إذا كانت العقدة فرعية مباشرة وتمّت إزالتها، false إذا لم يكن الأمر كذلك

`removeContent(index)`

تزيل العقدة في الفهرس المحدَّد من بين جميع العقد التي هي عناصر فرعية فورية لملف الاطّلاع. إذا لم تكن هناك عقدة في الفهرس المحدَّد، تعرض هذه الطريقة القيمة null.

المعلمات

الاسم	النوع	الوصف
`index`	`Integer`	فهرس العقدة بين جميع العقد التي هي عناصر ثانوية مباشرة للمستند

الإرجاع

Content: العقدة التي تمت إزالتها، أو null إذا لم تكن هناك عقدة في الفهرس المحدّد

`setDocType(docType)`

تُستخدَم لضبط تعريف DocType للمستند. إذا كان المستند يتضمّن عقدة DocType مختلفة، تستبدل هذه الطريقة العقدة القديمة. تُعرِض هذه الطريقة استثناءً إذا كان المستند يحتوي على عقدة DocType نفسها التي يتم ضبطها.

المعلمات

الاسم	النوع	الوصف
`docType`	`DocType`	`DocumentType` لضبط

الإرجاع

Document - المستند، لتسلسل العناصر

`setRootElement(element)`

تُستخدَم لضبط عقدة Element الجذر للمستند. إذا كان المستند يحتوي على عقدة جذر Element، تستبدل هذه الطريقة العقدة القديمة.

المعلمات

الاسم	النوع	الوصف
`element`	`Element`	العقدة الأساسية `Element` المطلوب ضبطها

الإرجاع

Document - المستند، لتسلسل العناصر