Function DE Version 4.50

@RTFetchParagraph

RichText

Syntax

@RTFetchParagraph(HRT1;RTFH;RETSIG);
@RTFetchParagraph(HRT1;RTFH;RETSIG;REGRTPARAGRAPH);

Beschreibung

Gibt bei jedem Aufruf jeweils einen Paragraph des RICHTEXT Feldes HRT HRT1 in RT REGRTPARAGRAPH zurück.
(Dieser Paragraph wird als plain RT und nicht als HUGERICHTEXT zurückgegeben)
Der Fetch-Handle RTFH muß zu Begin durch @RTFetchInit initialisiert worden sein.
In FN RETSIG wird ein Identifier des zurückgegebenen Paragraphen zurückgegeben.
Mit @RTSigTranslate kann dieser Identifier in einen aussagekräftigeren Text umgewandelt werden.

Return-Wert:
Im Erfolgsfall wird ein weitergeführter (zeigt auf den nächsten Paragraphen) Fetch-Handle RTFH zurückgegeben, andernfalls, oder wenn das Ende des RICHTEXT-Feldes erreicht ist, @ERROR.

Beispiel: @RTFetchInit(HRT1);

RTout:=@RTInitEmpty;

RTF:=@RTFetchInit(RTinp);
WHILE(@CheckHandle(RTF))
{
   RTF:=@RTFetchParagraph(RTinp;RTF;Sig;RT);
   SigText:=@RTSigTranslate(Sig;1);
   IF(@CheckHandle(RTF))
   {
      RTout:=@RTAddParagraph(RT;RTout);
   }
}

Es wird der Inhalt der HRT Variable RTinp Paragraph-weise in das Feld neue HRT Feld RTout kopiert.