AddToFilePopupDirHistory

int AddToFilePopupDirHistory (char *directoryPathname);

Purpose

Inserts a directory pathname into the directory history list that appears in the dialog boxes you can display with the FileSelectPopup, MultiFileSelectPopup, and the DirSelectPopup functions.

The directory history list can hold up to a maximum of 15 directory pathnames. The first entry in the list is always the pathname of the directory that the dialog box is currently displaying.

Parameters

Input
Name Type Description
directoryPathname char * The directory name you want to insert into the directory history list that appears in the dialog boxes you can display with the FileSelectPopup, MultiFileSelectPopup, and the DirSelectPopup functions.

Pass the absolute pathname of a directory, including the drive letter; for example d:\myapps\simptest. The function does not check the validity of the pathname. The function adds the pathmame to the directory history even if pathname is invalid or does not exist on disk.

You can pass NULL or an empty string, in which case function has no effect.

Return Value

Name Type Description
status integer Return value indicating whether the function was successful. A negative number indicates that an error occurred.

Code Error Message String
xx Success