Programmierung

XML DOM compareBoundaryPoints() Methode

Definition und Verwendung

Die Methode compareBoundaryPoints() vergleicht die Positionen zweier Bereiche.

Syntax:howcompareBoundaryPoints(sourceRange,

)

) Beschreibung
how Parameter
sourceRange muss mit dem Bereich verglichen werden, der verglichen werden soll. Es ist der Wert der Konstanten der Range-Schnittstelle. Die gültigen Werte sind die Konstanten der Range-Schnittstelle.

Rückgabewert

wenn der angegebene Grenzpunkt des aktuellen Bereichs sourceRange liegt sourceRange nach dem angegebenen Grenzpunkt zurückgegeben wird, wird 1 zurückgegeben. Wenn der angegebene Grenzpunkt vor dem aktuellen Bereich liegt, wird -1 zurückgegeben. Wenn die beiden angegebenen Grenzpunkte gleich sind, wird 0 zurückgegeben. Wenn der aktuelle Bereichsgrenzpunkt

werfen

Wenn sourceRange bedeutet, dass das Dokument, das durch diesen Ausdruck dargestellt wird, anders ist als das Dokument, das durch den aktuellen Bereich dargestellt wird, und die Methode wirft einen Fehler mit dem Code WRONG_DOCUMENT_ERR aus. DOMException-Exception.

Beschreibung

Diese Methode vergleicht die Kantenpunkte des aktuellen Bereichs mit den sourceRange Kantenpunkte und gibt einen Wert zurück, der ihre relative Position im Quelldokument angibt. Der Parameter how bestimmt, welche Kantenpunkte zweier Bereiche verglichen werden sollen. Die gültigen Werte dieses Parameters und ihre Bedeutung sind wie folgt:

  • Range.START_TO_START - Vergleiche die Startpunkte zweier Range-Knoten
  • Range.END_TO_END - Vergleiche die Endpunkte zweier Range-Knoten
  • Range.START_TO_END - Mit sourceRange Startpunkt mit dem Endpunkt des aktuellen Bereichs verglichen wird
  • Range.END_TO_START - Mit sourceRange Endpunkt mit dem Startpunkt des aktuellen Bereichs verglichen wird

Das Rückgabewert dieser Methode ist eine Zahl, die angibt, wie sich der aktuelle Bereich relativ zum sourceRange Position. Daher könnten Sie denken, dass Sie zunächst die Parameter how Bereichskonstanten die Kantenpunkte des aktuellen Bereichs bestimmen und dann damit sourceRange Kantenpunkte. Tatsächlich legt jedoch der Konstanten Range.START_TO_END fest, dass die Kantenpunkte des aktuellen Bereichs mit den sourceRange mit dem Startpunkt verglichen. Ebenso legt der Konstanten Range.END_TO_START fest, dass der Startpunkt des aktuellen Bereichs mit dem Endpunkt des angegebenen Bereichs verglichen wird.