WinDocLoadBin

Mit diesem Befehl wird der Inhalt eines binären Objekts in ein CtxDocEdit-Objekt geladen. Der Deskriptor des CtxDocEdit-Objektes wird in (obj), der Deskriptor des binären Objekts in (handle1) übergeben.

Der Parameter (int2) bestimmt das zu lesende Format. Folgende Konstanten können angegeben werden:

• _WinDocLoadAscii

  Laden von Text im ASCII-Format.

• _WinDocLoadRtf

  Laden von Text im RTF-Format.

• _WinDocLoadHtml

  Laden von Text im HTML-Format.

• _WinDocLoadDoc

  Word-Dateien im.doc Format laden.

• _WinDocLoadDocX

  Word-Dateien im.docx Format laden.

• _WinDocLoadOEM

  Laden von Text im OEM-Format.

• _WinDocLoadMix

  Text mit Daten mischen.

• _WinDocLoadInsert

  Der zu ladende Text wird in einen bestehenden Text eingefügt.

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

Der Text ersetzt den Text, der mit der Markierung ($ctxDocEdit->cpiSelLength) selektiert ist. Ist keine Markierung vorhanden, wird der Text an der aktuellen Cursorposition $ctxDocEdit->cpiSelStart eingefügt.

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

info

_WinDocLoadMix kann nicht zusammen mit _WinDocLoadDoc oder _WinDocLoadDocX angegeben werden.

Als Rückgabewert kann neben den Fehlerkonstanten aus dem Bereich der binären Objekte der Wert _ErrGeneric zurückgegeben werden, wenn ein interner Fehler aufgetreten ist. Bei der Rückgabe von _ErrOk ist kein Fehler aufgetreten.

info

Intern wird die Funktion LoadFromMemory der Text-Control-Bibliothek aufgerufen. Dabei wird die Eigenschaft LoadSaveAttribute der Bibliothek beachtet. Die Eigenschaft kann mit $ctxDocEdit->cpiLoadSaveAttribute gelesen und gesetzt werden. Nähere Informationen finden Sie auf der Hersteller-Seite des Moduls.

Beispiel:

// Word-Dokument aus binärem Objekt laden
$ctxDocEdit->WinDocLoadBin(tBinFileHdl, _WinDocLoadDoc);

// RTF-Dokument aus binärem Objekt laden und in aktuellen Text einfügen
$ctxDocEdit->WinDocLoadBin(tBinFileHdl, _WinDocLoadRtf | _WinDocLoadInsert);

Mögliche Laufzeitfehler

• _ErrHdlInvalid: Bei (obj) handelt es sich nicht um ein CtxDocEdit-Objekt bzw. bei (handle1) nicht um ein BLOb-Objekt.
• _ErrValueInvalid: Argument (int2) enthält ungültige Werte.