Method XbpMetaFile():setIPicture() Foundation

Initializes the metafile through an IPicture automation object.

:setIPicture( <oPicture> ) --> lSuccess
An automation object connected to an IPicture COM object.

The method returns a logical value. If the XbpMetaFile object was initialized, the value .T. (true) is returned. In case of an error, :setIPicture()returns .F. (false).


ActiveX components and controls use IPicture COM objects to manage images of various formats. When working with COM/ActiveX objects, an Xbase++ application may have to manipulate images, either stored in COM/ActiveX properties or returned by method calls. In both cases, the image is usually returned as an AutomationObject() connected to an IPicture COM/ActiveX interface. In order to use the image returned with Xbase Parts or the Graphics Engine, the image must be specified as an XbpBitmap() or XbpMetaFile() object.

Method :setIPicture() initializes an XbpMetaFile object with image data from an IPicture COM/ActiveX interface. It provides a convenient way to obtain the metafile maintained by a IPicture COM/ActiveX interface.


If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.