WinDocSaveBin

obj -> WinDocSaveBin(handle1, int2[, int3[, alpha4]]) : int

Text aus CtxDocEdit-Objekt in binärem Objekt speichern

Details

• obj: Objekt ( CtxDocEdit -Objekt)
• handle1: Deskriptor des binären Objekts
• int2:
  • Modus:
  • _WinDocSaveAscii
  • _WinDocSaveRtf
  • _WinDocSaveHtml
  • _WinDocSaveDoc
  • _WinDocSaveDocX
  • _WinDocSavePdf
  • _WinDocSaveMix
  • _WinDocSaveOEM
  • _WinDocSaveMark
• int3: Kompressionsfaktor (optional)
• alpha4: Verschlüsselungscode (optional)
• Resultat: int Fehlerwert
• Siehe: Verwandte Befehle , WinDocSaveName () , WinDocLoadBin () , BinOpen ()

Mit diesem Befehl wird ein Text aus einem CtxDocEdit -Objekt in einem binären Objekt gespeichert. Der Deskriptor des CtxDocEdit-Objektes wird in (obj), der Deskriptor des binären Objekts in (handle1) übergeben. Das binäre Objekt (handle1) muss beim Öffnen mit _BinLock oder _BinSingleLock gesperrt werden.

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

• _WinDocSaveAscii ASCII-Text sichern
• _WinDocSaveRtf RTF-Text sichern
• _WinDocSaveHtml HTML-Format sichern
• _WinDocSaveDoc Inhalt im .doc Format sichern
• _WinDocSaveDocX Inhalt im .docx Format sichern
• _WinDocSavePdf Inhalt im PDF-Format sichern
• _WinDocSaveOEM OEM-Text sichern
• _WinDocSaveMix Text mit Daten mischen
• _WinDocSaveMark Markierten Bereich sichern

Die Parameter zum Zielformat können mit _WinDocSaveMark kombiniert werden, um einen markierten Teil innerhalb des Textes zu sichern.

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

info

_WinDocSaveMix kann nicht zusammen mit _WinDocSaveDoc , _WinDocSaveDocX oder _WinDocSavePdf 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 SaveToMemory 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 als binäres Objekt speichern
$ctxDocEdit->WinDocSaveBin(tBinFileHdl, _WinDocSaveDoc);

// markierten Bereich als RTF-Dokument in einem binären Objekt komprimiert speichern
$ctxDocEdit->WinDocSaveBin(tBinFileHdl, _WinDocSaveRtf | _WinDocSaveMark, 4);

Mögliche Laufzeitfehler

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