WinDocLoadBin

obj -> WinDocLoadBin(handle1, int2[, alpha3]) : int

Binäres Objekt in CtxDocEdit-Objekt laden

Details

• obj: Objekt (CtxDocEdit-Objekt)
• handle1: Deskriptor des binären Objekts
• int2:
  • Modus:
  • _WinDocLoadAscii
  • _WinDocLoadRtf
  • _WinDocLoadHtml
  • _WinDocLoadDoc
  • _WinDocLoadDocX
  • _WinDocLoadOEM
  • _WinDocLoadMix
  • _WinDocLoadInsert
• alpha3: Verschlüsselungscode (optional)
• Resultat: int Fehlerwert
• Siehe: Verwandte Befehle , WinDocLoadName () , WinDocSaveBin () , BinOpen ()

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.