/* @(#)39	1.1  src/dtuimx/ibmr2/dtscriptdir/contrib/FileBrowser/README, uimx, dtuimx720 8/8/94 20:09:41 */
/*
 *  COMPONENT_NAME: DT UIM/X
 *  
 *  ORIGINS: 58
 *  
 *  
 *                   Copyright IBM Corporation 1991, 1994
 *  
 *                         All Rights Reserved
 *  
 *   Permission to use, copy, modify, and distribute this software and its
 *   documentation for any purpose and without fee is hereby granted,
 *   provided that the above copyright notice appear in all copies and that
 *   both that copyright notice and this permission notice appear in
 *   supporting documentation, and that the name of IBM not be
 *   used in advertising or publicity pertaining to distribution of the
 *   software without specific, written prior permission.
 *  
 *   IBM DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
 *   ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 *   PURPOSE. IN NO EVENT SHALL IBM BE LIABLE FOR ANY SPECIAL, INDIRECT OR
 *   CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
 *   USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
 *   OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE
 *   OR PERFORMANCE OF THIS SOFTWARE.
*/

Desktop Script contrib

Name:   FileBrowser

Abstract:  

        This contrib is a basic file browser.  It allows you to   
        browse a file contents by either selecting or providing
        the directory and file name.

Getting Started:

     i. load the contrib, FileBrowser.i into Desktop Script and
	try it in Test Mode (click on the "Test" radio button of
        the main window titled "Desktop Script").
	
	 - or -

    ii. load the contrib, FileBrowser.i, into Desktop Script, generate 
        interface code and run it as a standalone application.  To    
        generate interface code, select "Generate Interface Code As..."
        from the "File" pulldown of the main window titled "Desktop Script").

Description:

        When the file browser is executed, the "Directory:" Text Field
        displays the current directory.  The Scrolled List just below
        displays all directories within the current directory.  You
        can type in your own value for "Directory:" or select one
        of the directories listed in the Directory List.  The "."
        in the directory list indicates the current directory, and the
        ".." indicates one directory level up.

        Once the directory is selected, you can either type in your  
        own value for "File:" or select one of the files listed in 
        the Files List.  Once a file has been selected, the file
        contents are displayed just below the "File Contents:" label.
               
Purpose:

        This contrib shows how to build a single application interface
        using Desktop Script.  The interface is built using the Text Field,
        Scrolled List, Seperator, Pushbutton, Label and Scrolled Text
        widgets.

        The interface is a file browser.  It sets various callbacks
        in the property editor with the shell scripts to initialize
        and load the fields.  The callbacks are also used to set
        resources which are not surfaced in Desktop Script.
        
 
Contents:

	README		- this file.
	FileBrowser.i   - the interface file.