====== XT Frame Navi System ======

XT中每个命令都拥有一个唯一的字符串标识，通过字符串标识我们可以很方便的定制命令的界面入口形式。XT的功能入口主要分为主菜单、导航工具栏、快速工具条以及右键菜单几种方式。除了右键菜单以外，其他均可通过uisetting/xtframe目录下相应的配置文件定制，如果命令绑定了某个状态值，那么它对应的入口控件可通过函数来自动更新控件状态。添加功能需要按照各自的规范格式添加到对应的配置文件中。

  * [[reference::navisys#action|按钮入口]]
  * [[reference::navisys#edit|编辑框入口]]
  * [[reference::navisys#combo|下拉框入口]]
  * [[reference::navisys#titlebar|主标题栏]]
  * [[reference::navisys#ribbon|导航工具栏]]
  * [[reference::navisys#toolbar|快速工具条]]

----
{{anchor:action}}
**按钮入口**
关键字action，用于通过点击按钮即可触发的命令,如果该命令需要保持状态则改用关键字Check，样式如下：
  <action tip="Fit to Window" icon="icons/view_fit.png" cid="FitWindow" />
  <Check tip="Fit to Window" icon="icons/view_fit.png" cid="FitWindow" />
按钮入口可以配置如下属性：
^ 属性名      ^ 说明       ^ 类型          ^
| cid    | 命令标识（必须）     | 字符串        |
| icon    | 按钮图标相对路径 |字符串|
| tip    | 按钮小贴士     | 字符串        |
| text   | 显示字符串     | 字符串        |
| width  | 宽度    | 整数值        |


{{anchor:edit}}
**编辑框入口**
关键字Edit，用于需要输入一个参数值的命令，样式如下：
  <Edit text="Search" cid="search.id" width="120/>
  
{{anchor:combo}}
**下拉框入口**
关键字Combo，用于通过点击按钮即可触发的命令，样式如下：
<code>
  <Combo cid="search.type" width="100">
				<option text="Node" value="33000"/>
				<option text="Element" value="34000"/>
				<option text="Vertex" value="31002"/>
				<option text="Edge" value="31003"/>
				<option text="Face" value="31004"/>
				<option text="Body" value="31005"/>
				<option text="Command" value="-1"/>
 </Combo>
</code>
   

{{anchor:titlebar}}
**主标题栏**
主菜单的定制样式如下：
<code>
<title_bar>
		<menu text="File">
			<action text="New Pre" cid="NewPreDocument" icon="icons/file_new.png"/>
			<action text="New Post" cid="NewPostDocument" icon="icons/file_new.png"/>
		</menu>
		<module text="general">
 			<action tip="Open" cid="OpenDocument"  icon="icons/file_open.png"/>
			<action tip="Save As" cid="SaveAs"  icon="icons/saveas.png"/>
			<action tip="Save" cid="SaveDocument"  icon="icons/save.png"/>
		</module>
		<Combo cid="SetCurrentModel" width="200"/>
		<Combo cid="search.type" width="100">
				<option text="Node" value="33000"/>
				<option text="Element" value="34000"/>
		</Combo>
		<Edit text="Search" cid="search.id" width="120"></Edit>
</title_bar>
</code>
菜单栏可以定制菜单、下拉框、工具条以及编辑框。

{{anchor:ribbon}}
**导航工具栏**
导航工具栏可定制命令按钮
<code>
<tool_navi>
    <module text="主面板">
    	  <panel text="Import">
           <menu text="CAD" icon="icons/view_fit.png">
	            <action cid="ImportStl" text="STL" icon="icons/view_fit.png"/>
	            <action cid="ImportBdf" text="BDF" icon="icons/view_fit.png" />
	            <action cid="ImportStp" text="Stp" icon="icons/view_fit.png" />
           </menu>
           <menu text="Result" icon="icons/file_import.png">
	            <action cid="ImportOP2" text="Op2" icon="icons/view_fit.png" />
           </menu>
       </panel>
    </module>
    <module text="模型" tid="model">
         <panel text="部件">
            <action cid="CreatePart" text="新建" width="100" icon="icons/view_fit.png"/>
            <action cid="MovePart" text="移动" width="100" icon="icons/view_fit.png"/>
            <action cid="DeletePart" text="删除" width="100" icon="icons/view_fit.png"/>      
        </panel>
    </module>   
</code>
 
{{anchor:toolbar}}
**快速工具条**
快速工具条主要用于定制视图操作相关按钮
<code>
<tool_bar>  
    <module text="View" location="0">
        <action tip="Fit to Window" icon="icons/view_fit.png" cid="FitWindow" param="0" />
        <action tip="Front View" icon="icons/view_front.png" cid="SetFrontView"/>
        <action tip="Back View" icon="icons/view_back.png" cid="SetBackView" />
        <action tip="Right View" icon="icons/view_right.png" cid="SetRightView" />
        <action tip="Left View" icon="icons/view_left.png" cid="SetLeftView" />
        <action tip="Top View" icon="icons/view_top.png" cid="SetTopView" />
        <action tip="Bottom View" icon="icons/view_bottom.png" cid="SetBottomView" />
        <Check tip="Reset Center" icon="icons/view_reset_center.png" cid="SetViewCenter" />
        <Check tip="Local Zoom" icon="icons/view_local_zoom.png" cid="LocalZoom"/>
        <Check tip="Show Face" icon="icons/display_surface.png" cid="SetShowFace"/>
        <Check tip="Show Mesh" icon="icons/display_mesh_line.png" cid="SetShowMesh"/>
        <Check tip="Show Frame" icon="icons/display_frame.png" cid="SetShowEdge"/>
        <Check tip="Show LBC" icon="icons/show_lbc.png" cid="SetShowLBC"/>
        <Check tip="Solid" icon="icons/display_detail_section.png" cid="SetShowSolid" />
    </module>
</tool_bar>    
</code>