﻿<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<?application progid="SMath Studio Desktop" version="0.99.7030.1435"?>
<worksheet xmlns="http://smath.info/schemas/worksheet/1.0">
  <settings ppi="96">
    <identity>
      <id>00abbfad-953a-4c6a-b146-5abbedff71f1</id>
      <revision>8</revision>
    </identity>
    <metadata lang="eng">
      <title>Path Picker Region Documentation</title>
      <author>Davide Carpi</author>
      <translator>Davide Carpi</translator>
      <description>Official documentation about the Path Picker Region.</description>
      <company>Davide Carpi</company>
      <keywords>path, picker, select, file, folder, directory, region</keywords>
    </metadata>
    <calculation>
      <precision>4</precision>
      <exponentialThreshold>5</exponentialThreshold>
      <trailingZeros>false</trailingZeros>
      <significantDigitsMode>false</significantDigitsMode>
      <roundingMode>0</roundingMode>
      <fractions>decimal</fractions>
    </calculation>
    <pageModel active="true" viewMode="0" printGrid="false" printAreas="true" simpleEqualsOnly="false" printBackgroundImages="true">
      <paper id="0" orientation="Portrait" width="827" height="1169" />
      <margins left="39" right="39" top="39" bottom="39" />
      <header alignment="Center" color="#a9a9a9">&amp;[DATE] &amp;[TIME] - &amp;[FILENAME]</header>
      <footer alignment="Center" color="#a9a9a9">&amp;[PAGENUM] / &amp;[COUNT]</footer>
      <backgrounds />
    </pageModel>
    <dependencies>
      <assembly name="SMath Studio Desktop" version="0.99.7030.1435" guid="a37cba83-b69c-4c71-9992-55ff666763bd" />
      <assembly name="Math Region" version="0.99.7030.1435" guid="02f1ab51-215b-466e-a74d-5d8b1cf85e8d" />
      <assembly name="TextRegion" version="1.11.7030.1435" guid="485d28c5-349a-48b6-93be-12a35a1c1e39" />
      <assembly name="Path Picker Region" version="0.1.7038.33439" guid="bd70ce3f-ee97-4c22-aa20-acd725feff4e" />
    </dependencies>
  </settings>
  <regions type="content">
    <region id="0" left="234" top="0" width="242" height="31" color="#000000" bgColor="#ffffff" fontSize="16">
      <text lang="eng">
        <p bold="true">Path Picker Region</p>
      </text>
    </region>
    <region id="1" left="0" top="36" width="104" height="23" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p bold="true">Installation</p>
      </text>
    </region>
    <region id="2" left="9" top="72" width="744" height="38" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p>Inside the program: "Tools" &gt; "Plugins..." then switch "Local Storage" button to
"Online Gallery", finally search for this plugin in the list, select it and click "install".</p>
      </text>
    </region>
    <region id="3" left="9" top="117" width="704" height="53" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p>Offline installation: go to the extension's page, download the plugin, then drag &amp; drop
the zip archive into the program canvas. If you are not running the latest SMath Studio
version, ask the developer or the community to know the appropriate plugin version.</p>
      </text>
    </region>
    <region id="4" left="0" top="180" width="48" height="23" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p bold="true">Usage</p>
      </text>
    </region>
    <region id="5" left="9" top="216" width="720" height="23" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p>Click on "Insert" &gt; "Controls" &gt; "Path picker"; a new region will be added on the canvas.</p>
      </text>
    </region>
    <region id="6" left="270" top="252" width="191" height="27" color="#000000" bgColor="#ffffff" fontSize="10">
      <pathpicker error="0" type="directory" relative="true" path="">
        <input>
          <e type="operand">#</e>
        </input>
      </pathpicker>
    </region>
    <region id="7" left="9" top="306" width="704" height="23" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p>In the math placeholder, place the name of a variable where you want to store the path.</p>
      </text>
    </region>
    <region id="8" left="270" top="333" width="191" height="27" color="#000000" bgColor="#ffffff" fontSize="10">
      <pathpicker type="directory" relative="true" path="">
        <input>
          <e type="operand">path</e>
        </input>
      </pathpicker>
    </region>
    <region id="9" left="9" top="387" width="600" height="23" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p>The variable will be an empty string "" up to when you will choose a path.</p>
      </text>
    </region>
    <region id="10" left="324" top="423" width="86" height="24" color="#000000" bgColor="#ffff80" fontSize="10">
      <math>
        <input>
          <e type="operand">path</e>
        </input>
        <result action="numeric">
          <e type="operand" style="string"></e>
        </result>
      </math>
    </region>
    <region id="11" left="9" top="459" width="688" height="23" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p>Right-click on the region, and choose the best options for you from the context menu:</p>
      </text>
    </region>
    <region id="12" left="27" top="495" width="288" height="23" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p bold="true">- Browse directories / Browse files</p>
      </text>
    </region>
    <region id="13" left="45" top="522" width="600" height="23" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p>This changes the type of items you can pick once you click on "Select...".</p>
      </text>
    </region>
    <region id="14" left="27" top="549" width="128" height="23" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p bold="true">- Relative path</p>
      </text>
    </region>
    <region id="15" left="45" top="576" width="656" height="38" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p>Check it to have the path relative to your worksheet; the worksheet must be saved
somewhere in order to generate a relative path.</p>
      </text>
    </region>
    <region id="16" left="27" top="621" width="64" height="23" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p bold="true">- Clear</p>
      </text>
    </region>
    <region id="17" left="45" top="648" width="352" height="23" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p>Clear the path if one was already selected.</p>
      </text>
    </region>
    <region id="18" left="9" top="684" width="368" height="23" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p>Finally you can pick the path by clicking on:</p>
      </text>
    </region>
    <region id="19" left="27" top="711" width="96" height="23" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p bold="true">- Select...</p>
      </text>
    </region>
    <region id="20" left="45" top="738" width="232" height="23" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p>Open the path picker dialog.</p>
      </text>
    </region>
    <region id="21" left="0" top="783" width="104" height="23" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p bold="true">SMath Viewer</p>
      </text>
    </region>
    <region id="22" left="9" top="810" width="712" height="38" color="#000000" bgColor="#ffffff" fontSize="10">
      <text lang="eng">
        <p>A dedicated input control is generated in SMath Viewer if the region is enabled.
If a description is set and visible, it will be used on the LHS to describe the control.</p>
      </text>
    </region>
  </regions>
</worksheet>