Passing Back Results from the COM Object

There are three primary ways for the client to receive results back from the COM Object. The COM Object can:

Create or update a file on disk containing information for use by the client
Copy a map to the Windows clipboard for use by the client
Return information as the result of a COM call

Storing COM Object Results in a File

The COM Object can store information in a file in any of several formats. Any open window (map, legend in a separate window, editor, figure, or layout) can be saved to an image file: a Windows bitmap file, a PNG compressed file, or a JPEG compressed file. Map, figure, and layout windows also can be saved to a Windows Enhanced metafile. Here are the functions:

GISDK Function	Summary
SaveMapToImage()	Saves the contents of the map window to an image file
SaveLegendToImage()	Saves a legend in a separate window to an image file
SaveMapToMetafile()	Saves map graphics to a Windows Enhanced metafile
SaveEditorToImage()	Saves the contents of the editor window to an image file
SaveFigureToImage()	Saves the contents of the figure window to an image file
SaveFigureToMetafile()	Saves figure graphics to a Windows Enhanced metafile
SaveLayoutToImage()	Saves the contents of the layout window to an image file
SaveLayoutToMetafile()	Saves layout graphics to a Windows Enhanced metafile

The results of a COM Object query can also be written to a tabular file using any of the methods described in Reading and Writing Data.

Storing COM Object Results on the Clipboard

Maps can be transmitted from the COM Object back to a client program using CopyMapToClipboard().

For more information, see...

Accessing Maptitude as a COM Object