ChartDirector 5.1 (Java Edition)

DrawArea.setSearchPath


Usage

public void setSearchPath(String path)

Description

Sets the file system 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), user-defined symbols (DataSet.setDataSymbol2) or for embedding images in text using ChartDirector Mark Up Language.

By default, if a relative path name is used for an image file, ChartDirector will search for the image file using a ClassLoader (see DrawArea.setSearchPath2 for details), and also in the "current directory".

The setSearchPath method allows you to specify a search path instead of using the "current directory". Multiple directories are supported by separating them with the path separator (";" for Windows and ":" for Linux/UNIX).

If you are using ChartDirector in a web server, you may want to search for the images relative to the current servlet context. Please refer to DrawArea.setSearchPath3 for details.

If you are using ChartDirector in an applet environment, you may want to search for the images based on the "code base" or "document base" of the Applet. Please refer to DrawArea.setSearchPath4 for details.

Arguments

ArgumentDefaultDescription
path(Mandatory)A list of directories, separated with the path separator (java.io.File.pathSeparator) of your operating system (";" for Windows, ":" for Linux/UNIX).

Return Value

None