本頁面由 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 節點，如果文件沒有根 Element 節點，則為 null

`getAllContent()`

取得文件的所有直接子項節點。

回攻員

Content[]：文件的直接子項的所有節點陣列

`getContent(index)`

在文件的所有直接子項節點中，取得指定索引的節點。如果指定索引處沒有節點，這個方法會傳回 null。

參數

名稱	類型	說明
`index`	`Integer`	在文件的所有直接子項中，節點的索引

回攻員

Content：節點，如果指定索引處沒有節點，則為 null

`getContentSize()`

取得文件直接子項的節點數量。

回攻員

Integer：文件的直接子節點數

`getDescendants()`

取得文件的直接或間接子項，並按照文件中顯示的順序。

回攻員

Content[]：陣列，其中包含文件的直接或間接子項的所有節點

`getDocType()`

取得文件的 DocType 宣告。如果文件沒有 DocumentType 節點，這個方法會傳回 null。

回攻員

DocType：DocumentType 節點，如果文件沒有 DocumentType 節點，則為 null

`getRootElement()`

取得文件的根 Element 節點。如果文件沒有根 Element 節點，這個方法會傳回 null。

回攻員

Element：根 Element 節點，如果文件沒有根 Element 節點，則為 null

`hasRootElement()`

判斷文件是否有根 Element 節點。

回攻員

Boolean：如果文件有根 Element 節點，則為 true；如果沒有，則為 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：用於鏈結的文件