WinRtfLoad

obj -> WinRtfLoad(int1[, int2[, handle3]]) : int

Text in RtfEdit-Objekt laden

Details

• obj: Objekt ( RtfEdit -Objekt)
• int1:
  • Quelle des Textes:
  • _WinStreamCaption
  • _WinStreamBufField
  • _WinStreamBufText
• int2:
  • Modus (optional):
  • _WinRtfLoadAuto
  • _WinRtfLoadRtf
  • _WinRtfLoadAscii
  • _WinRtfLoadInsert
  • _WinRtfLoadMix
• int3: Deskriptor des Textpuffers (optional)
• Resultat: int Fehlerwert
• Siehe: Verwandte Befehle , WinRtfLoadName () , WinRtfLoadBin () , WinRtfSave ()

Mit diesem Befehl wird ein Text in ein RtfEdit -Objekt geladen. Der Deskriptor des Objektes wird in (obj) übergeben.

In (int1) wird die Quelle des zu ladenden Textes definiert. Der Deskriptor der Quelle kann in (handle3) angegeben werden. Wird kein Deskriptor angegeben, wird der Inhalt der entsprechenden Eigenschaft verwendet.

Folgende Quellen können angegeben werden:

• _WinStreamCaption Werden prozedural Änderungen der Caption vorgenommen, kann mit dieser Option eine Aktualisierung des Objektes durchgeführt werden. Der Parameter (handle3) darf nicht gesetzt werden.
• _WinStreamBufField Der Inhalt des in der Eigenschaft DbFieldName angegebenen Feldpuffers wird geladen. der Parameter (handle3) darf nicht gesetzt sein.
• _WinStreamBufText Der Text steht in einem Textpuffer bereit. Der Deskriptor des Textes kann in (handle3) angegeben werden. Ist kein Textpuffer angegeben, wird der in der Eigenschaft DbTextBuf angegebene Textpuffer verwendet.

Der Parameter (int2) bestimmt das Format der Quelle. Folgende Konstanten können übergeben werden:

• _WinRtfLoadAuto Das Format der Quelle wird automatisch bestimmt.
• _WinRtfLoadRtf Die Textquelle ist im RTF-Format.
• _WinRtfLoadAscii Die Textquelle ist im ASCII-Format.

Die Parameter zum Quellenformat können mit _WinRtfLoadInsert kombiniert werden, um in einen bestehenden Text den angegebenen Text einzufügen.

Der Text ersetzt den Text, der mit der Markierung (Range) selektiert ist. Ist keine Markierung vorhanden, wird der Text an der aktuellen Cursorposition eingefügt.

Bei der Kombination mit der Option _WinRtfLoadMix werden beim Laden des Textes die Platzhalter durch die entsprechenden Daten ersetzt. Weitere Informationen befinden sich im Abschnitt Text und Daten mischen .

Als Rückgabewert können neben den Fehlerkonstanten aus dem Bereich der externe Dateien die Werte _ErrData und _ErrRtfSyntaxError zurückgegeben werden. Bei der Rückgabe von _ErrOk ist kein Fehler aufgetreten.