WinRtfPicInsertMem

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

Einfügen von Bildern in ein RtfEdit-Objekt

Details

• obj: Deskriptor des RtfEdit-Objekts
• handle1: Deskriptor des Memory-Objekts
• int2: Seitennummer (optional)
• int3:
  • Optionen (optional):
  • _WinRtfPicModeSpeed
  • _WinRtfPicModeQuality
  • _WinRtfPicModeAuto
• Resultat: int Einfügeresultat (siehe Text)
• Siehe: Verwandte Befehle , WinRtfPicInsertName ()

Diese Funktion fügt ein Bild aus einem Memory -Objekt (handle1) an der aktuellen Cursorposition eines RtfEdit -Objekts (obj) ein. Ist eine Selektion vorhanden, wird diese durch das Bild ersetzt. Das Argument Seitennummer (int2) bestimmt bei einem Multipage-TIFF, die Seite, die das einzufügende Bild enthält. Die Seitenzählung beginnt mit 1. Wird (int2) nicht angegeben oder ist der Wert Null, dann wird immer die erste Seite gewählt. Bei Formaten außer TIFF wird das Argument ignoriert.

Optional können in (int3) folgende Optionen angegeben werden:

• _WinRtfPicModeSpeed: Performantes Einfügen
• _WinRtfPicModeQuality: Qualitatives Einfügen
• _WinRtfPicModeAuto: Modus abhängig von der Farbtiefe und Größe des Bildes auswählen

Wird keine der Optionen angegeben, wird automatisch _WinRtfPicModeAuto verwendet.

Die anzeigbaren Formate sind GIF, TIFF, JPEG, PNG und BMP.

info

Transparente oder semitransparente Pixel bei PNG bzw. 32bpp BMP-Dateien werden zu weißer Farbe gemischt.

Wird das Bildformat nicht unterstützt, gibt die Funktion den Fehlerwert _ErrGeneric zurück. Ist der Arbeitsspeicher nicht ausreichend, wird _ErrOutOfMemory zurückgegeben.

Beispiel:

// Bild laden
tMem # MemAllocate(_MemAutoSize);
tFsi # FsiOpen(_Sys->spPathMyPictures + '\MyPicture.jpg', _FsiStdRead);
tFsi->FsiReadMem(tMem, 1, tFsi->FsiSize());
tRes # $RtfEdit->WinRtfPicInsertMem(tMem);
tFsi->FsiClose();

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Bei (obj) handelt es sich nicht um ein RtfEdit-Objekt