C++
bool retainOriginalThumbnailBitmap() const;
Description
This function returns the status of the thumbnail bitmap toggle flag. The retainOriginal status is FALSE by default. If it is toggled to TRUE, the AcDbDatabase will always try to retain the original image, no matter what other action is taken.
Note This function is intended for RealDWG developers. Preview thumbnail behavior reflects what the host application must do to generate a preview.
ObjectARX developers should not call this function because AutoCAD generates all preview thumbnails.
Three behaviors are possible:
- Save the database without a thumbnail bitmap.
- Save the database while retaining the pre-existing thumbnail bitmap.
- Set a new thumbnail bitmap to save with the DWG.
The behavior depends on two things: whether there is a thumbnail bitmap, and whether the retainOriginal behavior has been requested.