The file will typically be one of the following types: JPEG,
GIF, TIFF, BMP, PNG, PSD, PDB, EXIF, WMF, EMF, EPS, PS or SWF
For details of additional formats which are supported and the
way they are imported, see the ReadModule
property and the the Doc.Read method.
The advantage of this method over SetFile, is that you can specify the ReadModule
you would like to use. This allows precise control over the way
that your graphics are imported.
In addition you can also control the way that transparency is
treated using the PreserveTransparency
The object takes the ownership of the XReadOptions, which is
disposed of when the object is disposed of. You can make the object
release the ownership without disposing of the XReadOptions using
the parameterized overloads of Dispose
and Clear. The XReadOptions must not be
modified as long as the object has the ownership.
If the returned XImage has the NeedsFile property set to true,
you must ensure that the specified file will remain present and
unmodified until the XImage object is cleared, disposed of, or