IMathcadPrimeEvents2

API 指南 > IMathcadPrimeEvents2

IMathcadPrimeEvents2 是 Ptc.MathcadPrime.Automation.dll 中声明的 COM 事件接口，位于 PTC Mathcad Prime 安装目录中。客户端应用程序可通过此接口来处理 PTC Mathcad Prime 事件。为此，请注册一个使用 InitializeEvents2 函数实现 IMathcadPrimeEvents2 的对象。

以下 COM 事件接口适用于 PTC Mathcad Prime：

• IMathcadPrimeEvents (已废弃)

• IMathcadPrimeEvents2 (扩展和取代 IMathcadPrimeEvents)

PTC 建议使用 IMathcadPrimeEvents2。此 API 指南中未介绍已废弃的 IMathcadPrimeEvents 接口。

以下事件适用于 IMathcadPrimeEvents2：

    public interface IMathcadPrimeEvents2
    {
        void OnWorksheetSaved([In] string documentFullNameArg);

        void OnWorksheetClosed([In] string documentFullNameArg,
                               [In] string documentNameArg);

        void OnWorksheetModified([In] string documentFullNameArg,
                                 [In] string documentNameArg,
                                 [In] bool isModifiedArg);

        void OnWorksheetRenamed([In] string previousFullNameArg,
                                [In] string currentFullNameArg,
                                [In] string previousDocNameArg,
                                [In] string currentDocNameArg);

        void OnWorksheetInputsOutputsSelected([In] string documentFullNameArg,
                                              [In] string documentNameArg,
                                              [In] IMathcadPrimeInputs inputsArg,
                                              [In] IMathcadPrimeOutputs outputsArg);
        void OnExit();

        void OnWorksheetStatesGenerated([In] [MarshalAs(UnmanagedType.BStr)] string documentFullNameArg,
                                        [In] [MarshalAs(UnmanagedType.BStr)] string documentNameArg,
                                        [In] WorksheetOperations operationsArg,
                                        [In] [MarshalAs(UnmanagedType.Interface)] IMathcadPrimeInputsOutputsStates itemsStatesArg,
                                        [In] [MarshalAs(UnmanagedType.Interface)] IMathcadPrimeInputsOutputsConflicts conflictsArg);

        void OnWorksheetStatesGenerating([In] string documentFullNameArg,
                                         [In] string documentNameArg,
                                         [In] WorksheetOperations operationsArg,
                                         [In] IMathcadPrimeInputsOutputsStates itemsStatesArg,
                                         [In] IMathcadPrimeInputsOutputsConflicts conflictsArg);

        void OnWorksheetRequestToUpdateInputs([In] string documentFullNameArg,
                                              [In] string documentNameArg,
                                              [In] IMathcadPrimeValuesSetter setterArg);
   }

事件语法和自变量

OnWorksheetSaved

发生于保存工作表后。

Syntax

void OnWorksheetSaved([In] string documentFullNameArg);

Arguments

• documentFullNameArg - 工作表的完整名称和路径。

OnWorksheetClosed

发生于工作表关闭后。

Syntax

void OnWorksheetClosed([In] string documentFullNameArg,
[In] string documentNameArg);

Arguments

• documentFullNameArg - 已关闭工作表的完整名称和路径。如果工作表是新的未保存文档，则自变量为 null。

• documentNameArg - 工作表名称。

OnWorksheetModified

发生于工作表修改后。

Syntax

void OnWorksheetModified([In] string documentFullNameArg,
[In] string documentNameArg,
[In] bool isModifiedArg);

Arguments

• documentFullNameArg - 已修改工作表的完整名称和路径。如果工作表是新的未保存文档，则自变量为 null。

• documentNameArg - 工作表名称。

• isModifiedArg:

◦ True - 将工作表标记为已修改。

◦ False - 将工作表标记为未修改。

OnWorksheetRenamed

发生于通过“另存为”将工作表重命名后。

Syntax

void OnWorksheetRenamed([In] string previousFullNameArg,
[In] string currentFullNameArg,
[In] string previousDocNameArg,
[In] string currentDocNameArg);

Arguments

• documentFullNameArg - 工作表先前的完整名称和路径。

• documentNameArg - 工作表当前的完整名称和路径。

• previousDocNameArg - 工作表先前的名称。

• currentDocNameArg - 工作表当前的名称。

OnWorksheetInputsOutputsSelected

发生于在工作表中选择所有输入和/或输出后。

Syntax

void OnWorksheetInputsOutputsSelected([In] string documentFullNameArg,
[In] string documentNameArg,
[In] IMathcadPrimeInputs inputsArg,
[In] IMathcadPrimeOutputs outputsArg);

Arguments

• documentFullNameArg - 工作表的完整名称和路径。如果工作表是新的未保存文档，则自变量为 null。

• documentNameArg - 工作表名称。

• inputsArg - 选定输入的列表。

• outputsArg - 选定输出的列表。

OnExit

发生于 PTC Mathcad Prime 由另一个 COM 客户端或通过任何非 COM 方法关闭时。

当 COM 客户端使用 IMathcadPrimeApplication3.Quit 关闭 PTC Mathcad Prime 时，不会发生此事件。

Syntax

void OnExit();

OnWorksheetStatesGenerated

发生于状态生成完成时。

Syntax

void OnWorksheetStatesGenerated([In] [MarshalAs(UnmanagedType.BStr)] string documentFullNameArg,
[In] [MarshalAs(UnmanagedType.BStr)] string documentNameArg,
[In] WorksheetOperations operationsArg,
[In] [MarshalAs(UnmanagedType.Interface)] IMathcadPrimeInputsOutputsStates itemsStatesArg,
[In] [MarshalAs(UnmanagedType.Interface)] IMathcadPrimeInputsOutputsConflicts conflictsArg);

Arguments

• documentFullNameArg - 工作表的完整名称和路径。

• documentNameArg - 工作表名称。

• operationsArg - 触发事件的工作表操作。

• itemsStatesArg - 带有提取值的输入和输出项列表。

• conflictsArg - 由 itemsStatesArg 引起的冲突集合。

OnWorksheetStatesGenerating

发生于状态生成期间。

Syntax

void OnWorksheetStatesGenerating([In] string documentFullNameArg,
[In] string documentNameArg,
[In] WorksheetOperations operationsArg,
[In] IMathcadPrimeInputsOutputsStates itemsStatesArg,
[In] IMathcadPrimeInputsOutputsConflicts conflictsArg);

Arguments

• documentFullNameArg - 将生成状态的工作表的完整名称和路径。

• documentNameArg - 工作表名称。

• operationsArg - 触发事件的工作表操作。

• itemsStatesArg - 带有提取值的输入和输出项列表。

• conflictsArg - 由 itemsStatesArg 引起的冲突集合。

OnWorksheetRequestToUpdateInputs

发生于 Mathcad 需要输入区域的新值时。

Syntax

void OnWorksheetRequestToUpdateInputs([In] string documentFullNameArg,
[In] string documentNameArg,
[In] IMathcadPrimeValuesSetter setterArg);

Arguments

• documentFullNameArg - 工作表的完整名称和路径。

• documentNameArg - 工作表名称。

• setterArg - 新输入值的设置器。自变量由客户端提供。