ImageSetFileName

ImageSetFileName sets the file name of the picture and loads the file into the picture object.

bool = ImageSetFileName(hImg, ssNewFileName)

Return Value

If the function succeeds, the return value is TRUE (1); otherwise it is FALSE (0).

Parameters

hImg

Identifies the image.

ssNewFileName

ssNewFileName is the file name the linked file.

Comment

The file name can be specified as a complete file name or a relative file name To open the file UniPlot searches in the following order for the given file. The search ends when the file is found:

• Try to open the file with its given name.
• Search in the directory where the IPW/IPZ file is saved.
• Search the directories specified in the dialog Tools=>More Options in the edit field Searchpath for picture files.

If the picture file is not found a box with the file name is displayed in the UniPlot document page.

See also

Overview Pictures, ImageGetFileName

_id-134981