Introduction Class TWPCustomRTFControl Class TWPRichText Class TWPCustomRichText Class TDBWPRichText Class TWPCustomRtfEdit Class TWPPreview Class TWPRichTextLabel
Class TWPToolbar Class TWPToolButton Class TWPToolPanel Class TWPVertRuler Class TWPRuler Class TWPGutter
Class TTextHeader Class TWPRTFSectionProps Class TWPOwnedCharAttrInterface Class TWPStoredCharAttrInterface Class TWPAbstractCharAttrInterface Class TWPAbstractCharParAttrInterface Class TWPCursorCharAttrInterface Class TWPFoundTextAttrInterface Class TWPCurrentWritingmodeAttrInterface
Class TWPRTFReaderEx Class TWPRTFReader Class TWPRTFWriter Class TWPRTFWriterEx Class TWPToolsReaderWriter Class TWPTextWriter Class TWPHTMLWriter Class TWPTOOLSWriter Class TWPUNITextWriter Class TWPCustomTextWriter Class TWPTextReader Class TWPHTMLReader Class TWPTOOLSReader Class TWPUNITextReader Class TWPCustomTextReader
Class TWPRTFDataCollectionBase Class TWPRTFDataCollection Class TWPRTFDataBlock Class TWPRTFDataBlockEd Class TParagraph Class TWPTextStyle Class TWPORTFTextBox Class TWPObjectField Class TWPObject Class TWPRTFEngineBasis Class TWPRTFEngineEdit
Class TWPManageHeaderFooterDlg Class TWPPagePropDlg Class TWPParagraphBorderDlgEx Class TWPParagraphBorderDlg Class TWPTabDlgPrp Class TWPOneStyleDlg Class TWPBulletDlg Class TWPSymbolDlg Class TWPSymbolDlgEx Class TWPSpellCheckDlg Class TWPStringDlg Class TWPStyleDlg Class TWPCustomAttrDlg Class TWPSearchReplaceDlg Class TWPParagraphPropDlg Class TWPPreviewDlg Class TWPReportBandsDialog Class TWPTableDlg
Class TWPSuperMerge Class TDBWPEvalEngine Class TWPEvalEngine Class TWPTableProducer Class TWPBand Class TWPDataSetAbstractAdapter
Class TWPSvgXMLNode Class TWPXMLOneLevel Class TWPCustomXMLInterface Class TWPXMLInterface Class TWPLanguageControl Class TWPXMLTree Class TWPSVGXMLTree Class TWPCustomXMLTree
Main Website Buy WPCubed VCL Components Contact/License

Function TWPObjectEnv.Insert(data:TPersistent; w:Integer; h:Integer; objname:string; StreamName:string) : TWPTextObj

Unit: WPRTEDefs
Class: WPRTEDefs.TWPObjectEnv

Parameters

  • data:TPersistent
  • w:Integer
  • h:Integer
  • objname:string
  • StreamName:string

Returns

The type of the result value is TWPTextObj.

Description

Insert a object at cursor position. It can be of type Image, Picture, Bitmap, Metafile, too. Then a new TWPTOImage will be created. The optional parameters are the size of the object and the name. You can also use a 'streamname' to create a link to a file. If you provide a ObjName the procedure will first try to find a TWPObject with this name and link to it before it uses 'data'.

Note: If the provided data object inherits from the TGraphic class it will be freed after it had been assigned to the automatically created . If you want to keep the graphic (maybe it was passed as Image1.Picture.Graphic) then please use the procedure instead of Insert.

If currently an image object is selected the new object will use the same wrap mode and position as the replaced image. The size will be changed to match the size of the old image while the height is modified to keep aspect ration of the new image.

Note: In an completely empty TWPRichText this function will not insert anything unless CheckHasBody has been called to make sure there is a vaild cursor position.

Upgrade notes: InsertNameLink, InsertName ... are superseeded by this function. In previous versions the ID (tag) of the object was returned, now the reference to this object is returned directly. USe TWPTextObj.ID to read the tag/id.