ExportImageDpi

Purpose

Controls the embedding or utilizing of target resolution info (in DotsPerInch) when exporting metafiles and bitmaps.

ExportImageDpi works differently based upon metafile or bitmap exports:

Metafile Exports:

If non-zero, the metafile export will be generated with the respective ExportImageDpi value. If FixedFonts=TRUE, font sizing logic also uses the DPI value. If ExportImageDpi=0, DpiX and DpiY will potentially control the target DPI of export. If ExportImageDpi=0, DpiX=0, and DpiY=0, export defaults to 1000 DPI and temporarily sets FixedFonts = False while performing export. ExportImageLargeFont can be used to increase font sizes for exports.

PNG/JPG/BMP Exports:

If non-zero, bitmap exports embed the ExportImageDpi value and resulting size info within the bitmap bits. If FixedFonts=TRUE, font sizing logic also uses the DPI value. If ExportImageDpi=0, DpiX and DpiY will potentially control DPI and font sizing logic when FixedFonts=TRUE. If ExportImageDpi=0, DpiX=0, and DpiY=0, font sizing logic will be A) similar to controls on the desktop if ExportImageLargeFont=FALSE, or B) similar to printing if ExportImageLargeFont=TRUE.

Comments

ProEssentials v6 adds the ability to control/embed DPI/size info when exporting images. The end user can gain access to this control by default as the ExportImageDpi setting is adjustable within the ProEssentials built-in export dialog. You can prevent the end user from accessing this property by setting HideExportImageDpi to TRUE.

PeUserInterface.Dialog.ExportImageDpi members of Pego.PeUserInterface.Dialog, Pesgo.PeUserInterface.Dialog, Pe3do.PeUserInterface.Dialog, Pepso.PeUserInterface.Dialog, Pepco.PeUserInterface.Dialog

See Also: HideExportImageDpi, PrintDpi, DpiX, DpiY, ExportImageLargeFont