<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
<MAN>
  <LANGUAGE>eng</LANGUAGE>
  <TITLE>xgetfile</TITLE>
  <TYPE>Scilab Function</TYPE>
  <DATE>Jan 1996</DATE>
  <SHORT_DESCRIPTION name="xgetfile"> dialog to get a file path</SHORT_DESCRIPTION>
  <CALLING_SEQUENCE>
    <CALLING_SEQUENCE_ITEM>path=xgetfile([title='string'])  </CALLING_SEQUENCE_ITEM>
    <CALLING_SEQUENCE_ITEM>path=xgetfile(file_mask,[title='string'])  </CALLING_SEQUENCE_ITEM>
    <CALLING_SEQUENCE_ITEM>path=xgetfile(file_mask,dir,[title='string'])  </CALLING_SEQUENCE_ITEM>
    <CALLING_SEQUENCE_ITEM>path=xgetfile(file_mask,dir,'string')  </CALLING_SEQUENCE_ITEM>
  </CALLING_SEQUENCE>
  <PARAM>
    <PARAM_INDENT>
      <PARAM_ITEM>
        <PARAM_NAME>file_mask</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: a character string which gives the file mask to use for file selection. <VERB>file_mask</VERB> is written with Unix convention. the default value is '*'.</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
      <PARAM_ITEM>
        <PARAM_NAME>dir</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: a character string which gives the initial directory used for file search. by default xgetfile uses the previously selected directory.</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
      <PARAM_ITEM>
        <PARAM_NAME>path</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: is the user selected file path if user answers &quot;Ok&quot; or the &quot; &quot; string if user answers &quot;Cancel&quot;</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
      <PARAM_ITEM>
        <PARAM_NAME>title='string'  </PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>:Optional arguments which gives the title for the xgetfile window.</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
    </PARAM_INDENT>
  </PARAM>
  <DESCRIPTION>
    <P>
    Creates a dialog window for file selection</P>
  </DESCRIPTION>
  <EXAMPLE>
<![CDATA[
xgetfile()
xgetfile('*.sci','SCI/macros/xdess')
xgetfile(title='Choose a file name ')
 ]]>
  </EXAMPLE>
  <SEE_ALSO>
    <SEE_ALSO_ITEM>
      <LINK>x_dialog</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>file</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>read</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>write</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>exec</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>getf</LINK>
    </SEE_ALSO_ITEM>
  </SEE_ALSO>
</MAN>
