多文档命令

多文档命令允许用户在选定的用户提示下切换文档，同时命令仍处于控制状态。使单个命令跨文档保持活动状态的功能非常复杂。在执行时，当用户选择要切换到的另一个文档时，所有文档都会轮询输入。因此，它们建立了可能错综复杂的命令处理器状态，包括可能的嵌套命令、AutoLISP 表达式、活动脚本以及任意嵌套顺序。

人们不费吹灰之力就不容易地将一个国家的相关要素界定为另一个州，更不用说嫁接了。相反，最佳策略是让应用程序保留对用户指定的文档开关的控制，即使应用程序必须作为不同窗口中的不同命令实现。然后，应用程序所需要的只是一种机制来链接在不同文档中运行的单独命令，并控制在更改文档时启动哪个命令。

要同步多个命令的操作，请实现覆盖以下反应器函数的反应器：AcApDocManager

virtual void
documentActivated(
    AcApDocument* pActivatedDoc);
 
virtual void
documentToBeDeactivated(
    AcApDocument* pDeActivatedDoc);

也可以使用反应器功能，但它发生在文档激活之前。在这种情况下，尚未设置文档上下文。documentToBeActivated()

每当用户单击其他文档以激活它时，都会调用这些回调。只有在提示用户输入之前的初始命令中，在支持文档切换时，才应使用 on。当任何或所有此类提示完成或取消时，应拆除反应堆。从回调中调用：AcApDocManager

virtual Acad::ErrorStatus 
sendStringToExecute(
    AcApDocument* pAcTargetDocument,
    const char * pszExecute,
    bool bActivate = true,
    bool bWrapUpInactiveDoc = false,
    bool bEchoString = true) = 0;

此函数将字符串排队，以便在下次激活指定文档时进行解释。该字符串通常应该是命令调用（我们称之为辅助命令），但也可以是 AutoLISP 表达式、命令片段或菜单标记。字符串限制为 296 字节，因此较长的序列应作为运行临时脚本的 SCRIPT 命令实现，或作为 AutoLISP 表达式实现以加载和执行 AutoLISP 程序。新文档将根据注册期间指定的新命令的锁定级别进行锁定。

如果初始命令中的输入提示符看起来与辅助命令中的第一个提示符相同，则用户无需知道正在执行两个单独的命令。

此外，为了管理跨文档的控制流，此回调应维护应用程序所需的任何转换状态。例如，不可重入变体可以记住原始文档，并为每个文档提供一个标志，以指示它是否已处于活动状态，因此不必调用。sendStringToExecute()

当多文档命令完成时，控制应用程序应确保该命令在以前的文档中没有留下挂起的命令状态。应用程序可以通过使用 bWrapUpInactiveDoc 参数向其遍历的文档发送 ESC 或 ENTER 来执行此操作。如果不这样做，文档可能会处于非静止状态。sendStringToExecute()

初始命令和辅助命令之间的协调（以及可能的多次调用）必须通过静态或堆驻留变量进行管理。

初始命令和辅助命令都应通过 or 注册。初始命令应编码为自行成功完成，以防用户决定在不切换文档的情况下执行整个命令。第二个命令不需要是完整命令，只需调用命令的一部分，以从不同的打开文档中累积信息（植根于静态结构），并应用结果。第二个命令可能还必须进行编码，以便可以在另一个文档中重新输入，如果这是命令的结构。acedRegCmds()acedDefun()

请记住，在设计这些构造时，UNDO 在每个文档中单独运行。