LOGO
帮助文档
旧版文档
说明com接口的命令执行vc接口的命令执行
说明

在CAD控件中,所有与用户交到的操作函数, 都必须放在命令执行事件中调用 。 因为与用户交互操作时,CAD控件会启动一个临时的windows消息循环,这样执行交互函数时,会临时等待用户操作,在事件退出时,CAD控件就有机会控制临时信息消息循环的退出处理。 

比如在等待用户交到操作过程中,如果用户点击了窗口上关闭按钮结束程序,或点击了另一个按钮,又重新执行一个命令,这些都需要CAD控件在事件结束时自动处理,防止出错。

com接口的命令执行

DoCommand说明: 该函数开始执行控件的一个用户自定义命令,参数是命令的id,这个id值可以随便取值,它是用来标识该命令, 多个命令之间的id值不能重复

前面的DoCommand的调用后,程序将会跳转命令执行事件函数中。 命令调用过程流程图:


step.png


如C#语言


开始执行一个命令: 在界面上放一个按钮“ 打开DWG ” 给按钮增加点击事件如下:


private void button6_Click(object sender, EventArgs e)
        {
            axMxDrawX1.DoCommand(6);
        }


axMxDrawX1.DoCommand调用后就会跳到命令事件中,给窗口增加CAD控件命令执行事件,并加代码,如下:


   private void axMxDrawX1_ImplementCommandEvent(object sender, AxMxDrawXLib._DMxDrawXEvents_ImplementCommandEventEvent e)
        {
 
if (e.iCommandId == 6)
             {
                // 打开文件.
                OpenFileDialog ofd = new OpenFileDialog();
                ofd.Filter = "dwg 文件(*.dwg)|*.dwg";
 
                if(ofd.ShowDialog() ==  DialogResult.OK)
                {
                    axMxDrawX1.OpenDwgFile(ofd.FileName);
                }
             }
  }


如JS语言


开始执行一个命令: 在界面上放一个按钮“ 打开DWG ” 给按钮增加点击事件如下:


<input type="button" value="写扩展数据" onclick="DoCmd(11)">


调用DoCommand执行用户命令,DoCommand调用后就会跳到命令事件中,DoCmd代码如下:


function DoCmd(iCmd) {
    mxOcx.DoCommand(iCmd);
}


添加命令事件:


document.getElementById("MxDrawXCtrl").ImplementCommandEventFun = DoCommandEventFunc;


命令事件函数实现:


function DoCommandEventFunc(iCmd)
{
     if (iCmd == 11) {
        WriteXData();
    }
}


写扩展数据函数实现:


function WriteXData() {
    var selEnt = mxOcx.NewComObject("IMxDrawUiPrEntity");

    selEnt.message = "选择要写扩展数据的对象";
    if (selEnt.go() != 1)
        return;

    var ent = selEnt.Entity();
    if (ent == null)
        return;

    if (ent.SetxDataString("ExDataName", 0, "ExDataValue")) {
        alert("写扩展数据成功");
    }
    else {
        alert("写扩展数据失败");
    }
}


在工具条定义文件中执行用户命令


工具条定义文件中一行代表一个工具条上的按钮,如果用户想点击工具条上的按钮,按钮执行命令事件,如下定义工具条:


    ("保存dwg文件" "保存dwg文件" "SaveDwg" "IDB_SAVEDWG_BITMAP"  "" "MxDraw.dll" "15")


上述定义了一个打开dwg文件按钮,点击这个按钮,相当于执行DoCommand(15)。


在菜单条中执行用户命令


菜单条定义文件中一行代表一个菜单命令,如果用户想点击菜单,执行命令事件,如下定义菜单条定义文件:


    "打开(&O)" "Mx_OpenMxg" "IDB_OPENMXG_BITMAP" "" "" "15"


上述定义了一个打开文件菜单,点击这个菜单项,相当于执行DoCommand(15)。


为命令注册一个命令名称,方便命令输入和调用


RegistUserCustomCommand function


作用:向控件注册一个命令,用户在命令行输入命令名这个字符串,就会触发执行命令事件 命令事件的id就是该注册时的id值。


接口BOOL RegistUserCustomCommand(LPCTSTR pszCommandName, long lId)


参数


名称说明
pszCommandName

命令名称

lId

命令id


参考例程(VB代码)


MxDrawX1.RegistUserCustomCommand " MyTest11", 15


参考例程(c#代码)


axMxDrawX1.RegistUserCustomCommand("MyTest11",9999);
        axMxDrawX1.Focus();
      // 命令 响应代码
        private void axMxDrawX1_ImplementCommandEvent(object sender, AxMxDrawXLib._DMxDrawXEvents_ImplementCommandEventEvent e)
        {
           if (e.iCommandId == 9999)
            {
                MessageBox.Show("用户定义命令执行....");
            }
        }


调用控件自带命令


CAD控件工具条上的按钮,都是CAD控件内部命令实现,点击工具条上的按钮,就会在命令行看到相关命令名称。如下图所示:


hh.png


如果用户想在自己的按钮中,调用画线命令。如下:


axMxDrawX1.SendStringToExecute("Mx_Line");


在命令执行中,再调用另一个命令


控件是不允许命令被重入,也就是说不能同时执行两个命令,比如当前用户正交到绘制直线,当用户点击绘制圆按钮时,绘制直线命令就需要立即退出,并进入绘圆命令。


那么如果用户想要在命令中,调用另一个命令,可以把另一个命令当前一个函数调用,调用如下:


axMxDrawX1.SendStringToExecuteFun("Mx_Line");


命令函数执行完后,可以调用GetEntitysLastCmd函数返回,命令函数新增加的实体,它返一个MxDrawResbuf对象,也就是说,得到一个数组,得到多个新增加的实体。


如下JS代码,调用控件的绘制样条线命令,并得到新绘制样的样条线,然后修改它的线重:


function DrawSpline() {
    mxOcx.Cal("Mx_ShowWeight");
 
    var param = mxOcx.NewResbuf();
    mxOcx.SendStringToExecuteFun("_DrawSpline", param);
    var retparam = mxOcx.GetEntitysLastCmd();
    if (retparam == null)
        return;
 
    if (retparam.Count == 0)
        return;
 
    var spline = retparam.AtObject(0);
    if (spline == null) {
        return;
    }
 
    spline.Lineweight = 40;
 
}


有些命令在用时,可以转入参数,调用SendStringToExecuteEx函数。 如:调用阵列命令,并传递参数:


MxDrawSelectionSet ss = new MxDrawSelectionSet();
                        MxDrawUtility utility = new MxDrawUtility();
                        utility.Prompt("选择阵列对象:");
                        ss.Select(MCAD_McSelect.mcSelectionSetUserSelect, null, null, null);
                        if (ss.Count == 0)
                            return; 
                        MxDrawResbuf param = new MxDrawResbuf();
 
                        // 10行.
                        param.AddLongEx(10, 1070);
 
                        // 20列.
                        param.AddLongEx(20, 1070);
 
                        // 行偏移.
                        param.AddDoubleEx(100, 1040);
 
                        // 列偏移.
                        param.AddDoubleEx(150, 1040);
 
                        // 阵列角度.
                        param.AddDoubleEx(15.0, 1040);
 
                        // 阵列对象个数.
                        param.AddLongEx(ss.Count, 1070);
                        for (int i = 0; i < ss.Count; i++)
                        {
                            MxDrawEntity ent = ss.Item(i);
                            param.AddObjectId(ent.ObjectID);
                        }
 
                        // 调用阵列命令.
                        axMxDrawX1.SendStringToExecuteEx("Mx_Array", param);
vc接口的命令执行

VC2010调用是控件 DLL 接口,这个调用过程和AutoCAD Arx开发是一样的。


命令函数实现:


.h文件:


class CTestCommands
{
static void TextToCurve();
}


.cpp文件:


void CTestCommands::TextToCurve()
{
	ads_name entName;
	ads_point pt;
	if(acedEntSel(_T("选择需要编辑的文字:"),entName,pt) != RTNORM)
	{
		return;
	}
	AcDbObjectId objId;
	if(acdbGetObjectId(objId,entName) != Acad::eOk)
		return;

	AcDbObjectPointerspText(objId,AcDb::kForWrite);
	if(spText.openStatus() != Acad::eOk)
		return;


	McDbVoidPtrArray aryCurve ;
	if(!MxDraw::TextToCurves(spText.object(),aryCurve) )
		return;

	for(int i = 0; i < aryCurve.length();i++)
	{
		McDbEntity* pEntity = (McDbEntity* )aryCurve[i];

		MrxDbgUtils::addToCurrentSpaceAndClose(pEntity);
	}
	spText->erase();
}


注册一个命令:


acedRegCmds->addCommand(_T("SysCmd"), _T("TextToCurve"), _T("TextToCurve"), 1, TextToCurve);


执行命令:


acDocManager->sendStringToExecute(MxDraw::GetDatabase(m_hDrawOcx)->GetDocument()
		,_T("TextToCurve") );