PEresetimageEx

BOOL PEresetimageEx (hObject, nExtX, nExtY, nOrgX, nOrgY )

The PEresetimageEx function rebuilds the control's internal metafile used to paint itself and export via PEgetmeta and then played via PEplaymetafile.

The PEresetimageEx method is designed to be called in custom printing logic.

The parameters nExtX and nExtY should match the units used when calling SetViewportExt. The nOrgX and nOrgY parameters should match the units used when calling SetViewportOrg. An example of this can be found in common Question 21.

This function was needed to handle the new clipping logic built into the image construction process. By default, DisableClipping is FALSE and clipping is enabled, so this function is generally necessary in custom printing logic. If clipping is disabled, then PEresetimage can be used instead of PEresetimageEx.

Comments

The addition of clipping logic has the potential to break current ProEssentials implementations which include custom printing logic. In the process of porting an application to v4, you should plan on changing calls of PEresetimage to PEresetimageEx or disabling clipping by setting DisableClipping to TRUE.

For example code showing the use of this method, look at common Question 21.

See Also: PEresetimage.