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);
}
{
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);
[In] string documentNameArg);
Arguments
• documentFullNameArg - 已关闭工作表的完整名称和路径。如果工作表是新的未保存文档，则自变量为 null。
• documentNameArg - 工作表名称。
OnWorksheetModified
发生于工作表修改后。
Syntax
void OnWorksheetModified([In] string documentFullNameArg,
[In] string documentNameArg,
[In] bool isModifiedArg);
[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);
[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);
[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);
[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);
[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);
[In] string documentNameArg,
[In] IMathcadPrimeValuesSetter setterArg);
Arguments
• documentFullNameArg - 工作表的完整名称和路径。
• documentNameArg - 工作表名称。
• setterArg - 新输入值的设置器。自变量由客户端提供。
相关链接