WinRtfLoadName

obj -> WinRtfLoadName(int1, int2[, alpha3]]) : int

Text in RtfEdit-Objekt laden

Details

• obj: Objekt ( RtfEdit -Objekt)
• int1:
  • Quelle des Textes:
  • _WinStreamNameText
  • _WinStreamNameFile
• int2:
  • Modus:
  • _WinRtfLoadAuto
  • _WinRtfLoadRtf
  • _WinRtfLoadAscii
  • _WinRtfLoadOem
  • _WinRtfLoadInsert
  • _WinRtfLoadMix
• alpha3: Name des Textes oder Feldpuffer (optional)
• Resultat: int Fehlerwert
• Siehe: Verwandte Befehle , WinRtfLoad () , WinRtfLoadBin () , WinRtfSaveName ()

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 Name der Quelle kann in (alpha3) angegeben werden. Wird kein Name angegeben, wird der Inhalt der entsprechenden Eigenschaft verwendet.

Folgende Quellen können angegeben werden:

• _WinStreamNameText Der Text steht in einem internen Text zur Verfügung. Der Name des Textes kann entweder in (alpha3) übergeben werden oder wird der Eigenschaft FileName entnommen.
• _WinStreamNameFile Der Text steht in einer externen Datei zur Verfügung. Der Name der Datei kann entweder in (alpha3) übergeben werden oder wird der Eigenschaft FileName entnommen.

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.
• _WinRtfLoadOem Die Textquelle ist im OEM-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.