DESIGN (xvutils) functions


LIBRARY ROUTINE

xvu_browse_wait - pop up the Khoros file/alias browser; wait for response

LIBRARY CALL

char *xvu_browse_wait(
   char *directory)

INPUT

OUTPUT

none

RETURN VALUE

The string chosen from the browser by the user, or NULL if the user clicked on "Cancel".

DESCRIPTION

Causes the Khoros file / alias browser to pop up, and waits until the user selects a file or an alias before returning their selection.

The first element in the list is the "-- aliases --" entry with which the user may access the aliases capability of the browser. For more information on the Aliases capability, see Chapter 1 of the Khoros User's Manual.

The second element of the list is "../", which is used to move to an upper level directory. The remaining elements of the browser list are the contents of the specified directory. The browser remains displayed until the user selects a file from the browser, or clicks on "Cancel".

The user may select a file from the browser list; when this happens, the full path to the file is returned to the calling routine.

Alternatively, the user may select a sub-directory to change to that directory, or "../" to go up in the directory structure.

A text object at the bottom of the browser allows the user to type their own filename, or change directories. If a directory path is typed into the bottom text object followed by a <cr>, files in the browser list will be updated with the contents of the new directory.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DESIGN/objects/library/xvutils/src/browser.c

SEE ALSO

xvutils(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.