WinRtfPicInsertName

obj -> WinRtfPicInsertName(alpha1[, alpha2[, int3[, int4]]]) : int

Einfügen von Bildern in ein RtfEdit-Objekt

Details

• obj: Deskriptor des RtfEdit-Objekts
• alpha1: Name der Bilddatei
• alpha2: Verschlüsselungs-Code (optional)
• int3: Seitennummer (optional)
• int4:
  • Optionen (optional):
  • _WinRtfPicModeSpeed
  • _WinRtfPicModeQuality
  • _WinRtfPicModeAuto
• Resultat: int Einfügeresultat (siehe Text)
• Siehe: Verwandte Befehle , WinRtfPicInsertMem ()

Diese Funktion fügt ein Bild an der aktuellen Cursorposition eines RtfEdit -Objekts ein. Ist eine Selektion vorhanden, wird diese durch das Bild ersetzt.

Durch die Voranstellung eines Präfixes (alpha1) bezeichnet der Name entweder eine externe Datei, ein binäres Objekt oder ein in der Datenbank gespeichertes Bild.

Der Verschlüsselungs-Code (alpha2) wird verwendet, wenn das Bild in der Datenbank verschlüsselt vorliegt. Das Argument Seitennummer (int3) bestimmt bei einem Multipage-Tiff, die Seite, die das einzufügende Bild enthält. Die Seitenzählung beginnt mit 1. Wird (int3) 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 (int4) 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.

Als Fehlerwerte können Fehlerwerte aus dem Bereich der Befehle für externe Dateien auftreten, wenn das Bild extern gelesen wird.

Zusätzlich sind folgende Fehlerwerte möglich:

• _ErrGeneric: BLOb oder externe Datei enthält kein Bild oder ein unbekanntes Bildformat
• _ErrNameInvalid: Der Parameter (alpha1) ist leer
• _ErrUnavailable: Das Bild (alpha1) existiert nicht in der Datenbank
• _ErrOutOfMemory: Arbeitsspeicher nicht ausreichend

Beispiele:

// Externe Datei laden
$RtfEdit->WinRtfPicInsertName('*' + _Sys->spPathMyPictures + '\MyPicture.jpg');

// Blob aus der Datenbank laden
$RtfEdit->WinRtfPicInsertName('>0\Pictures\MyPicture.jpg');

Mögliche Laufzeitfehler:

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