aspose-html-net 25.6.0__py3-none-win_amd64.whl → 25.7.0__py3-none-win_amd64.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (30) hide show
  1. aspose/assemblies/html/Aspose.HTML.dll +0 -0
  2. aspose/assemblies/html/WrpInterop.Aspose.Html.dll +0 -0
  3. aspose/html/__init__.pyi +3367 -2025
  4. aspose/html/collections/__init__.pyi +4 -4
  5. aspose/html/dom/__init__.pyi +778 -404
  6. aspose/html/dom/canvas/__init__.pyi +2 -2
  7. aspose/html/dom/css/__init__.pyi +12 -11
  8. aspose/html/dom/events/__init__.pyi +20 -20
  9. aspose/html/dom/mutations/__init__.pyi +4 -4
  10. aspose/html/dom/svg/__init__.pyi +2726 -1627
  11. aspose/html/dom/svg/datatypes/__init__.pyi +52 -52
  12. aspose/html/dom/svg/events/__init__.pyi +4 -4
  13. aspose/html/dom/svg/filters/__init__.pyi +1375 -825
  14. aspose/html/dom/svg/paths/__init__.pyi +42 -42
  15. aspose/html/rendering/__init__.pyi +8 -0
  16. aspose/html/window/__init__.pyi +18 -7
  17. aspose/html.cp310-win_amd64.pyd +0 -0
  18. aspose/html.cp311-win_amd64.pyd +0 -0
  19. aspose/html.cp313-win_amd64.pyd +0 -0
  20. aspose/html.cp35-win_amd64.pyd +0 -0
  21. aspose/html.cp36-win_amd64.pyd +0 -0
  22. aspose/html.cp37-win_amd64.pyd +0 -0
  23. aspose/html.cp38-win_amd64.pyd +0 -0
  24. aspose/html.cp39-win_amd64.pyd +0 -0
  25. aspose_html_net-25.7.0.dist-info/METADATA +224 -0
  26. {aspose_html_net-25.6.0.dist-info → aspose_html_net-25.7.0.dist-info}/RECORD +29 -29
  27. aspose_html_net-25.6.0.dist-info/METADATA +0 -114
  28. {aspose_html_net-25.6.0.dist-info → aspose_html_net-25.7.0.dist-info}/WHEEL +0 -0
  29. {aspose_html_net-25.6.0.dist-info → aspose_html_net-25.7.0.dist-info}/entry_points.txt +0 -0
  30. {aspose_html_net-25.6.0.dist-info → aspose_html_net-25.7.0.dist-info}/top_level.txt +0 -0
aspose/html/dom/svg/filters/__init__.pyi CHANGED
@@ -88,7 +88,11 @@ class SVGFEBlendElement(aspose.html.dom.svg.SVGElement):
88
88
 
89
89
  @overload
90
90
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
91
- '''This method allows the registration of event listeners on the event target.
91
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
92
+
93
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
94
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
95
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
92
96
 
93
97
  :param type: The event type for which the user is registering
94
98
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -96,7 +100,11 @@ class SVGFEBlendElement(aspose.html.dom.svg.SVGElement):
96
100
 
97
101
  @overload
98
102
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
99
- '''This method allows the registration of event listeners on the event target.
103
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
104
+
105
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
106
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
107
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
100
108
 
101
109
  :param type: The event type for which the user is registering
102
110
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -132,17 +140,28 @@ class SVGFEBlendElement(aspose.html.dom.svg.SVGElement):
132
140
 
133
141
  @overload
134
142
  def clone_node(self) -> aspose.html.dom.Node:
135
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
143
+ '''Returns a duplicate of the node on which this method was called.
136
144
 
137
- :returns: Returns node'''
145
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
146
+
147
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
138
148
  ...
139
149
 
140
150
  @overload
141
151
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
142
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
152
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
143
153
 
144
- :param deep: if set to ``true`` [deep].
145
- :returns: Returns node'''
154
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
155
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
156
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
157
+
158
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
159
+
160
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
161
+
162
+ Note that deep has no effect on empty elements, such as the and elements.
163
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
164
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
146
165
  ...
147
166
 
148
167
  @overload
@@ -165,13 +184,16 @@ class SVGFEBlendElement(aspose.html.dom.svg.SVGElement):
165
184
  ...
166
185
 
167
186
  def get_platform_type(self) -> Type:
168
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
187
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
169
188
 
170
- :returns: The ECMAScript object :py:class:`System.Type`.'''
189
+ :returns: The ECMAScript object.'''
171
190
  ...
172
191
 
173
192
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
174
- '''This method allows the dispatch of events into the implementations event model.
193
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
194
+ the affected EventListeners in the appropriate order.
195
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
196
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
175
197
 
176
198
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
177
199
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -179,9 +201,9 @@ class SVGFEBlendElement(aspose.html.dom.svg.SVGElement):
179
201
  ...
180
202
 
181
203
  def has_child_nodes(self) -> bool:
182
- '''Returns whether this node has any children.
204
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
183
205
 
184
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
206
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
185
207
  ...
186
208
 
187
209
  def normalize(self):
@@ -197,11 +219,10 @@ class SVGFEBlendElement(aspose.html.dom.svg.SVGElement):
197
219
  ...
198
220
 
199
221
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
200
- '''Returns whether this node is the same node as the given one.
201
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
222
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
202
223
 
203
- :param other_node: The other node.
204
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
224
+ :param other_node: The Node to test against.
225
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
205
226
  ...
206
227
 
207
228
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -245,17 +266,19 @@ class SVGFEBlendElement(aspose.html.dom.svg.SVGElement):
245
266
  ...
246
267
 
247
268
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
248
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
269
+ '''Removes a child node from the DOM and returns the removed node.
249
270
 
250
- :param child: The old child.
251
- :returns: Returns node'''
271
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
272
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
252
273
  ...
253
274
 
254
275
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
255
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
276
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
256
277
 
257
- :param node: The node to append.
258
- :returns: Returns node'''
278
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
279
+
280
+ :param node: The node to append to the given parent node (commonly an element).
281
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
259
282
  ...
260
283
 
261
284
  def get_attribute_names(self) -> List[str]:
@@ -365,18 +388,18 @@ class SVGFEBlendElement(aspose.html.dom.svg.SVGElement):
365
388
  ...
366
389
 
367
390
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
368
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
391
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
369
392
 
370
- :param name: The tag name.
371
- :returns: Returns attribute'''
393
+ :param name: String representation of tag name.
394
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
372
395
  ...
373
396
 
374
397
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
375
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
398
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
376
399
 
377
- :param namespace_uri: The namespace URI.
378
- :param local_name: Name of the local.
379
- :returns: Returns elements'''
400
+ :param namespace_uri: The namespace URI string representation.
401
+ :param local_name: String representation of local name.
402
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
380
403
  ...
381
404
 
382
405
  def remove(self):
@@ -405,11 +428,10 @@ class SVGFEBlendElement(aspose.html.dom.svg.SVGElement):
405
428
  ...
406
429
 
407
430
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
408
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
409
- http://www.w3.org/TR/dom/
431
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
410
432
 
411
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
412
- :returns: The :py:class:`aspose.html.dom.Element`.'''
433
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
434
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
413
435
  ...
414
436
 
415
437
  @property
@@ -796,7 +818,11 @@ class SVGFEColorMatrixElement(aspose.html.dom.svg.SVGElement):
796
818
 
797
819
  @overload
798
820
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
799
- '''This method allows the registration of event listeners on the event target.
821
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
822
+
823
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
824
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
825
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
800
826
 
801
827
  :param type: The event type for which the user is registering
802
828
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -804,7 +830,11 @@ class SVGFEColorMatrixElement(aspose.html.dom.svg.SVGElement):
804
830
 
805
831
  @overload
806
832
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
807
- '''This method allows the registration of event listeners on the event target.
833
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
834
+
835
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
836
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
837
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
808
838
 
809
839
  :param type: The event type for which the user is registering
810
840
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -840,17 +870,28 @@ class SVGFEColorMatrixElement(aspose.html.dom.svg.SVGElement):
840
870
 
841
871
  @overload
842
872
  def clone_node(self) -> aspose.html.dom.Node:
843
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
873
+ '''Returns a duplicate of the node on which this method was called.
844
874
 
845
- :returns: Returns node'''
875
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
876
+
877
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
846
878
  ...
847
879
 
848
880
  @overload
849
881
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
850
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
882
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
851
883
 
852
- :param deep: if set to ``true`` [deep].
853
- :returns: Returns node'''
884
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
885
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
886
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
887
+
888
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
889
+
890
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
891
+
892
+ Note that deep has no effect on empty elements, such as the and elements.
893
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
894
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
854
895
  ...
855
896
 
856
897
  @overload
@@ -873,13 +914,16 @@ class SVGFEColorMatrixElement(aspose.html.dom.svg.SVGElement):
873
914
  ...
874
915
 
875
916
  def get_platform_type(self) -> Type:
876
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
917
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
877
918
 
878
- :returns: The ECMAScript object :py:class:`System.Type`.'''
919
+ :returns: The ECMAScript object.'''
879
920
  ...
880
921
 
881
922
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
882
- '''This method allows the dispatch of events into the implementations event model.
923
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
924
+ the affected EventListeners in the appropriate order.
925
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
926
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
883
927
 
884
928
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
885
929
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -887,9 +931,9 @@ class SVGFEColorMatrixElement(aspose.html.dom.svg.SVGElement):
887
931
  ...
888
932
 
889
933
  def has_child_nodes(self) -> bool:
890
- '''Returns whether this node has any children.
934
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
891
935
 
892
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
936
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
893
937
  ...
894
938
 
895
939
  def normalize(self):
@@ -905,11 +949,10 @@ class SVGFEColorMatrixElement(aspose.html.dom.svg.SVGElement):
905
949
  ...
906
950
 
907
951
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
908
- '''Returns whether this node is the same node as the given one.
909
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
952
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
910
953
 
911
- :param other_node: The other node.
912
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
954
+ :param other_node: The Node to test against.
955
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
913
956
  ...
914
957
 
915
958
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -953,17 +996,19 @@ class SVGFEColorMatrixElement(aspose.html.dom.svg.SVGElement):
953
996
  ...
954
997
 
955
998
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
956
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
999
+ '''Removes a child node from the DOM and returns the removed node.
957
1000
 
958
- :param child: The old child.
959
- :returns: Returns node'''
1001
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
1002
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
960
1003
  ...
961
1004
 
962
1005
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
963
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
1006
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
964
1007
 
965
- :param node: The node to append.
966
- :returns: Returns node'''
1008
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
1009
+
1010
+ :param node: The node to append to the given parent node (commonly an element).
1011
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
967
1012
  ...
968
1013
 
969
1014
  def get_attribute_names(self) -> List[str]:
@@ -1073,18 +1118,18 @@ class SVGFEColorMatrixElement(aspose.html.dom.svg.SVGElement):
1073
1118
  ...
1074
1119
 
1075
1120
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
1076
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
1121
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
1077
1122
 
1078
- :param name: The tag name.
1079
- :returns: Returns attribute'''
1123
+ :param name: String representation of tag name.
1124
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
1080
1125
  ...
1081
1126
 
1082
1127
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
1083
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
1128
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
1084
1129
 
1085
- :param namespace_uri: The namespace URI.
1086
- :param local_name: Name of the local.
1087
- :returns: Returns elements'''
1130
+ :param namespace_uri: The namespace URI string representation.
1131
+ :param local_name: String representation of local name.
1132
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
1088
1133
  ...
1089
1134
 
1090
1135
  def remove(self):
@@ -1113,11 +1158,10 @@ class SVGFEColorMatrixElement(aspose.html.dom.svg.SVGElement):
1113
1158
  ...
1114
1159
 
1115
1160
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
1116
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
1117
- http://www.w3.org/TR/dom/
1161
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
1118
1162
 
1119
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
1120
- :returns: The :py:class:`aspose.html.dom.Element`.'''
1163
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
1164
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
1121
1165
  ...
1122
1166
 
1123
1167
  @property
@@ -1432,7 +1476,11 @@ class SVGFEComponentTransferElement(aspose.html.dom.svg.SVGElement):
1432
1476
 
1433
1477
  @overload
1434
1478
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
1435
- '''This method allows the registration of event listeners on the event target.
1479
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
1480
+
1481
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
1482
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
1483
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
1436
1484
 
1437
1485
  :param type: The event type for which the user is registering
1438
1486
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -1440,7 +1488,11 @@ class SVGFEComponentTransferElement(aspose.html.dom.svg.SVGElement):
1440
1488
 
1441
1489
  @overload
1442
1490
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
1443
- '''This method allows the registration of event listeners on the event target.
1491
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
1492
+
1493
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
1494
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
1495
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
1444
1496
 
1445
1497
  :param type: The event type for which the user is registering
1446
1498
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -1476,17 +1528,28 @@ class SVGFEComponentTransferElement(aspose.html.dom.svg.SVGElement):
1476
1528
 
1477
1529
  @overload
1478
1530
  def clone_node(self) -> aspose.html.dom.Node:
1479
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
1531
+ '''Returns a duplicate of the node on which this method was called.
1480
1532
 
1481
- :returns: Returns node'''
1533
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
1534
+
1535
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
1482
1536
  ...
1483
1537
 
1484
1538
  @overload
1485
1539
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
1486
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
1540
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
1487
1541
 
1488
- :param deep: if set to ``true`` [deep].
1489
- :returns: Returns node'''
1542
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
1543
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
1544
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
1545
+
1546
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
1547
+
1548
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
1549
+
1550
+ Note that deep has no effect on empty elements, such as the and elements.
1551
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
1552
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
1490
1553
  ...
1491
1554
 
1492
1555
  @overload
@@ -1509,13 +1572,16 @@ class SVGFEComponentTransferElement(aspose.html.dom.svg.SVGElement):
1509
1572
  ...
1510
1573
 
1511
1574
  def get_platform_type(self) -> Type:
1512
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
1575
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
1513
1576
 
1514
- :returns: The ECMAScript object :py:class:`System.Type`.'''
1577
+ :returns: The ECMAScript object.'''
1515
1578
  ...
1516
1579
 
1517
1580
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
1518
- '''This method allows the dispatch of events into the implementations event model.
1581
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
1582
+ the affected EventListeners in the appropriate order.
1583
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
1584
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
1519
1585
 
1520
1586
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
1521
1587
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -1523,9 +1589,9 @@ class SVGFEComponentTransferElement(aspose.html.dom.svg.SVGElement):
1523
1589
  ...
1524
1590
 
1525
1591
  def has_child_nodes(self) -> bool:
1526
- '''Returns whether this node has any children.
1592
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
1527
1593
 
1528
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
1594
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
1529
1595
  ...
1530
1596
 
1531
1597
  def normalize(self):
@@ -1541,11 +1607,10 @@ class SVGFEComponentTransferElement(aspose.html.dom.svg.SVGElement):
1541
1607
  ...
1542
1608
 
1543
1609
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
1544
- '''Returns whether this node is the same node as the given one.
1545
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
1610
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
1546
1611
 
1547
- :param other_node: The other node.
1548
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
1612
+ :param other_node: The Node to test against.
1613
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
1549
1614
  ...
1550
1615
 
1551
1616
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -1589,17 +1654,19 @@ class SVGFEComponentTransferElement(aspose.html.dom.svg.SVGElement):
1589
1654
  ...
1590
1655
 
1591
1656
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
1592
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
1657
+ '''Removes a child node from the DOM and returns the removed node.
1593
1658
 
1594
- :param child: The old child.
1595
- :returns: Returns node'''
1659
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
1660
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
1596
1661
  ...
1597
1662
 
1598
1663
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
1599
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
1664
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
1600
1665
 
1601
- :param node: The node to append.
1602
- :returns: Returns node'''
1666
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
1667
+
1668
+ :param node: The node to append to the given parent node (commonly an element).
1669
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
1603
1670
  ...
1604
1671
 
1605
1672
  def get_attribute_names(self) -> List[str]:
@@ -1709,18 +1776,18 @@ class SVGFEComponentTransferElement(aspose.html.dom.svg.SVGElement):
1709
1776
  ...
1710
1777
 
1711
1778
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
1712
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
1779
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
1713
1780
 
1714
- :param name: The tag name.
1715
- :returns: Returns attribute'''
1781
+ :param name: String representation of tag name.
1782
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
1716
1783
  ...
1717
1784
 
1718
1785
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
1719
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
1786
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
1720
1787
 
1721
- :param namespace_uri: The namespace URI.
1722
- :param local_name: Name of the local.
1723
- :returns: Returns elements'''
1788
+ :param namespace_uri: The namespace URI string representation.
1789
+ :param local_name: String representation of local name.
1790
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
1724
1791
  ...
1725
1792
 
1726
1793
  def remove(self):
@@ -1749,11 +1816,10 @@ class SVGFEComponentTransferElement(aspose.html.dom.svg.SVGElement):
1749
1816
  ...
1750
1817
 
1751
1818
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
1752
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
1753
- http://www.w3.org/TR/dom/
1819
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
1754
1820
 
1755
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
1756
- :returns: The :py:class:`aspose.html.dom.Element`.'''
1821
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
1822
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
1757
1823
  ...
1758
1824
 
1759
1825
  @property
@@ -2028,7 +2094,11 @@ class SVGFECompositeElement(aspose.html.dom.svg.SVGElement):
2028
2094
 
2029
2095
  @overload
2030
2096
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
2031
- '''This method allows the registration of event listeners on the event target.
2097
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
2098
+
2099
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
2100
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
2101
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
2032
2102
 
2033
2103
  :param type: The event type for which the user is registering
2034
2104
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -2036,7 +2106,11 @@ class SVGFECompositeElement(aspose.html.dom.svg.SVGElement):
2036
2106
 
2037
2107
  @overload
2038
2108
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
2039
- '''This method allows the registration of event listeners on the event target.
2109
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
2110
+
2111
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
2112
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
2113
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
2040
2114
 
2041
2115
  :param type: The event type for which the user is registering
2042
2116
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -2072,17 +2146,28 @@ class SVGFECompositeElement(aspose.html.dom.svg.SVGElement):
2072
2146
 
2073
2147
  @overload
2074
2148
  def clone_node(self) -> aspose.html.dom.Node:
2075
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
2149
+ '''Returns a duplicate of the node on which this method was called.
2076
2150
 
2077
- :returns: Returns node'''
2151
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
2152
+
2153
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
2078
2154
  ...
2079
2155
 
2080
2156
  @overload
2081
2157
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
2082
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
2158
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
2083
2159
 
2084
- :param deep: if set to ``true`` [deep].
2085
- :returns: Returns node'''
2160
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
2161
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
2162
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
2163
+
2164
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
2165
+
2166
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
2167
+
2168
+ Note that deep has no effect on empty elements, such as the and elements.
2169
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
2170
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
2086
2171
  ...
2087
2172
 
2088
2173
  @overload
@@ -2105,13 +2190,16 @@ class SVGFECompositeElement(aspose.html.dom.svg.SVGElement):
2105
2190
  ...
2106
2191
 
2107
2192
  def get_platform_type(self) -> Type:
2108
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
2193
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
2109
2194
 
2110
- :returns: The ECMAScript object :py:class:`System.Type`.'''
2195
+ :returns: The ECMAScript object.'''
2111
2196
  ...
2112
2197
 
2113
2198
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
2114
- '''This method allows the dispatch of events into the implementations event model.
2199
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
2200
+ the affected EventListeners in the appropriate order.
2201
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
2202
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
2115
2203
 
2116
2204
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
2117
2205
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -2119,9 +2207,9 @@ class SVGFECompositeElement(aspose.html.dom.svg.SVGElement):
2119
2207
  ...
2120
2208
 
2121
2209
  def has_child_nodes(self) -> bool:
2122
- '''Returns whether this node has any children.
2210
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
2123
2211
 
2124
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
2212
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
2125
2213
  ...
2126
2214
 
2127
2215
  def normalize(self):
@@ -2137,11 +2225,10 @@ class SVGFECompositeElement(aspose.html.dom.svg.SVGElement):
2137
2225
  ...
2138
2226
 
2139
2227
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
2140
- '''Returns whether this node is the same node as the given one.
2141
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
2228
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
2142
2229
 
2143
- :param other_node: The other node.
2144
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
2230
+ :param other_node: The Node to test against.
2231
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
2145
2232
  ...
2146
2233
 
2147
2234
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -2185,17 +2272,19 @@ class SVGFECompositeElement(aspose.html.dom.svg.SVGElement):
2185
2272
  ...
2186
2273
 
2187
2274
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
2188
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
2275
+ '''Removes a child node from the DOM and returns the removed node.
2189
2276
 
2190
- :param child: The old child.
2191
- :returns: Returns node'''
2277
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
2278
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
2192
2279
  ...
2193
2280
 
2194
2281
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
2195
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
2282
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
2196
2283
 
2197
- :param node: The node to append.
2198
- :returns: Returns node'''
2284
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
2285
+
2286
+ :param node: The node to append to the given parent node (commonly an element).
2287
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
2199
2288
  ...
2200
2289
 
2201
2290
  def get_attribute_names(self) -> List[str]:
@@ -2305,18 +2394,18 @@ class SVGFECompositeElement(aspose.html.dom.svg.SVGElement):
2305
2394
  ...
2306
2395
 
2307
2396
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
2308
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
2397
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
2309
2398
 
2310
- :param name: The tag name.
2311
- :returns: Returns attribute'''
2399
+ :param name: String representation of tag name.
2400
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
2312
2401
  ...
2313
2402
 
2314
2403
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
2315
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
2404
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
2316
2405
 
2317
- :param namespace_uri: The namespace URI.
2318
- :param local_name: Name of the local.
2319
- :returns: Returns elements'''
2406
+ :param namespace_uri: The namespace URI string representation.
2407
+ :param local_name: String representation of local name.
2408
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
2320
2409
  ...
2321
2410
 
2322
2411
  def remove(self):
@@ -2345,11 +2434,10 @@ class SVGFECompositeElement(aspose.html.dom.svg.SVGElement):
2345
2434
  ...
2346
2435
 
2347
2436
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
2348
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
2349
- http://www.w3.org/TR/dom/
2437
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
2350
2438
 
2351
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
2352
- :returns: The :py:class:`aspose.html.dom.Element`.'''
2439
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
2440
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
2353
2441
  ...
2354
2442
 
2355
2443
  @property
@@ -2696,7 +2784,11 @@ class SVGFEConvolveMatrixElement(aspose.html.dom.svg.SVGElement):
2696
2784
 
2697
2785
  @overload
2698
2786
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
2699
- '''This method allows the registration of event listeners on the event target.
2787
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
2788
+
2789
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
2790
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
2791
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
2700
2792
 
2701
2793
  :param type: The event type for which the user is registering
2702
2794
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -2704,7 +2796,11 @@ class SVGFEConvolveMatrixElement(aspose.html.dom.svg.SVGElement):
2704
2796
 
2705
2797
  @overload
2706
2798
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
2707
- '''This method allows the registration of event listeners on the event target.
2799
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
2800
+
2801
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
2802
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
2803
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
2708
2804
 
2709
2805
  :param type: The event type for which the user is registering
2710
2806
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -2740,17 +2836,28 @@ class SVGFEConvolveMatrixElement(aspose.html.dom.svg.SVGElement):
2740
2836
 
2741
2837
  @overload
2742
2838
  def clone_node(self) -> aspose.html.dom.Node:
2743
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
2839
+ '''Returns a duplicate of the node on which this method was called.
2744
2840
 
2745
- :returns: Returns node'''
2841
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
2842
+
2843
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
2746
2844
  ...
2747
2845
 
2748
2846
  @overload
2749
2847
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
2750
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
2848
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
2751
2849
 
2752
- :param deep: if set to ``true`` [deep].
2753
- :returns: Returns node'''
2850
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
2851
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
2852
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
2853
+
2854
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
2855
+
2856
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
2857
+
2858
+ Note that deep has no effect on empty elements, such as the and elements.
2859
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
2860
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
2754
2861
  ...
2755
2862
 
2756
2863
  @overload
@@ -2773,13 +2880,16 @@ class SVGFEConvolveMatrixElement(aspose.html.dom.svg.SVGElement):
2773
2880
  ...
2774
2881
 
2775
2882
  def get_platform_type(self) -> Type:
2776
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
2883
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
2777
2884
 
2778
- :returns: The ECMAScript object :py:class:`System.Type`.'''
2885
+ :returns: The ECMAScript object.'''
2779
2886
  ...
2780
2887
 
2781
2888
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
2782
- '''This method allows the dispatch of events into the implementations event model.
2889
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
2890
+ the affected EventListeners in the appropriate order.
2891
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
2892
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
2783
2893
 
2784
2894
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
2785
2895
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -2787,9 +2897,9 @@ class SVGFEConvolveMatrixElement(aspose.html.dom.svg.SVGElement):
2787
2897
  ...
2788
2898
 
2789
2899
  def has_child_nodes(self) -> bool:
2790
- '''Returns whether this node has any children.
2900
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
2791
2901
 
2792
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
2902
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
2793
2903
  ...
2794
2904
 
2795
2905
  def normalize(self):
@@ -2805,11 +2915,10 @@ class SVGFEConvolveMatrixElement(aspose.html.dom.svg.SVGElement):
2805
2915
  ...
2806
2916
 
2807
2917
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
2808
- '''Returns whether this node is the same node as the given one.
2809
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
2918
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
2810
2919
 
2811
- :param other_node: The other node.
2812
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
2920
+ :param other_node: The Node to test against.
2921
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
2813
2922
  ...
2814
2923
 
2815
2924
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -2853,17 +2962,19 @@ class SVGFEConvolveMatrixElement(aspose.html.dom.svg.SVGElement):
2853
2962
  ...
2854
2963
 
2855
2964
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
2856
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
2965
+ '''Removes a child node from the DOM and returns the removed node.
2857
2966
 
2858
- :param child: The old child.
2859
- :returns: Returns node'''
2967
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
2968
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
2860
2969
  ...
2861
2970
 
2862
2971
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
2863
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
2972
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
2864
2973
 
2865
- :param node: The node to append.
2866
- :returns: Returns node'''
2974
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
2975
+
2976
+ :param node: The node to append to the given parent node (commonly an element).
2977
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
2867
2978
  ...
2868
2979
 
2869
2980
  def get_attribute_names(self) -> List[str]:
@@ -2973,18 +3084,18 @@ class SVGFEConvolveMatrixElement(aspose.html.dom.svg.SVGElement):
2973
3084
  ...
2974
3085
 
2975
3086
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
2976
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
3087
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
2977
3088
 
2978
- :param name: The tag name.
2979
- :returns: Returns attribute'''
3089
+ :param name: String representation of tag name.
3090
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
2980
3091
  ...
2981
3092
 
2982
3093
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
2983
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
3094
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
2984
3095
 
2985
- :param namespace_uri: The namespace URI.
2986
- :param local_name: Name of the local.
2987
- :returns: Returns elements'''
3096
+ :param namespace_uri: The namespace URI string representation.
3097
+ :param local_name: String representation of local name.
3098
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
2988
3099
  ...
2989
3100
 
2990
3101
  def remove(self):
@@ -3013,11 +3124,10 @@ class SVGFEConvolveMatrixElement(aspose.html.dom.svg.SVGElement):
3013
3124
  ...
3014
3125
 
3015
3126
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
3016
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
3017
- http://www.w3.org/TR/dom/
3127
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
3018
3128
 
3019
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
3020
- :returns: The :py:class:`aspose.html.dom.Element`.'''
3129
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
3130
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
3021
3131
  ...
3022
3132
 
3023
3133
  @property
@@ -3362,7 +3472,11 @@ class SVGFEDiffuseLightingElement(aspose.html.dom.svg.SVGElement):
3362
3472
 
3363
3473
  @overload
3364
3474
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
3365
- '''This method allows the registration of event listeners on the event target.
3475
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
3476
+
3477
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
3478
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
3479
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
3366
3480
 
3367
3481
  :param type: The event type for which the user is registering
3368
3482
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -3370,7 +3484,11 @@ class SVGFEDiffuseLightingElement(aspose.html.dom.svg.SVGElement):
3370
3484
 
3371
3485
  @overload
3372
3486
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
3373
- '''This method allows the registration of event listeners on the event target.
3487
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
3488
+
3489
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
3490
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
3491
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
3374
3492
 
3375
3493
  :param type: The event type for which the user is registering
3376
3494
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -3406,17 +3524,28 @@ class SVGFEDiffuseLightingElement(aspose.html.dom.svg.SVGElement):
3406
3524
 
3407
3525
  @overload
3408
3526
  def clone_node(self) -> aspose.html.dom.Node:
3409
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
3527
+ '''Returns a duplicate of the node on which this method was called.
3410
3528
 
3411
- :returns: Returns node'''
3529
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
3530
+
3531
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
3412
3532
  ...
3413
3533
 
3414
3534
  @overload
3415
3535
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
3416
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
3536
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
3417
3537
 
3418
- :param deep: if set to ``true`` [deep].
3419
- :returns: Returns node'''
3538
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
3539
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
3540
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
3541
+
3542
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
3543
+
3544
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
3545
+
3546
+ Note that deep has no effect on empty elements, such as the and elements.
3547
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
3548
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
3420
3549
  ...
3421
3550
 
3422
3551
  @overload
@@ -3439,13 +3568,16 @@ class SVGFEDiffuseLightingElement(aspose.html.dom.svg.SVGElement):
3439
3568
  ...
3440
3569
 
3441
3570
  def get_platform_type(self) -> Type:
3442
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
3571
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
3443
3572
 
3444
- :returns: The ECMAScript object :py:class:`System.Type`.'''
3573
+ :returns: The ECMAScript object.'''
3445
3574
  ...
3446
3575
 
3447
3576
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
3448
- '''This method allows the dispatch of events into the implementations event model.
3577
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
3578
+ the affected EventListeners in the appropriate order.
3579
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
3580
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
3449
3581
 
3450
3582
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
3451
3583
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -3453,9 +3585,9 @@ class SVGFEDiffuseLightingElement(aspose.html.dom.svg.SVGElement):
3453
3585
  ...
3454
3586
 
3455
3587
  def has_child_nodes(self) -> bool:
3456
- '''Returns whether this node has any children.
3588
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
3457
3589
 
3458
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
3590
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
3459
3591
  ...
3460
3592
 
3461
3593
  def normalize(self):
@@ -3471,11 +3603,10 @@ class SVGFEDiffuseLightingElement(aspose.html.dom.svg.SVGElement):
3471
3603
  ...
3472
3604
 
3473
3605
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
3474
- '''Returns whether this node is the same node as the given one.
3475
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
3606
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
3476
3607
 
3477
- :param other_node: The other node.
3478
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
3608
+ :param other_node: The Node to test against.
3609
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
3479
3610
  ...
3480
3611
 
3481
3612
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -3519,17 +3650,19 @@ class SVGFEDiffuseLightingElement(aspose.html.dom.svg.SVGElement):
3519
3650
  ...
3520
3651
 
3521
3652
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
3522
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
3653
+ '''Removes a child node from the DOM and returns the removed node.
3523
3654
 
3524
- :param child: The old child.
3525
- :returns: Returns node'''
3655
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
3656
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
3526
3657
  ...
3527
3658
 
3528
3659
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
3529
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
3660
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
3530
3661
 
3531
- :param node: The node to append.
3532
- :returns: Returns node'''
3662
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
3663
+
3664
+ :param node: The node to append to the given parent node (commonly an element).
3665
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
3533
3666
  ...
3534
3667
 
3535
3668
  def get_attribute_names(self) -> List[str]:
@@ -3639,18 +3772,18 @@ class SVGFEDiffuseLightingElement(aspose.html.dom.svg.SVGElement):
3639
3772
  ...
3640
3773
 
3641
3774
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
3642
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
3775
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
3643
3776
 
3644
- :param name: The tag name.
3645
- :returns: Returns attribute'''
3777
+ :param name: String representation of tag name.
3778
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
3646
3779
  ...
3647
3780
 
3648
3781
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
3649
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
3782
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
3650
3783
 
3651
- :param namespace_uri: The namespace URI.
3652
- :param local_name: Name of the local.
3653
- :returns: Returns elements'''
3784
+ :param namespace_uri: The namespace URI string representation.
3785
+ :param local_name: String representation of local name.
3786
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
3654
3787
  ...
3655
3788
 
3656
3789
  def remove(self):
@@ -3679,11 +3812,10 @@ class SVGFEDiffuseLightingElement(aspose.html.dom.svg.SVGElement):
3679
3812
  ...
3680
3813
 
3681
3814
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
3682
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
3683
- http://www.w3.org/TR/dom/
3815
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
3684
3816
 
3685
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
3686
- :returns: The :py:class:`aspose.html.dom.Element`.'''
3817
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
3818
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
3687
3819
  ...
3688
3820
 
3689
3821
  @property
@@ -3974,7 +4106,11 @@ class SVGFEDisplacementMapElement(aspose.html.dom.svg.SVGElement):
3974
4106
 
3975
4107
  @overload
3976
4108
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
3977
- '''This method allows the registration of event listeners on the event target.
4109
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
4110
+
4111
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
4112
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
4113
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
3978
4114
 
3979
4115
  :param type: The event type for which the user is registering
3980
4116
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -3982,7 +4118,11 @@ class SVGFEDisplacementMapElement(aspose.html.dom.svg.SVGElement):
3982
4118
 
3983
4119
  @overload
3984
4120
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
3985
- '''This method allows the registration of event listeners on the event target.
4121
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
4122
+
4123
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
4124
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
4125
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
3986
4126
 
3987
4127
  :param type: The event type for which the user is registering
3988
4128
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -4018,17 +4158,28 @@ class SVGFEDisplacementMapElement(aspose.html.dom.svg.SVGElement):
4018
4158
 
4019
4159
  @overload
4020
4160
  def clone_node(self) -> aspose.html.dom.Node:
4021
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
4161
+ '''Returns a duplicate of the node on which this method was called.
4022
4162
 
4023
- :returns: Returns node'''
4163
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
4164
+
4165
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
4024
4166
  ...
4025
4167
 
4026
4168
  @overload
4027
4169
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
4028
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
4170
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
4029
4171
 
4030
- :param deep: if set to ``true`` [deep].
4031
- :returns: Returns node'''
4172
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
4173
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
4174
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
4175
+
4176
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
4177
+
4178
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
4179
+
4180
+ Note that deep has no effect on empty elements, such as the and elements.
4181
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
4182
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
4032
4183
  ...
4033
4184
 
4034
4185
  @overload
@@ -4051,13 +4202,16 @@ class SVGFEDisplacementMapElement(aspose.html.dom.svg.SVGElement):
4051
4202
  ...
4052
4203
 
4053
4204
  def get_platform_type(self) -> Type:
4054
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
4205
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
4055
4206
 
4056
- :returns: The ECMAScript object :py:class:`System.Type`.'''
4207
+ :returns: The ECMAScript object.'''
4057
4208
  ...
4058
4209
 
4059
4210
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
4060
- '''This method allows the dispatch of events into the implementations event model.
4211
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
4212
+ the affected EventListeners in the appropriate order.
4213
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
4214
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
4061
4215
 
4062
4216
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
4063
4217
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -4065,9 +4219,9 @@ class SVGFEDisplacementMapElement(aspose.html.dom.svg.SVGElement):
4065
4219
  ...
4066
4220
 
4067
4221
  def has_child_nodes(self) -> bool:
4068
- '''Returns whether this node has any children.
4222
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
4069
4223
 
4070
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
4224
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
4071
4225
  ...
4072
4226
 
4073
4227
  def normalize(self):
@@ -4083,11 +4237,10 @@ class SVGFEDisplacementMapElement(aspose.html.dom.svg.SVGElement):
4083
4237
  ...
4084
4238
 
4085
4239
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
4086
- '''Returns whether this node is the same node as the given one.
4087
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
4240
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
4088
4241
 
4089
- :param other_node: The other node.
4090
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
4242
+ :param other_node: The Node to test against.
4243
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
4091
4244
  ...
4092
4245
 
4093
4246
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -4131,17 +4284,19 @@ class SVGFEDisplacementMapElement(aspose.html.dom.svg.SVGElement):
4131
4284
  ...
4132
4285
 
4133
4286
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
4134
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
4287
+ '''Removes a child node from the DOM and returns the removed node.
4135
4288
 
4136
- :param child: The old child.
4137
- :returns: Returns node'''
4289
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
4290
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
4138
4291
  ...
4139
4292
 
4140
4293
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
4141
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
4294
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
4142
4295
 
4143
- :param node: The node to append.
4144
- :returns: Returns node'''
4296
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
4297
+
4298
+ :param node: The node to append to the given parent node (commonly an element).
4299
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
4145
4300
  ...
4146
4301
 
4147
4302
  def get_attribute_names(self) -> List[str]:
@@ -4251,18 +4406,18 @@ class SVGFEDisplacementMapElement(aspose.html.dom.svg.SVGElement):
4251
4406
  ...
4252
4407
 
4253
4408
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
4254
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
4409
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
4255
4410
 
4256
- :param name: The tag name.
4257
- :returns: Returns attribute'''
4411
+ :param name: String representation of tag name.
4412
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
4258
4413
  ...
4259
4414
 
4260
4415
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
4261
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
4416
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
4262
4417
 
4263
- :param namespace_uri: The namespace URI.
4264
- :param local_name: Name of the local.
4265
- :returns: Returns elements'''
4418
+ :param namespace_uri: The namespace URI string representation.
4419
+ :param local_name: String representation of local name.
4420
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
4266
4421
  ...
4267
4422
 
4268
4423
  def remove(self):
@@ -4291,11 +4446,10 @@ class SVGFEDisplacementMapElement(aspose.html.dom.svg.SVGElement):
4291
4446
  ...
4292
4447
 
4293
4448
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
4294
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
4295
- http://www.w3.org/TR/dom/
4449
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
4296
4450
 
4297
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
4298
- :returns: The :py:class:`aspose.html.dom.Element`.'''
4451
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
4452
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
4299
4453
  ...
4300
4454
 
4301
4455
  @property
@@ -4618,7 +4772,11 @@ class SVGFEDistantLightElement(aspose.html.dom.svg.SVGElement):
4618
4772
 
4619
4773
  @overload
4620
4774
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
4621
- '''This method allows the registration of event listeners on the event target.
4775
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
4776
+
4777
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
4778
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
4779
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
4622
4780
 
4623
4781
  :param type: The event type for which the user is registering
4624
4782
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -4626,7 +4784,11 @@ class SVGFEDistantLightElement(aspose.html.dom.svg.SVGElement):
4626
4784
 
4627
4785
  @overload
4628
4786
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
4629
- '''This method allows the registration of event listeners on the event target.
4787
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
4788
+
4789
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
4790
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
4791
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
4630
4792
 
4631
4793
  :param type: The event type for which the user is registering
4632
4794
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -4662,17 +4824,28 @@ class SVGFEDistantLightElement(aspose.html.dom.svg.SVGElement):
4662
4824
 
4663
4825
  @overload
4664
4826
  def clone_node(self) -> aspose.html.dom.Node:
4665
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
4827
+ '''Returns a duplicate of the node on which this method was called.
4666
4828
 
4667
- :returns: Returns node'''
4829
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
4830
+
4831
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
4668
4832
  ...
4669
4833
 
4670
4834
  @overload
4671
4835
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
4672
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
4836
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
4673
4837
 
4674
- :param deep: if set to ``true`` [deep].
4675
- :returns: Returns node'''
4838
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
4839
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
4840
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
4841
+
4842
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
4843
+
4844
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
4845
+
4846
+ Note that deep has no effect on empty elements, such as the and elements.
4847
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
4848
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
4676
4849
  ...
4677
4850
 
4678
4851
  @overload
@@ -4695,13 +4868,16 @@ class SVGFEDistantLightElement(aspose.html.dom.svg.SVGElement):
4695
4868
  ...
4696
4869
 
4697
4870
  def get_platform_type(self) -> Type:
4698
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
4871
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
4699
4872
 
4700
- :returns: The ECMAScript object :py:class:`System.Type`.'''
4873
+ :returns: The ECMAScript object.'''
4701
4874
  ...
4702
4875
 
4703
4876
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
4704
- '''This method allows the dispatch of events into the implementations event model.
4877
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
4878
+ the affected EventListeners in the appropriate order.
4879
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
4880
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
4705
4881
 
4706
4882
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
4707
4883
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -4709,9 +4885,9 @@ class SVGFEDistantLightElement(aspose.html.dom.svg.SVGElement):
4709
4885
  ...
4710
4886
 
4711
4887
  def has_child_nodes(self) -> bool:
4712
- '''Returns whether this node has any children.
4888
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
4713
4889
 
4714
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
4890
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
4715
4891
  ...
4716
4892
 
4717
4893
  def normalize(self):
@@ -4727,11 +4903,10 @@ class SVGFEDistantLightElement(aspose.html.dom.svg.SVGElement):
4727
4903
  ...
4728
4904
 
4729
4905
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
4730
- '''Returns whether this node is the same node as the given one.
4731
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
4906
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
4732
4907
 
4733
- :param other_node: The other node.
4734
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
4908
+ :param other_node: The Node to test against.
4909
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
4735
4910
  ...
4736
4911
 
4737
4912
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -4775,17 +4950,19 @@ class SVGFEDistantLightElement(aspose.html.dom.svg.SVGElement):
4775
4950
  ...
4776
4951
 
4777
4952
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
4778
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
4953
+ '''Removes a child node from the DOM and returns the removed node.
4779
4954
 
4780
- :param child: The old child.
4781
- :returns: Returns node'''
4955
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
4956
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
4782
4957
  ...
4783
4958
 
4784
4959
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
4785
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
4960
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
4786
4961
 
4787
- :param node: The node to append.
4788
- :returns: Returns node'''
4962
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
4963
+
4964
+ :param node: The node to append to the given parent node (commonly an element).
4965
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
4789
4966
  ...
4790
4967
 
4791
4968
  def get_attribute_names(self) -> List[str]:
@@ -4895,18 +5072,18 @@ class SVGFEDistantLightElement(aspose.html.dom.svg.SVGElement):
4895
5072
  ...
4896
5073
 
4897
5074
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
4898
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
5075
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
4899
5076
 
4900
- :param name: The tag name.
4901
- :returns: Returns attribute'''
5077
+ :param name: String representation of tag name.
5078
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
4902
5079
  ...
4903
5080
 
4904
5081
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
4905
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
5082
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
4906
5083
 
4907
- :param namespace_uri: The namespace URI.
4908
- :param local_name: Name of the local.
4909
- :returns: Returns elements'''
5084
+ :param namespace_uri: The namespace URI string representation.
5085
+ :param local_name: String representation of local name.
5086
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
4910
5087
  ...
4911
5088
 
4912
5089
  def remove(self):
@@ -4935,11 +5112,10 @@ class SVGFEDistantLightElement(aspose.html.dom.svg.SVGElement):
4935
5112
  ...
4936
5113
 
4937
5114
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
4938
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
4939
- http://www.w3.org/TR/dom/
5115
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
4940
5116
 
4941
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
4942
- :returns: The :py:class:`aspose.html.dom.Element`.'''
5117
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
5118
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
4943
5119
  ...
4944
5120
 
4945
5121
  @property
@@ -5194,7 +5370,11 @@ class SVGFEDropShadowElement(aspose.html.dom.svg.SVGElement):
5194
5370
 
5195
5371
  @overload
5196
5372
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
5197
- '''This method allows the registration of event listeners on the event target.
5373
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
5374
+
5375
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
5376
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
5377
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
5198
5378
 
5199
5379
  :param type: The event type for which the user is registering
5200
5380
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -5202,7 +5382,11 @@ class SVGFEDropShadowElement(aspose.html.dom.svg.SVGElement):
5202
5382
 
5203
5383
  @overload
5204
5384
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
5205
- '''This method allows the registration of event listeners on the event target.
5385
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
5386
+
5387
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
5388
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
5389
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
5206
5390
 
5207
5391
  :param type: The event type for which the user is registering
5208
5392
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -5238,17 +5422,28 @@ class SVGFEDropShadowElement(aspose.html.dom.svg.SVGElement):
5238
5422
 
5239
5423
  @overload
5240
5424
  def clone_node(self) -> aspose.html.dom.Node:
5241
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
5425
+ '''Returns a duplicate of the node on which this method was called.
5242
5426
 
5243
- :returns: Returns node'''
5427
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
5428
+
5429
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
5244
5430
  ...
5245
5431
 
5246
5432
  @overload
5247
5433
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
5248
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
5434
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
5249
5435
 
5250
- :param deep: if set to ``true`` [deep].
5251
- :returns: Returns node'''
5436
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
5437
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
5438
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
5439
+
5440
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
5441
+
5442
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
5443
+
5444
+ Note that deep has no effect on empty elements, such as the and elements.
5445
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
5446
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
5252
5447
  ...
5253
5448
 
5254
5449
  @overload
@@ -5271,13 +5466,16 @@ class SVGFEDropShadowElement(aspose.html.dom.svg.SVGElement):
5271
5466
  ...
5272
5467
 
5273
5468
  def get_platform_type(self) -> Type:
5274
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
5469
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
5275
5470
 
5276
- :returns: The ECMAScript object :py:class:`System.Type`.'''
5471
+ :returns: The ECMAScript object.'''
5277
5472
  ...
5278
5473
 
5279
5474
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
5280
- '''This method allows the dispatch of events into the implementations event model.
5475
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
5476
+ the affected EventListeners in the appropriate order.
5477
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
5478
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
5281
5479
 
5282
5480
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
5283
5481
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -5285,9 +5483,9 @@ class SVGFEDropShadowElement(aspose.html.dom.svg.SVGElement):
5285
5483
  ...
5286
5484
 
5287
5485
  def has_child_nodes(self) -> bool:
5288
- '''Returns whether this node has any children.
5486
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
5289
5487
 
5290
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
5488
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
5291
5489
  ...
5292
5490
 
5293
5491
  def normalize(self):
@@ -5303,11 +5501,10 @@ class SVGFEDropShadowElement(aspose.html.dom.svg.SVGElement):
5303
5501
  ...
5304
5502
 
5305
5503
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
5306
- '''Returns whether this node is the same node as the given one.
5307
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
5504
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
5308
5505
 
5309
- :param other_node: The other node.
5310
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
5506
+ :param other_node: The Node to test against.
5507
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
5311
5508
  ...
5312
5509
 
5313
5510
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -5351,17 +5548,19 @@ class SVGFEDropShadowElement(aspose.html.dom.svg.SVGElement):
5351
5548
  ...
5352
5549
 
5353
5550
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
5354
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
5551
+ '''Removes a child node from the DOM and returns the removed node.
5355
5552
 
5356
- :param child: The old child.
5357
- :returns: Returns node'''
5553
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
5554
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
5358
5555
  ...
5359
5556
 
5360
5557
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
5361
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
5558
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
5362
5559
 
5363
- :param node: The node to append.
5364
- :returns: Returns node'''
5560
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
5561
+
5562
+ :param node: The node to append to the given parent node (commonly an element).
5563
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
5365
5564
  ...
5366
5565
 
5367
5566
  def get_attribute_names(self) -> List[str]:
@@ -5471,18 +5670,18 @@ class SVGFEDropShadowElement(aspose.html.dom.svg.SVGElement):
5471
5670
  ...
5472
5671
 
5473
5672
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
5474
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
5673
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
5475
5674
 
5476
- :param name: The tag name.
5477
- :returns: Returns attribute'''
5675
+ :param name: String representation of tag name.
5676
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
5478
5677
  ...
5479
5678
 
5480
5679
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
5481
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
5680
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
5482
5681
 
5483
- :param namespace_uri: The namespace URI.
5484
- :param local_name: Name of the local.
5485
- :returns: Returns elements'''
5682
+ :param namespace_uri: The namespace URI string representation.
5683
+ :param local_name: String representation of local name.
5684
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
5486
5685
  ...
5487
5686
 
5488
5687
  def remove(self):
@@ -5511,11 +5710,10 @@ class SVGFEDropShadowElement(aspose.html.dom.svg.SVGElement):
5511
5710
  ...
5512
5711
 
5513
5712
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
5514
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
5515
- http://www.w3.org/TR/dom/
5713
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
5516
5714
 
5517
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
5518
- :returns: The :py:class:`aspose.html.dom.Element`.'''
5715
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
5716
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
5519
5717
  ...
5520
5718
 
5521
5719
  def set_std_deviation(self, std_deviation_x : float, std_deviation_y : float):
@@ -5815,7 +6013,11 @@ class SVGFEFloodElement(aspose.html.dom.svg.SVGElement):
5815
6013
 
5816
6014
  @overload
5817
6015
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
5818
- '''This method allows the registration of event listeners on the event target.
6016
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
6017
+
6018
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
6019
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
6020
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
5819
6021
 
5820
6022
  :param type: The event type for which the user is registering
5821
6023
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -5823,7 +6025,11 @@ class SVGFEFloodElement(aspose.html.dom.svg.SVGElement):
5823
6025
 
5824
6026
  @overload
5825
6027
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
5826
- '''This method allows the registration of event listeners on the event target.
6028
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
6029
+
6030
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
6031
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
6032
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
5827
6033
 
5828
6034
  :param type: The event type for which the user is registering
5829
6035
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -5859,17 +6065,28 @@ class SVGFEFloodElement(aspose.html.dom.svg.SVGElement):
5859
6065
 
5860
6066
  @overload
5861
6067
  def clone_node(self) -> aspose.html.dom.Node:
5862
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
6068
+ '''Returns a duplicate of the node on which this method was called.
5863
6069
 
5864
- :returns: Returns node'''
6070
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
6071
+
6072
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
5865
6073
  ...
5866
6074
 
5867
6075
  @overload
5868
6076
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
5869
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
6077
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
5870
6078
 
5871
- :param deep: if set to ``true`` [deep].
5872
- :returns: Returns node'''
6079
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
6080
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
6081
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
6082
+
6083
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
6084
+
6085
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
6086
+
6087
+ Note that deep has no effect on empty elements, such as the and elements.
6088
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
6089
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
5873
6090
  ...
5874
6091
 
5875
6092
  @overload
@@ -5892,13 +6109,16 @@ class SVGFEFloodElement(aspose.html.dom.svg.SVGElement):
5892
6109
  ...
5893
6110
 
5894
6111
  def get_platform_type(self) -> Type:
5895
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
6112
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
5896
6113
 
5897
- :returns: The ECMAScript object :py:class:`System.Type`.'''
6114
+ :returns: The ECMAScript object.'''
5898
6115
  ...
5899
6116
 
5900
6117
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
5901
- '''This method allows the dispatch of events into the implementations event model.
6118
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
6119
+ the affected EventListeners in the appropriate order.
6120
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
6121
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
5902
6122
 
5903
6123
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
5904
6124
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -5906,9 +6126,9 @@ class SVGFEFloodElement(aspose.html.dom.svg.SVGElement):
5906
6126
  ...
5907
6127
 
5908
6128
  def has_child_nodes(self) -> bool:
5909
- '''Returns whether this node has any children.
6129
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
5910
6130
 
5911
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
6131
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
5912
6132
  ...
5913
6133
 
5914
6134
  def normalize(self):
@@ -5924,11 +6144,10 @@ class SVGFEFloodElement(aspose.html.dom.svg.SVGElement):
5924
6144
  ...
5925
6145
 
5926
6146
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
5927
- '''Returns whether this node is the same node as the given one.
5928
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
6147
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
5929
6148
 
5930
- :param other_node: The other node.
5931
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
6149
+ :param other_node: The Node to test against.
6150
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
5932
6151
  ...
5933
6152
 
5934
6153
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -5972,17 +6191,19 @@ class SVGFEFloodElement(aspose.html.dom.svg.SVGElement):
5972
6191
  ...
5973
6192
 
5974
6193
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
5975
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
6194
+ '''Removes a child node from the DOM and returns the removed node.
5976
6195
 
5977
- :param child: The old child.
5978
- :returns: Returns node'''
6196
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
6197
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
5979
6198
  ...
5980
6199
 
5981
6200
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
5982
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
6201
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
5983
6202
 
5984
- :param node: The node to append.
5985
- :returns: Returns node'''
6203
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
6204
+
6205
+ :param node: The node to append to the given parent node (commonly an element).
6206
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
5986
6207
  ...
5987
6208
 
5988
6209
  def get_attribute_names(self) -> List[str]:
@@ -6092,18 +6313,18 @@ class SVGFEFloodElement(aspose.html.dom.svg.SVGElement):
6092
6313
  ...
6093
6314
 
6094
6315
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
6095
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
6316
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
6096
6317
 
6097
- :param name: The tag name.
6098
- :returns: Returns attribute'''
6318
+ :param name: String representation of tag name.
6319
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
6099
6320
  ...
6100
6321
 
6101
6322
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
6102
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
6323
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
6103
6324
 
6104
- :param namespace_uri: The namespace URI.
6105
- :param local_name: Name of the local.
6106
- :returns: Returns elements'''
6325
+ :param namespace_uri: The namespace URI string representation.
6326
+ :param local_name: String representation of local name.
6327
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
6107
6328
  ...
6108
6329
 
6109
6330
  def remove(self):
@@ -6132,11 +6353,10 @@ class SVGFEFloodElement(aspose.html.dom.svg.SVGElement):
6132
6353
  ...
6133
6354
 
6134
6355
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
6135
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
6136
- http://www.w3.org/TR/dom/
6356
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
6137
6357
 
6138
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
6139
- :returns: The :py:class:`aspose.html.dom.Element`.'''
6358
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
6359
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
6140
6360
  ...
6141
6361
 
6142
6362
  @property
@@ -6406,7 +6626,11 @@ class SVGFEFuncAElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
6406
6626
 
6407
6627
  @overload
6408
6628
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
6409
- '''This method allows the registration of event listeners on the event target.
6629
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
6630
+
6631
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
6632
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
6633
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
6410
6634
 
6411
6635
  :param type: The event type for which the user is registering
6412
6636
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -6414,7 +6638,11 @@ class SVGFEFuncAElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
6414
6638
 
6415
6639
  @overload
6416
6640
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
6417
- '''This method allows the registration of event listeners on the event target.
6641
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
6642
+
6643
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
6644
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
6645
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
6418
6646
 
6419
6647
  :param type: The event type for which the user is registering
6420
6648
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -6450,17 +6678,28 @@ class SVGFEFuncAElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
6450
6678
 
6451
6679
  @overload
6452
6680
  def clone_node(self) -> aspose.html.dom.Node:
6453
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
6681
+ '''Returns a duplicate of the node on which this method was called.
6454
6682
 
6455
- :returns: Returns node'''
6683
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
6684
+
6685
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
6456
6686
  ...
6457
6687
 
6458
6688
  @overload
6459
6689
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
6460
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
6690
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
6461
6691
 
6462
- :param deep: if set to ``true`` [deep].
6463
- :returns: Returns node'''
6692
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
6693
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
6694
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
6695
+
6696
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
6697
+
6698
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
6699
+
6700
+ Note that deep has no effect on empty elements, such as the and elements.
6701
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
6702
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
6464
6703
  ...
6465
6704
 
6466
6705
  @overload
@@ -6483,13 +6722,16 @@ class SVGFEFuncAElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
6483
6722
  ...
6484
6723
 
6485
6724
  def get_platform_type(self) -> Type:
6486
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
6725
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
6487
6726
 
6488
- :returns: The ECMAScript object :py:class:`System.Type`.'''
6727
+ :returns: The ECMAScript object.'''
6489
6728
  ...
6490
6729
 
6491
6730
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
6492
- '''This method allows the dispatch of events into the implementations event model.
6731
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
6732
+ the affected EventListeners in the appropriate order.
6733
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
6734
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
6493
6735
 
6494
6736
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
6495
6737
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -6497,9 +6739,9 @@ class SVGFEFuncAElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
6497
6739
  ...
6498
6740
 
6499
6741
  def has_child_nodes(self) -> bool:
6500
- '''Returns whether this node has any children.
6742
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
6501
6743
 
6502
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
6744
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
6503
6745
  ...
6504
6746
 
6505
6747
  def normalize(self):
@@ -6515,11 +6757,10 @@ class SVGFEFuncAElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
6515
6757
  ...
6516
6758
 
6517
6759
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
6518
- '''Returns whether this node is the same node as the given one.
6519
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
6760
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
6520
6761
 
6521
- :param other_node: The other node.
6522
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
6762
+ :param other_node: The Node to test against.
6763
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
6523
6764
  ...
6524
6765
 
6525
6766
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -6563,17 +6804,19 @@ class SVGFEFuncAElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
6563
6804
  ...
6564
6805
 
6565
6806
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
6566
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
6807
+ '''Removes a child node from the DOM and returns the removed node.
6567
6808
 
6568
- :param child: The old child.
6569
- :returns: Returns node'''
6809
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
6810
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
6570
6811
  ...
6571
6812
 
6572
6813
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
6573
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
6814
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
6574
6815
 
6575
- :param node: The node to append.
6576
- :returns: Returns node'''
6816
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
6817
+
6818
+ :param node: The node to append to the given parent node (commonly an element).
6819
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
6577
6820
  ...
6578
6821
 
6579
6822
  def get_attribute_names(self) -> List[str]:
@@ -6683,18 +6926,18 @@ class SVGFEFuncAElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
6683
6926
  ...
6684
6927
 
6685
6928
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
6686
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
6929
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
6687
6930
 
6688
- :param name: The tag name.
6689
- :returns: Returns attribute'''
6931
+ :param name: String representation of tag name.
6932
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
6690
6933
  ...
6691
6934
 
6692
6935
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
6693
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
6936
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
6694
6937
 
6695
- :param namespace_uri: The namespace URI.
6696
- :param local_name: Name of the local.
6697
- :returns: Returns elements'''
6938
+ :param namespace_uri: The namespace URI string representation.
6939
+ :param local_name: String representation of local name.
6940
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
6698
6941
  ...
6699
6942
 
6700
6943
  def remove(self):
@@ -6723,11 +6966,10 @@ class SVGFEFuncAElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
6723
6966
  ...
6724
6967
 
6725
6968
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
6726
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
6727
- http://www.w3.org/TR/dom/
6969
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
6728
6970
 
6729
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
6730
- :returns: The :py:class:`aspose.html.dom.Element`.'''
6971
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
6972
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
6731
6973
  ...
6732
6974
 
6733
6975
  @property
@@ -7042,7 +7284,11 @@ class SVGFEFuncBElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7042
7284
 
7043
7285
  @overload
7044
7286
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
7045
- '''This method allows the registration of event listeners on the event target.
7287
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
7288
+
7289
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
7290
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
7291
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
7046
7292
 
7047
7293
  :param type: The event type for which the user is registering
7048
7294
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -7050,7 +7296,11 @@ class SVGFEFuncBElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7050
7296
 
7051
7297
  @overload
7052
7298
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
7053
- '''This method allows the registration of event listeners on the event target.
7299
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
7300
+
7301
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
7302
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
7303
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
7054
7304
 
7055
7305
  :param type: The event type for which the user is registering
7056
7306
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -7086,17 +7336,28 @@ class SVGFEFuncBElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7086
7336
 
7087
7337
  @overload
7088
7338
  def clone_node(self) -> aspose.html.dom.Node:
7089
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
7339
+ '''Returns a duplicate of the node on which this method was called.
7090
7340
 
7091
- :returns: Returns node'''
7341
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
7342
+
7343
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
7092
7344
  ...
7093
7345
 
7094
7346
  @overload
7095
7347
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
7096
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
7348
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
7097
7349
 
7098
- :param deep: if set to ``true`` [deep].
7099
- :returns: Returns node'''
7350
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
7351
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
7352
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
7353
+
7354
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
7355
+
7356
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
7357
+
7358
+ Note that deep has no effect on empty elements, such as the and elements.
7359
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
7360
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
7100
7361
  ...
7101
7362
 
7102
7363
  @overload
@@ -7119,13 +7380,16 @@ class SVGFEFuncBElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7119
7380
  ...
7120
7381
 
7121
7382
  def get_platform_type(self) -> Type:
7122
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
7383
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
7123
7384
 
7124
- :returns: The ECMAScript object :py:class:`System.Type`.'''
7385
+ :returns: The ECMAScript object.'''
7125
7386
  ...
7126
7387
 
7127
7388
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
7128
- '''This method allows the dispatch of events into the implementations event model.
7389
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
7390
+ the affected EventListeners in the appropriate order.
7391
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
7392
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
7129
7393
 
7130
7394
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
7131
7395
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -7133,9 +7397,9 @@ class SVGFEFuncBElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7133
7397
  ...
7134
7398
 
7135
7399
  def has_child_nodes(self) -> bool:
7136
- '''Returns whether this node has any children.
7400
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
7137
7401
 
7138
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
7402
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
7139
7403
  ...
7140
7404
 
7141
7405
  def normalize(self):
@@ -7151,11 +7415,10 @@ class SVGFEFuncBElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7151
7415
  ...
7152
7416
 
7153
7417
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
7154
- '''Returns whether this node is the same node as the given one.
7155
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
7418
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
7156
7419
 
7157
- :param other_node: The other node.
7158
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
7420
+ :param other_node: The Node to test against.
7421
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
7159
7422
  ...
7160
7423
 
7161
7424
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -7199,17 +7462,19 @@ class SVGFEFuncBElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7199
7462
  ...
7200
7463
 
7201
7464
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
7202
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
7465
+ '''Removes a child node from the DOM and returns the removed node.
7203
7466
 
7204
- :param child: The old child.
7205
- :returns: Returns node'''
7467
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
7468
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
7206
7469
  ...
7207
7470
 
7208
7471
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
7209
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
7472
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
7210
7473
 
7211
- :param node: The node to append.
7212
- :returns: Returns node'''
7474
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
7475
+
7476
+ :param node: The node to append to the given parent node (commonly an element).
7477
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
7213
7478
  ...
7214
7479
 
7215
7480
  def get_attribute_names(self) -> List[str]:
@@ -7319,18 +7584,18 @@ class SVGFEFuncBElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7319
7584
  ...
7320
7585
 
7321
7586
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
7322
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
7587
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
7323
7588
 
7324
- :param name: The tag name.
7325
- :returns: Returns attribute'''
7589
+ :param name: String representation of tag name.
7590
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
7326
7591
  ...
7327
7592
 
7328
7593
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
7329
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
7594
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
7330
7595
 
7331
- :param namespace_uri: The namespace URI.
7332
- :param local_name: Name of the local.
7333
- :returns: Returns elements'''
7596
+ :param namespace_uri: The namespace URI string representation.
7597
+ :param local_name: String representation of local name.
7598
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
7334
7599
  ...
7335
7600
 
7336
7601
  def remove(self):
@@ -7359,11 +7624,10 @@ class SVGFEFuncBElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7359
7624
  ...
7360
7625
 
7361
7626
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
7362
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
7363
- http://www.w3.org/TR/dom/
7627
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
7364
7628
 
7365
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
7366
- :returns: The :py:class:`aspose.html.dom.Element`.'''
7629
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
7630
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
7367
7631
  ...
7368
7632
 
7369
7633
  @property
@@ -7678,7 +7942,11 @@ class SVGFEFuncGElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7678
7942
 
7679
7943
  @overload
7680
7944
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
7681
- '''This method allows the registration of event listeners on the event target.
7945
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
7946
+
7947
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
7948
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
7949
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
7682
7950
 
7683
7951
  :param type: The event type for which the user is registering
7684
7952
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -7686,7 +7954,11 @@ class SVGFEFuncGElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7686
7954
 
7687
7955
  @overload
7688
7956
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
7689
- '''This method allows the registration of event listeners on the event target.
7957
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
7958
+
7959
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
7960
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
7961
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
7690
7962
 
7691
7963
  :param type: The event type for which the user is registering
7692
7964
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -7722,17 +7994,28 @@ class SVGFEFuncGElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7722
7994
 
7723
7995
  @overload
7724
7996
  def clone_node(self) -> aspose.html.dom.Node:
7725
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
7997
+ '''Returns a duplicate of the node on which this method was called.
7726
7998
 
7727
- :returns: Returns node'''
7999
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
8000
+
8001
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
7728
8002
  ...
7729
8003
 
7730
8004
  @overload
7731
8005
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
7732
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
8006
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
7733
8007
 
7734
- :param deep: if set to ``true`` [deep].
7735
- :returns: Returns node'''
8008
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
8009
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
8010
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
8011
+
8012
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
8013
+
8014
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
8015
+
8016
+ Note that deep has no effect on empty elements, such as the and elements.
8017
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
8018
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
7736
8019
  ...
7737
8020
 
7738
8021
  @overload
@@ -7755,13 +8038,16 @@ class SVGFEFuncGElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7755
8038
  ...
7756
8039
 
7757
8040
  def get_platform_type(self) -> Type:
7758
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
8041
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
7759
8042
 
7760
- :returns: The ECMAScript object :py:class:`System.Type`.'''
8043
+ :returns: The ECMAScript object.'''
7761
8044
  ...
7762
8045
 
7763
8046
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
7764
- '''This method allows the dispatch of events into the implementations event model.
8047
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
8048
+ the affected EventListeners in the appropriate order.
8049
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
8050
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
7765
8051
 
7766
8052
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
7767
8053
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -7769,9 +8055,9 @@ class SVGFEFuncGElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7769
8055
  ...
7770
8056
 
7771
8057
  def has_child_nodes(self) -> bool:
7772
- '''Returns whether this node has any children.
8058
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
7773
8059
 
7774
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
8060
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
7775
8061
  ...
7776
8062
 
7777
8063
  def normalize(self):
@@ -7787,11 +8073,10 @@ class SVGFEFuncGElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7787
8073
  ...
7788
8074
 
7789
8075
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
7790
- '''Returns whether this node is the same node as the given one.
7791
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
8076
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
7792
8077
 
7793
- :param other_node: The other node.
7794
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
8078
+ :param other_node: The Node to test against.
8079
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
7795
8080
  ...
7796
8081
 
7797
8082
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -7835,17 +8120,19 @@ class SVGFEFuncGElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7835
8120
  ...
7836
8121
 
7837
8122
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
7838
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
8123
+ '''Removes a child node from the DOM and returns the removed node.
7839
8124
 
7840
- :param child: The old child.
7841
- :returns: Returns node'''
8125
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
8126
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
7842
8127
  ...
7843
8128
 
7844
8129
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
7845
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
8130
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
7846
8131
 
7847
- :param node: The node to append.
7848
- :returns: Returns node'''
8132
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
8133
+
8134
+ :param node: The node to append to the given parent node (commonly an element).
8135
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
7849
8136
  ...
7850
8137
 
7851
8138
  def get_attribute_names(self) -> List[str]:
@@ -7955,18 +8242,18 @@ class SVGFEFuncGElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7955
8242
  ...
7956
8243
 
7957
8244
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
7958
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
8245
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
7959
8246
 
7960
- :param name: The tag name.
7961
- :returns: Returns attribute'''
8247
+ :param name: String representation of tag name.
8248
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
7962
8249
  ...
7963
8250
 
7964
8251
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
7965
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
8252
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
7966
8253
 
7967
- :param namespace_uri: The namespace URI.
7968
- :param local_name: Name of the local.
7969
- :returns: Returns elements'''
8254
+ :param namespace_uri: The namespace URI string representation.
8255
+ :param local_name: String representation of local name.
8256
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
7970
8257
  ...
7971
8258
 
7972
8259
  def remove(self):
@@ -7995,11 +8282,10 @@ class SVGFEFuncGElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
7995
8282
  ...
7996
8283
 
7997
8284
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
7998
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
7999
- http://www.w3.org/TR/dom/
8285
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
8000
8286
 
8001
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
8002
- :returns: The :py:class:`aspose.html.dom.Element`.'''
8287
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
8288
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
8003
8289
  ...
8004
8290
 
8005
8291
  @property
@@ -8314,7 +8600,11 @@ class SVGFEFuncRElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
8314
8600
 
8315
8601
  @overload
8316
8602
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
8317
- '''This method allows the registration of event listeners on the event target.
8603
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
8604
+
8605
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
8606
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
8607
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
8318
8608
 
8319
8609
  :param type: The event type for which the user is registering
8320
8610
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -8322,7 +8612,11 @@ class SVGFEFuncRElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
8322
8612
 
8323
8613
  @overload
8324
8614
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
8325
- '''This method allows the registration of event listeners on the event target.
8615
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
8616
+
8617
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
8618
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
8619
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
8326
8620
 
8327
8621
  :param type: The event type for which the user is registering
8328
8622
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -8358,17 +8652,28 @@ class SVGFEFuncRElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
8358
8652
 
8359
8653
  @overload
8360
8654
  def clone_node(self) -> aspose.html.dom.Node:
8361
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
8655
+ '''Returns a duplicate of the node on which this method was called.
8362
8656
 
8363
- :returns: Returns node'''
8657
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
8658
+
8659
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
8364
8660
  ...
8365
8661
 
8366
8662
  @overload
8367
8663
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
8368
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
8664
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
8369
8665
 
8370
- :param deep: if set to ``true`` [deep].
8371
- :returns: Returns node'''
8666
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
8667
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
8668
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
8669
+
8670
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
8671
+
8672
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
8673
+
8674
+ Note that deep has no effect on empty elements, such as the and elements.
8675
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
8676
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
8372
8677
  ...
8373
8678
 
8374
8679
  @overload
@@ -8391,13 +8696,16 @@ class SVGFEFuncRElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
8391
8696
  ...
8392
8697
 
8393
8698
  def get_platform_type(self) -> Type:
8394
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
8699
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
8395
8700
 
8396
- :returns: The ECMAScript object :py:class:`System.Type`.'''
8701
+ :returns: The ECMAScript object.'''
8397
8702
  ...
8398
8703
 
8399
8704
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
8400
- '''This method allows the dispatch of events into the implementations event model.
8705
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
8706
+ the affected EventListeners in the appropriate order.
8707
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
8708
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
8401
8709
 
8402
8710
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
8403
8711
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -8405,9 +8713,9 @@ class SVGFEFuncRElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
8405
8713
  ...
8406
8714
 
8407
8715
  def has_child_nodes(self) -> bool:
8408
- '''Returns whether this node has any children.
8716
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
8409
8717
 
8410
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
8718
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
8411
8719
  ...
8412
8720
 
8413
8721
  def normalize(self):
@@ -8423,11 +8731,10 @@ class SVGFEFuncRElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
8423
8731
  ...
8424
8732
 
8425
8733
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
8426
- '''Returns whether this node is the same node as the given one.
8427
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
8734
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
8428
8735
 
8429
- :param other_node: The other node.
8430
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
8736
+ :param other_node: The Node to test against.
8737
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
8431
8738
  ...
8432
8739
 
8433
8740
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -8471,17 +8778,19 @@ class SVGFEFuncRElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
8471
8778
  ...
8472
8779
 
8473
8780
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
8474
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
8781
+ '''Removes a child node from the DOM and returns the removed node.
8475
8782
 
8476
- :param child: The old child.
8477
- :returns: Returns node'''
8783
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
8784
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
8478
8785
  ...
8479
8786
 
8480
8787
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
8481
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
8788
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
8482
8789
 
8483
- :param node: The node to append.
8484
- :returns: Returns node'''
8790
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
8791
+
8792
+ :param node: The node to append to the given parent node (commonly an element).
8793
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
8485
8794
  ...
8486
8795
 
8487
8796
  def get_attribute_names(self) -> List[str]:
@@ -8591,18 +8900,18 @@ class SVGFEFuncRElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
8591
8900
  ...
8592
8901
 
8593
8902
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
8594
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
8903
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
8595
8904
 
8596
- :param name: The tag name.
8597
- :returns: Returns attribute'''
8905
+ :param name: String representation of tag name.
8906
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
8598
8907
  ...
8599
8908
 
8600
8909
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
8601
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
8910
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
8602
8911
 
8603
- :param namespace_uri: The namespace URI.
8604
- :param local_name: Name of the local.
8605
- :returns: Returns elements'''
8912
+ :param namespace_uri: The namespace URI string representation.
8913
+ :param local_name: String representation of local name.
8914
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
8606
8915
  ...
8607
8916
 
8608
8917
  def remove(self):
@@ -8631,11 +8940,10 @@ class SVGFEFuncRElement(aspose.html.dom.svg.SVGComponentTransferFunctionElement)
8631
8940
  ...
8632
8941
 
8633
8942
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
8634
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
8635
- http://www.w3.org/TR/dom/
8943
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
8636
8944
 
8637
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
8638
- :returns: The :py:class:`aspose.html.dom.Element`.'''
8945
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
8946
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
8639
8947
  ...
8640
8948
 
8641
8949
  @property
@@ -8950,7 +9258,11 @@ class SVGFEGaussianBlurElement(aspose.html.dom.svg.SVGElement):
8950
9258
 
8951
9259
  @overload
8952
9260
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
8953
- '''This method allows the registration of event listeners on the event target.
9261
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
9262
+
9263
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
9264
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
9265
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
8954
9266
 
8955
9267
  :param type: The event type for which the user is registering
8956
9268
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -8958,7 +9270,11 @@ class SVGFEGaussianBlurElement(aspose.html.dom.svg.SVGElement):
8958
9270
 
8959
9271
  @overload
8960
9272
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
8961
- '''This method allows the registration of event listeners on the event target.
9273
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
9274
+
9275
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
9276
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
9277
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
8962
9278
 
8963
9279
  :param type: The event type for which the user is registering
8964
9280
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -8994,17 +9310,28 @@ class SVGFEGaussianBlurElement(aspose.html.dom.svg.SVGElement):
8994
9310
 
8995
9311
  @overload
8996
9312
  def clone_node(self) -> aspose.html.dom.Node:
8997
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
9313
+ '''Returns a duplicate of the node on which this method was called.
8998
9314
 
8999
- :returns: Returns node'''
9315
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
9316
+
9317
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
9000
9318
  ...
9001
9319
 
9002
9320
  @overload
9003
9321
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
9004
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
9322
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
9005
9323
 
9006
- :param deep: if set to ``true`` [deep].
9007
- :returns: Returns node'''
9324
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
9325
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
9326
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
9327
+
9328
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
9329
+
9330
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
9331
+
9332
+ Note that deep has no effect on empty elements, such as the and elements.
9333
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
9334
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
9008
9335
  ...
9009
9336
 
9010
9337
  @overload
@@ -9027,13 +9354,16 @@ class SVGFEGaussianBlurElement(aspose.html.dom.svg.SVGElement):
9027
9354
  ...
9028
9355
 
9029
9356
  def get_platform_type(self) -> Type:
9030
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
9357
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
9031
9358
 
9032
- :returns: The ECMAScript object :py:class:`System.Type`.'''
9359
+ :returns: The ECMAScript object.'''
9033
9360
  ...
9034
9361
 
9035
9362
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
9036
- '''This method allows the dispatch of events into the implementations event model.
9363
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
9364
+ the affected EventListeners in the appropriate order.
9365
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
9366
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
9037
9367
 
9038
9368
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
9039
9369
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -9041,9 +9371,9 @@ class SVGFEGaussianBlurElement(aspose.html.dom.svg.SVGElement):
9041
9371
  ...
9042
9372
 
9043
9373
  def has_child_nodes(self) -> bool:
9044
- '''Returns whether this node has any children.
9374
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
9045
9375
 
9046
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
9376
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
9047
9377
  ...
9048
9378
 
9049
9379
  def normalize(self):
@@ -9059,11 +9389,10 @@ class SVGFEGaussianBlurElement(aspose.html.dom.svg.SVGElement):
9059
9389
  ...
9060
9390
 
9061
9391
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
9062
- '''Returns whether this node is the same node as the given one.
9063
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
9392
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
9064
9393
 
9065
- :param other_node: The other node.
9066
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
9394
+ :param other_node: The Node to test against.
9395
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
9067
9396
  ...
9068
9397
 
9069
9398
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -9107,17 +9436,19 @@ class SVGFEGaussianBlurElement(aspose.html.dom.svg.SVGElement):
9107
9436
  ...
9108
9437
 
9109
9438
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
9110
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
9439
+ '''Removes a child node from the DOM and returns the removed node.
9111
9440
 
9112
- :param child: The old child.
9113
- :returns: Returns node'''
9441
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
9442
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
9114
9443
  ...
9115
9444
 
9116
9445
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
9117
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
9446
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
9118
9447
 
9119
- :param node: The node to append.
9120
- :returns: Returns node'''
9448
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
9449
+
9450
+ :param node: The node to append to the given parent node (commonly an element).
9451
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
9121
9452
  ...
9122
9453
 
9123
9454
  def get_attribute_names(self) -> List[str]:
@@ -9227,18 +9558,18 @@ class SVGFEGaussianBlurElement(aspose.html.dom.svg.SVGElement):
9227
9558
  ...
9228
9559
 
9229
9560
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
9230
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
9561
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
9231
9562
 
9232
- :param name: The tag name.
9233
- :returns: Returns attribute'''
9563
+ :param name: String representation of tag name.
9564
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
9234
9565
  ...
9235
9566
 
9236
9567
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
9237
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
9568
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
9238
9569
 
9239
- :param namespace_uri: The namespace URI.
9240
- :param local_name: Name of the local.
9241
- :returns: Returns elements'''
9570
+ :param namespace_uri: The namespace URI string representation.
9571
+ :param local_name: String representation of local name.
9572
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
9242
9573
  ...
9243
9574
 
9244
9575
  def remove(self):
@@ -9267,11 +9598,10 @@ class SVGFEGaussianBlurElement(aspose.html.dom.svg.SVGElement):
9267
9598
  ...
9268
9599
 
9269
9600
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
9270
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
9271
- http://www.w3.org/TR/dom/
9601
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
9272
9602
 
9273
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
9274
- :returns: The :py:class:`aspose.html.dom.Element`.'''
9603
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
9604
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
9275
9605
  ...
9276
9606
 
9277
9607
  def set_std_deviation(self, std_deviation_x : float, std_deviation_y : float):
@@ -9561,7 +9891,11 @@ class SVGFEImageElement(aspose.html.dom.svg.SVGElement):
9561
9891
 
9562
9892
  @overload
9563
9893
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
9564
- '''This method allows the registration of event listeners on the event target.
9894
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
9895
+
9896
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
9897
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
9898
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
9565
9899
 
9566
9900
  :param type: The event type for which the user is registering
9567
9901
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -9569,7 +9903,11 @@ class SVGFEImageElement(aspose.html.dom.svg.SVGElement):
9569
9903
 
9570
9904
  @overload
9571
9905
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
9572
- '''This method allows the registration of event listeners on the event target.
9906
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
9907
+
9908
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
9909
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
9910
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
9573
9911
 
9574
9912
  :param type: The event type for which the user is registering
9575
9913
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -9605,17 +9943,28 @@ class SVGFEImageElement(aspose.html.dom.svg.SVGElement):
9605
9943
 
9606
9944
  @overload
9607
9945
  def clone_node(self) -> aspose.html.dom.Node:
9608
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
9946
+ '''Returns a duplicate of the node on which this method was called.
9609
9947
 
9610
- :returns: Returns node'''
9948
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
9949
+
9950
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
9611
9951
  ...
9612
9952
 
9613
9953
  @overload
9614
9954
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
9615
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
9955
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
9616
9956
 
9617
- :param deep: if set to ``true`` [deep].
9618
- :returns: Returns node'''
9957
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
9958
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
9959
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
9960
+
9961
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
9962
+
9963
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
9964
+
9965
+ Note that deep has no effect on empty elements, such as the and elements.
9966
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
9967
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
9619
9968
  ...
9620
9969
 
9621
9970
  @overload
@@ -9638,13 +9987,16 @@ class SVGFEImageElement(aspose.html.dom.svg.SVGElement):
9638
9987
  ...
9639
9988
 
9640
9989
  def get_platform_type(self) -> Type:
9641
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
9990
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
9642
9991
 
9643
- :returns: The ECMAScript object :py:class:`System.Type`.'''
9992
+ :returns: The ECMAScript object.'''
9644
9993
  ...
9645
9994
 
9646
9995
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
9647
- '''This method allows the dispatch of events into the implementations event model.
9996
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
9997
+ the affected EventListeners in the appropriate order.
9998
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
9999
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
9648
10000
 
9649
10001
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
9650
10002
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -9652,9 +10004,9 @@ class SVGFEImageElement(aspose.html.dom.svg.SVGElement):
9652
10004
  ...
9653
10005
 
9654
10006
  def has_child_nodes(self) -> bool:
9655
- '''Returns whether this node has any children.
10007
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
9656
10008
 
9657
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
10009
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
9658
10010
  ...
9659
10011
 
9660
10012
  def normalize(self):
@@ -9670,11 +10022,10 @@ class SVGFEImageElement(aspose.html.dom.svg.SVGElement):
9670
10022
  ...
9671
10023
 
9672
10024
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
9673
- '''Returns whether this node is the same node as the given one.
9674
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
10025
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
9675
10026
 
9676
- :param other_node: The other node.
9677
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
10027
+ :param other_node: The Node to test against.
10028
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
9678
10029
  ...
9679
10030
 
9680
10031
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -9718,17 +10069,19 @@ class SVGFEImageElement(aspose.html.dom.svg.SVGElement):
9718
10069
  ...
9719
10070
 
9720
10071
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
9721
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
10072
+ '''Removes a child node from the DOM and returns the removed node.
9722
10073
 
9723
- :param child: The old child.
9724
- :returns: Returns node'''
10074
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
10075
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
9725
10076
  ...
9726
10077
 
9727
10078
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
9728
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
10079
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
9729
10080
 
9730
- :param node: The node to append.
9731
- :returns: Returns node'''
10081
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
10082
+
10083
+ :param node: The node to append to the given parent node (commonly an element).
10084
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
9732
10085
  ...
9733
10086
 
9734
10087
  def get_attribute_names(self) -> List[str]:
@@ -9838,18 +10191,18 @@ class SVGFEImageElement(aspose.html.dom.svg.SVGElement):
9838
10191
  ...
9839
10192
 
9840
10193
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
9841
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
10194
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
9842
10195
 
9843
- :param name: The tag name.
9844
- :returns: Returns attribute'''
10196
+ :param name: String representation of tag name.
10197
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
9845
10198
  ...
9846
10199
 
9847
10200
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
9848
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
10201
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
9849
10202
 
9850
- :param namespace_uri: The namespace URI.
9851
- :param local_name: Name of the local.
9852
- :returns: Returns elements'''
10203
+ :param namespace_uri: The namespace URI string representation.
10204
+ :param local_name: String representation of local name.
10205
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
9853
10206
  ...
9854
10207
 
9855
10208
  def remove(self):
@@ -9878,11 +10231,10 @@ class SVGFEImageElement(aspose.html.dom.svg.SVGElement):
9878
10231
  ...
9879
10232
 
9880
10233
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
9881
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
9882
- http://www.w3.org/TR/dom/
10234
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
9883
10235
 
9884
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
9885
- :returns: The :py:class:`aspose.html.dom.Element`.'''
10236
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
10237
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
9886
10238
  ...
9887
10239
 
9888
10240
  @property
@@ -10161,7 +10513,11 @@ class SVGFEMergeElement(aspose.html.dom.svg.SVGElement):
10161
10513
 
10162
10514
  @overload
10163
10515
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
10164
- '''This method allows the registration of event listeners on the event target.
10516
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
10517
+
10518
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
10519
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
10520
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
10165
10521
 
10166
10522
  :param type: The event type for which the user is registering
10167
10523
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -10169,7 +10525,11 @@ class SVGFEMergeElement(aspose.html.dom.svg.SVGElement):
10169
10525
 
10170
10526
  @overload
10171
10527
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
10172
- '''This method allows the registration of event listeners on the event target.
10528
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
10529
+
10530
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
10531
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
10532
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
10173
10533
 
10174
10534
  :param type: The event type for which the user is registering
10175
10535
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -10205,17 +10565,28 @@ class SVGFEMergeElement(aspose.html.dom.svg.SVGElement):
10205
10565
 
10206
10566
  @overload
10207
10567
  def clone_node(self) -> aspose.html.dom.Node:
10208
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
10568
+ '''Returns a duplicate of the node on which this method was called.
10209
10569
 
10210
- :returns: Returns node'''
10570
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
10571
+
10572
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
10211
10573
  ...
10212
10574
 
10213
10575
  @overload
10214
10576
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
10215
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
10577
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
10216
10578
 
10217
- :param deep: if set to ``true`` [deep].
10218
- :returns: Returns node'''
10579
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
10580
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
10581
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
10582
+
10583
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
10584
+
10585
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
10586
+
10587
+ Note that deep has no effect on empty elements, such as the and elements.
10588
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
10589
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
10219
10590
  ...
10220
10591
 
10221
10592
  @overload
@@ -10238,13 +10609,16 @@ class SVGFEMergeElement(aspose.html.dom.svg.SVGElement):
10238
10609
  ...
10239
10610
 
10240
10611
  def get_platform_type(self) -> Type:
10241
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
10612
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
10242
10613
 
10243
- :returns: The ECMAScript object :py:class:`System.Type`.'''
10614
+ :returns: The ECMAScript object.'''
10244
10615
  ...
10245
10616
 
10246
10617
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
10247
- '''This method allows the dispatch of events into the implementations event model.
10618
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
10619
+ the affected EventListeners in the appropriate order.
10620
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
10621
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
10248
10622
 
10249
10623
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
10250
10624
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -10252,9 +10626,9 @@ class SVGFEMergeElement(aspose.html.dom.svg.SVGElement):
10252
10626
  ...
10253
10627
 
10254
10628
  def has_child_nodes(self) -> bool:
10255
- '''Returns whether this node has any children.
10629
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
10256
10630
 
10257
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
10631
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
10258
10632
  ...
10259
10633
 
10260
10634
  def normalize(self):
@@ -10270,11 +10644,10 @@ class SVGFEMergeElement(aspose.html.dom.svg.SVGElement):
10270
10644
  ...
10271
10645
 
10272
10646
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
10273
- '''Returns whether this node is the same node as the given one.
10274
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
10647
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
10275
10648
 
10276
- :param other_node: The other node.
10277
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
10649
+ :param other_node: The Node to test against.
10650
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
10278
10651
  ...
10279
10652
 
10280
10653
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -10318,17 +10691,19 @@ class SVGFEMergeElement(aspose.html.dom.svg.SVGElement):
10318
10691
  ...
10319
10692
 
10320
10693
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
10321
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
10694
+ '''Removes a child node from the DOM and returns the removed node.
10322
10695
 
10323
- :param child: The old child.
10324
- :returns: Returns node'''
10696
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
10697
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
10325
10698
  ...
10326
10699
 
10327
10700
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
10328
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
10701
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
10329
10702
 
10330
- :param node: The node to append.
10331
- :returns: Returns node'''
10703
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
10704
+
10705
+ :param node: The node to append to the given parent node (commonly an element).
10706
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
10332
10707
  ...
10333
10708
 
10334
10709
  def get_attribute_names(self) -> List[str]:
@@ -10438,18 +10813,18 @@ class SVGFEMergeElement(aspose.html.dom.svg.SVGElement):
10438
10813
  ...
10439
10814
 
10440
10815
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
10441
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
10816
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
10442
10817
 
10443
- :param name: The tag name.
10444
- :returns: Returns attribute'''
10818
+ :param name: String representation of tag name.
10819
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
10445
10820
  ...
10446
10821
 
10447
10822
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
10448
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
10823
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
10449
10824
 
10450
- :param namespace_uri: The namespace URI.
10451
- :param local_name: Name of the local.
10452
- :returns: Returns elements'''
10825
+ :param namespace_uri: The namespace URI string representation.
10826
+ :param local_name: String representation of local name.
10827
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
10453
10828
  ...
10454
10829
 
10455
10830
  def remove(self):
@@ -10478,11 +10853,10 @@ class SVGFEMergeElement(aspose.html.dom.svg.SVGElement):
10478
10853
  ...
10479
10854
 
10480
10855
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
10481
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
10482
- http://www.w3.org/TR/dom/
10856
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
10483
10857
 
10484
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
10485
- :returns: The :py:class:`aspose.html.dom.Element`.'''
10858
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
10859
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
10486
10860
  ...
10487
10861
 
10488
10862
  @property
@@ -10752,7 +11126,11 @@ class SVGFEMergeNodeElement(aspose.html.dom.svg.SVGElement):
10752
11126
 
10753
11127
  @overload
10754
11128
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
10755
- '''This method allows the registration of event listeners on the event target.
11129
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
11130
+
11131
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
11132
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
11133
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
10756
11134
 
10757
11135
  :param type: The event type for which the user is registering
10758
11136
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -10760,7 +11138,11 @@ class SVGFEMergeNodeElement(aspose.html.dom.svg.SVGElement):
10760
11138
 
10761
11139
  @overload
10762
11140
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
10763
- '''This method allows the registration of event listeners on the event target.
11141
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
11142
+
11143
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
11144
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
11145
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
10764
11146
 
10765
11147
  :param type: The event type for which the user is registering
10766
11148
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -10796,17 +11178,28 @@ class SVGFEMergeNodeElement(aspose.html.dom.svg.SVGElement):
10796
11178
 
10797
11179
  @overload
10798
11180
  def clone_node(self) -> aspose.html.dom.Node:
10799
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
11181
+ '''Returns a duplicate of the node on which this method was called.
10800
11182
 
10801
- :returns: Returns node'''
11183
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
11184
+
11185
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
10802
11186
  ...
10803
11187
 
10804
11188
  @overload
10805
11189
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
10806
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
11190
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
10807
11191
 
10808
- :param deep: if set to ``true`` [deep].
10809
- :returns: Returns node'''
11192
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
11193
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
11194
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
11195
+
11196
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
11197
+
11198
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
11199
+
11200
+ Note that deep has no effect on empty elements, such as the and elements.
11201
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
11202
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
10810
11203
  ...
10811
11204
 
10812
11205
  @overload
@@ -10829,13 +11222,16 @@ class SVGFEMergeNodeElement(aspose.html.dom.svg.SVGElement):
10829
11222
  ...
10830
11223
 
10831
11224
  def get_platform_type(self) -> Type:
10832
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
11225
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
10833
11226
 
10834
- :returns: The ECMAScript object :py:class:`System.Type`.'''
11227
+ :returns: The ECMAScript object.'''
10835
11228
  ...
10836
11229
 
10837
11230
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
10838
- '''This method allows the dispatch of events into the implementations event model.
11231
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
11232
+ the affected EventListeners in the appropriate order.
11233
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
11234
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
10839
11235
 
10840
11236
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
10841
11237
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -10843,9 +11239,9 @@ class SVGFEMergeNodeElement(aspose.html.dom.svg.SVGElement):
10843
11239
  ...
10844
11240
 
10845
11241
  def has_child_nodes(self) -> bool:
10846
- '''Returns whether this node has any children.
11242
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
10847
11243
 
10848
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
11244
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
10849
11245
  ...
10850
11246
 
10851
11247
  def normalize(self):
@@ -10861,11 +11257,10 @@ class SVGFEMergeNodeElement(aspose.html.dom.svg.SVGElement):
10861
11257
  ...
10862
11258
 
10863
11259
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
10864
- '''Returns whether this node is the same node as the given one.
10865
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
11260
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
10866
11261
 
10867
- :param other_node: The other node.
10868
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
11262
+ :param other_node: The Node to test against.
11263
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
10869
11264
  ...
10870
11265
 
10871
11266
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -10909,17 +11304,19 @@ class SVGFEMergeNodeElement(aspose.html.dom.svg.SVGElement):
10909
11304
  ...
10910
11305
 
10911
11306
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
10912
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
11307
+ '''Removes a child node from the DOM and returns the removed node.
10913
11308
 
10914
- :param child: The old child.
10915
- :returns: Returns node'''
11309
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
11310
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
10916
11311
  ...
10917
11312
 
10918
11313
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
10919
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
11314
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
10920
11315
 
10921
- :param node: The node to append.
10922
- :returns: Returns node'''
11316
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
11317
+
11318
+ :param node: The node to append to the given parent node (commonly an element).
11319
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
10923
11320
  ...
10924
11321
 
10925
11322
  def get_attribute_names(self) -> List[str]:
@@ -11029,18 +11426,18 @@ class SVGFEMergeNodeElement(aspose.html.dom.svg.SVGElement):
11029
11426
  ...
11030
11427
 
11031
11428
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
11032
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
11429
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
11033
11430
 
11034
- :param name: The tag name.
11035
- :returns: Returns attribute'''
11431
+ :param name: String representation of tag name.
11432
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
11036
11433
  ...
11037
11434
 
11038
11435
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
11039
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
11436
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
11040
11437
 
11041
- :param namespace_uri: The namespace URI.
11042
- :param local_name: Name of the local.
11043
- :returns: Returns elements'''
11438
+ :param namespace_uri: The namespace URI string representation.
11439
+ :param local_name: String representation of local name.
11440
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
11044
11441
  ...
11045
11442
 
11046
11443
  def remove(self):
@@ -11069,11 +11466,10 @@ class SVGFEMergeNodeElement(aspose.html.dom.svg.SVGElement):
11069
11466
  ...
11070
11467
 
11071
11468
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
11072
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
11073
- http://www.w3.org/TR/dom/
11469
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
11074
11470
 
11075
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
11076
- :returns: The :py:class:`aspose.html.dom.Element`.'''
11471
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
11472
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
11077
11473
  ...
11078
11474
 
11079
11475
  @property
@@ -11323,7 +11719,11 @@ class SVGFEMorphologyElement(aspose.html.dom.svg.SVGElement):
11323
11719
 
11324
11720
  @overload
11325
11721
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
11326
- '''This method allows the registration of event listeners on the event target.
11722
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
11723
+
11724
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
11725
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
11726
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
11327
11727
 
11328
11728
  :param type: The event type for which the user is registering
11329
11729
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -11331,7 +11731,11 @@ class SVGFEMorphologyElement(aspose.html.dom.svg.SVGElement):
11331
11731
 
11332
11732
  @overload
11333
11733
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
11334
- '''This method allows the registration of event listeners on the event target.
11734
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
11735
+
11736
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
11737
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
11738
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
11335
11739
 
11336
11740
  :param type: The event type for which the user is registering
11337
11741
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -11367,17 +11771,28 @@ class SVGFEMorphologyElement(aspose.html.dom.svg.SVGElement):
11367
11771
 
11368
11772
  @overload
11369
11773
  def clone_node(self) -> aspose.html.dom.Node:
11370
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
11774
+ '''Returns a duplicate of the node on which this method was called.
11371
11775
 
11372
- :returns: Returns node'''
11776
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
11777
+
11778
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
11373
11779
  ...
11374
11780
 
11375
11781
  @overload
11376
11782
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
11377
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
11783
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
11378
11784
 
11379
- :param deep: if set to ``true`` [deep].
11380
- :returns: Returns node'''
11785
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
11786
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
11787
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
11788
+
11789
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
11790
+
11791
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
11792
+
11793
+ Note that deep has no effect on empty elements, such as the and elements.
11794
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
11795
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
11381
11796
  ...
11382
11797
 
11383
11798
  @overload
@@ -11400,13 +11815,16 @@ class SVGFEMorphologyElement(aspose.html.dom.svg.SVGElement):
11400
11815
  ...
11401
11816
 
11402
11817
  def get_platform_type(self) -> Type:
11403
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
11818
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
11404
11819
 
11405
- :returns: The ECMAScript object :py:class:`System.Type`.'''
11820
+ :returns: The ECMAScript object.'''
11406
11821
  ...
11407
11822
 
11408
11823
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
11409
- '''This method allows the dispatch of events into the implementations event model.
11824
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
11825
+ the affected EventListeners in the appropriate order.
11826
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
11827
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
11410
11828
 
11411
11829
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
11412
11830
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -11414,9 +11832,9 @@ class SVGFEMorphologyElement(aspose.html.dom.svg.SVGElement):
11414
11832
  ...
11415
11833
 
11416
11834
  def has_child_nodes(self) -> bool:
11417
- '''Returns whether this node has any children.
11835
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
11418
11836
 
11419
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
11837
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
11420
11838
  ...
11421
11839
 
11422
11840
  def normalize(self):
@@ -11432,11 +11850,10 @@ class SVGFEMorphologyElement(aspose.html.dom.svg.SVGElement):
11432
11850
  ...
11433
11851
 
11434
11852
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
11435
- '''Returns whether this node is the same node as the given one.
11436
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
11853
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
11437
11854
 
11438
- :param other_node: The other node.
11439
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
11855
+ :param other_node: The Node to test against.
11856
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
11440
11857
  ...
11441
11858
 
11442
11859
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -11480,17 +11897,19 @@ class SVGFEMorphologyElement(aspose.html.dom.svg.SVGElement):
11480
11897
  ...
11481
11898
 
11482
11899
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
11483
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
11900
+ '''Removes a child node from the DOM and returns the removed node.
11484
11901
 
11485
- :param child: The old child.
11486
- :returns: Returns node'''
11902
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
11903
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
11487
11904
  ...
11488
11905
 
11489
11906
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
11490
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
11907
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
11491
11908
 
11492
- :param node: The node to append.
11493
- :returns: Returns node'''
11909
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
11910
+
11911
+ :param node: The node to append to the given parent node (commonly an element).
11912
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
11494
11913
  ...
11495
11914
 
11496
11915
  def get_attribute_names(self) -> List[str]:
@@ -11600,18 +12019,18 @@ class SVGFEMorphologyElement(aspose.html.dom.svg.SVGElement):
11600
12019
  ...
11601
12020
 
11602
12021
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
11603
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
12022
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
11604
12023
 
11605
- :param name: The tag name.
11606
- :returns: Returns attribute'''
12024
+ :param name: String representation of tag name.
12025
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
11607
12026
  ...
11608
12027
 
11609
12028
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
11610
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
12029
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
11611
12030
 
11612
- :param namespace_uri: The namespace URI.
11613
- :param local_name: Name of the local.
11614
- :returns: Returns elements'''
12031
+ :param namespace_uri: The namespace URI string representation.
12032
+ :param local_name: String representation of local name.
12033
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
11615
12034
  ...
11616
12035
 
11617
12036
  def remove(self):
@@ -11640,11 +12059,10 @@ class SVGFEMorphologyElement(aspose.html.dom.svg.SVGElement):
11640
12059
  ...
11641
12060
 
11642
12061
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
11643
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
11644
- http://www.w3.org/TR/dom/
12062
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
11645
12063
 
11646
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
11647
- :returns: The :py:class:`aspose.html.dom.Element`.'''
12064
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
12065
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
11648
12066
  ...
11649
12067
 
11650
12068
  @property
@@ -11950,7 +12368,11 @@ class SVGFEOffsetElement(aspose.html.dom.svg.SVGElement):
11950
12368
 
11951
12369
  @overload
11952
12370
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
11953
- '''This method allows the registration of event listeners on the event target.
12371
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
12372
+
12373
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
12374
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
12375
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
11954
12376
 
11955
12377
  :param type: The event type for which the user is registering
11956
12378
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -11958,7 +12380,11 @@ class SVGFEOffsetElement(aspose.html.dom.svg.SVGElement):
11958
12380
 
11959
12381
  @overload
11960
12382
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
11961
- '''This method allows the registration of event listeners on the event target.
12383
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
12384
+
12385
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
12386
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
12387
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
11962
12388
 
11963
12389
  :param type: The event type for which the user is registering
11964
12390
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -11994,17 +12420,28 @@ class SVGFEOffsetElement(aspose.html.dom.svg.SVGElement):
11994
12420
 
11995
12421
  @overload
11996
12422
  def clone_node(self) -> aspose.html.dom.Node:
11997
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
12423
+ '''Returns a duplicate of the node on which this method was called.
11998
12424
 
11999
- :returns: Returns node'''
12425
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
12426
+
12427
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
12000
12428
  ...
12001
12429
 
12002
12430
  @overload
12003
12431
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
12004
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
12432
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
12005
12433
 
12006
- :param deep: if set to ``true`` [deep].
12007
- :returns: Returns node'''
12434
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
12435
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
12436
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
12437
+
12438
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
12439
+
12440
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
12441
+
12442
+ Note that deep has no effect on empty elements, such as the and elements.
12443
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
12444
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
12008
12445
  ...
12009
12446
 
12010
12447
  @overload
@@ -12027,13 +12464,16 @@ class SVGFEOffsetElement(aspose.html.dom.svg.SVGElement):
12027
12464
  ...
12028
12465
 
12029
12466
  def get_platform_type(self) -> Type:
12030
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
12467
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
12031
12468
 
12032
- :returns: The ECMAScript object :py:class:`System.Type`.'''
12469
+ :returns: The ECMAScript object.'''
12033
12470
  ...
12034
12471
 
12035
12472
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
12036
- '''This method allows the dispatch of events into the implementations event model.
12473
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
12474
+ the affected EventListeners in the appropriate order.
12475
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
12476
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
12037
12477
 
12038
12478
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
12039
12479
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -12041,9 +12481,9 @@ class SVGFEOffsetElement(aspose.html.dom.svg.SVGElement):
12041
12481
  ...
12042
12482
 
12043
12483
  def has_child_nodes(self) -> bool:
12044
- '''Returns whether this node has any children.
12484
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
12045
12485
 
12046
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
12486
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
12047
12487
  ...
12048
12488
 
12049
12489
  def normalize(self):
@@ -12059,11 +12499,10 @@ class SVGFEOffsetElement(aspose.html.dom.svg.SVGElement):
12059
12499
  ...
12060
12500
 
12061
12501
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
12062
- '''Returns whether this node is the same node as the given one.
12063
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
12502
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
12064
12503
 
12065
- :param other_node: The other node.
12066
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
12504
+ :param other_node: The Node to test against.
12505
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
12067
12506
  ...
12068
12507
 
12069
12508
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -12107,17 +12546,19 @@ class SVGFEOffsetElement(aspose.html.dom.svg.SVGElement):
12107
12546
  ...
12108
12547
 
12109
12548
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
12110
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
12549
+ '''Removes a child node from the DOM and returns the removed node.
12111
12550
 
12112
- :param child: The old child.
12113
- :returns: Returns node'''
12551
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
12552
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
12114
12553
  ...
12115
12554
 
12116
12555
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
12117
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
12556
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
12118
12557
 
12119
- :param node: The node to append.
12120
- :returns: Returns node'''
12558
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
12559
+
12560
+ :param node: The node to append to the given parent node (commonly an element).
12561
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
12121
12562
  ...
12122
12563
 
12123
12564
  def get_attribute_names(self) -> List[str]:
@@ -12227,18 +12668,18 @@ class SVGFEOffsetElement(aspose.html.dom.svg.SVGElement):
12227
12668
  ...
12228
12669
 
12229
12670
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
12230
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
12671
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
12231
12672
 
12232
- :param name: The tag name.
12233
- :returns: Returns attribute'''
12673
+ :param name: String representation of tag name.
12674
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
12234
12675
  ...
12235
12676
 
12236
12677
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
12237
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
12678
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
12238
12679
 
12239
- :param namespace_uri: The namespace URI.
12240
- :param local_name: Name of the local.
12241
- :returns: Returns elements'''
12680
+ :param namespace_uri: The namespace URI string representation.
12681
+ :param local_name: String representation of local name.
12682
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
12242
12683
  ...
12243
12684
 
12244
12685
  def remove(self):
@@ -12267,11 +12708,10 @@ class SVGFEOffsetElement(aspose.html.dom.svg.SVGElement):
12267
12708
  ...
12268
12709
 
12269
12710
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
12270
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
12271
- http://www.w3.org/TR/dom/
12711
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
12272
12712
 
12273
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
12274
- :returns: The :py:class:`aspose.html.dom.Element`.'''
12713
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
12714
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
12275
12715
  ...
12276
12716
 
12277
12717
  @property
@@ -12556,7 +12996,11 @@ class SVGFEPointLightElement(aspose.html.dom.svg.SVGElement):
12556
12996
 
12557
12997
  @overload
12558
12998
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
12559
- '''This method allows the registration of event listeners on the event target.
12999
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
13000
+
13001
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
13002
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
13003
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
12560
13004
 
12561
13005
  :param type: The event type for which the user is registering
12562
13006
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -12564,7 +13008,11 @@ class SVGFEPointLightElement(aspose.html.dom.svg.SVGElement):
12564
13008
 
12565
13009
  @overload
12566
13010
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
12567
- '''This method allows the registration of event listeners on the event target.
13011
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
13012
+
13013
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
13014
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
13015
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
12568
13016
 
12569
13017
  :param type: The event type for which the user is registering
12570
13018
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -12600,17 +13048,28 @@ class SVGFEPointLightElement(aspose.html.dom.svg.SVGElement):
12600
13048
 
12601
13049
  @overload
12602
13050
  def clone_node(self) -> aspose.html.dom.Node:
12603
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
13051
+ '''Returns a duplicate of the node on which this method was called.
12604
13052
 
12605
- :returns: Returns node'''
13053
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
13054
+
13055
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
12606
13056
  ...
12607
13057
 
12608
13058
  @overload
12609
13059
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
12610
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
13060
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
12611
13061
 
12612
- :param deep: if set to ``true`` [deep].
12613
- :returns: Returns node'''
13062
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
13063
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
13064
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
13065
+
13066
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
13067
+
13068
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
13069
+
13070
+ Note that deep has no effect on empty elements, such as the and elements.
13071
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
13072
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
12614
13073
  ...
12615
13074
 
12616
13075
  @overload
@@ -12633,13 +13092,16 @@ class SVGFEPointLightElement(aspose.html.dom.svg.SVGElement):
12633
13092
  ...
12634
13093
 
12635
13094
  def get_platform_type(self) -> Type:
12636
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
13095
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
12637
13096
 
12638
- :returns: The ECMAScript object :py:class:`System.Type`.'''
13097
+ :returns: The ECMAScript object.'''
12639
13098
  ...
12640
13099
 
12641
13100
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
12642
- '''This method allows the dispatch of events into the implementations event model.
13101
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
13102
+ the affected EventListeners in the appropriate order.
13103
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
13104
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
12643
13105
 
12644
13106
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
12645
13107
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -12647,9 +13109,9 @@ class SVGFEPointLightElement(aspose.html.dom.svg.SVGElement):
12647
13109
  ...
12648
13110
 
12649
13111
  def has_child_nodes(self) -> bool:
12650
- '''Returns whether this node has any children.
13112
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
12651
13113
 
12652
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
13114
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
12653
13115
  ...
12654
13116
 
12655
13117
  def normalize(self):
@@ -12665,11 +13127,10 @@ class SVGFEPointLightElement(aspose.html.dom.svg.SVGElement):
12665
13127
  ...
12666
13128
 
12667
13129
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
12668
- '''Returns whether this node is the same node as the given one.
12669
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
13130
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
12670
13131
 
12671
- :param other_node: The other node.
12672
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
13132
+ :param other_node: The Node to test against.
13133
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
12673
13134
  ...
12674
13135
 
12675
13136
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -12713,17 +13174,19 @@ class SVGFEPointLightElement(aspose.html.dom.svg.SVGElement):
12713
13174
  ...
12714
13175
 
12715
13176
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
12716
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
13177
+ '''Removes a child node from the DOM and returns the removed node.
12717
13178
 
12718
- :param child: The old child.
12719
- :returns: Returns node'''
13179
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
13180
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
12720
13181
  ...
12721
13182
 
12722
13183
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
12723
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
13184
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
12724
13185
 
12725
- :param node: The node to append.
12726
- :returns: Returns node'''
13186
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
13187
+
13188
+ :param node: The node to append to the given parent node (commonly an element).
13189
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
12727
13190
  ...
12728
13191
 
12729
13192
  def get_attribute_names(self) -> List[str]:
@@ -12833,18 +13296,18 @@ class SVGFEPointLightElement(aspose.html.dom.svg.SVGElement):
12833
13296
  ...
12834
13297
 
12835
13298
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
12836
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
13299
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
12837
13300
 
12838
- :param name: The tag name.
12839
- :returns: Returns attribute'''
13301
+ :param name: String representation of tag name.
13302
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
12840
13303
  ...
12841
13304
 
12842
13305
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
12843
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
13306
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
12844
13307
 
12845
- :param namespace_uri: The namespace URI.
12846
- :param local_name: Name of the local.
12847
- :returns: Returns elements'''
13308
+ :param namespace_uri: The namespace URI string representation.
13309
+ :param local_name: String representation of local name.
13310
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
12848
13311
  ...
12849
13312
 
12850
13313
  def remove(self):
@@ -12873,11 +13336,10 @@ class SVGFEPointLightElement(aspose.html.dom.svg.SVGElement):
12873
13336
  ...
12874
13337
 
12875
13338
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
12876
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
12877
- http://www.w3.org/TR/dom/
13339
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
12878
13340
 
12879
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
12880
- :returns: The :py:class:`aspose.html.dom.Element`.'''
13341
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
13342
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
12881
13343
  ...
12882
13344
 
12883
13345
  @property
@@ -13137,7 +13599,11 @@ class SVGFESpecularLightingElement(aspose.html.dom.svg.SVGElement):
13137
13599
 
13138
13600
  @overload
13139
13601
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
13140
- '''This method allows the registration of event listeners on the event target.
13602
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
13603
+
13604
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
13605
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
13606
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
13141
13607
 
13142
13608
  :param type: The event type for which the user is registering
13143
13609
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -13145,7 +13611,11 @@ class SVGFESpecularLightingElement(aspose.html.dom.svg.SVGElement):
13145
13611
 
13146
13612
  @overload
13147
13613
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
13148
- '''This method allows the registration of event listeners on the event target.
13614
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
13615
+
13616
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
13617
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
13618
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
13149
13619
 
13150
13620
  :param type: The event type for which the user is registering
13151
13621
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -13181,17 +13651,28 @@ class SVGFESpecularLightingElement(aspose.html.dom.svg.SVGElement):
13181
13651
 
13182
13652
  @overload
13183
13653
  def clone_node(self) -> aspose.html.dom.Node:
13184
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
13654
+ '''Returns a duplicate of the node on which this method was called.
13185
13655
 
13186
- :returns: Returns node'''
13656
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
13657
+
13658
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
13187
13659
  ...
13188
13660
 
13189
13661
  @overload
13190
13662
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
13191
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
13663
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
13192
13664
 
13193
- :param deep: if set to ``true`` [deep].
13194
- :returns: Returns node'''
13665
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
13666
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
13667
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
13668
+
13669
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
13670
+
13671
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
13672
+
13673
+ Note that deep has no effect on empty elements, such as the and elements.
13674
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
13675
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
13195
13676
  ...
13196
13677
 
13197
13678
  @overload
@@ -13214,13 +13695,16 @@ class SVGFESpecularLightingElement(aspose.html.dom.svg.SVGElement):
13214
13695
  ...
13215
13696
 
13216
13697
  def get_platform_type(self) -> Type:
13217
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
13698
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
13218
13699
 
13219
- :returns: The ECMAScript object :py:class:`System.Type`.'''
13700
+ :returns: The ECMAScript object.'''
13220
13701
  ...
13221
13702
 
13222
13703
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
13223
- '''This method allows the dispatch of events into the implementations event model.
13704
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
13705
+ the affected EventListeners in the appropriate order.
13706
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
13707
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
13224
13708
 
13225
13709
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
13226
13710
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -13228,9 +13712,9 @@ class SVGFESpecularLightingElement(aspose.html.dom.svg.SVGElement):
13228
13712
  ...
13229
13713
 
13230
13714
  def has_child_nodes(self) -> bool:
13231
- '''Returns whether this node has any children.
13715
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
13232
13716
 
13233
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
13717
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
13234
13718
  ...
13235
13719
 
13236
13720
  def normalize(self):
@@ -13246,11 +13730,10 @@ class SVGFESpecularLightingElement(aspose.html.dom.svg.SVGElement):
13246
13730
  ...
13247
13731
 
13248
13732
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
13249
- '''Returns whether this node is the same node as the given one.
13250
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
13733
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
13251
13734
 
13252
- :param other_node: The other node.
13253
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
13735
+ :param other_node: The Node to test against.
13736
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
13254
13737
  ...
13255
13738
 
13256
13739
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -13294,17 +13777,19 @@ class SVGFESpecularLightingElement(aspose.html.dom.svg.SVGElement):
13294
13777
  ...
13295
13778
 
13296
13779
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
13297
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
13780
+ '''Removes a child node from the DOM and returns the removed node.
13298
13781
 
13299
- :param child: The old child.
13300
- :returns: Returns node'''
13782
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
13783
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
13301
13784
  ...
13302
13785
 
13303
13786
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
13304
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
13787
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
13305
13788
 
13306
- :param node: The node to append.
13307
- :returns: Returns node'''
13789
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
13790
+
13791
+ :param node: The node to append to the given parent node (commonly an element).
13792
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
13308
13793
  ...
13309
13794
 
13310
13795
  def get_attribute_names(self) -> List[str]:
@@ -13414,18 +13899,18 @@ class SVGFESpecularLightingElement(aspose.html.dom.svg.SVGElement):
13414
13899
  ...
13415
13900
 
13416
13901
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
13417
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
13902
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
13418
13903
 
13419
- :param name: The tag name.
13420
- :returns: Returns attribute'''
13904
+ :param name: String representation of tag name.
13905
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
13421
13906
  ...
13422
13907
 
13423
13908
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
13424
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
13909
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
13425
13910
 
13426
- :param namespace_uri: The namespace URI.
13427
- :param local_name: Name of the local.
13428
- :returns: Returns elements'''
13911
+ :param namespace_uri: The namespace URI string representation.
13912
+ :param local_name: String representation of local name.
13913
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
13429
13914
  ...
13430
13915
 
13431
13916
  def remove(self):
@@ -13454,11 +13939,10 @@ class SVGFESpecularLightingElement(aspose.html.dom.svg.SVGElement):
13454
13939
  ...
13455
13940
 
13456
13941
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
13457
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
13458
- http://www.w3.org/TR/dom/
13942
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
13459
13943
 
13460
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
13461
- :returns: The :py:class:`aspose.html.dom.Element`.'''
13944
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
13945
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
13462
13946
  ...
13463
13947
 
13464
13948
  @property
@@ -13753,7 +14237,11 @@ class SVGFESpotLightElement(aspose.html.dom.svg.SVGElement):
13753
14237
 
13754
14238
  @overload
13755
14239
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
13756
- '''This method allows the registration of event listeners on the event target.
14240
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
14241
+
14242
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
14243
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
14244
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
13757
14245
 
13758
14246
  :param type: The event type for which the user is registering
13759
14247
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -13761,7 +14249,11 @@ class SVGFESpotLightElement(aspose.html.dom.svg.SVGElement):
13761
14249
 
13762
14250
  @overload
13763
14251
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
13764
- '''This method allows the registration of event listeners on the event target.
14252
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
14253
+
14254
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
14255
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
14256
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
13765
14257
 
13766
14258
  :param type: The event type for which the user is registering
13767
14259
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -13797,17 +14289,28 @@ class SVGFESpotLightElement(aspose.html.dom.svg.SVGElement):
13797
14289
 
13798
14290
  @overload
13799
14291
  def clone_node(self) -> aspose.html.dom.Node:
13800
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
14292
+ '''Returns a duplicate of the node on which this method was called.
13801
14293
 
13802
- :returns: Returns node'''
14294
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
14295
+
14296
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
13803
14297
  ...
13804
14298
 
13805
14299
  @overload
13806
14300
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
13807
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
14301
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
13808
14302
 
13809
- :param deep: if set to ``true`` [deep].
13810
- :returns: Returns node'''
14303
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
14304
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
14305
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
14306
+
14307
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
14308
+
14309
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
14310
+
14311
+ Note that deep has no effect on empty elements, such as the and elements.
14312
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
14313
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
13811
14314
  ...
13812
14315
 
13813
14316
  @overload
@@ -13830,13 +14333,16 @@ class SVGFESpotLightElement(aspose.html.dom.svg.SVGElement):
13830
14333
  ...
13831
14334
 
13832
14335
  def get_platform_type(self) -> Type:
13833
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
14336
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
13834
14337
 
13835
- :returns: The ECMAScript object :py:class:`System.Type`.'''
14338
+ :returns: The ECMAScript object.'''
13836
14339
  ...
13837
14340
 
13838
14341
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
13839
- '''This method allows the dispatch of events into the implementations event model.
14342
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
14343
+ the affected EventListeners in the appropriate order.
14344
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
14345
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
13840
14346
 
13841
14347
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
13842
14348
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -13844,9 +14350,9 @@ class SVGFESpotLightElement(aspose.html.dom.svg.SVGElement):
13844
14350
  ...
13845
14351
 
13846
14352
  def has_child_nodes(self) -> bool:
13847
- '''Returns whether this node has any children.
14353
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
13848
14354
 
13849
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
14355
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
13850
14356
  ...
13851
14357
 
13852
14358
  def normalize(self):
@@ -13862,11 +14368,10 @@ class SVGFESpotLightElement(aspose.html.dom.svg.SVGElement):
13862
14368
  ...
13863
14369
 
13864
14370
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
13865
- '''Returns whether this node is the same node as the given one.
13866
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
14371
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
13867
14372
 
13868
- :param other_node: The other node.
13869
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
14373
+ :param other_node: The Node to test against.
14374
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
13870
14375
  ...
13871
14376
 
13872
14377
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -13910,17 +14415,19 @@ class SVGFESpotLightElement(aspose.html.dom.svg.SVGElement):
13910
14415
  ...
13911
14416
 
13912
14417
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
13913
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
14418
+ '''Removes a child node from the DOM and returns the removed node.
13914
14419
 
13915
- :param child: The old child.
13916
- :returns: Returns node'''
14420
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
14421
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
13917
14422
  ...
13918
14423
 
13919
14424
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
13920
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
14425
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
13921
14426
 
13922
- :param node: The node to append.
13923
- :returns: Returns node'''
14427
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
14428
+
14429
+ :param node: The node to append to the given parent node (commonly an element).
14430
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
13924
14431
  ...
13925
14432
 
13926
14433
  def get_attribute_names(self) -> List[str]:
@@ -14030,18 +14537,18 @@ class SVGFESpotLightElement(aspose.html.dom.svg.SVGElement):
14030
14537
  ...
14031
14538
 
14032
14539
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
14033
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
14540
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
14034
14541
 
14035
- :param name: The tag name.
14036
- :returns: Returns attribute'''
14542
+ :param name: String representation of tag name.
14543
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
14037
14544
  ...
14038
14545
 
14039
14546
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
14040
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
14547
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
14041
14548
 
14042
- :param namespace_uri: The namespace URI.
14043
- :param local_name: Name of the local.
14044
- :returns: Returns elements'''
14549
+ :param namespace_uri: The namespace URI string representation.
14550
+ :param local_name: String representation of local name.
14551
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
14045
14552
  ...
14046
14553
 
14047
14554
  def remove(self):
@@ -14070,11 +14577,10 @@ class SVGFESpotLightElement(aspose.html.dom.svg.SVGElement):
14070
14577
  ...
14071
14578
 
14072
14579
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
14073
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
14074
- http://www.w3.org/TR/dom/
14580
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
14075
14581
 
14076
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
14077
- :returns: The :py:class:`aspose.html.dom.Element`.'''
14582
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
14583
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
14078
14584
  ...
14079
14585
 
14080
14586
  @property
@@ -14354,7 +14860,11 @@ class SVGFETileElement(aspose.html.dom.svg.SVGElement):
14354
14860
 
14355
14861
  @overload
14356
14862
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
14357
- '''This method allows the registration of event listeners on the event target.
14863
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
14864
+
14865
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
14866
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
14867
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
14358
14868
 
14359
14869
  :param type: The event type for which the user is registering
14360
14870
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -14362,7 +14872,11 @@ class SVGFETileElement(aspose.html.dom.svg.SVGElement):
14362
14872
 
14363
14873
  @overload
14364
14874
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
14365
- '''This method allows the registration of event listeners on the event target.
14875
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
14876
+
14877
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
14878
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
14879
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
14366
14880
 
14367
14881
  :param type: The event type for which the user is registering
14368
14882
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -14398,17 +14912,28 @@ class SVGFETileElement(aspose.html.dom.svg.SVGElement):
14398
14912
 
14399
14913
  @overload
14400
14914
  def clone_node(self) -> aspose.html.dom.Node:
14401
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
14915
+ '''Returns a duplicate of the node on which this method was called.
14402
14916
 
14403
- :returns: Returns node'''
14917
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
14918
+
14919
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
14404
14920
  ...
14405
14921
 
14406
14922
  @overload
14407
14923
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
14408
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
14924
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
14409
14925
 
14410
- :param deep: if set to ``true`` [deep].
14411
- :returns: Returns node'''
14926
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
14927
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
14928
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
14929
+
14930
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
14931
+
14932
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
14933
+
14934
+ Note that deep has no effect on empty elements, such as the and elements.
14935
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
14936
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
14412
14937
  ...
14413
14938
 
14414
14939
  @overload
@@ -14431,13 +14956,16 @@ class SVGFETileElement(aspose.html.dom.svg.SVGElement):
14431
14956
  ...
14432
14957
 
14433
14958
  def get_platform_type(self) -> Type:
14434
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
14959
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
14435
14960
 
14436
- :returns: The ECMAScript object :py:class:`System.Type`.'''
14961
+ :returns: The ECMAScript object.'''
14437
14962
  ...
14438
14963
 
14439
14964
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
14440
- '''This method allows the dispatch of events into the implementations event model.
14965
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
14966
+ the affected EventListeners in the appropriate order.
14967
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
14968
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
14441
14969
 
14442
14970
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
14443
14971
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -14445,9 +14973,9 @@ class SVGFETileElement(aspose.html.dom.svg.SVGElement):
14445
14973
  ...
14446
14974
 
14447
14975
  def has_child_nodes(self) -> bool:
14448
- '''Returns whether this node has any children.
14976
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
14449
14977
 
14450
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
14978
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
14451
14979
  ...
14452
14980
 
14453
14981
  def normalize(self):
@@ -14463,11 +14991,10 @@ class SVGFETileElement(aspose.html.dom.svg.SVGElement):
14463
14991
  ...
14464
14992
 
14465
14993
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
14466
- '''Returns whether this node is the same node as the given one.
14467
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
14994
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
14468
14995
 
14469
- :param other_node: The other node.
14470
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
14996
+ :param other_node: The Node to test against.
14997
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
14471
14998
  ...
14472
14999
 
14473
15000
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -14511,17 +15038,19 @@ class SVGFETileElement(aspose.html.dom.svg.SVGElement):
14511
15038
  ...
14512
15039
 
14513
15040
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
14514
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
15041
+ '''Removes a child node from the DOM and returns the removed node.
14515
15042
 
14516
- :param child: The old child.
14517
- :returns: Returns node'''
15043
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
15044
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
14518
15045
  ...
14519
15046
 
14520
15047
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
14521
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
15048
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
14522
15049
 
14523
- :param node: The node to append.
14524
- :returns: Returns node'''
15050
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
15051
+
15052
+ :param node: The node to append to the given parent node (commonly an element).
15053
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
14525
15054
  ...
14526
15055
 
14527
15056
  def get_attribute_names(self) -> List[str]:
@@ -14631,18 +15160,18 @@ class SVGFETileElement(aspose.html.dom.svg.SVGElement):
14631
15160
  ...
14632
15161
 
14633
15162
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
14634
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
15163
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
14635
15164
 
14636
- :param name: The tag name.
14637
- :returns: Returns attribute'''
15165
+ :param name: String representation of tag name.
15166
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
14638
15167
  ...
14639
15168
 
14640
15169
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
14641
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
15170
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
14642
15171
 
14643
- :param namespace_uri: The namespace URI.
14644
- :param local_name: Name of the local.
14645
- :returns: Returns elements'''
15172
+ :param namespace_uri: The namespace URI string representation.
15173
+ :param local_name: String representation of local name.
15174
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
14646
15175
  ...
14647
15176
 
14648
15177
  def remove(self):
@@ -14671,11 +15200,10 @@ class SVGFETileElement(aspose.html.dom.svg.SVGElement):
14671
15200
  ...
14672
15201
 
14673
15202
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
14674
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
14675
- http://www.w3.org/TR/dom/
15203
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
14676
15204
 
14677
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
14678
- :returns: The :py:class:`aspose.html.dom.Element`.'''
15205
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
15206
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
14679
15207
  ...
14680
15208
 
14681
15209
  @property
@@ -14950,7 +15478,11 @@ class SVGFETurbulenceElement(aspose.html.dom.svg.SVGElement):
14950
15478
 
14951
15479
  @overload
14952
15480
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener):
14953
- '''This method allows the registration of event listeners on the event target.
15481
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
15482
+
15483
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
15484
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
15485
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
14954
15486
 
14955
15487
  :param type: The event type for which the user is registering
14956
15488
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.'''
@@ -14958,7 +15490,11 @@ class SVGFETurbulenceElement(aspose.html.dom.svg.SVGElement):
14958
15490
 
14959
15491
  @overload
14960
15492
  def add_event_listener(self, type : str, listener : aspose.html.dom.events.IEventListener, use_capture : bool):
14961
- '''This method allows the registration of event listeners on the event target.
15493
+ '''Sets up a function that will be called whenever the specified event is delivered to the target.
15494
+
15495
+ It works by adding a function, or an object that implements :py:class:`aspose.html.dom.events.IEventListener`,
15496
+ to the list of event listeners for the specified event type on the :py:class:`aspose.html.dom.EventTarget` on which it's called.
15497
+ If the function or object, is already in the list of event listeners for this target, they are not added a second time.
14962
15498
 
14963
15499
  :param type: The event type for which the user is registering
14964
15500
  :param listener: Takes an interface implemented by the user which contains the methods to be called when the event occurs.
@@ -14994,17 +15530,28 @@ class SVGFETurbulenceElement(aspose.html.dom.svg.SVGElement):
14994
15530
 
14995
15531
  @overload
14996
15532
  def clone_node(self) -> aspose.html.dom.Node:
14997
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
15533
+ '''Returns a duplicate of the node on which this method was called.
14998
15534
 
14999
- :returns: Returns node'''
15535
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners. It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener` or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
15536
+
15537
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document, until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
15000
15538
  ...
15001
15539
 
15002
15540
  @overload
15003
15541
  def clone_node(self, deep : bool) -> aspose.html.dom.Node:
15004
- '''Returns a duplicate of this node, i.e., serves as a generic copy constructor for nodes. The duplicate node has no parent (parentNode is null) and no user data.
15542
+ '''Returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
15005
15543
 
15006
- :param deep: if set to ``true`` [deep].
15007
- :returns: Returns node'''
15544
+ Cloning a node copies all of its attributes and their values, including intrinsic (inline) listeners.
15545
+ It does not copy event listeners added using :py:func:`aspose.html.dom.events.IEventTarget.add_event_listener`
15546
+ or those assigned to element properties (e.g., node.onclick = someFunction). Additionally, for a HTMLCanvasElement element, the painted image is not copied.
15547
+
15548
+ :param deep: If , then the node and its whole subtree, including text that may be in child :py:class:`aspose.html.dom.Text` nodes, is also copied.
15549
+
15550
+ If , only the node will be cloned. The subtree, including any text that the node contains, is not cloned.
15551
+
15552
+ Note that deep has no effect on empty elements, such as the and elements.
15553
+ :returns: The new :py:class:`aspose.html.dom.Node` cloned. The cloned node has no parent and is not part of the document,
15554
+ until it is added to another node that is part of the document, using :py:func:`aspose.html.dom.Node.append_child` or a similar method.'''
15008
15555
  ...
15009
15556
 
15010
15557
  @overload
@@ -15027,13 +15574,16 @@ class SVGFETurbulenceElement(aspose.html.dom.svg.SVGElement):
15027
15574
  ...
15028
15575
 
15029
15576
  def get_platform_type(self) -> Type:
15030
- '''This method is used to retrieve ECMAScript object :py:class:`System.Type`.
15577
+ '''This method is used to retrieve the ECMAScript object :py:class:`System.Type`.
15031
15578
 
15032
- :returns: The ECMAScript object :py:class:`System.Type`.'''
15579
+ :returns: The ECMAScript object.'''
15033
15580
  ...
15034
15581
 
15035
15582
  def dispatch_event(self, event : aspose.html.dom.events.Event) -> bool:
15036
- '''This method allows the dispatch of events into the implementations event model.
15583
+ '''Dispatches an Event at the specified :py:class:`aspose.html.dom.events.IEventTarget`, (synchronously) invoking
15584
+ the affected EventListeners in the appropriate order.
15585
+ The normal event processing rules (including the capturing and optional bubbling phase) also apply to events
15586
+ dispatched manually with :py:func:`aspose.html.dom.events.IEventTarget.dispatch_event`.
15037
15587
 
15038
15588
  :param event: Specifies the event type, behavior, and contextual information to be used in processing the event.
15039
15589
  :returns: The return value of :py:func:`aspose.html.dom.EventTarget.dispatch_event` indicates whether any of the listeners which handled the event called :py:func:`aspose.html.dom.events.Event.prevent_default`.
@@ -15041,9 +15591,9 @@ class SVGFETurbulenceElement(aspose.html.dom.svg.SVGElement):
15041
15591
  ...
15042
15592
 
15043
15593
  def has_child_nodes(self) -> bool:
15044
- '''Returns whether this node has any children.
15594
+ '''Returns a boolean value indicating whether the given :py:class:`aspose.html.dom.Node` has child nodes or not.
15045
15595
 
15046
- :returns: ``true`` if has child nodes otherwise, ``false``.'''
15596
+ :returns: A boolean value that is if the node has child nodes, and otherwise.'''
15047
15597
  ...
15048
15598
 
15049
15599
  def normalize(self):
@@ -15059,11 +15609,10 @@ class SVGFETurbulenceElement(aspose.html.dom.svg.SVGElement):
15059
15609
  ...
15060
15610
 
15061
15611
  def is_same_node(self, other_node : aspose.html.dom.Node) -> bool:
15062
- '''Returns whether this node is the same node as the given one.
15063
- This method provides a way to determine whether two Node references returned by the implementation reference the same object. When two Node references are references to the same object, even if through a proxy, the references may be used completely interchangeably, such that all attributes have the same values and calling the same DOM method on either reference always has exactly the same effect.
15612
+ '''Method is a legacy alias the for the strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
15064
15613
 
15065
- :param other_node: The other node.
15066
- :returns: ``true`` if [is same node] [the specified other]; otherwise, ``false``.'''
15614
+ :param other_node: The Node to test against.
15615
+ :returns: A boolean value that is if both nodes are strictly equal, if not.'''
15067
15616
  ...
15068
15617
 
15069
15618
  def lookup_prefix(self, namespace_uri : str) -> str:
@@ -15107,17 +15656,19 @@ class SVGFETurbulenceElement(aspose.html.dom.svg.SVGElement):
15107
15656
  ...
15108
15657
 
15109
15658
  def remove_child(self, child : aspose.html.dom.Node) -> aspose.html.dom.Node:
15110
- '''Removes the child node indicated by oldChild from the list of children, and returns it.
15659
+ '''Removes a child node from the DOM and returns the removed node.
15111
15660
 
15112
- :param child: The old child.
15113
- :returns: Returns node'''
15661
+ :param child: A :py:class:`aspose.html.dom.Node` that is the child node to be removed from the DOM.
15662
+ :returns: Unlike :py:func:`aspose.html.dom.Node.clone_node` the return value preserves the :py:class:`aspose.html.dom.events.IEventListener` objects associated with it.'''
15114
15663
  ...
15115
15664
 
15116
15665
  def append_child(self, node : aspose.html.dom.Node) -> aspose.html.dom.Node:
15117
- '''Adds the node newChild to the end of the list of children of this node. If the newChild is already in the tree, it is first removed.
15666
+ '''Adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, :py:func:`aspose.html.dom.Node.append_child` moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
15118
15667
 
15119
- :param node: The node to append.
15120
- :returns: Returns node'''
15668
+ This means that a node can't be in two points of the document simultaneously. So if the node already has a parent, the node is first removed, then appended at the new position. The :py:func:`aspose.html.dom.Node.clone_node` method can be used to make a copy of the node before appending it under the new parent. Copies made with :py:func:`aspose.html.dom.Node.clone_node` are not be automatically kept in sync.
15669
+
15670
+ :param node: The node to append to the given parent node (commonly an element).
15671
+ :returns: A Node that is the appended child, except when child is a :py:class:`aspose.html.dom.DocumentFragment`, in which case the empty :py:class:`aspose.html.dom.DocumentFragment` is returned.'''
15121
15672
  ...
15122
15673
 
15123
15674
  def get_attribute_names(self) -> List[str]:
@@ -15227,18 +15778,18 @@ class SVGFETurbulenceElement(aspose.html.dom.svg.SVGElement):
15227
15778
  ...
15228
15779
 
15229
15780
  def get_elements_by_tag_name(self, name : str) -> aspose.html.collections.HTMLCollection:
15230
- '''Returns a NodeList of all descendant Elements with a given tag name, in document order.
15781
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given tag name, in document order.
15231
15782
 
15232
- :param name: The tag name.
15233
- :returns: Returns attribute'''
15783
+ :param name: String representation of tag name.
15784
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
15234
15785
  ...
15235
15786
 
15236
15787
  def get_elements_by_tag_name_ns(self, namespace_uri : str, local_name : str) -> aspose.html.collections.HTMLCollection:
15237
- '''Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
15788
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all :py:class:`aspose.html.dom.Element` with a given local name and namespace URI string in document order.
15238
15789
 
15239
- :param namespace_uri: The namespace URI.
15240
- :param local_name: Name of the local.
15241
- :returns: Returns elements'''
15790
+ :param namespace_uri: The namespace URI string representation.
15791
+ :param local_name: String representation of local name.
15792
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
15242
15793
  ...
15243
15794
 
15244
15795
  def remove(self):
@@ -15267,11 +15818,10 @@ class SVGFETurbulenceElement(aspose.html.dom.svg.SVGElement):
15267
15818
  ...
15268
15819
 
15269
15820
  def get_elements_by_class_name(self, class_names : str) -> aspose.html.collections.HTMLCollection:
15270
- '''Returns a live NodeList object containing all the elements in the document that have all the classes specified in argument.
15271
- http://www.w3.org/TR/dom/
15821
+ '''Returns :py:class:`aspose.html.collections.HTMLCollection` object containing all the elements within :py:class:`aspose.html.dom.Element` that have all the classes specified in argument.
15272
15822
 
15273
- :param class_names: The string string that contains an unordered set of unique space-separated tokens representing classes (class names)
15274
- :returns: The :py:class:`aspose.html.dom.Element`.'''
15823
+ :param class_names: The string that contains an unordered set of unique space-separated tokens representing classes (class names)
15824
+ :returns: A live :py:class:`aspose.html.collections.HTMLCollection` of found elements.'''
15275
15825
  ...
15276
15826
 
15277
15827
  @property