blob: 6747b3203bc1b341b27e9106104fdff5aaee1722 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
|
//Auto-generated by kalyptus. DO NOT EDIT.
package org.trinitydesktop.koala;
import org.trinitydesktop.qt.Qt;
import org.trinitydesktop.qt.QtSupport;
/**
<code>DocumentFragment</code> is a "lightweight" or "minimal"
<code>Document</code> object. It is very common to want to be
able to extract a portion of a document's tree or to create a new
fragment of a document. Imagine implementing a user command like
cut or rearranging a document by moving fragments around. It is
desirable to have an object which can hold such fragments and it is
quite natural to use a Node for this purpose. While it is true that
a <code>Document</code> object could fulfil this role, a
<code>Document</code> object can potentially be a heavyweight object,
depending on the underlying implementation. What is really needed
for this is a very lightweight object. <code>DocumentFragment</code>
is such an object.
Furthermore, various operations -- such as inserting nodes as
children of another <code>Node</code> -- may take
<code>DocumentFragment</code> objects as arguments; this results in all
the child nodes of the <code>DocumentFragment</code> being moved
to the child list of this node.
The children of a <code>DocumentFragment</code> node are zero or
more nodes representing the tops of any sub-trees defining the
structure of the document. <code>DocumentFragment</code> nodes do
not need to be well-formed XML documents (although they do need to
follow the rules imposed upon well-formed XML parsed entities,
which can have multiple top nodes). For example, a
<code>DocumentFragment</code> might have only one child and that child
node could be a <code>Text</code> node. Such a structure model
represents neither an HTML document nor a well-formed XML document.
When a <code>DocumentFragment</code> is inserted into a
<code>Document</code> (or indeed any other <code>Node</code> that may
take children) the children of the <code>DocumentFragment</code>
and not the <code>DocumentFragment</code> itself are inserted
into the <code>Node</code> . This makes the
<code>DocumentFragment</code> very useful when the user wishes to create
nodes that are siblings; the <code>DocumentFragment</code> acts
as the parent of these nodes so that the user can use the standard
methods from the <code>Node</code> interface, such as
<code>insertBefore</code>() and <code>appendChild</code>() .
@short <code>DocumentFragment</code> is a "lightweight" or "minimal" <code>Document</code> object.
*/
public class DocumentFragment extends Node {
protected DocumentFragment(Class dummy){super((Class) null);}
public DocumentFragment() {
super((Class) null);
newDocumentFragment();
}
private native void newDocumentFragment();
public DocumentFragment(DocumentFragment other) {
super((Class) null);
newDocumentFragment(other);
}
private native void newDocumentFragment(DocumentFragment other);
public DocumentFragment(Node other) {
super((Class) null);
newDocumentFragment(other);
}
private native void newDocumentFragment(Node other);
// DOM::DocumentFragment* DocumentFragment(DOM::DocumentFragmentImpl* arg1); >>>> NOT CONVERTED
}
|