<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet href="../../../design/description.xslt" type="text/xsl"?>
<node lang="en" type="DynamicNode.Lib.Cockpit.NFile" assembly="NLibCockpit" xmlns="http://dynamicnodes.mastersign.de/description">
  <caption>File Path</caption>
  <group>Cockpit</group>
  <description>Represents a control in the cockpit for specifying a file system path to a file.</description>
  <inPorts>
    <port name="name">
      <type>string</type>
      <description>The name of the control.</description>
    </port>
    <port name="autoPublish">
      <type>bool</type>
      <description>
        <c>true</c> if the node passes the current value immediatly with every change; otherwise <c>false</c>.
      </description>
    </port>
    <port name="sortIndex">
      <type>int</type>
      <description>The index for specifying the order of the user controls in the cockpit.</description>
    </port>
    <port name="browseType">
      <type>DynamicNode.Lib.Cockpit.FileBrowseType</type>
      <description>The style of the dialog window: &quot;Open file&quot; or &quot;Save file&quot;.</description>
    </port>
    <port name="filter">
      <type>string</type>
      <description>The filter for the file name. 
      It consists of two parts: &quot;&lt;Caption&gt;|&lt;Filter&gt;&quot;. 
      A simple exmaple: &quot;Image file (*.jpg, *.png)|*.jpg;*.png&quot;</description>
    </port>
    <port name="defaultExt">
      <type>string</type>
      <description>The default file extension which is automatically appended, if none given.</description>
    </port>
    <port name="title">
      <type>string</type>
      <description>The title of the dialog window.</description>
    </port>
  </inPorts>
  <outPorts>
    <port name="value">
      <type>System.IO.FileInfo</type>
      <description>A file info object, describing the selected file.</description>
    </port>
  </outPorts>
  <helpText>
    <p>This node represents a user control for choosing a file in the file system.</p>
    <p>
      The cockpit is a collection of user controls managed by the DynamicNodes system
      and presented e.g. as a view port in the development environment or via a web interface.
    </p>
    <reference type="msdn" ref="system.io.fileinfo.aspx">System.IO.FileInfo</reference>
  </helpText>
  <customArea>The name of the user control.</customArea>
</node>