Picture Functions > VpePictureResName

[Windows platform only]

The same as VpePictureResID(), but instead of a numeric ID the resource is identified by name. The image is taken from the resource of

•the calling application, if hInstance = 0; or

•a DLL, with hInstance = handle of the instance of the loaded DLL

VpeCoord VpePictureResName(

VpeHandle hDoc,

VpeCoord x,

VpeCoord y,

VpeCoord x2,

VpeCoord y2,

int hInstance,

LPCSTR res_name

)

VpeHandle hDoc

Document Handle

VpeCoord x, y, x2, y2

position and dimensions

int hInstance

Instance-Handle

LPCSTR res_name

resource-name

Returns:

the bottom coordinate (y2) of the inserted image

Remarks:

From resources, VPE can only load BMP files, not JPEG, WMF, TIFF or any other file types.

If you create a VPE document file with images loaded from a resource, and the PIC_IN_FILE flag is NOT used, VPE stores the resource-link in document files. If you open such a document file with another application that does not contain these resources with same ID’s / names, then no images will be shown. Since DLL Instance-Handles change from load to load, VPE stores ALL images where hInstance is not null ALWAYS with the flag PIC_IN_FILE set automatically in the document files.

VPE offers several methods to attach an object's position to margins and relative to the position of previously inserted objects. In addition Text, Rich Text and Picture objects are able to compute their dimensions automatically depending on their visual content.
For details please see"Dynamic Positioning" in the Programmer's Manual.