Abarcar el Contenido A Través de Múltiples...

Abarcar el Contenido A Través de Múltiples CD-ROMs Para abarcar el contenido a través de múltiples CD’s, debes crear una a aplicación por separado para cada CD.

Si esta no es una opción para tu proyecto, y no hay forma de que puedas ajustar tu proyecto a un solo CD, deberías considerar la distribución de tu proyecto en un DV D.

Abrir un Archivo .DOC de Microsoft Word Para abrir un Documento de W ord usando AutoP lay M edia Studio, utiliza la Acción Rápida “Open Document” para llamar al documento. U sa el botón Browse que está junto a “Document to Open” para seleccionar el archivo .DOC que quieras abrir.

R ecuerda que tienes que asignarle una Acción Rápida a algún objeto, así que primeramente tienes que crear uno (normalmente un botón).

Nota: AutoP lay M edia Studio no cuenta con un objeto W ord. Para abrir un documento W ord en la computadora del usuario, éste debe tener un programa capaz de abrir el documento (por ejemplo M icrosoft W ord o M icrosoft W ord V iewer).

Consejo: AutoP lay M edia Studio 7 contiene el objeto R ichT ext que puede ser usado para mostrar texto con formato.

Abrir un Archivo HTML en una Ventana Desplegable En AutoP lay M edia Studio es posible abrir un documento H TML en el Explorador por defecto del usuario. Para lograr esto, por favor dirígete al tema “Abrir un Sitio Web en un Explorador Externo”.

Abrir un Archivo PDF Adobe Acrobat Para abrir un Archivo PDF en Adobe Acrobat usando AutoP lay M edia Studio, utiliza la Acción Rápida “Open Document” para llamar al documento. U sa el botón Browse que está junto a “Document to Open” para seleccionar el archivo PDF que quieras abrir.


1

Nota: AutoP lay M edia Studio no cuenta con un objeto PDF. Para abrir un documento PDF en la computadora del usuario, éste debe tener un programa capaz de abrir el documento (por ejemplo Adobe Acrobat R eader).

Abrir un Archivo PPT/PPS de PowerPoint Para abrir una presentación PowerPoint usando AutoP lay M edia Studio, utiliza la Acción Rápida “Open Document” para llamar al documento. U sa el botón Browse que está junto a “Document to Open” para seleccionar el archivo PPT /PPS que quieras abrir.


Nota: AutoP lay M edia Studio no cuenta con un objeto PowerPoint. Para abrir una presentación PowerPoint en la computadora del usuario, éste debe tener un programa capaz de abrir la presentación (por ejemplo M icrosoft PowerPoint).

Abrir un Archivo QuickTime MOV Para abrir una película Q uickT ime usando AutoP lay M edia Studio, utiliza la Acción Rápida “Open Document” para llamar al documento. U sa el botón Browse que está junto a “Document to Open” para seleccionar el archivo .MOV que quieras abrir.


Nota: AutoP lay M edia Studio no cuenta con un objeto Q uickT ime. Para abrir un documento Q uickT ime en la computadora del usuario, éste debe tener un programa capaz de abrir la película (por ejemplo Apple Q uickT ime). Además, date cuenta que no utilizamos la Acción Rápida “Play Multimedia”. La Acción Rápida “Play Multimedia” es sólo para tipos de archivo multimedia que pueden ser reproducidos en el interior de AutoP lay M edia Studio.

Abrir un Sitio Web en un Explorador Externo AutoPlay M edia Studio contiene una Acción Rápida incorporada la cual abre un sitio web en el explorador por defecto del usuario: V iew W ebsite. Esto es útil, por ejemplo, si quieres tener un botón etiquetado como “Company W ebsite” para abrir el sitio web de tu compañía en el explorador por defecto del usuario

Para lograr esto, utiliza la Acción Rápida “V iew W ebsite”:

1 . Crea un objeto de Botón.

2

2. H az doble click en el objeto de Botón, elige la pestaña Q uick Action (Acción

Rápida) y luego elige V iew W ebsite como Action to run (Acción a ejecutarse). 3. En el campo W eb site, escribe la dirección web de tu compañía. 4. H az click en OK.

Ajustar el Control de Volumen en Tiempo de Ejecución A manera de ejemplo, crearemos un proyecto con dos botones: un botón que incremente el volumen y otro botón que lo disminuya.

1 . Inserta el siguiente código en el evento On Click del botón que incrementa el volumen:

audio_channel = CHANNEL_U SER 1 ; Audio.SetV olume(audio_channel, Audio.GetV olume(audio_channel)+ 20);

2. Inserta el siguiente código en el evento On Click del botón que disminuye el volumen:

audio_channel = CHANNEL_U SER 1 ; Audio.SetV olume(audio_channel, Audio.GetV olume(audio_channel)-20);

Ajustar el Nivel del Volumen Ajustar el volumen de un canal de audio es útil cuando tú quieres, por ejemplo, no tener música impertinente escuchándose en tu proyecto. Para lograr esto en AutoP lay M edia Studio, utiliza la acción Audio.SetV olume.

Como un ejemplo, tocaremos un soundtrack como música de fondo y fijaremos el volumen con un máximo de 25% :

1 . Inserta el siguiente código en el evento “On Show” de tu página:

Audio.Load(CHANNEL_BACKGR OU ND, "your_audio_here.ogg", true, true); Audio.SetV olume(CHANNEL_BACKGR OU ND, 63); -- fija el nivel de volumen en un 25% de 255

3

Ajustar los Atributos de Archivo para Más de un Archivo AutoPlay M edia Studio tiene una acción File.SetAttributes para ajustar los atributos de un archivo. Si quieres ajustar los atributos de muchos archivos a la vez, necesitas ejecutar esa acción múltiples veces. U na manera fácil de hacer esto es almacenar la lista de archivos en una tabla, y luego orbitar a través de esa tabla utilizando un bucle for. Cada paso a través del bucle ajustará los atributos para cada uno de los archivos.

U na forma sencilla de crear una tabla llena de rutas de archivo es usar la acción File.Find. La acción File.Find regresa una tabla conteniendo una lista de todos los archivos que concuerden con un patrón específico.

Como ejemplo, ajustaremos todos los archivos .exe en la carpeta raíz de la unidad C a sólo lectura:

1 . Inserta el siguiente script dentro de un evento de tu proyecto:

files_to_change = File.Find("C:\\", "*.exe"); -- orbita a través de los archivos para pasarlos a tabla -- y ajusta los atributos de cada archive uno a la vez for index, filename in files_to_change do File.SetAttributes(filename,{R eadOnly= true}); end

Ajustar los Efectos de Transición de Página AutoP lay M edia Studio incluye un par de transiciones de página. En lugar de simplemente saltar de una página a la siguiente, y hacer que una página desaparezca y la siguiente aparezca, estas transiciones hacen que una página salte un poco más emocionante.

Para lograr esto, utiliza las transiciones de página:

1 . En el panel Propiedades de la página, cambia el campo T ransition de None a la transición que desees (Dissolve, Slide o W ipe). Ahora, al utilizar una Acción page jump o una page navigate desde esa página, la transición que seleccionaste será utilizada.

4

La transición no afecta a algunos objetos, tales como web, listbox, etc. Para utilizar las transiciones en páginas conteniendo estos objetos, haz lo siguiente:

1 . T oma una captura de pantalla de la página completamente renderizada que quieras hacerle la transición.

2. Inserta esta captura de pantalla como una gran imagen hacia la página a la que quieras que se haga la transición.

3. Ajusta la visibilidad de todos los objetos a false, y la visibilidad de la imagen a true.

4. En el evento On Show de esta página, muestra todos los objetos, y oculta la imagen.

Alternar la Música de Fondo a On/Off Es posible en AutoP lay M edia Studio tener música de fondo reproduciéndose en tu aplicación.

En AutoP lay M edia Studio esto se logra usando la Acción Rápida Play/Pause Background Music:

1 . Crea un botón. 2. Elige Play/Pause Background Music como la Acción Rápida para el botón.

Añadir una Contraseña de Protección H ay muchos casos donde se le requerirá al usuario introducir información que no debe estar visible en la pantalla, tal como una contraseña. En AutoP lay M edia Studio se consigue esto usando una acción Dialog.PasswordInput.

5

Como un ejemplo, se le requerirá al usuario una contraseña al iniciar un programa, y se comparará con un valor almacenado (en consecuencia se limita el acceso al programa sólo a aquellos que conocen la contraseña).

Para lograr esto:

1 . Inserta el siguiente script en el evento “On Show” de la página:

-- La contraseña “correcta” real_password = "password"; -- Pedir al usuario que escriba la contraseña user_password = Dialog.PasswordInput("Password", "Por favor introduce la contraseña: ", MB_ICONQ U EST ION); -- Comparar si la contraseña del usuario es la contraseña “correcta”. -- Si el usuario proporciona una contraseña errónea, salir del programa. if real_password ~= user_password then Application.Exit(); end

Este script hace que aparezca un cuadro de diálogo requiriendo la contraseña. Cualquier cosa que el usuario escriba en este cuadro de diálogo aparecerá como ******. Si la contraseña correcta es escrita, el programa se abrirá normalmente. Si la contraseña escrita no es la correcta, el programa se cerrará.

Alternativamente, tú puedes tener una “lista” de contraseñas válidas. Para lograr esto, almacena tus contraseñas válidas en una tabla:

1 . Inserta el siguiente script en el evento “On Show” de tu página:

--Suponer que el usuario escribió una contraseña incorrecta correct_password = false; -- La contraseña “correcta” real_passwords = {"password", "password2", "3rdPassword"}; -- Pedir al usuario que escriba la contraseña user_password = Dialog.PasswordInput("Password", " Por favor introduce la contraseña: ", MB_ICONQ U EST ION); -- Comparar la contraseña del usuario con la contraseña “correcta”. for j in real_passwords do if real_passwords[j] == user_password then correct_password = true; end end --S i la contraseña no es la correcta, salir if not correct_password then

6

Application.Exit(); end

Consejo: Como una pequeña variación de esta técnica, puedes almacenar tu lista de contraseñas en un archivo de texto, y cuando tu aplicación esté abierta, llena una tabla con el contenido de ese archivo de texto. U n ejemplo para pasar un archivo de texto a una tabla lo puedes ver en: “¿Cómo leer líneas específicas de un archivo de texto?”.

Añadir un Hipervínculo o un Hotspot a un Objeto Añadir un hipervínculo a un proyecto es útil si deseas que un usuario al hacer click en una parte de tu proyecto pueda obtener más información. Esto se logra en Autoplay M edia Studio usando el evento “On Click” de un objeto.

Ejemplo 1:

Como un ejemplo, asumamos que quieres saltar a la Página 2 cuando el usuario hace click sobre la frase “Continue… ” dentro de un Paragraph Object. Para el propósito de este ejemplo, asumiremos también que tú tienes el siguiente párrafo en tu proyecto:

1 . U tiliza un H otspot Object y colócalo sobre la frase “Continue… ” en tu Paragraph Object

2. En la ficha “Q uick Action” del H otspot Object, elige “Show Page” como Action to run, luego elige “Specific Page” en Page to show, y elige “Page 2” en Page name.

Ejemplo 2:

Para obtener efectos “mouseover” (el texto cambia de color cuando tú posicionas el ratón encima de la palabra “Continue… ”) no utilices un H otspot, en vez de esto utiliza un segundo Paragraph Object que contenga sólo el texto que el “mouseover” debería cambiar:

1 . Crea un Paragraph Object que contenga solamente la palabra “Continue… ” 2. Coloca ese objeto exactamente sobre la frase “Continue… ” en tu párrafo más

grande.

7

Consejo: U sa las flechas del teclado para posicionar exactamente tu segundo Paragraph Object.

3. Selecciona el color que quieras para el “mouseover”. En la ficha Q uick Action de este Paragraph Object elige “Show Page” en Action to run; elige “Specific Page” en Page to show, y elige “Page 2” en Page name. T ambién puedes hacer que al posicionar el ratón sobre un objeto de párrafo cambie de dibujo el cursor del ratón; para ello ve a la ficha “Attributes” y selecciona “H and” en Cursor y listo.

Ejemplo 3:

Para incluir hipervínculos en un archivo de texto sin utilizar un H otspot Object o un Paragraph Object, incrusta un archivo H TML en tu proyecto usando un W eb Object. Cuando el usuario hace click sobre un enlace en este archivo incrustado, tu proyecto puede ejecutar cualquier acción que elijas:

1 . Crea un W eb object y cárgale el archivo H TML deseado. 2. V e a “¿Cómo interactuar con Web objects incrustados?” para establecer la

navegación en tu proyecto, y para un ejemplo de un simple archivo H TML.

Nota: Esta es la mejor manera de incluir hipervínculos si tu texto no es estático con relación a la página. M ientras que un Paragraph Object o un H otspot Object son estacionarios, los vínculos dentro de un archivo H TML se mueven dinámicamente basados en el tamaño del W eb object en tiempo de ejecución.

Aplicar Cambios a Múltiples Objetos Con frecuencia es útil poder cambiar las propiedades de varios objetos a la vez. Para lograr esto en AutoP lay M edia Studio:

1 . Selecciona el primer objeto. 2. Mantén oprimida la techa Ctrl de tu telado. 3. Selecciona los demás objetos que desees. 4. Suelta ahora la tecla Ctrl.

Cualquiera de las propiedades que estén disponibles para todos los objetos que seleccionaste, estarán visibles en el Panel Propiedades (Properties Pane). Ahora puedes hacer los cambios que requieras.

Consejo: Cuando selecciones múltiples objetos, el mantener oprimida la tecla Shift de tu teclado tiene las mismas funciones que mantener oprimida la tecla Ctrl.

8

Auto-Guardar Mi Proyecto Los apagones de luz o “congelamientos” de las computadoras son inevitables, incluso pareciera que esto ocurre a propósito en el peor momento posible. AutoP lay M edia Studio tiene una opción incorporada para grabar tu proyecto en un intervalo de tiempo que tú elijas.

Para habilitar esta opción:

1 . V e al menú Edit > Preferences. 2. H az click en Document. 3. H abilita la característica Auto Save y elige el intervalo de tiempo para el

autoguardado. 4. H az click en OK.

Bloquear Objetos En AutoP lay M edia Studio es posible bloquear tus objetos a la página de modo que no puedan ser movidos a ninguna posición o ser editados al hacer doble click sobre ellos. El bloquear tus objetos los hace aparecer como si fueran parte del fondo. Si haces doble click sobre un objeto bloqueado, la ventana Page Properties será mostrada.

Nota: Aunque un objeto esté bloqueado, aún puedes editarlo desde el panel Propiedades.

Para bloquear un objeto:

1 . Selecciona el objeto deseado. 2. H az click derecho sobre el objeto. 3. Elige Lock.

Para desbloquear un objeto:

1 . Selecciona el objeto deseado. 2. H az click derecho sobre el objeto. 3. Deshabilita Lock.

Caducar mi Aplicación Después de Treinta Días Para hacer que tu Aplicación expire después de treinta días, almacena en el registro la fecha en que el programa fue ejecutado por primera vez, y cada vez consecutiva que el programa es corrido, compara el registro con la fecha de expiración (30 días después de que tu programa por primera vez se instaló)

Para lograr esto:

9

1 . Inserta el siguiente código dentro del evento On Startup de tu proyecto:

-- Inicializar variables days_left = 30; date_installed = Application.LoadV alue("My Application ", "Date Installed"); time_limit = 30; --la duración del periodo de prueba, en días -- Convertir el valor de la cadena a número date_installed = String.T oNumber(date_installed); -- Fue date_installed 0 (inexistente)? if date_installed == 0 then -- El valor fue inexistente, créalo Application.SaveV alue("My Application", "Date Installed", System.GetDate(DATE_FMT _JU LIAN)); else -- Actualizar días que quedan days_left = (date_installed + time_limit) - System.GetDate(DATE_FM T _JU LIAN); end -- H ay días remanentes? if days_left < 1 then -- No hay días remanentes, alertar al usuario y salir. Dialog.M essage("Fin del Periodo de Prueba", "Este software ha expirado"); Application.Exit(); else -- Aún quedan días, alertar al usuario cuántos Dialog.M essage("Periodo de Prueba", "T e quedan "..days_left.." días en tu periodo de prueba."); end

Caducar mi Aplicación después de Cierta Fecha Para hacer que tu aplicación expire después de cierta fecha, fija una variable en tu programa para la fecha de vencimiento, y cada vez que el programa sea corrido, compara la fecha actual contra ese valor. Si tu programa ha expirado, se cerrará.

Para lograr esto:

1 . Inserta el siguiente código dentro del evento On Startup de tu proyecto:

--Inserta tu fecha de expiración aquí, con formato Y Y Y Y MMDD --(sin espacios, guiones, abreviaturas, etc., sólo usa números) --Abajo está la fecha 1 2 de Diciembre de 2003 Expiration_Date = "20031 21 2" --Obtén la fecha del sistema en formato ISO

10

--Fecha = Y Y Y Y -MM -DD Date = System.GetDate(DATE_FM T _ISO); --Q uita los guiones en la fecha del formato ISO --para reflejar el formato de nuestra fecha de expiración --Fecha == Y Y Y Y MMDD Date = String.R eplace(Date, "-", "", false); --comprobar si la aplicación ha expirado if Date > Expiration_Date then --La aplicación ha expirado Dialog.M essage ("Aplicación V encida!", "T u copia de esta aplicación ha expirado! Este programa se cerrará ahora."); Application.Exit(); end

Al intentar abrir tu aplicación, se desplegará un mensaje de diálogo como el siguiente:

Caducar mi Aplicación Después de Cierto Número de Ejecuciones Para hacer que tu aplicación expire después de cierto número de ejecuciones, almacena un valor en el registro la primera vez que el programa es corrido, y lo incrementa cada vez consecutiva que el programa es corrido. Entonces, cada vez que el programa se ejecuta, verifica el valor almacenado.

Para lograr esto:

1 . Inserta el siguiente código dentro del evento On Startup de tu Proyecto:

-- Fija el número de veces permitido times_allowed = 30; -- R ecupera el número de veces que se ha corrido y convierte el valor en número times_run = Application.LoadV alue("M i Aplicación", "H a Sido Corrida"); times_run = String.T oNumber(times_run);

11

-- Calcula el número permitido de veces que quedan para poder correrlo times_remaining = (times_allowed - times_run) -- V erifica si esta es la primera vez que la aplicación ha sido corrida -- Guarda el valor del nuevo número de veces que se ha corrido if times_run == 0 then Application.SaveV alue("M i Aplicación", "H a Sido Corrida ", "1"); else Application.SaveV alue("M i Aplicación", "H a Sido Corrida ", (times_run + 1 )); end -- V erifica si la aplicación ha sido corrida más veces que las permitidas if times_run > times_allowed then Dialog.M essage("Fin del Periodo de Prueba", "Este software ha expirado"); Application.Exit(); else Dialog.M essage("Periodo de Prueba", "Puedes ejecutar este Programa "..times_remaining.." veces más."); end

Cambiar el Icono de la Aplicación Para cambiar el icono que tu aplicación usa:

1 . H az click en el menu Project > Settings 2. Activa la casilla “Custon Icon” en Options. 3. H az click en “Browse” y elige el icono que quieras usar. 4. H az click en OK.

Nota: Cualquier otro icono personalizado que tú elijas debe estar en el formato .ICO (que es el estándar de W indows)

Cambiar el Tamaño de Página En AutoP lay M edia Studio, el tamaño predeterminado de un proyecto es de 630 pixeles de ancho por 425 pixeles de alto. Si tu proyecto requiere diferentes dimensiones, cambia el tamaño de la ventana en el cuadro de diálogo Project Settings:

1 . V e al menú Project > Settings. 2. Cambia el tamaño de la ventana en “W idth” y “H eight” a los valores que

quieras, y haz click en OK.

12

Cambiar el Texto de la Barra de Título Para cambiar el texto que aparece en la barra de título de tu aplicación:

1 . V e al menú Project > Settings. 2. Escribe el título de tu elección en el área de W indow T itle. 3. H az click en OK.

Cargar y Mostrar un Archivo de Texto Para desplegar una gran cantidad de texto en tu página, utiliza la acción T extFile.R eadT oString y muestra los resultados en un objeto de párrafo.

Para lograr esto en AutoP lay M edia Studio:

1 . Elige el menú Object > Paragraph. 2. Inserta el siguiente código dentro de cualquier evento en tu aplicación:

text = T extFile.R eadT oString("AutoP lay\\Docs\\large_text.txt"); Paragraph.SetT ext("Paragraph1", text);

Nota: Acuérdate de añadir un archivo con extensión .txt en la carpeta Docs de Autoplay. Este archivo de texto debe ser grande y tiene que llevar por nombre large_text.

Cerrar Mi Aplicación Inmediatamente Normalmente para cerrar tu aplicación, deberías usar la acción Application.Exit(). Sin embargo, si necesitas que tu aplicación termine inmediatamente, en vez de usar Application.Exit(), usa el siguiente código:

W indow.Close(Application.GetW ndH andle(), CLOSEW ND_TER MINATE);

Comparar Dos Strings (Cadenas) Las comparaciones de String son ejecutadas de la misma forma que las comparaciones de números. A manera de ejemplo, crearemos dos Springs, y ejecutaremos una acción basada en sus contenidos:

1 . Crear dos variables conteniendo strings:

13

String1 = "Soy String1 "; String2 = "Soy String2";

2. Comparar las dos strings:

if String1 == String2 then --las dos strings son iguales else -- las dos strings no son iguales if String1 > String2 then --String1 es alfabéticamente más grande que String2 elseif S tring1 < String2 then --String1 es alfabéticamente más pequeña que String2 end end

Nota: S i quieres comparar las longitudes de las dos strings, debes usar la acción String.Length:

if String.Length(String1 ) == String.Length(String2) then --las dos strings tienen la misma longitud end

Consejo: Para ejecutar la comparación de dos strings en un caso no sensible, usa una acción String.CompareNoCase.

Copiar un Archivo o una Fuente en el Disco Duro Con frecuencia es útil copiar un archivo desde el CD-R OM (o desde otro medio) a la computadora del usuario. En AutoP lay M edia Studio, esto se logra con una acción File.Copy.

A manera de ejemplo, cargaremos una fuente específica dentro de la computadora del usuario:

--obtener el directorio de destino (en este caso, donde las fuentes están almacenadas) fonts_dir = Shell.GetFolder(SHF_FONT S); --copiar el archivo desde tu CD al directorio de fuentes del usuario File.Copy(_SourceFolder .. "\\my_font.ttf", fonts_dir..\\"my_font.ttf", false, true, false, true, nil); --registrar la fuente en W indows System.R egisterFont(fonts_dir .. "\\myfont.ttf", "My Font Name", true);

14

Crear un Botón que Cierre la Aplicación En AutoP lay M edia Studio, para crear un botón que cierre la aplicación haz lo siguiente:

1 . V e al menú Object > Button y selecciona un archive de botón para usar. 2. H az doble click en el botón que acabas de incorporar, luego haz click en la ficha

Q uick Action. 3. Selecciona Exit/Close en Action to run. 4. H az click en OK.

Crear un CD de Modo-Mixto Los CD’s pueden ser creados en modo mixto, es decir, CD’s que contienen tanto aplicaciones para usarse en una computadora como pistas de música para usarse en un reproductor estándar de CD’s. Los CD’s de modo mixto son frecuencia usados para crear un CD de audio “enriquecido” el cual se reproduce normalmente en un reproductor regular de CD y presenta contenido multimedia adicional cuando es colocado en el CD-R OM de una computadora.

H ay tres tipos básicos de CD’s de Modo-M ixto:

Datos en Pista 1

Descripción:

Este tipo de CD de modo mixto coloca la pista de datos como la primer pista de música en el disco.

Pros:

El CD es grabado como R OM Modo 1 , por ello puede ser reproducido prácticamente en cualquier unidad de CD-R OM.

Contras:

Algunos reproductores de CD intentarán reproducir la pista datos. La mayoría de los reproductores nuevos pasarán por alto la pista debido a que está listada como “datos” en la tabla de contenidos del CD, pero algunos reproductores intentarán reproducir la pista de datos como audio, dando como resultado un sonido ruidoso (como el “chillido” de un fax).

Este método es usado típicamente sólo en situaciones donde sea improbable que el CD vaya a ser reproducido en un reproductor de CD de audio.

15

Pre-Gap / Track-Zero

Descripción:

Este tipo de CD de modo mixto oculta la pista de datos en la pausa antes de que la pista 1 comience.

Pros:

Los reproductores de CD más viejos normalmente no intentan reproducir la pista de datos.

Contras:

S i el usuario rebobina el CD hasta la pista de datos, los datos pueden ser reproducidos como audio, dando como resultado un ruido desconcertante.

Este tipo de CD no se amolda en el estándar oficial y puede ser no-compatible con algunos reproductores o sistemas operativos.

CD Extra o CD Enriquecido

Descripción:

Este tipo de CD de modo mixto contiene dos sesiones (disco multi-sesión). La primera sesión contiene más de 98 pistas de audio, y la segunda sesión contiene la pista de datos. Los reproductores de CD de audio sólo pueden “ver” la primera sesión, y por ello no reproducirán la pista de datos. La mayoría de las unidades de CD-R OM pueden “ver” ambas sesiones, y cargarán tu aplicación AutoP lay.

Pros:

Incluso los reproductores de CD más viejos no reproducirán la pista de datos, así que los oídos y bocinas del usuario están seguras de daño.

Este formato es el más compatible tanto para reproductores de CD stand-alone como para unidades de CD-R OM.

Contras:

Los CD́s enriquecidos no se pueden reproducir en reproductores Photo CD.

Se requiere una unidad de CD-R OM que pueda leer discos multi-sesión.

16

Conclusión

Nuestra Sugerencia:

T e sugerimos que utilices el tipo “CD Enriquecido”, debido a que cuenta con mayor compatibilidad. Comúnmente cualquier CD-R OM creado para W indows 95 o superior soporta este formato.

Los archivos de datos serán reconocidos en el Explorador de W indows como si no hubiera pistas de audio, ya que el Explorador de W indows normalmente sólo puede ver la última sesión en un disco multi-sesión. Por otra parte, los reproductores de audio normalmente sólo ven la primer sesión en un disco multi-sesión. Por esto, los reproductores de audio de CD-R OM y los stand-alone pueden reproducir las pistas de audio.

Quemar un CD Enriquecido (CD Extra) con Nero:

Para quemar un CD Enriquecido con Nero Burning R OM (6.0 o superior):

1 . Selecciona “CD Extra” e ingresa tu configuración deseada. 2. Agrega tus pistas de audio arrastrando tus archivos de audio a la ventana de la

pista . 3. Agrega tus archivos de datos arrastrándolos a la carpeta de la estructura de la

ventana.

Crear un CD-ROM Navegador de Windows En AutoP lay M edia Studio se puede abrir una carpeta de la computadora del usuario, ya sea dentro de tu proyecto, o en una ventana externa (lo mismo que al hacer doble click sobre una carpeta de tu escritorio). Es posible abrir una carpeta en vista para explorar (de la misma forma que usando el Explorador de W indows)

Abrir una carpeta dentro de tu proyecto: 1 . Crea un W eb Object, y nómbralo W eb1 . 2. Llama la acción W eb.LoadU R L:

W eb.LoadU R L("W eb1", "C:\\");

Nota: S i el usuario no tiene el Explorador de Internet 4.0 o superior como su explorador predeterminado, la vista de la carpeta será en H TML, y no basada en W indows.

17

Abrir una carpeta en una ventana externa: 1 . Llama la acción File.Open:

File.Open("C:\\", "", SW _SHOW NOR MAL);

Abrir una carpeta en una ventana del Explorador: 1 . Llama la acción File.ExploreFolder:

File.ExploreFolder("C:\\", SW _SHOW NOR MAL);

Consejo: S i tu proyecto está siendo corrido desde la unidad de CD-R OM del usuario y deseas explorar el CD-R OM desde tu aplicación en Autoplay, utiliza _SourceFolder como la ruta para explorar/abrir.

Crear un Explorador de Archivos En AutoP lay M edia Studio es posible tener una lista de archivos que el usuario pueda abrir haciendo click sobre ellos.

A manera de ejemplo, crearemos una listbox con dos opciones de película en ella. El usuario hará click en uno de los archivos y clickeará un botón para abrir el archivo.

1 . Crear un objeto listbox

2. Agregar los nombres de la película en la columna Item T ext y la ruta de las películas en la columna Item Data.

3. Crear un botón.

4. En el evento On Click de la ficha Script del botón, añade el siguiente script:

selected = ListBox.GetSelected("ListBox1"); file = ListBox.GetItemData("ListBox1", selected[1 ]); File.Open(file, "", SW _SHOW NOR MAL)

Nota: S i tienes habilitada la opción de Multiple Selection en tu listbox, el ejemplo de arriba sólo abrirá el primer archivo seleccionado

Consejo: Q uizás podrías añadir algo para prevenir errores que puedan ocurrir. U no de esos errores sería si el usuario hace click en la listbox pero no selecciona nada. El script de arriba comenzaría bien, pero la línea 2 fallaría porque selected[1 ] sería nulo. Puedes usar una declaración “if” para que revise en busca de valores nulos:

18

if (selected) then -- Hay por lo menos un item seleccionado, ponga sus acciones aquí end De este modo, no ocurre nada a menos que algo sea seleccionado (los errores nulos asociados son prevenidos).

Crear un Mapa de Imagen Los mapas de imagen son usados para hacer varias localizaciones dentro de una imagen “hot” o clikeable. Para lograr esto en AutoP lay M edia Studio:

1 . Crea una imagen en un editor de imágenes externo. En tu proyecto utiliza un H otspot object para cada área clickeable:

2. Agrega una acción para cada H otspot object en el evento On Click para lograr la tarea deseada. Por ejemplo, para abrir un Explorador W eb, usa la acción:

File.OpenU R L("http://www.indigorose.com/", SW _SHOW NOR MAL);

Consejo: Al pasar el ratón en alguno de los botones de la izquierda se puede visualizar alguna imagen en el área de la derecha que permita al usuario darse una idea del contenido de cada opción.

Crear un Unico Archivo Ejecutable U na vez que hayas terminado la creación de tu aplicación, AutoP lay M edia Studio ofrece la opción de publicar tu proyecto en un simple ejecutable. Cuando el usuario corre este archivo, con ello extrae el contenido a un directorio temporal y lanza tu aplicación. Cuando tu aplicación es cerrada, el directorio temporal y su contenido son borrados.

Para convertir tu proyecto en un archivo ejecutable:

19

1 . V e al menú Publish > Build. 2. Selecciona W eb/Email executable. 3. H az click en Next. 4. Introduce la ruta y el nombre de archivo deseados. 5. H az click en Build.

Nota: El seleccionar la opción “Encrypt data segment” no afecta la manera en la que el usuario corre tu programa. Más bien esta opción de encriptado genera una contraseña al azar previniendo que el usuario quiera descomprimir el archivo ejecutable y así evitar que tenga acceso a los archivos de tu proyecto.

Crear una Aplicación Multilenguaje Para crear un proyecto que soporte más de un lenguaje, crea un proyecto para cada lenguaje que desees que soporte, y un proyecto maestro para decidir cual proyecto lanzar.

En tu proyecto maestro, usa una acción System.GetDefaultLangID para determinar cuál es el lenguaje predeterminado del usuario, y así lanzar el archivo del proyecto apropiado.

Otra posibilidad es determinar el lenguaje ID en el evento On Preload y entonces saltar a una página en particular o incluso presentarle opciones disponibles que lo redirijan a la sección apropiada de una sola aplicación.

Crear una Función Callback Personalizada H abrá ocasiones en las que querrás personalizar la manera en que la información es desplegada a tus usuarios cuando ciertas acciones son ejecutadas. Para hacer esto, tendrás que crear una función callback personalizada.

Para ver un ejemplo de una función callback personalizada, favor de ver el tema Ejemplos de Funciones Callback.

Crear una Tabla de Contenidos (Un Indice) U na forma de navegar a través de una aplicación con multi-páginas es utilizar una página de T abla de Contenidos. En AutoP lay M edia Studio esto se logra creando una página al principio de tu proyecto e incorporando un objeto navegante (por ejemplo un botón) para cada página hacia donde quieras dirigirte.

20

A manera de ejemplo, crearemos un proyecto con tres páginas (una página para la T abla de Contenidos, y dos páginas con el contenido) donde la Página 1 es la T abla de Contenidos, y las Páginas 2 y 3 son las páginas con el contenido:

Para la primer página:

1 . Crea dos botones. 2. En la pestaña Q uick Action del primer botón, elige Show Page como action to

run, elige Specific Page y Page 1 como Properties. 3. En la pestaña Q uick Action del segundo botón, elige Show Page como action to

run, elige Specific Page y Page 2 como Properties.

Nota: Es posible que quieras crear un botón de regreso en cada una de tus páginas de contenido para volver a la T abla de Contenidos. Esto de logra exactamente de la misma manera descrita arriba. Simplemente tienes que especificar cuál página deseas que se muestre en las opciones de Show Page de la pestaña Q uick action.

Crear una Ventana que no sea Rectangular S i una ventana rectangular normal es inapropiada para tu proyecto, es posible crear una ventana de forma personalizada. Para lograr esto en AutoP lay M edia Studio primero crea una máscara de transparencia con un editor de imágenes externo (por ejemplo con CorelDraw o Illustrator).

1 . Para crear una máscara de transparencia, crea una imagen que tenga las mismas dimensiones de tu proyecto.

2. Ahora dibuja la forma de la ventana que quieras. Lo que desees que esté visible hazlo blanco, lo que desees que esté oculto hazlo negro:

3. Guarda tu imagen como archivo png.

21

4. U na vez que la máscara ha sido creada, abre un proyecto en blanco en AutoP lay,

luego abre el M enú Project > Settings. Click en la pestaña Appearance, habilita la casilla Custom Mask, luego haz click en Browse y selecciona tu imagen. Ahora en tiempo de ejecución, tu proyecto tomará la forma de tu máscara.

Consejo: S i la imagen de tu máscara de transparencia no tiene las mismas dimensiones que la ventana de tu aplicación, puedes habilitar la opción “Fit to window” en el cuadro de diálogo Project Settings para ajustar el ancho y el alto de la imagen de tu máscara a las dimensiones de tu ventana.

Desplegar Texto y/o Imágenes con Eventos MouseOver (Ratón Encima) La mayoría de los objetos en AutoP lay M edia Studio tienen dos eventos útiles para efectos mouseover: On Enter y On Leave.

A manera de ejemplo, crearemos un botón que con mouseover (ratón encima) desplegará una imagen, y con mouseout (ratón fuera) ocultará la imagen:

1 . Crea un objecto de imagen. 2. Fija su estado visible por defecto como false. Para hacer esto haz doble click

sobre la imagen para abrir sus propiedades, luego selecciona la pestaña Attributes y desactiva la opción “V isible”.

3. Ahora crea un objeto de botón. 4. En el evento On Enter del botón, introduce el siguiente script:

Image.SetV isible("Image1", true);

5. En el evento On Leave del botón, introduce el siguiente script:

Image.SetV isible("Image1", false);

Nota: Cuando el ratón del usuario esté sobre el botón, el objeto de imagen aparecerá. Cuando el ratón del usuario abandone el botón, el objeto de imagen desaparecerá.

Consejo: Para hacer que aparezca texto en un mouseover, sigue los pasos anteriores, pero con un Objeto de Párrafo en lugar de un Objeto de Imagen. Además debes sustituir Image.SetV isible por Paragraph.SetV isible.

Desplegar un Diálogo Guardar Como (Save As) U n cuadro de diálogo Guardar Como es con frecuencia presentado para permitir al usuario que seleccione una ubicación para guardar un archivo.

Para desplegar un cuadro de Diálogo Guardar Como usando AutoP lay M edia Studio:

22

1 . Crea una acción Dialog.FileBrowse. Establece la propiedad FileOpen como

false:

file=Dialog.FileBrowse(false, "Save As", "c:\\", "All Files (*.*)|*.*|", "", "", false, true);

Nota: El archivo es una tabla. En el ejemplo de arriba, la selección de archivos múltiples no está permitida. Para acceder a la ruta devuelta por la acción FileBrowse, utiliza file[1 ] como una variable. Esto obtiene el valor desde la primera posición de la tabla.

2. S i estás usando el diálogo Guardar Como para copiar un archivo desde tu CD a el sistema del usuario, debes usar un comando File.Copy después de que el diálogo Guardar Como ha sido desplegado

File.Copy("c:\\example.exe", file[1 ], false, false, false, false, nil);

Detectar Cuál Sistema Operativo está siendo Utilizado AutoPlay M edia Studio incluye una acción para detectar qué Sistema Operativo está corriendo:

1 . Agrega el siguiente script a cualquier evento en tu aplicación para almacenar la versión del Sistema Operativo del usuario en una variable OS_Name:

OS_Name = "OS Name: " .. System.GetOSName();

Nota: AutoP lay tiene otra función integrada: System.GetOsV ersionInfo(), la cual regresa información de la versión del Sistema Operativo del usuario en una tabla.

Detectar qué versión de Internet Explorer está Instalada Para detectar la versión de Internet Explorer que está instalada en el sistema del usuario:

1 . H abilita la dependencia Internet Explorer

Nota: Si quieres detectar la versión de Internet Explorer, pero no requieres que el usuario la tenga instalada, fija la versión requerida en 0.0.0.0

2. Inserta el siguiente Script en el evento On Show de la primer página:

if _InternetExplorerV er == "0.0.0.0" then Dialog.M essage("Internet Explorer", "Internet Explorer is not installed"); else

23

Dialog.M essage("Internet Explorer", "la versión Internet Explorer" .. _InternetExplorerV er .. " está instalada en este sistema"); end

Nota: El script anterior desplegará un cuadro de diálogo en tiempo de ejecución mostrando la versión del Internet Explorer que la computadora del usuario tenga instalada.

Detectar el Final de una Película Flash En AutoP lay M edia Studio es posible detectar el momento en que una película Flash finalizó usando un FSCommand. Esto es útil si, por ejemplo, quieres navegar a otra página una vez que tu película Flash ha terminado.

Para lograr esto:

1 . En Macromedia Flash: Crea una película Flash la cual contenga un FSCommand en el fotograma final de la línea de tiempo:

fscommand("quit", "");

2. Inserta el siguiente código dentro del evento On FSCommand de tu objeto Flash

if e_FSCommand == "quit" then -- Cualquier script que pongas aquí, se ejecutará cuando tu película Flash termine. end

Detectar si el Acceso a Internet está Disponible S i tu aplicación va a utilizar Internet en algún sentido, puedes verificar y asegurarte que el usuario tiene acceso a Internet antes de continuar, y si no es así, advertir al usuario para que se conecte.


1 . Introduce el siguiente script dentro de un evento en tu aplicación:

connected = H T T P.T estConnection("http://www.indigorose.com", 20, 80, nil, nil); if connected then --Insert your internet related action here else Dialog.M essage("Error de Internet", "No estás conectado a Internet. Esta aplicación se cerrará");

24

Application.Exit(); end

Este script verifica si el usuario está conectado a Internet. Si después de 20 segundos el programa no puede encontrar una conexión de Internet válida, lo notifica al usuario y sale de la aplicación.

Determinar cuando la Reproducción de un Video ha Finalizado En AutoP lay M edia Studio, es posible ejecutar una acción una vez que tu video ha completado su reproducción. Algunos usos para esto incluyen redirigir al usuario a tu sitio W eb después de que el video terminó, o redirigirlo a otro video.

Para lanzar tu sitio W eb cuando un video ha finalizado, coloca el siguiente Script en el evento On Finish del V ideo Object:

File.OpenU R L("http://www.indigorose.com/", SW _SHOW NOR MAL);

Determinar el Lenguaje del Sistema Operativo En AutoP lay M edia Studio, para determinar el lenguaje del Sistema Operativo del usuario y almacenarlo en una variable user_language:

user_language = System.GetDefaultLangID;

Nota: user_language es una tabla, y puede hacerse referencia a ella con user_language.Primary y user_language.Secondary

Determinar la Cantidad de Espacio Libre en una Unidad Cuando se instala software en el Sistema del usuario, es útil asegurarse que se tiene suficiente espacio libre en su disco duro para alojar dicho software.


1 . Inserta el siguiente código dentro de cualquier evento de tu aplicación:

25

--espacio requerido, en megabytes space_required = 253 --obtener el espacio libre del sistema del usuario (en este caso de la unidad C) space_available = Drive.GetFreeSpace("C:"); --comparar el espacio libre disponible con el espacio libre requerido if space_required > space_available then Dialog.M essage("","Necesitas "..(space_required - space_available).." MB más"); else Dialog.M essage("","T ienes "..(space_available - space_required).." MB más que los necesarios"); end

Nota: La variable space_required debes fijarla tú. 253 es un número arbitrario.

Determinar la Letra de la Unidad del Disco Duro Primario Para determinar cuál es el disco duro principal del usuario en AutoP lay M edia Studio, utiliza la acción Drive.Enumerate, y toma nota de la primera unidad fija (es decir, el disco duro principal).

Introduce el siguiente código dentro de cualquier evento en tu aplicación:

-- Obtener una lista de todas las unidades en el sistema del usuario drives = Drive.Enumerate(); -- Ir directo a la lista for j in drives do -- Obtener el tipo de unidad type = Drive.GetT ype(drives[j]); -- V erificar si el tipo de unidad es fija if type == 3 then -- Es fija, registra la letra de la unidad y abandona el script first_hdd = drives[j]; break; end end -- R esultado de salida para el usuario Dialog.M essage("", "El disco duro principal del usuario es "..first_hdd);

26

Determinar si una Red (LAN) está Presente En AutoP lay M edia Studio, para determinar si un usuario está conectado a una LAN:

1 . Inserta el siguiente código dentro de cualquier evento en tu aplicación:

lan = System.GetLANInfo(); lan_exist = true; for j in lan do if lan[j] == "U nknown" then lan_exist = false; end end if lan_exist then Dialog.M essage("", "Estás conectado a una LAN"); else Dialog.M essage("", "No estás conectado a una LAN"); end

Nota: Este ejemplo trabaja en W indows 98 Primera Edición, W indows 98 Segunda Edición, W indows 2000 y W indows XP. W indows 95 y W indows NT no se adaptan a este modelo. Para detectar una conexión LAN en todos los sistemas operativos, primero detecta el sistema operativo del usuario e introduce un Script de detección adecuado.

Dimensionar mi Aplicación a Medidas de Pantalla Particulares La forma más fácil de asegurar que tu proyecto se reproduzca en cualquier computadora es diseñarlo al más bajo común denominador. Cada sistema de computadora capaz de correr un archivo generado en AutoP lay puede soportar una resolución de 640x480.

Nuestro tamaño de proyecto por defecto es compatible con una resolución de 640x480.

Si deseas tener un proyecto que abarque la pantalla completa del usuario, no importando su resolución, la forma más fácil es diseñar un proyecto separado para cada resolución. T ambién crear un proyecto “maestro” que determine la resolución del usuario (System.GetDisplayInfo), y tenerlo para lanzar la aplicación al tamaño apropiado.

Si estas dos opciones son inaceptables, AutoP lay incluye acciones para redimensionar y reposicionar objetos de tu página. Del mismo modo, como en la versión 7, los objetos y la ventana de tu aplicación pueden ser redimensionables, y cada vez que la ventana es redimensionada el evento del proyecto On Size es detonado.

27

Duplicar Objetos Para duplicar un Objeto en AutoP lay M edia Studio:

1 . Selecciona el objeto deseado (haciendo click izquierdo sobre él una vez). 2. V e al menú Edit > Duplicate. (T ambién puedes presionar Ctrl+D si prefieres

usar el teclado.)

Nota: Esto duplica el objeto, incluyendo todas las propiedades configuradas y todos los scripts de los eventos. T odas las referencias del objeto duplicado son absolutas, no relativas

Para duplicar un objeto usando referencias relativas, usa “this” en lugar del nombre del objeto en todos los scripts. Como ejemplo, crearemos un objeto de botón que con ratón encima cambia su texto a “ratón”, y con el ratón fuera cambia su texto a “gato”:

1 . Inserta el siguiente código dentro del evento On Enter de tu botón:

Button.SetT ext(this, "R atón");

2. Inserta el siguiente código dentro del evento On Leave de tu botón:

Button.SetT ext(this, "Gato");

Nota: Cuando este objeto es duplicado, el texto del nuevo objeto cambiará, y dejará el texto original intacto.

Ejecutar Adobe Acrobat Reader Directamente desde el CD-ROM Esto es mucho más fácil que simplemente requerir a los usuarios que instales el Adobe Acrobat R eader ellos mismos desde el sitio web de Adobe. Puedes entonces simplemente utilizar una acción File.Open para ver el archivo PDF. Si requieres otra opción, por favor lee la siguiente información, pero debes estar al tanto que Indigo R ose no puede proporcionarte más asistencia o guía legal sobre los detalles de implementación.

1 . Instala Acrobat R eader (4.0 o superior) en una PC sin Acrobat. 2. Arrastra la carpeta \Acrobat x.x\ y todo su contenido dentro de tu carpeta de

distribución. (CD_R OOT) *Este directorio es normalmente encontrado en c:\program files\adobe\ directory.

Nota: La carpeta “Acrobat x.x” no es 1 00% compatible con algunos de los estándares nombrados ISO, y por ello puedes tener la necesidad de renombrar algunos de tus archivos o carpetas.

28

3. Crea la carpeta "instalador" en la carpeta "Acrobat x.x", y copia el instalador

Adobe Acrobat ahí. Las cláusulas de licencia para el R eader requieren que incluyas: - El instalador Acrobat R eader, exactamente como es proporcionado por Adobe. - El Acuerdo de Licencia Electrónico de U suario Final del Acrobat R eader. (Este es un archivo .TXT que R eader instala en \Acrobat x.x\R eader\) - Derechos de Autor y otras noticias del propietario incluidas en Acrobat R eader. (Asumiendo que copias todos los archivos en la carpeta \Acrobat x.x\R eader\ tendrás todo lo necesario, excepto el instalador Acrobat R eader).

4. U tiliza la siguiente acción para abrir tu documento PDF usando el lector en tu CD:

path_short = File.GetShortName(_SourceFolder); File.R un("Acrobat 5.0\\R eader\\AcroR d32.exe", path_short .. "\\AutoP lay\\Docs\\luabook1 .pdf", "", SW _SHOW NOR MAL, false);

Nota: El acrobat reader no es instalado en el sistema del usuario, sino que es ejecutado desde tu CD.

Ejecutar en Modo Full Screen (Kiosk) AutoPlay M edia Studio tiene una opción para correr tu aplicación en modo full screen (pantalla completa). Este modo no cambia de tamaño tu proyecto a full screen, sino que más bien llena el espacio circundante con un color de fondo de tu elección.

Para habilitar esta opción:

1 . Elige el menú Project > Settings. 2. En la pestaña “Appearance” selecciona la opción de Estilo Kiosk. 3. Selecciona tu color de fondo deseado. 4. H az click en OK.

Ejecutar mi Aplicación Sólo Una Vez Para correr tu aplicación sólo una vez (por ejemplo, la primera vez que el usuario inserta tu CD-R OM, y no otra vez) coloca el siguiente código en el evento On Startup de tu proyecto:

--recupera o regresa el valor del registro. Si la clave no existe, result = "" result = Application.LoadV alue("Application_Name", "First_T ime"); --si no hubo una clave, el programa nunca ha sido corrido if result == "" then Application.SaveV alue("Application_Name", "First_T ime", "yes");

29

Dialog.M essage("Mensaje", "Esta es la primera vez que este programa se ha corrido"); else Application.Exit(); end

Consejo: T ambién puedes utilizar W indow.Close(Application.GetW ndH andle(), CLOSEW ND_TER MINATE) en lugar de Application.Exit(). Esto cerrará la ventana antes de que la ventana misma aparezca (es decir, el usuario no verá nada).

Ejecutar un Archivo Ejecutable AutoPlay M edia Studio incluye una Q uick Action (Acción Rápida) para lanzar un archivo ejecutable. Esto es útil, por ejemplo, cuando creas una sección de entrada para tu instalador. Cuando el usuario hace click sobre un objeto etiquetado como “Instalar”, tu aplicación lanza tu programa de instalación. Esto se logra en AutoP lay M edia Studio usando la Acción Rápida “R un Program”.

Puedes especificar sólo un archivo a ejecutarse así como los argumentos de la línea de comandos y la carpeta de trabajo.

Ejecutar un Programa y Esperar a que éste Finalice Al utilizar AutoP lay M edia Studio, puedes lanzar un archivo ejecutable, y tener tu aplicación esperando hasta que el archivo ejecutable termine.

Como ejemplo, correremos el ejecutable ejemplo.exe, y tendremos la aplicación esperando hasta que ejemplo.exe finalice. Esto se logra utilizando la acción File.R un, y ajustando la propiedad W aitForR eturn a true:

File.R un("c:\\ejemplo.exe", "", "", SW _SHOW NOR MAL, true);

Nota: Esta acción lanza ejemplo.exe y espera hasta que ejemplo.exe ha terminado.

Ejecutar una Aplicación después de un Reinicio del Sistema A manera de ejemplo, crearemos una aplicación con dos botones: Instalar Acrobat, e Instalar Aplicacion1 01 . El programa de instalación de Acrobat requerirá que el usuario reinicie su computadora una vez que la instalación se complete. Para asegurar que la aplicación sea lanzada cuando el usuario reinicia su sistema, añade el siguiente código en el evento On Click del botón “Instalar Acrobat”:

30

reboot = Application.LoadV alue("Settings", "R eboot"); if reboot == "" then Shell.CreateShortcut(Shell.GetFolder(SHF_STAR T U P_COMMON), "T emporary Shortcut", "Autorun.exe", "", "", "Autorun.exe", 0, SW _SHOW NOR MAL); Application.SaveV alue("Settings", "R eboot", "done"); else Shell.DeleteShortcut(Shell.GetFolder(SHF_STAR T U P_COMMON), "T emporary Shortcut"); Application.SaveV alue("Settings", "R eboot", ""); end

Nota: Este script agrega un atajo temporal a la carpeta de arranque de W indows. Cuando tu aplicación es ejecutada después de un reinicio, el atajo temporal es eliminado.

Eliminar Archivos Sin Uso de Mi Proyecto Durante el desarrollo de una aplicación, inevitablemente son incluidos en tu distribución archivos que al final están sin uso, y por ello están ocupando un precioso espacio.

Para que lo entiendas mejor, durante la creación de tu proyecto creas objetos tales como botones, párrafos, etiquetas, etc., pero es muy probable que no te agrade cómo va quedando el proyecto y borras algunos objetos. Sin embargo, aunque los has eliminado y ya no están visibles en tu página, éstos permanecen en la memoria del proyecto y siguen ocupando espacio en disco duro (consumiendo ese espacio).

En AutoP lay M edia Studio, estos archivos pueden ser removidos automáticamente:

1 . Elige el menú T ools > Optimize R esources. 2. Selecciona las carpetas del proyecto que quieras limpiar. 3. H az click en OK.

Esto busca a fondo todos los archivos en tu proyecto que están sin uso y te muestra la opción de eliminarlos.

Consejo: H abilita la opción Confirm deletion para asegurarte que nada se borre sin tu conocimiento.

Escribir Texto a un Archivo Cuando se escribe información a un archivo de texto, hay dos opciones: el texto puede ser añadido al final del archivo de texto, o la información actual en el archivo de texto puede ser sobre-escrita. En AutoP lay M edia Studio esto se logra cambiando el valor Append a false en cualquier acción que escriba al archivo.

31

A manera de ejemplo, escribiremos "la de da de da" a un archivo de texto, sobrescribiendo su contenido. Esto es logrado con la siguiente acción:

T extFile.W riteFromString("c:\text.txt", "la de da de da", false);

Hacer que la Información Persista a lo Largo de las Sesiones Con frecuencia es agradable añadir un toque personal a tu Proyecto, tal como saludar al usuario por su nombre cuando tu aplicación se inicia.

Como ejemplo, crearemos una aplicación que sugiera o invite al usuario a poner su nombre la primera vez que es ejecutada, y almacene estos datos en el registro. Cada subsecuente vez que la aplicación sea corrida, le dará la bienvenida al usuario con el nombre que él había introducido:

1 . Coloca el siguiente código en el evento On Startup o en el evento On Preload de tu proyecto:

-- Carga el último nombre utilizado por el usuario user = Application.LoadV alue("Information", "Name"); -- había un nombre de usuario ya almacenado? if user == "" then -- No! Advierte al usuario que ponga su nombre. user = "U suario Desconocido"; user = Dialog.Input("Información R equerida", "Por favor introduce tu nombre completo:", "", MB_ICONQ U EST ION); Application.SaveV alue("Information", "Name", user); end -- Devuelve un mensaje de bienvenida Dialog.M essage("Bienvenido", "H ola "..user..", bienvenido a mi aplicación");

Nota: Este ejemplo incita al usuario a introducir su nombre completo la primera vez que ejecute tu aplicación, y almacena ese valor en el registro. Cada subsecuente vez que el usuario ejecute tu aplicación un mensaje aparecerá de pronto en la pantalla saludándolo por su nombre.

Hacer un Explorador de Documentos A manera de ejemplo, crearemos una aplicación en la cual el usuario tenga que seleccionar una carpeta de su unidad, y luego llenar un objeto ListBox con todos los archivos *.doc dentro de ese directorio. El usuario hace click en un archivo del objeto ListBox, y clickea el botón “Open” para abrir el documento.

32

1 . Crea un proyecto con un objeto ListBox, y dos objetos de botón. 2. Etiqueta el botón 1 como "Cargar" y el botón 2 como "Abrir". 3. Inserta el siguiente código dentro del evento On Click del botón 1 :

--Deshabilitar la actualización de la ListBox ListBox.SetU pdate("ListBox1", false); --Obtener la carpeta a explorar deseada folder = Dialog.FolderBrowse("Open Folder", "C:\\"); --llenar una tabla con todos los archivos .doc file = File.Find(folder, "*.doc", false, false, nil); --hacer lo siguiente para cada archivo: for j,file_path in file do --añadir el item a la ListBox, con el nombre visible y la ruta como datos ListBox.AddItem("ListBox1", String.SplitPath(file_path).Filename, file_path); end --permitir que la ListBox muestre el contenido actualizado ListBox.SetU pdate("ListBox1", true);

4. Inserta el siguiente código dentro del evento On Click del botón 2:

selected = ListBox.GetSelected("ListBox1"); for j,k in selected do File.Open(ListBox.GetItemData("ListBox1", k),"", SW _SHOW NOR MAL); end

Hacer un Explorador de Imágenes A manera de ejemplo, crearemos una aplicación en la que el usuario tenga que seleccionar una carpeta de su unidad, y luego llene un objeto ListBox con todos los archivos *.png y *.jpg dentro de ese directorio. El usuario hace click sobre un archivo en el objeto ListBox y enseguida hace click en el botón “Abrir” para cargar la imagen seleccionada dentro del objeto de Imagen.

1 . Crea un proyecto con dos objetos de Botón, un objeto ListBox y un objeto de Imagen.

2. Etiqueta el Button1 como "Cargar" y el Button2 como "Abrir". 3. Inserta el siguiente código dentro del evento On Click del Button1 :

--deshabilitar actualización de ListBox ListBox.SetU pdate("ListBox1", false); --obtener la carpeta a explorar deseada folder = Dialog.FolderBrowse("Open Folder", "C:\\");

33

--llenar las tablas con todos los archivos .jpg y .png file_jpg = File.Find(folder, "*.jpg", false, false, nil); file_png = File.Find(folder, "*.png", false, false, nil); images = {file_jpg, file_png}; --hacer lo siguiente para cada archivo: for k in images do -- da vueltas a través de los distintos tipos de imagen for j,file_path in images[k] do -- da vueltas a través de cada archivo de imagen --añade el item a la listbox, con el nombre visible y la ruta como datos ListBox.AddItem("ListBox1", String.SplitPath(file_path).Filename, file_path); end end --Permitir que la listbox muestre el contenido actualizado ListBox.SetU pdate("ListBox1", true);

4. Inserta el siguiente código dentro del evento On Click del Button2:

selected = ListBox.GetSelected("ListBox1"); for j,k in selected do Image.Load("Image1", ListBox.GetItemData("ListBox1", k)); end

Hacer un Explorador de Imágenes Miniatura La idea detrás de una imagen miniatura es presentarle al usuario una pequeña imagen que cuando sea clickeada lo enlace a una imagen más grande. Para lograr esto en AutoP lay M edia Studio, crea un objeto de imagen con la imagen que desees usar para la miniatura, y cámbiala de tamaño a la dimensión deseada. Ahora crea una acción que la vincule a la imagen más grande cuando la miniatura sea clickeada.

Ejemplo 1 1 . Crea un proyecto con dos páginas. En la primera página (Page1 ) estará tu

miniatura, en tu segunda página (Page2) estará tu imagen más grande. 2. En cada página de tu proyecto, crea un objeto de imagen el cual cargue la

imagen deseada. 3. Crea una acción en el evento On Click de tu imagen miniatura que haga saltar a

la segunda página de tu proyecto (la que contiene la imagen más grande):

Page.Jump("Page2");

3. En tu segunda página, podrías incluir un botón de retorno que haga saltar atrás hacia la primer página. U sa la siguiente acción para el evento On Click de este botón:

34

Page.Jump("Page1");

Nota: Si deseas tener más de una miniatura, crea una nueva página por cada imagen, y luego agrega sus miniaturas a la primer página. Enseguida agrega acciones para abrir cada página cuando determinada miniatura sea clickeada.

Ejemplo 2 1 . Crea un proyecto de una página. 2. Crea dos objetos de imagen en esta página: Image1 e Image2. La Image1 será la

imagen miniatura, la Image2 será tu imagen grande. Dales el tamaño adecuado a las dos imágenes.

3. Fija la propiedad visible de Image2 a false. 4. Crea una acción On Click para la Image1 que muestre la Image2 cuando sea

clickeada:

Image.SetV isible("Image2", true);

5. Crea una acción para la Image2 que la oculte cuando ésta sea clickeada (usa el evento On Click):

Image.SetV isible("Image2", false);

Nota: Si deseas puedes incluir más imágenes, por cada imagen haz una miniatura y una grande. Para ver detalles y scripts de este ejemplo revisa el archivo de proyecto “H acer un Explorador de Imágenes M iniatura 2” que está en la carpeta “Ejemplos”.

Hacer un Menú Desplegable Para crear un menú desplegable en AutoP lay M edia Studio:

1 . Crea un proyecto con seis objetos label, y organízalos como sigue:

35

2. Inserta el siguiente código dentro del evento On Click de la Label1 :

if visible then Label.SetV isible("Label2", false); Label.SetV isible("Label3", false); Label.SetV isible("Label4", false); Label.SetV isible("Label5", false); Label.SetV isible("Label6", false); visible = false; else Label.SetV isible("Label2", true); Label.SetV isible("Label3", true); Label.SetV isible("Label4", true); Label.SetV isible("Label5", true); Label.SetV isible("Label6", true); visible = true; end

3. Inserta el siguiente código dentro de tus Funciones Globales:

visible = false;

Hacer un Proyector de Diapositivas Consejo: AutoP lay M edia Studio 7 ahora contiene un Objeto SlideShow que también puede ser utilizado para esta funcionalidad.

El propósito de un proyector de diapositivas es mostrar imágenes a una velocidad predeterminada. En AutoP lay M edia Studio, esto se logra creando un proyecto con una página por cada imagen que desees mostrar.

1 . Para cada página en tu proyecto, crea un objeto de imagen conteniendo la imagen apropiada.

2. Crea la siguiente acción en el evento On Show de cada página en tu proyecto:

Page.S tartT imer(5000); --iniciar el cronómetro una vez cada 5 segundos.

3. Crea la siguiente acción en el evento On T imer de cada página de tu proyecto:

Page.Navigate(PAGE_NEXT);

La única página que no tiene esta acción es la última, porque no hay más páginas a donde saltar.

4. Crea la siguiente acción en el evento On Show de tu última página:

36

Page.StopT imer(); --detener el cronómetro

Nota: Los eventos On T imer y On Show se pueden localizar haciendo click derecho en un espacio en blanco de la página y luego eligiendo Actions.

Hacer un Proyector de Diapositivas con Audio Consejo: AutoP lay M edia Studio 7 ahora contiene un Objeto SlideShow que también puede ser utilizado para esta funcionalidad.

A manera de ejemplo, crearemos un proyector de diapositivas con voz superpuesta para cada imagen. Este proyecto requerirá un archivo de audio por cada imagen, y una página en tu proyecto por cada imagen que quieras mostrar. En cada página, crea un objeto de imagen el cual cargue la imagen deseada.

1 . Crea una página en tu proyecto por cada archivo de imagen que desees mostrar. En este ejemplo, tendremos tres imágenes, y tres archivos de audio.

2. En cada página de tu proyecto, crea un objeto de imagen el cual cargue la imagen deseada.

3. Crea variables globales:

-- seguirá la pista de los archivos de audio audio_count = 1 ; --carga los archivos de audio deseados dentro de una tabla audio = { "Autoplay\\Audio\\audio_file1 .ogg", "Autoplay\\Audio\\audio_file2.ogg", "Autoplay\\Audio\\audio_file3.ogg" };

4. Crea la siguiente acción en el evento On Show de cada página:

Audio.Load(CHANNEL_U SER 1 , audio[audio_count], true, false);

5. Crea el siguiente script en el evento On Audio de cada página (excepto en tu última página):

Input.SetT ext("Input1 ", e_S tate); if e_S tate == "Finish" then audio_count = audio_count + 1 ; Page.Navigate(PAGE_NEXT); end

Nota: Cuando sea corrida, esta aplicación cargará la primer página y reproducirá el archivo de audio. Cuando ese archivo de audio se complete, la aplicación brincará a la próxima página, y lanzará el archivo de audio. Esto continúa hasta la última página. Cada imagen es mostrada mientras dure el archivo de audio.

37

Consejo: S i quieres tener música de fondo escuchándose en tu aplicación, inserta el siguiente código dentro del evento On Show de la primer página (así cargarás la música de fondo dentro de un canal diferente del que utiliza la música superpuesta):

Audio.Load(CHANNEL_BACKGR OU ND, "AutoPlay\\Audio\\background.ogg, true, true); Audio.SetV olume(CHANNEL_BACKGR OU ND, (255 * 0.25)); --sets the volume to 25%

Hacer una Aplicación Básica Cuestionario/Test A manera de ejemplo, crearemos un test de dos páginas, y una tercera página para mostrar los resultados:

1 . Crea un proyecto con tres páginas. 2. Inserta el siguiente código en Global Functions:

--Cada una de las siguientes tablas contiene una pregunta y 4 respuestas: Q _01 = {Q uestion="¿Cuántas patas tiene un perro de tres patas?", A1 ="U na", A2="Dos", A3="Cuatro", ACorrect="T res"}; Q _02 = {Q uestion="¿Cuántas patas tiene un gato de una pata?", A1 ="T res", A2="Dos", A3="Cuatro", ACorrect="U na"}; Correct={Q 1 ="",Q 2=""};

3. En la Página 1 , crea un objeto de párrafo, y cuatro objetos de botón.

4. En el evento On Preload de la Página 1 , inserta el código siguiente:

Paragraph.SetT ext("Paragraph2", Q _01 .Q uestion); Button.SetT ext("Button1 ", Q _01 .A2); Button.SetT ext("Button2", Q _01 .A1 ); Button.SetT ext("Button3", Q _01 .ACorrect); Button.SetT ext("Button4", Q _01 .A3);

5. Inserta el siguiente código dentro del evento On Click del Botón 1 :

Correct.Q 1 = "Incorrecta"; Page.Navigate(PAGE_NEXT);

6. Inserta el siguiente código dentro del evento On Click del Botón 2:



Correct.Q 1 = "Correcta"; Page.Navigate(PAGE_NEXT);

38



9. En la Página 2, crea un objeto de párrafo, y 4 objetos de botón.

1 0. En el evento On Preload de la Página 2, inserta el código siguiente:

Paragraph.SetT ext("Paragraph2", Q _02.Q uestion); Button.SetT ext("Button1 ", Q _02.A3); Button.SetT ext("Button2", Q _02.A2); Button.SetT ext("Button3", Q _02.A1 ); Button.SetT ext("Button4", Q _02.ACorrect);

1 1 . Inserta el siguiente código dentro del evento On Click del Botón 1 :


1 2. Inserta el siguiente código dentro del evento On Click del Botón 2:





Correct.Q 2 = "Correcta"; Page.Navigate(PAGE_NEXT);

1 5. Crea un objeto de párrafo en la última página de tu proyecto. 1 6. Inserta el siguiente código dentro del evento On Preload de la última página:

string_correct=""; correct = 0; possible = 0; for j,k in Correct do possible = possible + 1 ; if k == "Correcta" then correct = correct + 1 ; end end Paragraph.SetT ext("Paragraph2", "Pregunta 1 : " .. Correct.Q 1 .. "\r\n" ..

39

"Pregunta 2: " .. Correct.Q 2 .. "\r\n" .. "R espondiste correctamente " .. correct .. " de " .. possible .. " posibles preguntas para una calificación de " .. ((correct/possible)*1 00) .. "% ." );

Hacer una Imagen Semi-Transparente En AutoP lay M edia Studio es posible hacer que un objeto de Imagen sea translúcido o "transparente". Esto se logra bajando el valor configurado de la Opacidad (Opacity) en el panel Propiedades

1 . Crea un objeto de Imagen. 2. En el panel Propiedades, cambia la configuración de opacidad a la opacidad

deseada.

Nota: El número de opacidad es un porcentaje. U n valor de 1 00 hace al objeto totalmente visible, mientras que un valor de 0 lo hace invisible.

Heredar las Propiedades de Página A manera de ejemplo, asumamos que estás creando un proyecto de tres páginas, y quieres usar el mismo fondo para cada una de tus tres páginas. La mejor manera de hacer esto es establecer que en la página 2 y la página 3 se herede el fondo de la página 1 . De modo que si cambias el fondo de la página 1 , los fondos de las páginas 2 y 3 como consecuencia cambiarán.


1 . Crea un proyecto con tres páginas. 2. Añade un fondo a la Página 1 (un color sólido, un gradiente o una imagen).

Note: La Página 1 puede tener un color sólido, un gradiente o una imagen como fondo.

3. V e a la Página 2.

40

4. En el panel Propiedades, cambia la propiedad Inherit Background de Page2 a

Page1 .

5. Ahora ve a la Página 3. 6. En el panel Propiedades, cambia la propiedad Inherit Background de Page3 a

Page1 .

Nota: T ambién puedes heredar objetos desde una página en tu proyecto. Para heredar todos los objetos de la Página 1 , fija la categoría Inherit Objects del Panel Propiedades (en tu página deseada) a la Page1 .

41

Imprimir un Archivo Para imprimir un archivo desde tu aplicación, utiliza la acción rápida “Print Document”. H az click en el botón “Browse” del campo “Document to print” para seleccionar el archivo a imprimir.

Nota: Esta acción abre el documento que deseas imprimir en el editor por defecto, imprime el documento y cierra el editor por defecto. Esta conducta es similar a hacer click derecho sobre un archivo en el Explorador de W indows y seleccionar “Imprimir”.

Incrustar una Ventana de Navegador Web AutoPlay M edia Studio incluye un objeto web para desplegar un sitio web dentro de tu aplicación. Para añadir un sitio web a tu proyecto:

1 . Elije Object > W eb. 2. En el diálogo New W eb Object, introduce la dirección web deseada en la

configuración U R L y haz click en OK.

Inmovilizar Objetos U na vez que has creado la apariencia de tu proyecto, es probable que quieras “trabar” los objetos a la página, pero aún ser capaz de cambiar sus propiedades y editar sus acciones. Esto es conocido como “apuntalar” un objeto a la página.

Para apuntalar un objeto:

1 . Selecciona el objeto deseado.

42

2. H az click derecho sobre el objeto. 3. Elige Pin.

Esto hará que el objeto quede inmóvil y no puedas desplazarlo a ninguna parte de la página. Aunque el objeto esté apuntalado, aún puedes editar sus propiedades haciendo doble click sobre él.

T en bien claro que no es lo mismo Apuntalar (Pin) que Bloquear (Lock).

Para desapuntalar un objeto:

1 . Selecciona el objeto deseado. 2. H az click derecho sobre el objeto. 3. Deshabilita Pin.

Interactuar con Objetos Flash Incrustados AutoPlay M edia Studio es capaz de “colectar” FS_Commands de una película Flash incrustada. R ecibirás el FS_Command, y luego completarás una acción basada en este comando, utilizando una declaración if.

Por favor dirígete a la sección Interactuar con objetos web incrustados para ver un simple ejemplo de navegación de tu proyecto basado en una entrada desde una fuente externa.

Interactuar con Objetos Web Incrustados In AutoP lay M edia Studio, es posible navegar de tu proyecto usando un archivo H TML incrustado.

Por ejemplo, asumamos que quieres tener el siguiente archivo H TML en un objeto web (nombremos al archivo index.html):

<html> <body> <a href="#Page2">Go to Page 2</a> </body> </html>

1 . Crea un objeto web en la página de la aplicación que cargue index.html. Nómbralo "W eb1".

2. Inserta el siguiente script en el evento On Preload de la página:

W eb.LoadU R L("W eb1", "AutoP lay\\Docs\\index.html");

43

Las líneas anteriores redireccionan el objeto web llamado W eb1 hacia AutoP lay\Docs\index.html. Esto es necesario debido a que la U R L en un objeto web insistirá a través de las páginas, y el evento On Navigate es llamado cuando el objeto web se hace presente en la página después de que una página se carga; si no redirigimos la U R L en este objeto web cada vez que la página se cargue, ésta aún tendrá la U R L #Page2 en él, y nuestro script en el evento On Navigate (ver abajo) hará que la aplicación brinque justo de regreso a la Página 2

3. Inserta el siguiente script en el evento On Navigate del objeto web:

-- buscar de derecha a izquierda un símbolo de número (#) nPos = String.R everseFind(e_U R L, "#", true); -- ¿se encontró algún #? if nPos then -- obtener todo a la derecha del # strPage = String.M id(e_U R L, nPos + 1 , -1 ); --[[ saltar al nombre de la página que extrajimos de la U R L. Si no hay página con ese nombre, el Page.Jump no hará nada. ]] Page.Jump(strPage); end

Al clickear sobre un enlace en este objeto web, accionaremos el evento On Navigate y pondremos la cadena href (el enlace buscado) dentro de la variable del evento nombrada e_U R L. La acción String.R everseFind busca el símbolo # y, si lo encuentra, una acción String.M id captura todo a la derecha del símbolo # en la cadena. La cadena resultante es almacenada en una variable y luego es usada como el objetivo de una acción Page.Jump.

Nota: Cuando el usuario clickea sobre el enlace 'Go to Page 2' en nuestro archivo de ejemplo H TML, la aplicación saltará a “Page2”.

Leer Líneas Específicas de un Archivo de Texto Para recuperar líneas específicas de un archivo de texto en AutoP lay M edia Studio, usa la acción R eadT oT able.

Como ejemplo, leeremos el archivo C:\test.txt dentro de una tabla variable, luego devolveremos de la línea 4 a la 1 0 en un objeto de párrafo

1 . Inserta el siguiente código dentro de algún evento en tu aplicación:

-- Fija el inicio y el fin de los números de líneas de texto beginning_line = 4; end_line = 1 0;

44

-- llena una tabla con el contenido de un archivo de texto tabT ext = T extFile.R eadT oT able("c:\\test.txt"); -- Inicializa la variable strLinesOfT ext strLinesOfT ext = ""; -- Fija el número de línea actual line = beginning_line; -- Orbita a través de la tabla hasta que la condición “end” sea alcanzada while line < (end_line + 1 ) do -- Agrega los datos a la variable strLengthOfT ext strLinesOfT ext = strLinesOfT ext .. "\r\n" .. "Line " .. line .. ": " .. tabT ext[line] .. "\r\n"; line = line + 1 ; end -- Salida para el usuario Paragraph.SetT ext("Paragraph1", strLinesOfT ext);

Mandar un E-mail con Asunto, Cuerpo y Archivo Adjunto Para mandar un E-mail con varios campos llenos, utiliza la acción File.OpenEmail. Lo siguiente puede ser llenado en: T o, Cc, Bcc, Subject, Body.

1 . Para mandar un E-mail con las siguientes propiedades: T o: user@ yourdomain.com Cc: user2@ yourdomain.com Bcc: user3@ yourdomain.com Subject: T u asunto aquí Body: Lo que quieras como cuerpo del E-mail aquí U tiliza la siguiente acción:

File.OpenEmail("user@ yourdomain.com?CC=user2@ yourdomain.com&[email protected]&Subject=Y our subject here&Body= W hatever you want as your email body here", SW _SHOW NOR MAL);

Nota: Para mandar un E-mail con un archivo adjunto, tendrás que codificar el archivo (en formato U uencode) e incluirlo en el cuerpo del mensaje del E-mail. Esta es una implementación avanzada de la acción File.OpenEmail. Indigo R ose no puede ayudarte con detalles de implementación. Debes estar al tanto que no todos los clientes email reconocerán todas las opciones.

45

Mantener las Proporciones Dimensionales de los Objetos En el ambiente de diseño de AutoP lay, es posible mantener la proporción dimensional (proporción entre anchura y altura) de tus objetos al redimensionarlos. Esto es útil, por ejemplo, cuando deseas cambiar de tamaño un objeto de imagen pero no quieres que la imagen parezca distorsionada.

Para mantener la proporción dimensional de cualquier objeto en el ambiente de diseño de AutoP lay:

1 . Selecciona tu objeto deseado haciendo un solo click sobre él. 2. Ahora haz click derecho sobre el objeto que acabas de seleccionar. 3. H az click en Keep Aspect.

Nota: Si Keep Aspect tiene una marca de verificación junto a él, entonces la opción ya estaba habilitada.

Nota: Si bien una etiqueta de menú de click derecho del objeto tiene la opción Keep Aspect, está permanentemente establecida para mantener su proporción dimensional. No es posible apagar esta opción.

Para mantener temporalmente la proporción dimensional de un objeto, deja presionadas las teclas Ctrl y Shift mientras redimensionas el objeto. El mantener temporalmente la proporción dimensional de un objeto sólo aplica al redimensionamiento de un objeto con el ratón, el cambio de las dimensiones en el panel Propiedades con las teclas Ctrl y Shift presionadas no mantendrá la proporción dimensional.

Mantener mi Aplicación Siempre más Arriba Autoplay M edia Studio tiene una opción integrada para hacer que la ventana de tu aplicación siempre esté más arriba que todas en el sistema del usuario. Para lograr esto, elige la opción en el cuadro de diálogo Project Settings:

1 . Elige el menú Project > Settings. 2. H abilita la opción Always On T op. 3. H az click en OK.

Mostrar una Imagen en Splah Para desplegar una imagen en splash utilizando AutoP lay M edia Studio:

46

1 . Inserta el siguiente código dentro de cualquier evento en tu aplicación:

Dialog.SplashImage("AutoP lay\\Images\\splash.jpg", 5, false);

Nota: Obviamente, primero deberás cargar la imagen en la carpeta “Images” de AutoP lay.

Consejo: Para desplegar la imagen en splash antes de que tu aplicación se cargue, inserta el código de arriba dentro del evento On Startup de las Acciones del Proyecto (Menú Project Actions).

Obtener la Información del Usuario Registrado de la Computadora Para detectar el usuario registrado del sistema, en AutoP lay M edia Studio:

1 . Inserta el siguiente script en el evento On Startup de tu proyecto:

user = System.GetU serInfo();

Nota: El usuario es una variable de tabla. Para mostrar esta información en una página de tu aplicación, establece referencias para:

user.R egOwner – el propietario registrado de la computadora user.R egOrganization – la organización registrada

Obtener la Ruta de una Carpeta del Sistema AutoP lay M edia Studio incluye una acción para obtener las trayectorias de varias carpetas en tu computadora. Para lograr esto, utiliza la acción Shell.GetFolder.

A manera de ejemplo, obtendremos la trayectoria del escritorio del usuario, y la almacenaremos en la variable “path_to_desktop”.

1 . Inserta el siguiente código dentro de un evento en tu programa:

path_to_desktop = Shell.GetFolder(SHF_DESKTOP);

Ocultar la Barra de Título Para ocultar la Barra de T ítulo de la aplicación AutoP lay:

47

1 . V e al menú Project > Settings. 2. Cambia el estilo de la ventana a Flat. 3. H az click en OK.

Ocultar un Objeto H ay dos instancias en las que se pueden querer ocultar un objeto: Por el usuario en tiempo de ejecución, o por ti mismo en tiempo de diseño.

Ocultar un objeto en tiempo de ejecución es útil si no quieres que el usuario vea un objeto en el inicio de la aplicación. Es posible que desees mostrar el objeto más tarde basado en una acción del usuario

Como un ejemplo, ocultaremos un objeto de botón (Button1 ) en tiempo de ejecución:

1 . Inserta el siguiente código dentro del evento On Show de tu página:

Button.SetV isible("Button1 ", false);

Consejo: Para mostrar el objeto de botón, inserta el siguiente código dentro de un evento en tu aplicación

Button.SetV isible("Button1 ", true);

Ocultar un objeto en tiempo de diseño es útil cuando, por ejemplo, estás trabajando en un proyecto con muchos objetos, y deseas reducir el desorden.

Para ocultar un objeto en tiempo de diseño:

1 . Selecciona el objeto deseado. 2. En el Panel Propiedades, cambia el atributo V isible a false.

Consejo: Para mostrar un objeto en el tiempo de diseño que está actualmente oculto, cambia el atributo V isible a true.

Ocultar una Aplicación en Tiempo de Ejecución AutoPlay M edia Studio te permite crear una aplicación que corra en el fondo (es decir, que no es visible al usuario en la barra de tareas o en la bandeja del sistema). Para habilitar esta opción:

1 . Dirígete al menú Project > Settings. 2. Selecciona la opción H idden. 3. H az click en OK.

48

Consejo: Para que realmente esté oculta la ventana de la aplicación, utiliza una acción W indow.H ide

Pausar la Música de Fondo Cuando hay música de fondo en una presentación, algunas veces es necesario pausarla. En AutoP lay M edia Studio esto se logra usando la Acción Rápida “Play/Pause Background Music”.

Esta acción rápida pausará la música de fondo si se está reproduciendo, y la reproducirá si está en pausa.

R ecuerda crear antes un botón y asignarle esta acción rápida.

Recordar Preferencias de Tiempo de Ejecución A manera de ejemplo, asumamos que tu aplicación pregunta al usuario si los videos deberían estar visibles en la aplicación. Pero solamente quieres preguntarle al usuario la primera vez que corra el programa. En cada lanzamiento subsecuente de tu aplicación, deseas mostrar/ocultar el objeto de V ideo basado en la preferencia inicial del usuario.


1 . Inserta el siguiente código dentro del evento On Preload de la página que contiene el objeto de V ideo:

visible = Application.LoadV alue("Application", "V ideo"); if visible == "" then visible = Dialog.M essage("V ideos visibles", "Q uieres que los videos estén visibles?", MB_Y ESNO); Application.SaveV alue("Application", "V ideo", visible); end if String.T oNumber(visible) == 7 then V ideo.SetV isible("V ideo1", false); end

Nota: Este script no le da al usuario una segunda elección. U na vez que él elija yes/no, esa elección será permanente. Si quisieras ofrecer al usuario una segunda elección, o la opción para cambiar la configuración más tarde, incluye el siguiente código en el evento On Click de un objeto de Botón:

visible = Dialog.M essage("V ideos visibles", "Q uieres que los V ideos estén visibles la próxima vez que ejecutes el programa?", MB_Y ESNO); Application.SaveV alue("Application", "V ideo", visible);

49

Redondear un Número hacia Abajo AutoP lay M edia Studio incluye una acción incorporada para redondear cualquier número hacia abajo del próximo número entero. Para lograr esto, utiliza la acción Math.Floor.

your_number = 3.1 41 5; your_rounded_number = Math.Floor(your_number);

Nota: Este script ajustará la variable your_rounded_number a 3.

Redondear un Número hacia Arriba AutoP lay M edia Studio incluye una acción incorporada para redondear cualquier número hacia arriba del próximo número entero. Para lograr esto, utiliza la acción Math.

your_number = 3.1 41 5; your_rounded_number = Math.Ceil(your_number);

Nota: Este script ajustará la variable your_rounded_number a 4.

Redondear un Número hacia Arriba o hacia Abajo S i quieres que todas las fracciones se redondeen hacia arriba (por ejemplo 2.1 -> 3.0, 2.5 -> 3.0) entonces utiliza Math.Ceil. (V e “Redondear un Número hacia Arriba”).

Si quieres que todas las fracciones se redondeen hacia abajo (por ejemplo 2.1 -> 2.0, 2.5 -> 2.0) entonces utiliza Math.Floor. (V e “Redondear un Número hacia Abajo”).

Si quieres que cualquier decimal igual o mayor que “.5” se redondeé hacia arriba, y cualquier decimal menor a “.5” se redondeé hacia abajo (por ejemplo 2.1 -> 2.0, 2.5 -> 3.0), utiliza la siguiente acción:

n = 2.5; rounded = Math.R ound(n);

Referir Información a un Sitio Web AutoPlay M edia Studio tiene una función incorporada para mandar datos a un sitio web y recibir una respuesta:

• H T T P.Submit

50

Para referir información a un sitio web, utiliza la acción H T T P.Submit. Por favor ten en cuenta que tienes que desarrollar un script servidor para aceptar cualquier dato que estés mandando a la web.

H T T P.Submit toma la respuesta de tu script servidor y la almacena en una cadena.

U na posible implementación de esto sería lo siguiente:

1 . Desarrolla un script que pueda aceptar cualquier dato que desees pasarlo desde AutoP lay, y regresa algún valor.

2. U sa la acción H T T P.Submit para referir tus datos a tu script (localizado en tu servidor web).

3. Procesa la cadena devuelta.

Nota: Esta es una muy compleja implementación de AutoP lay M edia Studio. T endrás que coordinarte con el desarrollador de tu sitio web para decidir sobre un plan de implementación.

Reiniciar el Sistema Para reiniciar el sistema del usuario desde tu aplicación:

1 . Inserta la siguiente acción dentro de un evento en tu aplicación:

System.R eboot();

Nota: Esta acción reinicia la máquina sin interacción requerida por el usuario y sin dar ninguna advertencia.

Repetir Cosas en Intervalos Específicos Cuando hay una acción que debería repetirse en un intervalo predeterminado, utiliza un evento On T imer en AutoP lay M edia Studio:

1 . H az doble click en la página en uso. 2. Elige la pestaña Script. 3. H az click en la pestaña del evento On T imer. 4. Añade aquí tu acción.

Para comenzar ejecutando las acciones en el evento On T imer, utiliza la siguiente acción:

Page.S tartT imer(5000) --lanza las acciones On T imer cada 5 segundos

51

Esta acción es ejecutada típicamente ya sea por el evento On Click de un objeto, o como una acción en el evento On Show de la página

Nota: La acción Page.StartT imer sólo tiene que ser ejecutada una vez para iniciar el cronómetro. Las acciones en el evento On T imer continuarán siendo ejecutadas hasta que la acción StopT imer sea llamada.

Consejo: Para detener la acción de encendido del cronómetro, utiliza la acción Page.StopT imer();

Reproducir Múltiples Archivos de Audio en Secuencia En AutoP lay M edia Studio es posible reproducir un archivo de audio después de otro usando el evento On Audio.

A manera de ejemplo, crearemos un proyecto que al ser ejecutado cargará tres archivos en una tabla y los reproducirá uno tras otro hasta que la tercera canción haya finalizado.

Para lograr esto:

1 . Inserta el siguiente código dentro de tus Funciones Globales (haciendo click en Project > Global Functions):

-- sigue la pista de los archivos de audio audio_count = 1 ; --carga los archivos de audio deseados dentro de una tabla audio = { "Autoplay\\Audio\\audio_file1 .ogg", "Autoplay\\Audio\\audio_file2.ogg", "Autoplay\\Audio\\audio_file3.ogg" };

2. Inserta el siguiente código dentro del evento On Show de tu página:

Audio.Load(CHANNEL_U SER 1 , audio[audio_count], true, false);

3. Inserta el siguiente código dentro del evento On Audio de tu página: if e_S tate == "Finish" then audio_count = audio_count + 1 ; --se asegura de que un archivo válido fue cargado if audio_count < T able.Count(audio)+ 1 then Audio.Load(CHANNEL_U SER 1 , audio[audio_count], true, false); end end

52

Reproducir Múltiples Archivos de Video en Secuencia En AutoP lay M edia Studio es posible reproducir un video tras otro utilizando el evento On Finish.

Como ejemplo, crearemos un proyecto con un objeto de Botón y un objeto de V ideo. El usuario hará click en el botón y se cargarán múltiples videos dentro de una tabla. El proyecto entonces reproducirá un video tras otro hasta que todos los videos hayan sido reproducidos.

Para lograr esto:

1 . Inserta el siguiente código dentro de las Funciones Globales (haciendo click en project > functions):

--índice de tabla comienza en 1 video_count = 1 ;

2. Inserta el siguiente código en el evento On Click del botón previamente creado:

video = Dialog.FileBrowse(true, "Load V ideos", "", "", "", "", true, true); V ideo.Load("V ideo1", video[video_count], true, false);

3. Inserta el siguiente código dentro del evento On Finish del objeto de V ideo previamente creado:

--Atraviesa la tabla video_count = video_count + 1 ; --Se asegura que un archivo válido será cargado if video_count < T able.Count[video]+ 1 then --carga el archivo V ideo.Load("V ideo1", video[video_count], true, false); end

Reproducir Música de Fondo R eproducir una música suave de fondo en tu aplicación puede servir para establecer un estado de ánimo deseado para tu aplicación

A manera de ejemplo, cargaremos un archivo de música (que tenga extensión .ogg) en el canal de audio de fondo de tu proyecto:

1 . Inserta el siguiente código dentro del evento On Show de la primer página del proyecto:

53

--carga un archivo *.ogg en el canal de fondo, automáticamente lo reproduce, y lo hace cíclico Audio.Load(CHANNEL_BACKGR OU ND, "AutoPlay\\Audio\\background.ogg", true, true);

Nota: Para reproducir una canción después de otra en tu música de fondo, por favor dirígete al tema “Reproducir Múltiples Archivos de Audio en Secuencia”.

Nota 2: R ecuerda que debes añadir el archivo de la música de fondo a la carpeta Audio de AutoP lay. Es decir, no solamente lo añadas en el Script.

U na forma alternativa de añadir música de fondo a tu aplicación es usando la pestaña Background Music del cuadro de diálogo Audio Settings. Para acceder a este cuadro de diálogo:

1 . Elige Project > Audio. 2. H az click en el botón Add. 3. Selecciona tu archivo de audio. 4. H az click en OK.

Nota: R epite los pasos 2 y 3 antes de hacer click en OK para añadir más de un archivo de audio.

Reproducir un Archivo de Video AVI AutoP lay M edia Studio incluye un objeto de V ideo capaz de reproducir cualquier archivo de película que sea soportado por W indows M edia Player.

Para reproducir un archivo AV I en AutoP lay M edia Studio, crea un objeto de V ideo en la página deseada:

1 . Elige Object > V ideo. 2. Selecciona un archivo AV I. 3. H az click en OK.

Nota: S i tu archivo AV I contiene codecs no estandarizados, por favor asegúrate de incluirlos con tu proyecto, así tus usuarios no experimentarán ningún problema al reproducir dicho archivo.

Reproducir un Video antes de que mi Aplicación Inicie AutoP lay M edia Studio tiene una opción para añadir un video introductorio a tu presentación.

Para lograr esto:

54

1 . Elige en el menú Project > Startup Movie. 2. H abilita la opción Play Startup Movie. 3. Agrega tu archivo de película y configura los ajustes del proyecto. 4. H az click en OK.

Nota: S i deshabilitas la opción Allow Click to Skip, la película permanecerá visible hasta que se complete. Si esta opción es habilitada, el usuario puede hacer click en tu película introductoria para detenerla e ir directamente a la aplicación.

Reproducir un Video Utilizando el Modo Full Screen AutoP lay M edia Studio incluye una acción para reproducir un video en modo full screen.

Para lograr esto:

1 . Agrega el siguiente código al evento On Play de tu objeto de V ideo:

V ideo.SetFullScreen("V ideo1", true);

2. Agrega el siguiente código al evento On Finish de tu objeto de V ideo:

Application.Exit();

Este script reproduce tu video en pantalla completa y, una vez que finalice, cierra tu aplicación.

Nota: Algunas veces al iniciar la aplicación, el video no se mostrará en Full Screen. Para lograr que se muestre en Full Screen, páusalo y luego reinícialo.

Reproducir un Video usando el Objeto de Video Incrustado AutoPlay M edia Studio incluye un objeto de V ideo incrustado. Este objeto es capaz de reproducir cualquier archivo de video que sea soportado por W indows M edia Player (avi, mpg, wmv, etc).

Para crear un objeto de V ideo:

1 . V e al menú Object > V ideo. 2. Selecciona tu archivo de video. 3. H az click en OK.

55

Nota: Algunos codecs no son descargados automáticamente por W indows M edia Player. Si tu archivo de video utiliza un codec especializado, por favor asegúrate incluirlo con tu distribución.

Reproducir una Animación Flash AutoPlay M edia Studio incluye un objeto Flash incorporado para agregar archivos Flash en tu Aplicación

Para lograr esto:

1 . Elige el menú Object > Flash. 2. Selecciona tu película Flash. 3. H az click en OK.

Nota: Los objetos Flash de AutoP lay hacen que se utilice el plugin Macromedia Flash (que se puede descargar gratuitamente de www.macromedia.com). Puedes configurar tu aplicación para que detecte automáticamente Flash en la computadora del usuario y requerir que una versión específica o más reciente sea instalada (ver el tema “Revisar en Busca de Macromedia Flash”).

Responder a Teclas Presionadas En AutoP lay M edia Studio existe un evento llamado On Key. Este evento es lanzado cuando una tecla es presionada. Esto es útil si quieres que tu aplicación, por ejemplo, reproduzca un sonido cada vez que el usuario presione una tecla.

Otro uso para este evento es hacer algo solamente cuando una tecla específica es presionada. Como un de ejemplo, considera el Explorador de Internet. U n usuario introduce una U R L dentro de una barra de dirección y cuando la tecla enter es presionada, la página que él requirió es cargada.

Para lograr este ejemplo en AutoP lay M edia Studio:

1 . Crea un objeto input. En su evento On Key, ingresa el siguiente código:

-- e_Key es una variable incorporada que obtiene lo generado por el evento On Key. -- 1 3 es el valor del código de tecla virtual para la tecla [Enter]. if e_Key == 1 3 then -- Carga la dirección que fue ingresada por el usuario: W eb.LoadU R L("W eb1", Input.GetT ext("Input1 ")); end

56

http://www.macromedia.com/

Nota: Este script asume que tienes un objeto Input llamado "Input1 " y un objeto web llamado "W eb1".

Este script lee cada tecla presionada por el usuario en el input box (recuadro de entrada). Cuando [enter] es presionada, el script carga la U R L.

Restaurar un Objeto a su Tamaño Original En el ambiente de diseño de AutoP lay, es posible restaurar un objeto a su tamaño original después de que éste ha sido modificado. Esto es útil cuando quieres, por ejemplo, reanudar el tamaño de un objeto de Imagen a las dimensiones originales del archivo de imagen.

Para restaurar el tamaño original de un objeto:

1 . Selecciona el objeto deseado haciendo click sobre él. 2. H az click derecho en el objeto que acabas de seleccionar. 3. H az click en R estore Size.

Nota: Esto es también útil para el dimensionamiento de un objeto de V ideo que es cargado, a las dimensiones del archivo de video.

Revisar en Busca de Internet Explorer AutoP lay M edia Studio tiene una opción para buscar dependencias en tiempo de ejecución en el sistema del usuario, y opcionalmente puede requerir que las dependencias existan antes de que el programa pueda continuar. Para buscar Internet Explorer:

1 . V e al menu Project > Dependencies. 2. Selecciona las dependencias que tu proyecto requiere (en este caso Internet

Explorer). 3. H az click en OK.

Revisar en Busca de Macromedia Flash AutoPlay M edia Studio tiene una opción para buscar varias dependencias en tiempo de ejecución en el sistema del usuario, y opcionalmente puede requerir que las dependencias existan antes de que el programa pueda continuar. Para buscar M acromedia Flash:

1 . V e al menu Project > Dependencies.

57

2. Selecciona las dependencias que tu proyecto requiere (en este caso Macromedia

Flash). 3. H az click en OK.

Solicitar al Usuario Confirmación antes de Salir En AutoP lay M edia Studio es posible detener el cierre de tu aplicación basado en una acción del usuario, incluso después de que el botón “cerrar” ha sido presionado, o la acción Application.Exit ha sido usada. Esto es útil si, por ejemplo, te preocupa que el usuario accidentalmente cierre tu aplicación, o si quieres permitir que el usuario guarde sus cambios antes de salir.

Para lograr esto, debes incluir una función (Q ueryAllowProjectClose) en tus Funciones Globales (Project > Global Functions) que devuelva un “true” si el programa debiera cerrarse, o un “false” si no lo tenga que hacer:

function Q ueryAllowProjectClose() --esta función será llamada cuando el programa se esté cerrando

confirmation = Dialog.M essage("¿Estás Seguro?", "¿Estás seguro que quieres salir?", MB_Y ESNO, MB_ICONEXCLAMATION, MB_DEFBU T TON1 ); if confirmation == 6 then -- El botón “Y ES” fue presionado, permitiendo cerrar el programa (devuelve un “true”) return true; else -- El botón “Y ES” no fue presionado, evitando cerrar el programa (devuelve un “false”) return false; end end

Nota: Esta función es llamada internamente por tu aplicación cuando se le pide salir. Si “true” es devuelto, tu aplicación se cerrará. Si “false” es devuelto, tu programa no se cerrará.

Para usar esta función, deberías usar un script similar a éste:

if Q ueryAllowProjectClose() then Application.Exit(); end

58

Trabajar con Tablas y Archivos En AutoP lay M edia Studio, las tablas son frecuentemente utilizadas cuando se trabaja con archivos. Específicamente, observaremos cómo son almacenados en una tabla los resultados de una acción Dialog.FileBrowse, y cómo es posible trabajar con un archivo de texto cargado dentro de una tabla.

Las tablas, en su forma básica, simplemente son variables con muchas filas. La acción Dialog.FileBrowse almacena una ruta de archivo por fila en una tabla. Cuando se lee un archivo de texto dentro de una tabla, cada línea en el archivo de texto es una fila separada en la tabla.

Ejemplo 1 U sando la acción Dialog.FileBrowse, permitiremos al usuario explorar una carpeta y seleccionar múltiples archivos. Abriremos cada archivo con su aplicación por defecto:

-- Presenta al usuario un diálogo explorador de archivos (con el ajuste de selección múltiple a true) tFiles = Dialog.FileBrowse(true, "Multiple Select", "", "All Files(*.*)|*.*|", "", "", true, true); -- Asegura que tFiles contiene algo if tFiles then -- V erifica si el usuario presionó "Cancel" if tFiles[1 ] == "CANCEL" then -- El usuario presionó cancelar, no hacer nada else -- El usuario no presionó cancelar, viaja a través de la tabla de archivos. for nIndex, sFile in tFiles do -- Abre el archivo con el programa por defecto. File.Open(sFile, "", SW _SHOW NOR MAL); end end end

En el ejemplo anterior, la acción Dialog.FileBrowse regresa una tabla conteniendo todos los archivos que fueron seleccionados. Si el botón cancelar es presionado, la primer fila en la tabla (referenciada por tFiles[1 ]) es ajustada a 'CANCEL'. En caso contrario, cada fila en la tabla contiene la ruta de un archivo.

Ejemplo 2 U sando las acciones T extFile, cargaremos el contenido de un archivo de texto dentro de una tabla, e insertaremos el texto "¡¡La línea dos es la mejor de todas!!" dentro de la segunda línea del archivo de texto:

-- Presenta al usuario un diálogo explorador de archivos (con el ajuste de selección multiple a false) tFiles = Dialog.FileBrowse(true, "Single Select", "", "All Files(*.*)|*.*|", "", "", false,

59

true); -- Asegura que tFiles contiene algo if tFiles then -- V erifica si el usuario presionó "Cancel" if tFiles[1 ] ~= "CANCEL" then -- El usuario no presionó cancelar, continuar -- Lee el archivo de texto seleccionado a una tabla tT extFileContents = T extFile.R eadT oT able(tFiles[1 ]); -- Inserta el texto dentro de la línea (fila) dos T able.Insert(tT extFileContents, 2, "¡¡La línea dos es la mejor de todas!!"); -- Escribe la tabla alterada de regreso en el archivo de texto seleccionado (es decir, agregará la frase "¡¡La línea dos es la mejor de todas!!" en el segundo renglón del archivo de texto seleccionado) T extFile.W riteFromT able(tFiles[1 ], tT extFileContents, false); end end

Utilizar el Diálogo de Estado En AutoP lay M edia Studio es posible desplegar un diálogo de estado a tus usuarios utilizando acciones incorporadas. Esto es útil, por ejemplo, si tu aplicación utiliza un bucle que le toma bastante tiempo para completarse.

Como un ejemplo, crearemos un bucle que cuente hasta 20,000 y despliegue una ventana de estado permitiendo al usuario saber el progreso de la cuenta

1 . Crea un objeto de Botón, y añade el siguiente código en su evento On Click:

--ajusta los valores mínimo y máximo minimum_value = 0; maximum_value = 20000; --configuración de la ventana del estado de diálogo StatusDlg.Show(); --muestra la ventana del estado de diálogo StatusDlg.SetT itle("Contando de " .. minimum_value .. " a " .. maximum_value); --ajusta el título StatusDlg.SetM eterR ange(minimum_value, maximum_value); --ajusta el rango del contador --conteo en bucle loop_control = minimum_value; --ajusta la variable de control bucle while loop_control <= maximum_value do --mientras que la variable de control bucle sea menor o igual al valor máximo StatusDlg.SetM eterPos(loop_control); --ajusta la posición del contador a la variable

60

de control bucle StatusDlg.SetS tatusT ext("Actualmente contando . . . (" .. loop_control .. " of " .. maximum_value .. ")"); --ajusta el estado del texto para reflejar el número actual loop_control = loop_control + 1 ; --incrementa la variable de control bucle end

Nota: El código anterior cuando es ejecutado contará hasta 20,000 y desplegará un diálogo de estado mostrando el progreso del bucle.

Utilizar Eventos Timer Cuando hay una acción que debería repetirse en un intervalo predeterminado, utiliza un evento On T imer en AutoP lay M edia Studio

1 . H az doble click en la superficie de la página. 2. Elige la pestaña Script. 3. H az click en la pestaña del evento On T imer. 4. Añade tu acción aquí.

Para que inicie la ejecución de las acciones en el evento On T imer, utiliza la siguiente acción

Page.StartT imer(5000) -- lanza las acciones On T imer una vez cada 5 segundos

Esta acción es normalmente ejecutada ya sea por el evento On Click de un objeto, o como una acción en el evento On Show de la página.

Nota: La acción Page.StartT imer solo tiene que ser ejecutada una vez para iniciar el timer. Las acciones en el evento On T imer continuarán siendo ejecutadas hasta que la acción StopT imer sea llamada.

Nota 2: Para detener la acción timer desde su inicio, utiliza la acción Page.S topT imer();

Utilizar un FSCommand para Provocar una Acción En AutoP lay M edia Studio es posible provocar una acción usando un FSCommand flash. Esto es útil si, por ejemplo, quieres que tu aplicación haga algo específico al final de tu animación flash.

Como un ejemplo, crearemos una animación flash en Swish (programa para hacer animaciones Flash sin el Flash, muy sencillo y fácil de usar) que mande un FSCommand cuando ésta finalice de reproducirse. Cuando la animación flash llegue al final de su reproducción, desplegaremos un mensaje de diálogo.

En Swish:

61

1 . En Swish, haz click derecho en el último fotograma de la animación y elige

FSCommand del M enú Contextual. En el panel Action, verás el FSCommand añadido.

2. H az click en 'FSCommand' para mostrar los cuadros command/argument por debajo de éste.

3. En el cuadro command (el de arriba de los dos cuadros), teclea lo siguiente como un comando: SplashFinished.

4. Guarda la animación como un archivo swf.

En AutoP lay M edia Studio:

1 . Crea un objeto flash y carga el archivo swf que creaste en Swish. 2. Añade las siguientes acciones en el evento On FSCommand (en la pestaña

script):

if (e_FSCommand == "SplashFinished") then Dialog.M essage("T u T ítulo Aquí", "T u M ensaje Aquí"); end

Nota: e_FSCommand es una variable incorporada conteniendo el último FSCommand lanzado dentro del objeto Flash.

Verificar si un Programa en Particular está Corriendo A manera de ejemplo, asumamos que quieres correr tu programa (autorun.exe) sólo si no hay otro autorun.exe corriendo en el sistema. Para lograr esto, utiliza la acción W indow.EnumerateProcesses y coteja en cada proceso el nombre de archivo autorun.exe.

1 . Inserta el siguiente código en el evento On Show de tu página:

-- Inicializar variables instances_of_file = 0; file_to_check_for = "autorun.exe"; --poner todo en minúsculas processes = W indow.EnumerateProcesses(); -- Ir directamente a la tabla de proceso for j, file_path in processes do -- Divide la ruta para obtener el nombre del archivo file = String.SplitPath(file_path); -- compara el nombre del archivo con el archivo especificado en la variable de inicialización if (String.Lower(file.Filename..file.Extension)) == file_to_check_for then -- El proceso coteja, e incrementa la cuenta en 1 . instances_of_file = instances_of_file + 1 ; end

62

end -- V erificar si por lo menos un archivo concuerda if instances_of_file > 0 then -- H ubo por lo menos una concordancia, oculte la ventana de esta aplicación, muestre el error, y ciérrelo. W indow.H ide(Application.GetW ndH andle()); Dialog.M essage("Error", "Another instance of Autorun.exe is already open."); W indow.Close(Application.GetW ndH andle(), CLOSEW ND_TER MINATE); end

Volver a Cargar los Objetos de Imagen en Tiempo de Ejecución Para cargar una imagen dentro de un objeto de Imagen en tiempo de ejecución, utiliza la acción Image.Load.

Como ejemplo, cargaremos la imagen ejemplo.jpg (desde el directorio de Imágenes de la carpeta de distribución del proyecto) dentro del objeto de Imagen “Image1 ”:

Image.Load("Image1", "AutoP lay\\Images\\ejemplo.jpg");

Nota: Para cargar esta imagen en tiempo de ejecución, introduce el código anterior en el evento On Show de la página que contiene tu objeto de Imagen.

63

Abarcar el Contenido A Través de Múltiples...

Documents

Transcript of Abarcar el Contenido A Través de Múltiples...