ChartDirector Ver 3.0 (C++ Edition)

BaseChart.setSearchPath


Usage

void setSearchPath(const char *path);

Description

Set the search path for loading image files.

Several ChartDirector operations involve loading image files. Examples are wallpapers (BaseChart.setWallpaper), background images (BaseChart.setBgImage and PlotArea.setBackground2), use-defined symbols (DataSet.setDataSymbol2) or for embedding images in text using ChartDirector Mark Up Language.

By default, if a relative path name or just a file name is used for an image file, ChartDirector will load it relative to the "current directory".

For many applications, it is common to put all images in a dedicated "images" directory. The setSearchPath method can be used to inform ChartDirector to use that directory for loading image files.

Also, for applications running under Microsoft IIS, the "current directory" is in a non-intuitive location. It is the directory where IIS is installed (usually inside [system32]). To tell ChartDirector to load images relative to the "current URL directory", use:

c.setSearchPath(Server.MapPath("."))

You may specify more than one directory to search for the image files by separating the directories with semi-colons.

Arguments

ArgumentDefaultDescription
path(Mandatory)A list of directories, separated with semi-colons, acting as the search path for loading image files.

Return Value

None