ChartDirector 7.1 (C++ Edition)

DrawArea.setSearchPath


Usage

void setSearchPath(const char *path);

Description

Sets the search path for loading image files.

Many ChartDirector APIs expect a path for loading a file. Examples include BaseChart.setBgImage and the CDML, the <*img*> tag.

If the image path is a relative path, the setSearchPath allows you to set the location(s) to search for the image file. Its effect is to prepend the search path to the image path. For example, if the search path is "/aaa/bbb" and the image path is "nnn/mmm.png", the resulting path would be "/aaa/bbb/nnn/mmm.png". You can specify multiple search paths by separating them with the path separator of the operating system (";" for Windows and ":" for Linux/UNIX).

Please refer to Path Specification on how ChartDirector interprets pathnames.

Arguments

ArgumentDefaultDescription
path(Mandatory)A list of paths, separated with the path separator of the operating system (";" for Windows, ":" for Linux/UNIX).

Return Value

None