XT Document

XT框架中所有功能均从类ICommand继承实现。对于有对话框的功能，开发者（也可以是其他人）需提前准备好对话框的配置文件，对话框的配置文件可参考XT Customized GUI System编辑完成。

新的功能类从ICommand继承，需要注意的是const char * getName() const必须在头文件中声明，XT框架依赖该函数完成功能的注册。

class CmdTest : public ICommand
{
public:
  CmdForce(IMainFrame * pMain);
  void initWindow(); //初始化对话框，当对话框需要根据文档的数据或者当前状态进行初始化时需要
  const char * getUISettingXml() { return "test.xml"; } //指定对话框配置文件，当对话框功能时需要
  void onDataExchange( const char * dxdiag = NULL); //功能参数与对话框控件状态的匹配交换
  bool checkContext(); //检查参数是否满足功能执行条件
  void onControlEvent(const char * ctrlName, TypeID event = Event_Any); //响应控件的事件
  ErrorCode execute(); //执行功能逻辑
  const char * getName() const; //必须声明
  void setParam(const CmdParam *param); //设置功能参数
  bool checkContextParam(const TreeNode * targetNode, const TreeNode * refNode); //从模型树菜单启动功能时通过节点上下文设置命令参数
  void setContextParam(const TreeNode * targetNode, const TreeNode * refNode); //从模型树菜单启动功能时检查节点上下文是否匹配命令
  void exchangeScript(ParamList * param); //记录功能脚本
  CommandType getType() {return Command_Dialog;} //定义功能类型
  void updateFrame(); //更新框架和视图
private:
  ParamTest m_oParam; //功能参数，从CmdParam继承
  TreeNode * m_pObjNode = 0; //模型树节点
};

开发者根据需要实现声明中的部分或者全部成员函数。此外，开发者需调用REGISTER_CMD宏完成功能的注册，注册时需要指定命令名以及文档ID，如下所示，其中“Test”为命令名，Document_Test()为访问文档ID的接口，它们共同构成命令的索引。

REGISTER_CMD(CmdTest, 0, "Test", Document_Test())

需要注意的是，文档ID一般通过调用接口完成，不能指定静态变量来给定，原因是功能的注册是一个静态调用，而静态变量在此静态调用执行时是否已经正确初始化是不能保证的，通过接口调用则可避免该问题。

原则上一个功能只在它所属的文档空间中使用，但是在多数情况下，功能所涉及的数据都是通过XDocument所提供的统一接口访问，在这种情况下，这个功能是可以在另外一个文档空间中使用的，开发者可以使用宏BIND[NUMBER]_DOCCMD来完成，其中[NUMBER]从1到8，即意味着最多可以注册到9个不同的文档空间中（理论上，这个数字并没有限制，只是XT只预置了这么多宏，在超出这个数字的情况下，开发者可以调用CommandManager::registerCommandToDocument完成）。

REGISTER_CMD(CmdTest, 0, "Test", Document_Test())

开发好的功能通过功能管理器CommandManager管理索引，可以在功能入口配置文件进行配置然后通过用户交互触发，也可以直接在代码中调用。

• 通过Ribbon菜单触发

<tool_navi>
    <module text="主面板">
    	  <panel text="创建">
	          <action cid="ClearDocument" text="清空" icon="icons/import.png"/>
	          <action cid="CreateModel" text="模型" icon="icons/import.png"/>
	          <action cid="CreateMaterial" text="材料" icon="icons/import.png"/>
	          <action cid="CreateMPC" text="约束" icon="icons/import.png"/>
	          <action cid="SectionT" text="T型截面" icon="icons/import.png"/>
        </panel>
    	  <panel text="分析">
	          <action cid="ModalAnalysis" text="分析设定" icon="icons/import.png"/>
	          <action cid="RunJob" text="求解" icon="icons/import.png"/>
 	          <action cid="RunPost" text="后处理" icon="icons/import.png"/>
       </panel>
    </module>  
</tool_navi>

• 通过工具条触发

<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/xoy.png" cid="SetFrontView"/>
        <action tip="Back View" icon="icons/yox.png" cid="SetBackView" />
        <action tip="Right View" icon="icons/yoz.png" cid="SetRightView" />
        <action tip="Left View" icon="icons/zoy.png" cid="SetLeftView" />
        <action tip="Top View" icon="icons/zox.png" cid="SetTopView" />
        <action tip="Bottom View" icon="icons/xoz.png" cid="SetBottomView" />
        <action checkable="true" tip="Reset Center" icon="icons/view_reset_center.png" cid="SetViewCenter" />
        <action checkable="true" tip="Local Zoom" icon="icons/view_local_zoom.png" cid="LocalZoom"/>
        <action checkable="true" tip="Show Face" icon="icons/display_surface.png" cid="SetShowFace"/>
        <action checkable="true" tip="Show Mesh" icon="icons/display_mesh_line.png" cid="SetShowMesh"/>
        <action checkable="true" tip="Show Frame" icon="icons/display_frame.png" cid="SetShowEdge"/>
    </module>
</tool_bar>

• 通过菜单栏触发

<menu_bar>
		<module text="general">
 			<action tip="New" cid="NewDocument"  icon="icons/file_new.png"/>
 			<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"/>
			<action tip="Close" cid="CloseDocument"  icon="icons/closedoc.png"/>
		</module>
		<module_tab ></module_tab>
</menu_bar>

• 通过右键菜单触发

		<node type="CPART" icon="icons/tree/4-2Geom.png">
 			<action text="选择" cid="SelectTreeItem"  icon="icons/file_new.png"/>
		</node>
		<category type="Property">		
			<node type="CPRPBAR" >
				<action text="删除" cid="DeleteItem"  />
				<action text="修改" cid="Bar"  />
			</node>
			<node type="CPRPSHELL" >
				<action text="删除" cid="DeleteItem"  />
				<action text="修改" cid="Shell"  />
			</node>
			<node type="CSECT" >
				<action text="删除" cid="DeleteItem"  />
				<action text="修改" cid="SectionT"  />
			</node>
		</category>	

• 在代码中调用

	ParamPickByAngle param;
	param.setFlag(RunCmd_GUI_Off);
	param.dAngleTol = m_pCoAngle->text().toDouble();
	m_pFrm->launchCommand(Command_PickByAngle, &param);