=============================================
``grail.dialogs.gselectdialogproject`` Module
=============================================
.. include:: ..\..\version.h

.. contents:: Table of Contents
   :backlinks: top

--------
Overview
--------

Defines the Select Project dialog.

Use this dialog to query a user for a project file.  The dialog keeps a
"last queried" list, and will remember the last selected location
placed. 

The location and responses are remembered on a user-by-user basis.

To activate the dialog use the :f:`selectproject` function.

---------
Functions
---------

:df:`selectionproject()`
   Call this function to open a dialog that queries the user for a
   Minesight(r) Compass project file. This function will return a path
   to the project file as a string. A blank string is returned if the
   client canceled the request.

   The following python snippet illustrates its usage,

   ::

    >>> from grail.dialogs import gselectprojectdialog
    >>> gselectprojectdialog.selectproject()
    'C:/projects/clas.prj'

   when the dialog was selected the :file:`c:\\projects\\clas.prj`.