IMathcadPrimeEvents2
IMathcadPrimeEvents2 - это интерфейс событий COM, объявленный в Ptc.MathcadPrime.Automation.dll и доступный в каталоге установки PTC Mathcad Prime. Используя этот интерфейс, клиентские приложения могут обрабатывать события PTC Mathcad Prime. Для этого зарегистрируйте объект, который реализует IMathcadPrimeEvents2 с использованием функции InitializeEvents2.
Благодаря PTC Mathcad Prime доступны следующие интерфейсы событий COM:
• IMathcadPrimeEvents (устаревший)
• IMathcadPrimeEvents2 (расширяет и заменяет IMathcadPrimeEvents)
 |
PTC рекомендует использовать IMathcadPrimeEvents2. Устаревший интерфейс IMathcadPrimeEvents не задокументирован в этом руководстве по API.
|
Благодаря 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
Возникает при переименовании документа командой Сохранить как (Save As).
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 закрывает PTC Mathcad Prime, используя IMathcadPrimeApplication3.Quit.
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 - метод задания новых входных значений. Аргумент поставляется клиентом.
См. также: