GetRange-Methode des Text-Objekts

GetRange-Methode des Text-Objekts in der ABBYY FineReader Engine API — Gibt eine Kopie eines Textbereichs zurück, die über IParagraph::InsertText in einen anderen Absatz eingefügt werden kann.

Mit dieser Methode können Sie eine Kopie eines Textbereichs erhalten. Den so erhaltenen Text können Sie in den Text eines Absatzes einfügen (Methode IParagraph::InsertText).

​

Syntax

​

C++

HRESULT GetRange(
  int     FromParagraph,
  int     FromPos,
  int     ToParagraph,
  int     ToPos,
  IText** Result
);

​

C#

IText GetRange(
  int FromParagraph,
  int FromPos,
  int ToParagraph,
  int ToPos
);

​

Visual Basic .NET

Function GetRange( _
  FromParagraph As Integer, _
  FromPos As Integer, _
  ToParagraph As Integer, _
  ToPos As Integer _
) As IText

​

Parameter

FromParagraph

[in] Variable, die den Index des Absatzes für den Startpunkt des zu kopierenden Bereichs angibt.

FromPos

[in] Variable, die den Zeichenindex im Startabsatz für den Startpunkt des zu kopierenden Bereichs angibt.

ToParagraph

[in] Variable, die den Index des Absatzes für den Endpunkt des zu kopierenden Bereichs angibt.

ToPos

[in] Variable, die den Zeichenindex im Endabsatz für den Endpunkt des zu kopierenden Bereichs angibt. Dieses Zeichen selbst ist nicht im kopierten Text enthalten.

Result

[out, retval] Ein Zeiger auf die Zeigervariable vom Typ IText*, die den Schnittstellenzeiger des Text-Objekts aufnimmt, das den Bereich repräsentiert. Result darf nicht NULL sein. *Result muss NULL sein; andernfalls wird ein Fehlercode zurückgegeben.

​

Rückgabewerte

Diese Methode hat keine spezifischen Rückgabewerte. Sie gibt die Standard-Rückgabewerte von ABBYY FineReader Engine-Funktionen zurück.

​

Hinweise

Die Endposition des Bereichs muss im Text hinter der Startposition liegen; andernfalls wird ein Fehlercode zurückgegeben. Das Symbol an der Position (FromParagraph;FromPos) wird in den Bereich einbezogen, während das Zeichen an der Position (ToParagraph;ToPos) nicht einbezogen wird. Um eine Kopie des gesamten Texts zu erhalten, übergeben Sie für den Anfang des Bereichs die Koordinaten (0;0) und für das Ende des Bereichs die Koordinaten der “Sonderposition”.

​

Siehe auch

Text