macro/command/filenamebox.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
  "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  <title>filenamebox</title>
  <meta http-equiv="Content-Style-Type" content="text/css">
  <link rel="stylesheet" href="../../style.css" type="text/css">
</head>

<body>


<h1>filenamebox</h1>

<p>
Open a dialog can be selected a file. <em>(version 4.54 or later)</em>
</p>

<pre class="macro-syntax">
filenamebox &lt;title&gt; [&lt;dialogtype&gt; [&lt;initialdir&gt;]]
</pre>

<h2>Parameters</h2>

<dl>
        <dt class="macro">string &lt;title&gt;</dt>
        <dd>The title of dialog box</dd>

        <dt class="macro">integer &lt;dialogtype&gt; (optional default=zero) (version 4.65 or later)</dt>
        <dd>Specifies the type of dialog box.<br>
            If this parameter is zero, creates [Open] dialog box.<br>
            If this parameter is nonzero, creates [Save] dialog box.</dd>

        <dt class="macro">string &lt;initialdir&gt; (optional default="") (version 4.85 or later)</dt>
        <dd>The initial directory of the dialog box can be specified.<br>
            When the empty string and the invalid path are specified, the initial directory will be automatically selected 
            by using the Windows specification(lpstrInitialDir member of OPENFILENAME structure).
</dd>
</dl>

<h2>Return Value</h2>

<dl>
        <dt class="macro">System variable &lt;result&gt; (version 4.65 or later)</dt>
        <dd>If the user specifies a file name and clicks OK button, set to nonzero. The file name is stored in "inputstr."<br>
            If the user cancels or closes the dialog, set to zero.</dd>

        <dt class="macro">System variable &lt;inputstr&gt;</dt>
        <dd>The file name entered by the user</dd>
</dl>

<h2>Example</h2>

<pre class="macro-example">
connect '/C=11'
filenamebox 'File selection' 0
if result&lt;&gt;0 then
        messagebox inputstr 'title' 0
        sendfile inputstr 1
endif
</pre>

</body>
</html>