AddToFilePopupDirHistory
int AddToFilePopupDirHistory (char *directoryPathname);
Purpose
 |
Note The behavior of this function differs slightly depending on the functions you use with it. |
Inserts a folder into one of the following lists depending on the function you use in conjunction with the AddToFilePopupDirHistory function:
- Previous locations list that appears in the dialog
boxes you can display with the FileSelectPopupEx, MultiFileSelectPopupEx, and DirSelectPopupEx functions. Users access the Previous locations list by clicking the down arrow in the path text box of a Windows Vista and later style dialog box.
The Previous locations list can hold up to a maximum of 15 directory pathnames that you add to the list. The first entry in the list is always the pathname of the directory that the dialog box is currently displaying, unless the pathname already exists within the Previous locations list.Note In addition to folders added explicitly with this function, folders selected by the user in a common item dialog might also appear in the Previous locations list. - Directory history list that appears in the dialog boxes you can display with the FileSelectPopup, MultiFileSelectPopup, or 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 folder name you want to insert into the Previous locations list or directory history list. 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 pathname to the Previous locations list or directory history list even if the 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 | int | Return value indicating whether the function was successful. A negative number indicates that an error occurred. |
Additional Information
Library: User Interface Library
Include file: userint.h
LabWindows/CVI compatibility: LabWindows/CVI 5.5 and later