تمت ترجمة هذه الصفحة بواسطة 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 الجذرية ضمنيًا.

المَعلمات

الاسم	Type	الوصف
`content`	`Content`	العقدة لإلحاقها

استرجاع الكرة

Document - المستند، للتسلسل

`addContent(index, content)`

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

المَعلمات

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

استرجاع الكرة

Document - المستند، للتسلسل

`cloneContent()`

تنشئ نُسخًا غير مرتبطة بجميع العُقد الثانوية المباشرة للمستند.

استرجاع الكرة

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

`detachRootElement()`

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

استرجاع الكرة

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

`getAllContent()`

الحصول على جميع العُقد الثانوية المباشرة للمستند.

استرجاع الكرة

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

`getContent(index)`

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

المَعلمات

الاسم	Type	الوصف
`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.

المَعلمات

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

استرجاع الكرة

Boolean: true إذا كانت العقدة ثانوية مباشرة وتمت إزالتها، وfalse إذا لم تكن

`removeContent(index)`

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

المَعلمات

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

استرجاع الكرة

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

`setDocType(docType)`

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

المَعلمات

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

استرجاع الكرة

Document - المستند، للتسلسل

`setRootElement(element)`

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

المَعلمات

الاسم	Type	الوصف
`element`	`Element`	العقدة `Element` الجذر لضبطها

استرجاع الكرة

Document - المستند، للتسلسل