Guía de API > IMathcadPrimeEvents2
IMathcadPrimeEvents2
IMathcadPrimeEvents2 es una interfaz de eventos COM declarada en Ptc.MathcadPrime.Automation.dll y disponible en el directorio de instalación PTC Mathcad Prime. Las aplicaciones de cliente pueden gestionar eventos PTC Mathcad Prime empleando esta interfaz. Para ello, registre un objeto que implemente IMathcadPrimeEvents2 con la función InitializeEvents2.
Las siguientes interfaces de eventos COM están disponibles con PTC Mathcad Prime:
• IMathcadPrimeEvents (obsoleta)
• IMathcadPrimeEvents2 (amplía y sustituye a IMathcadPrimeEvents)
* 
PTC recomienda usar IMathcadPrimeEvents2. La interfaz obsoleta IMathcadPrimeEvents no se documenta en esta guía del API.
Los eventos siguientes están disponibles en 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);
}
Sintaxis y argumentos de eventos
OnWorksheetSaved 
Se produce cuando se guarda la hoja de trabajo.
Syntax
void OnWorksheetSaved([In] string documentFullNameArg);
Arguments
• documentFullNameArg: el nombre completo y la ruta de la hoja de trabajo.
OnWorksheetClosed 
Se produce cuando se cierra la hoja de trabajo.
Syntax
void OnWorksheetClosed([In] string documentFullNameArg,
[In] string documentNameArg);
Arguments
• documentFullNameArg: el nombre completo y la ruta de la hoja de trabajo cerrada. Si la hoja de trabajo es un documento nuevo que no se ha guardado, el argumento es null.
• documentNameArg: el nombre de la hoja de trabajo.
OnWorksheetModified 
Se produce cuando se modifica la hoja de trabajo.
Syntax
void OnWorksheetModified([In] string documentFullNameArg,
[In] string documentNameArg,
[In] bool isModifiedArg);
Arguments
• documentFullNameArg: el nombre completo y la ruta de la hoja de trabajo modificada. Si la hoja de trabajo es un documento nuevo que no se ha guardado, el argumento es null.
• documentNameArg: el nombre de la hoja de trabajo.
• isModifiedArg:
◦ True: la hoja de trabajo se marca como modificada.
◦ False: la hoja de trabajo se marca como no modificada.
OnWorksheetRenamed 
Se produce cuando se cambia el nombre de la hoja de trabajo usando Guardar como.
Syntax
void OnWorksheetRenamed([In] string previousFullNameArg,
[In] string currentFullNameArg,
[In] string previousDocNameArg,
[In] string currentDocNameArg);
Arguments
• documentFullNameArg: el nombre completo y la ruta de la hoja de trabajo anteriores.
• documentNameArg: el nombre completo y la ruta de la hoja de trabajo actuales.
• previousDocNameArg: el nombre anterior de la hoja de trabajo.
• currentDocNameArg: el nombre actual de la hoja de trabajo.
OnWorksheetInputsOutputsSelected 
Se produce cuando se seleccionan entradas o salidas en la hoja de trabajo.
Syntax
void OnWorksheetInputsOutputsSelected([In] string documentFullNameArg,
[In] string documentNameArg,
[In] IMathcadPrimeInputs inputsArg,
[In] IMathcadPrimeOutputs outputsArg);
Arguments
• documentFullNameArg: el nombre completo y la ruta de la hoja de trabajo. Si la hoja de trabajo es un documento nuevo que no se ha guardado, el argumento es null.
• documentNameArg: el nombre de la hoja de trabajo.
• inputsArg: una lista de entradas seleccionadas.
• outputsArg: una lista de salidas seleccionadas.
OnExit 
Se produce cuando PTC Mathcad Prime se cierra a través de otro cliente COM o de un método que no es COM.
El evento no se produce cuando un cliente COM cierra PTC Mathcad Prime empleando IMathcadPrimeApplication3.Quit.
Syntax
void OnExit();
OnWorksheetStatesGenerated 
Se produce cuando se completa una generación de estados.
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: el nombre completo y la ruta de la hoja de trabajo.
• documentNameArg: el nombre de la hoja de trabajo.
• operationsArg: las operaciones de la hoja de trabajo que han activado el evento.
• itemsStatesArg: una lista de elementos de entrada y salida con sus valores extraídos.
• conflictsArg: una recopilación de conflictos causados por itemsStatesArg.
OnWorksheetStatesGenerating 
Se produce durante la generación de estados.
Syntax
void OnWorksheetStatesGenerating([In] string documentFullNameArg,
[In] string documentNameArg,
[In] WorksheetOperations operationsArg,
[In] IMathcadPrimeInputsOutputsStates itemsStatesArg,
[In] IMathcadPrimeInputsOutputsConflicts conflictsArg);
Arguments
• documentFullNameArg: el nombre completo y la ruta de la hoja de trabajo que está generando los estados.
• documentNameArg: el nombre de la hoja de trabajo.
• operationsArg: las operaciones de la hoja de trabajo que han activado el evento.
• itemsStatesArg: una lista de elementos de entrada y salida con sus valores extraídos.
• conflictsArg: una recopilación de conflictos causados por itemsStatesArg.
OnWorksheetRequestToUpdateInputs 
Se produce cuando Mathcad necesita nuevos valores de regiones de entrada.
Syntax
void OnWorksheetRequestToUpdateInputs([In] string documentFullNameArg,
[In] string documentNameArg,
[In] IMathcadPrimeValuesSetter setterArg);
Arguments
• documentFullNameArg: el nombre completo y la ruta de la hoja de trabajo.
• documentNameArg: el nombre de la hoja de trabajo.
• setterArg: un establecedor de nuevos valores de entrada. El cliente proporciona el argumento.
Vínculos relacionados
Application.InitializeEvents2
Application.SubscribeEvent
¿Fue esto útil?