Function DE Version 2.97

@RTFetchText

RichText Text

Syntax

@RTFetchText(HRT1;RETNUMBER2);

Beschreibung

Gibt den Textanteil von HRT HRT1 als TEXT Portionsweise zurück.
Zu Beginn muß NUMBER RETNUMBER2 0 enthalten.
NUMBER RETNUMBER2 gibt den SEGMENTPOINTER an.
@RTFetchText gibt für den Fall das noch mehr Text abzuholen ist in NUMBER RETNUMBER2 einen Wert ungleich -1 zurück.
Ist kein Text mehr abzuholen enthält NUMBER RETNUMBER2 -1.

Beispiel: @RTFetchText(HRT1;RETNUMBER2)

RETNUMBER2:=0;
WHILE(RETNUMBER2!=-1)
{
   TXT:=@RTFetchText(HRT1;RETNUMBER2);
   IF(!@IsError(TXT))
   {
      @LogReport(TXT;7);
   }
}

Eine typische Text-Abholschleife für große HRT-Felder.
Die Schleife wird solange ausgeführt bis NUMBER RETNUMBER2 gleich -1 ist.
Die Textportionen werden TEXT TXT zugewiesen und ausgegeben.

ACHTUNG:
Es wird in der Regel so sein, daß diese Textportionen für eine Ausgabe mit @LogReport ins APILOG zu groß sind.
Der zweite Parameter von @RTFetchText, darf kein fester Wert sein, sondern muß eine Variable sein (Rückgabe bei Ende)