Objeto: Application
El objeto Application es el único objeto que se debe crear (mediante new). Se recuperan todos los demás objetos mediante la asignación de interfaces.
Consulte los siguientes ejemplos:
• Código administrado:
VB,
C# y
C++ usando
ApplicationCreator
• Código de creación de scripts:
JavaScript y
VBScript con el uso de ActiveX, un objeto
Application.
Métodos
• Activate(): permite colocar la ventana de PTC Mathcad Prime en primer plano y activarla.
• CloseAll(Ptc.MathcadPrime.Automation.SaveOption): permite cerrar todas las hojas de trabajo abiertas de PTC Mathcad Prime.
Comportamiento especial de las hojas de trabajo nuevas y no modificadas:
◦ La hoja de trabajo se cierra sin preguntar al usuario, aunque saveOption sea spPromptToSaveChanges.
◦ La hoja de trabajo se cierra sin guardar, aunque saveOption sea spSaveChanges.
Este método se utiliza para crear el objeto WorksheetReadonlyOptions y pasarlo como argumento OpenEx(String, WorksheetReadonlyOptions).
• GetVersion(): permite obtener la versión de PTC Mathcad Prime.
Devuelve:
Cadena
• InitializeEvents2(eventHandler,SubscribeAll)
eventHandler es un objeto proporcionado por el cliente que implementa la interfaz
IMathcadPrimeEvents2.
SubscribeAll es un valor booleano:
◦ True: se suscribe a todos los eventos al inicializar.
◦ False: no se suscribe a los eventos al inicializar. Puede suscribirse a eventos más adelante empleando la función
SubscribeEvent.
Devuelve:
S_OK: la inicialización de COM Events Sink se ha efectuado correctamente.
S_FALSE: la inicialización de COM Events Sink ha fallado.
• Open(filename)
filename (cadena): la ruta y el nombre de fichero de una hoja de trabajo PTC Mathcad Prime. Si filename es nulo o está vacío, abra una nueva hoja de trabajo.
• OpenEx(String,WorksheetReadonlyOptions): permite abrir la hoja de trabajo en PTC Mathcad Prime desde la ruta y definir WorksheetReadonlyOptions cuando se abre. Si String es NULL o EMPTY STRING, se abre una nueva hoja de trabajo.
String es la ruta a la hoja de trabajo que se debe abrir. Si la ruta es NULL o EMPTY STRING, abra una nueva hoja de trabajo.
WorksheetReadonlyOption es el objeto que se utilizará para definir las opciones
Readonly de la hoja de trabajo que se va a abrir.
Devuelve:
El objeto Worksheet asociado a la hoja de trabajo que se debe abrir o un valor nulo si se ha producido un error al recuperar una instancia de objeto.
• Quit(): permite cerrar esta aplicación de PTC Mathcad Prime, si es posible.
El comportamiento de Quit() se define del siguiente modo:
◦ Si hay conexiones activas, PTC Mathcad Prime sigue ejecutándose.
◦ Si no hay conexiones activas, pero sigue abierta una hoja de trabajo que no sea Sin título (o que sea Sin título pero se haya modificado y no se haya guardado), PTC Mathcad Prime se sigue ejecutando.
◦ Si no hay ninguna conexión activa y solo hay documentos Sin título no modificados abiertos, PTC Mathcad Prime se cierra.
• SubscribeEvent(MathcadPrimeEvents): permite suscribirse al evento
MathcadPrimeEvents por nombre.
MathcadPrimeEvents es el evento definido en la enumeración MathcadPrimeEvents que se debe suscribir.
Devuelve:
S_OK: la suscripción al evento se ha realizado correctamente.
S_FALSE: la suscripción al evento no se ha realizado correctamente (o el evento es erróneo).
• UnsubscribeEvent(MathcadPrimeEvents): permite cancelar la suscripción al evento MathcadPrimeEvents por nombre.
MathcadPrimeEvents es el evento definido en la enumeración MathcadPrimeEvents del cual debe anularse la suscripción.
Devuelve:
S_OK: la suscripción al evento se ha cancelado correctamente.
S_FALSE: la suscripción al evento no se ha cancelado (o el evento es erróneo)
Propiedades
• ActiveWorksheet: permite obtener la hoja de trabajo de PTC Mathcad Prime activa.
Devuelve:
El objeto MathcadPrimeWorksheet asociado a una hoja de trabajo activa, o Nulo si se ha producido un error al recuperar una instancia de objeto.
• Visible: permite definir u obtener la visibilidad de la ventana de PTC Mathcad Prime.