Está en la página 1de 63

Abarcar el Contenido A Travs de Mltiples CDROMs

P ara abarcar el contenido a travs de mltiples CD


s, debes crear una a aplicacin por
separado para cada CD
.
S i esta no es una opcin para tu proyecto, y no hay forma de que puedas ajustar tu
proyecto a un solo CD
,deberas considerar la distribucin de tu proyecto en un D
V D
.

Abrir un Archivo .DOC de Microsoft Word


P ara abrir un D
ocumento de W ord usando AutoP lay M edia S tudio, utiliza la Accin
R
pida Open D
ocument para llamar al documento. U sa el botn Browse que est
junto a D
ocument to Openpara seleccionar el archivo .D
OCque quieras abrir.
R ecuerda que tienes que asignarle una Accin R
pida a algn objeto, as que
primeramente tienes que crear uno (normalmente un botn).
Nota: AutoP lay M edia S tudio no cuenta con un objeto W ord. P ara 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 S tudio 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 S tudio es posible abrir un documento H T M L en el Explorador por
defecto del usuario. P ara lograr esto, por favor dirgete al tema Abrir un Sitio Web en
un Explorador Externo.

Abrir un Archivo PDF Adobe Acrobat


P ara abrir un Archivo P D
F en Adobe Acrobat usando AutoP lay M edia S tudio,utiliza la
Accin R
pida Open D
ocument para llamar al documento. U sa el botn Browse que
estjunto a D
ocument to Openpara seleccionar el archivo P D
F que quieras abrir.
R ecuerda que tienes que asignarle una Accin R
pida a algn objeto, as que
primeramente tienes que crear uno (normalmente un botn).

Nota: AutoP lay M edia S tudio no cuenta con un objeto P D


F. P ara abrir un documento
PD
F 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


P ara abrir una presentacin P owerP oint usando AutoP lay M edia S tudio, utiliza la
Accin R
pida Open D
ocument para llamar al documento. U sa el botn Browse que
estjunto a D
ocument to Openpara seleccionar el archivo P P T /P P S que quieras abrir.
R ecuerda que tienes que asignarle una Accin R
pida a algn objeto, as que
primeramente tienes que crear uno (normalmente un botn).
Nota: AutoP lay M edia S tudio no cuenta con un objeto P owerP oint. P ara abrir una
presentacin P owerP oint en la computadora del usuario, ste debe tener un programa
capaz de abrir la presentacin (por ejemplo M icrosoft P owerP oint).

Abrir un Archivo QuickTime MOV


P ara abrir una pelcula Q uickT ime usando AutoP lay M edia S tudio, utiliza la Accin
R
pida Open D
ocument para llamar al documento. U sa el botn Browse que est
junto a D
ocument to Openpara seleccionar el archivo .M OV que quieras abrir.
R ecuerda que tienes que asignarle una Accin R
pida a algn objeto, as que
primeramente tienes que crear uno (normalmente un botn).
Nota: AutoP lay M edia S tudio no cuenta con un objeto Q uickT ime. P ara abrir un
documento Q uickT ime en la computadora del usuario, ste debe tener un programa
capaz de abrir la pelcula (por ejemplo Apple Q uickT ime). Adem
s, date cuenta que no
utilizamos la Accin R
pida P lay M ultimedia. La Accin R
pida P lay M ultimedia
es slo para tipos de archivo multimedia que pueden ser reproducidos en el interior de
AutoP lay M edia S tudio.

Abrir un Sitio Web en un Explorador Externo


AutoP lay M edia S tudio contiene una Accin 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 botn etiquetado como Company W ebsitepara abrir el sitio web de
tu compaa en el explorador por defecto del usuario
P ara lograr esto,utiliza la Accin R
pida V iew W ebsite:
1 . Crea un objeto de Botn.

2. H az doble click en el objeto de Botn, elige la pestaa Q uick Action (Accin


R
pida)y luego elige V iew W ebsite como Action to run (Accin a ejecutarse).
3. En el campo W eb site,escribe la direccin web de tu compaa.
4. H az click en OK .

Ajustar el Control de Volumen en Tiempo de


Ejecucin
A manera de ejemplo,crearemos un proyecto con dos botones: un botn que incremente
el volumen y otro botn que lo disminuya.
1 . Inserta el siguiente cdigo en el evento On Click del botn que incrementa el
volumen:
audio_channel = CH ANNEL_U S ER 1 ;
Audio.S etV olume(audio_channel,Audio.GetV olume(audio_channel)+ 20);
2. Inserta el siguiente cdigo en el evento On Click del botn que disminuye el
volumen:
audio_channel = CH ANNEL_U S ER 1 ;
Audio.S etV 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
msica impertinente escuch
ndose en tu proyecto. P ara lograr esto en AutoP lay M edia
S tudio,utiliza la accin Audio.S etV olume.
Como un ejemplo, tocaremos un soundtrack como msica de fondo y fijaremos el
volumen con un m
ximo de 25% :
1 .Inserta el siguiente cdigo en el evento On S howde tu p
gina:
Audio.Load(CH ANNEL_BACK GR OU ND
,"your_audio_here.ogg",true,true);
Audio.S etV olume(CH ANNEL_BACK GR OU ND
,63);-- fija el nivel de volumen en un
25% de 255

Ajustar los Atributos de Archivo para Ms de un


Archivo
AutoP lay M edia S tudio tiene una accin File.S etAttributes para ajustar los atributos de
un archivo. S i quieres ajustar los atributos de muchos archivos a la vez, necesitas
ejecutar esa accin mltiples veces.U na manera f
cil de hacer esto es almacenar la lista
de archivos en una tabla, y luego orbitar a travs de esa tabla utilizando un bucle for.
Cada paso a travs del bucle ajustarlos atributos para cada uno de los archivos.
U na forma sencilla de crear una tabla llena de rutas de archivo es usar la accin
File.Find. La accin File.Find regresa una tabla conteniendo una lista de todos los
archivos que concuerden con un patrn especfico.
Como ejemplo, ajustaremos todos los archivos .exe en la carpeta raz de la unidad Ca
slo lectura:
1 . Inserta el siguiente script dentro de un evento de tu proyecto:
files_to_change = File.Find("C:\\","*.exe");
-- orbita a travs 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.S etAttributes(filename,{R eadOnly= true});
end

Ajustar los Efectos de Transicin de Pgina


AutoP lay M edia S tudio 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.
P ara lograr esto,utiliza las transiciones de p
gina:
1 . En el panel P ropiedades de la p
gina, cambia el campo T ransition de None a la
transicin que desees (D
issolve, S lide o W ipe). Ahora, al utilizar una Accin
page jump o una page navigate desde esa p
gina, la transicin que seleccionaste
serutilizada.

La transicin no afecta a algunos objetos, tales como web, listbox, etc. P ara 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 transicin.
2. Inserta esta captura de pantalla como una gran imagen hacia la p
gina a la que
quieras que se haga la transicin.
3. Ajusta la visibilidad de todos los objetos a false, y la visibilidad de la imagen a
true.
4. En el evento On S how de esta p
gina, muestra todos los objetos, y oculta la
imagen.

Alternar la Msica de Fondo a On/Off


Es posible en AutoP lay M edia S tudio tener msica de fondo reproducindose en tu
aplicacin.
En AutoP lay M edia S tudio esto se logra usando la Accin R
pida P lay/P ause
Background M usic:
1 . Crea un botn.
2. Elige P lay/P ause Background M usic como la Accin R
pida para el botn.

Aadir una Contrasea de Proteccin


H ay muchos casos donde se le requeriral usuario introducir informacin que no debe
estar visible en la pantalla, tal como una contrasea. En AutoP lay M edia S tudio se
consigue esto usando una accin D
ialog.P asswordInput.

Como un ejemplo, se le requeriral usuario una contrasea al iniciar un programa, y se


compararcon un valor almacenado (en consecuencia se limita el acceso al programa
slo a aquellos que conocen la contrasea).
P ara lograr esto:
1 .Inserta el siguiente script en el evento On S howde la p
gina:
-- La contrasea correcta
real_password = "password";
-- P edir al usuario que escriba la contrasea
user_password = D
ialog.P asswordInput("P assword","P or favor introduce la contrasea:
",M B_ICONQ U ES T ION);
-- Comparar si la contrasea del usuario es la contrasea correcta.
-- S i el usuario proporciona una contrasea errnea,salir del programa.
if real_password ~= user_password then
Application.Exit();
end
Este script hace que aparezca un cuadro de di
logo requiriendo la contrasea. Cualquier
cosa que el usuario escriba en este cuadro de di
logo aparecercomo ******. S i la
contrasea correcta es escrita, el programa se abrirnormalmente. S i la contrasea
escrita no es la correcta,el programa se cerrar
.
Alternativamente, t puedes tener una lista de contraseas v
lidas. P ara lograr esto,
almacena tus contraseas v
lidas en una tabla:
1 .Inserta el siguiente script en el evento On S howde tu p
gina:
--S uponer que el usuario escribiuna contrasea incorrecta
correct_password = false;
-- La contrasea correcta
real_passwords = {"password","password2","3rdP assword"};
-- P edir al usuario que escriba la contrasea
user_password = D
ialog.P asswordInput("P assword","P or favor introduce la
contrasea: ",M B_ICONQ U ES T ION);
-- Comparar la contrasea del usuario con la contrasea correcta.
for j in real_passwords do
if real_passwords[j] = = user_password then
correct_password = true;
end
end
--S i la contrasea no es la correcta,salir
if not correct_password then

Application.Exit();
end
Consejo: Como una pequea variacin de esta tcnica, puedes almacenar tu lista de
contraseas en un archivo de texto, y cuando tu aplicacin 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: Cmo leer lneas especficas de un archivo de texto?.

Aadir un Hipervnculo o un Hotspot a un Objeto


Aadir un hipervnculo a un proyecto es til si deseas que un usuario al hacer click en
una parte de tu proyecto pueda obtener m
s informacin. Esto se logra en Autoplay
M edia S tudio usando el evento On Clickde 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 P aragraph Object. P ara el propsito de
este ejemplo,asumiremos tambin que t tienes el siguiente p
rrafo en tu proyecto:

1 . U tiliza un H otspot Object y colcalo sobre la frase Continue en tu


P aragraph Object
2. En la ficha Q uick Actiondel H otspot Object,elige S how P agecomo Action
to run, luego elige S pecific P age en P age to show, y elige P age 2 en P age
name.

Ejemplo 2:
P ara obtener efectos mouseover (el texto cambia de color cuando t posicionas el
ratn encima de la palabra Continue )no utilices un H otspot, en vez de esto utiliza
un segundo P aragraph Object que contenga slo el texto que el mouseover debera
cambiar:
1 . Crea un P aragraph Object que contenga solamente la palabra Continue
2. Coloca ese objeto exactamente sobre la frase Continue en tu p
rrafo m
s
grande.

Consejo: U sa las flechas del teclado para posicionar exactamente tu segundo P aragraph
Object.
3. S elecciona el color que quieras para el mouseover. En la ficha Q uick Action de
este P aragraph Object elige S how P ageen Action to run;elige S pecific P ageen
P age to show, y elige P age 2 en P age name. T ambin puedes hacer que al
posicionar el ratn sobre un objeto de p
rrafo cambie de dibujo el cursor del ratn;
para ello ve a la ficha Attributesy selecciona H anden Cursor y listo.

Ejemplo 3:
P ara incluir hipervnculos en un archivo de texto sin utilizar un H otspot Object o un
P aragraph Object,incrusta un archivo H T M L 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 accin que elijas:
1 . Crea un W eb object y c
rgale el archivo H T M L deseado.
2. V e a Cmo interactuar con Web objects incrustados? para establecer la
navegacin en tu proyecto,y para un ejemplo de un simple archivo H T M L.
Nota: Esta es la mejor manera de incluir hipervnculos si tu texto no es est
tico con
relacin a la p
gina. M ientras que un P aragraph Object o un H otspot Object son
estacionarios, los vnculos dentro de un archivo H T M L se mueven din
micamente
basados en el tamao del W eb object en tiempo de ejecucin.

Aplicar Cambios a Mltiples Objetos


Con frecuencia es til poder cambiar las propiedades de varios objetos a la vez. P ara
lograr esto en AutoP lay M edia S tudio:
1.
2.
3.
4.

S elecciona el primer objeto.


M antn oprimida la techa Ctrl de tu telado.
S elecciona los dem
s objetos que desees.
S uelta ahora la tecla Ctrl.

Cualquiera de las propiedades que estn disponibles para todos los objetos que
seleccionaste, estar
n visibles en el P anel P ropiedades (P roperties P ane). Ahora puedes
hacer los cambios que requieras.
Consejo: Cuando selecciones mltiples objetos, el mantener oprimida la tecla S hift de
tu teclado tiene las mismas funciones que mantener oprimida la tecla Ctrl.

Auto-Guardar Mi Proyecto
Los apagones de luz o congelamientos de las computadoras son inevitables, incluso
pareciera que esto ocurre a propsito en el peor momento posible. AutoP lay M edia
S tudio tiene una opcin incorporada para grabar tu proyecto en un intervalo de tiempo
que t elijas.
P ara habilitar esta opcin:
1 . V e al men Edit > P references.
2. H az click en D
ocument.
3. H abilita la caracterstica Auto S ave y elige el intervalo de tiempo para el
autoguardado.
4. H az click en OK .

Bloquear Objetos
En AutoP lay M edia S tudio es posible bloquear tus objetos a la p
gina de modo que no
puedan ser movidos a ninguna posicin o ser editados al hacer doble click sobre ellos.
El bloquear tus objetos los hace aparecer como si fueran parte del fondo. S i haces doble
click sobre un objeto bloqueado,la ventana P age P roperties sermostrada.
Nota: Aunque un objeto est bloqueado, an puedes editarlo desde el panel
P ropiedades.
P ara bloquear un objeto:
1 . S elecciona el objeto deseado.
2. H az click derecho sobre el objeto.
3. Elige Lock.
P ara desbloquear un objeto:
1 . S elecciona el objeto deseado.
2. H az click derecho sobre el objeto.
3. D
eshabilita Lock.

Caducar mi Aplicacin Despus de Treinta Das


P ara hacer que tu Aplicacin expire despus de treinta das, 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 expiracin (30 das despus de
que tu programa por primera vez se instal)
P ara lograr esto:

1 . Inserta el siguiente cdigo dentro del evento On S tartup de tu proyecto:


-- Inicializar variables
days_left = 30;
date_installed = Application.LoadV alue("M y Application ","D
ate Installed");
time_limit = 30;--la duracin del periodo de prueba,en das
-- Convertir el valor de la cadena a nmero
date_installed = S tring.T oNumber(date_installed);

-- Fue date_installed 0 (inexistente)?


if date_installed = = 0 then
-- El valor fue inexistente,cralo
Application.S aveV alue("M y Application","D
ate Installed",
S ystem.GetD
ate(D
AT E_FM T _JU LIAN));
else
-- Actualizar das que quedan
days_left = (date_installed + time_limit)- S ystem.GetD
ate(D
AT E_FM T _JU LIAN);
end
-- H ay das remanentes?
if days_left < 1 then
-- No hay das remanentes,alertar al usuario y salir.
D
ialog.M essage("Fin del P eriodo de P rueba","Este software ha expirado");
Application.Exit();
else
-- An quedan das,alertar al usuario cu
ntos
D
ialog.M essage("P eriodo de P rueba","T e quedan "..days_left.."das en tu periodo de
prueba.");
end

Caducar mi Aplicacin despus de Cierta Fecha


P ara hacer que tu aplicacin expire despus 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.S i tu programa ha expirado,se cerrar
.
P ara lograr esto:
1 . Inserta el siguiente cdigo dentro del evento On S tartup de tu proyecto:
--Inserta tu fecha de expiracin aqu,con formato Y Y Y Y M M D
D
--(sin espacios,guiones,abreviaturas,etc.,slo usa nmeros)
--Abajo estla fecha 1 2 de D
iciembre de 2003
Expiration_D
ate = "20031 21 2"
--Obtn la fecha del sistema en formato IS O

10

--Fecha = Y Y Y Y -M M -D
D
D
ate = S ystem.GetD
ate(D
AT E_FM T _IS O);
--Q uita los guiones en la fecha del formato IS O
--para reflejar el formato de nuestra fecha de expiracin
--Fecha = = Y Y Y Y M M D
D
D
ate = S tring.R eplace(D
ate,"-","",false);
--comprobar si la aplicacin ha expirado
if D
ate > Expiration_D
ate then
--La aplicacin ha expirado
D
ialog.M essage ("Aplicacin V encida!","T u copia de esta aplicacin ha expirado!
Este programa se cerrarahora.");
Application.Exit();
end
Al intentar abrir tu aplicacin,se desplegarun mensaje de di
logo como el siguiente:

Caducar mi Aplicacin Despus de Cierto Nmero de


Ejecuciones
P ara hacer que tu aplicacin expire despus de cierto nmero 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.
P ara lograr esto:
1 . Inserta el siguiente cdigo dentro del evento On S tartup de tu P royecto:
-- Fija el nmero de veces permitido
times_allowed = 30;
-- R ecupera el nmero de veces que se ha corrido y convierte el valor en nmero
times_run = Application.LoadV alue("M i Aplicacin","H a S ido Corrida");
times_run = S tring.T oNumber(times_run);

11

-- Calcula el nmero permitido de veces que quedan para poder correrlo


times_remaining = (times_allowed - times_run)
-- V erifica si esta es la primera vez que la aplicacin ha sido corrida
-- Guarda el valor del nuevo nmero de veces que se ha corrido
if times_run = = 0 then
Application.S aveV alue("M i Aplicacin","H a S ido Corrida ","1 ");
else
Application.S aveV alue("M i Aplicacin","H a S ido Corrida ",(times_run + 1 ));
end
-- V erifica si la aplicacin ha sido corrida m
s veces que las permitidas
if times_run > times_allowed then
D
ialog.M essage("Fin del P eriodo de P rueba","Este software ha expirado");
Application.Exit();
else
D
ialog.M essage("P eriodo de P rueba","P uedes ejecutar este P rograma
"..times_remaining.."veces m
s.");
end

Cambiar el Icono de la Aplicacin


P ara cambiar el icono que tu aplicacin usa:
1.
2.
3.
4.

H az click en el menu P roject > S ettings


Activa la casilla Custon Iconen Options.
H az click en Browsey elige el icono que quieras usar.
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 Tamao de Pgina


En AutoP lay M edia S tudio, el tamao predeterminado de un proyecto es de 630 pixeles
de ancho por 425 pixeles de alto.S i tu proyecto requiere diferentes dimensiones,cambia
el tamao de la ventana en el cuadro de di
logo P roject S ettings:
1 . V e al men P roject > S ettings.
2. Cambia el tamao 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 Ttulo


P ara cambiar el texto que aparece en la barra de ttulo de tu aplicacin:
1 . V e al men P roject > S ettings.
2. Escribe el ttulo de tu eleccin en el
rea de W indow T itle.
3. H az click en OK .

Cargar y Mostrar un Archivo de Texto


P ara desplegar una gran cantidad de texto en tu p
gina, utiliza la accin
T extFile.R eadT oS tring y muestra los resultados en un objeto de p
rrafo.
P ara lograr esto en AutoP lay M edia S tudio:
1 . Elige el men Object > P aragraph.
2. Inserta el siguiente cdigo dentro de cualquier evento en tu aplicacin:
text = T extFile.R eadT oS tring("AutoP lay\\D
ocs\\large_text.txt");
P aragraph.S etT ext("P aragraph1 ",text);
Nota: Acurdate de aadir un archivo con extensin .txt en la carpeta D
ocs de
Autoplay. Este archivo de texto debe ser grande y tiene que llevar por nombre
large_text.

Cerrar Mi Aplicacin Inmediatamente


Normalmente para cerrar tu aplicacin, deberas usar la accin Application.Exit(). S in
embargo, si necesitas que tu aplicacin termine inmediatamente, en vez de usar
Application.Exit(),usa el siguiente cdigo:
W indow.Close(Application.GetW ndH andle(),CLOS EW ND
_T ER M INAT E);

Comparar Dos Strings (Cadenas)


Las comparaciones de S tring son ejecutadas de la misma forma que las comparaciones
de nmeros. A manera de ejemplo, crearemos dos S prings, y ejecutaremos una accin
basada en sus contenidos:
1 .Crear dos variables conteniendo strings:

13

S tring1 = "S oy S tring1 ";


S tring2 = "S oy S tring2";
2.Comparar las dos strings:
if S tring1 = = S tring2 then
--las dos strings son iguales
else
-- las dos strings no son iguales
if S tring1 > S tring2 then
--S tring1 es alfabticamente m
s grande que S tring2
elseif S tring1 < S tring2 then
--S tring1 es alfabticamente m
s pequea que S tring2
end
end
Nota: S i quieres comparar las longitudes de las dos strings, debes usar la accin
S tring.Length:
if S tring.Length(S tring1 )= = S tring.Length(S tring2)then
--las dos strings tienen la misma longitud
end
Consejo: P ara ejecutar la comparacin de dos strings en un caso no sensible, usa una
accin S tring.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 S tudio, esto se logra con una accin
File.Copy.
A manera de ejemplo, cargaremos una fuente especfica dentro de la computadora del
usuario:
--obtener el directorio de destino (en este caso,donde las fuentes est
n almacenadas)
fonts_dir = S hell.GetFolder(S H F_FONT S );
--copiar el archivo desde tu CD
al directorio de fuentes del usuario
File.Copy(_S ourceFolder .."\\my_font.ttf",fonts_dir..\\"my_font.ttf",false,true,false,
true,nil);
--registrar la fuente en W indows
S ystem.R egisterFont(fonts_dir .."\\myfont.ttf","M y Font Name",true);

14

Crear un Botn que Cierre la Aplicacin


En AutoP lay M edia S tudio,para crear un botn que cierre la aplicacin haz lo siguiente:
1 . V e al men Object > Button y selecciona un archive de botn para usar.
2. H az doble click en el botn que acabas de incorporar,luego haz click en la ficha
Q uick Action.
3. S elecciona 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 msica para usarse en un
reproductor est
ndar de CD
s. Los CD
s de modo mixto son frecuencia usados para
crear un CDde audio enriquecido el cual se reproduce normalmente en un
reproductor regular de CDy 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 M odo-M ixto:

Datos en Pista 1
Descripcin:
Este tipo de CD
de modo mixto coloca la pista de datos como la primer pista de msica
en el disco.

Pros:
El CD
es grabado como R OM M odo 1 ,por ello puede ser reproducido pr
cticamente en
cualquier unidad de CD
-R OM .

Contras:
Algunos reproductores de CDintentar
n reproducir la pista datos. La mayora de los
reproductores nuevos pasar
n por alto la pista debido a que estlistada como datosen
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 chillidode un
fax).
Este mtodo es usado tpicamente slo en situaciones donde sea improbable que el CD
vaya a ser reproducido en un reproductor de CD
de audio.

15

Pre-Gap / Track-Zero
Descripcin:
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 CDm
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 CDno se amolda en el est
ndar oficial y puede ser no-compatible con
algunos reproductores o sistemas operativos.

CD Extra o CD Enriquecido
Descripcin:
Este tipo de CD
de modo mixto contiene dos sesiones (disco multi-sesin). La primera
sesin contiene m
s de 98 pistas de audio, y la segunda sesin contiene la pista de
datos.Los reproductores de CD
de audio slo pueden verla primera sesin,y por ello
no reproducir
n la pista de datos. La mayora de las unidades de CD
-R OM pueden
verambas sesiones,y cargar
n tu aplicacin AutoP lay.

Pros:
Incluso los reproductores de CD
m
s viejos no reproducir
n la pista de datos, as que
los odos y bocinas del usuario est
n seguras de dao.
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 P hoto CD
.
S e requiere una unidad de CD
-R OM que pueda leer discos multi-sesin.

16

Conclusin
Nuestra Sugerencia:
T e sugerimos que utilices el tipo CDEnriquecido, debido a que cuenta con mayor
compatibilidad. Comnmente 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 slo puede ver
la ltima sesin en un disco multi-sesin. P or otra parte, los reproductores de audio
normalmente slo ven la primer sesin en un disco multi-sesin. P or 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:


P ara quemar un CD
Enriquecido con Nero Burning R OM (6.0 o superior):
1 . S elecciona CD
Extrae ingresa tu configuracin 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 S tudio 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 nmbralo W eb1 .
2. Llama la accin 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 seren H T M L,y no basada en W indows.

17

Abrir una carpeta en una ventana externa:


1 . Llama la accin File.Open:
File.Open("C:\\","",S W _S H OW NOR M AL);

Abrir una carpeta en una ventana del Explorador:


1 . Llama la accin File.ExploreFolder:
File.ExploreFolder("C:\\",S W _S H OW NOR M AL);
Consejo: S i tu proyecto estsiendo corrido desde la unidad de CD
-R OM del usuario y
deseas explorar el CD
-R OM desde tu aplicacin en Autoplay, utiliza _S ourceFolder
como la ruta para explorar/abrir.

Crear un Explorador de Archivos


En AutoP lay M edia S tudio 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 pelcula en ella. El
usuario harclick en uno de los archivos y clickearun botn para abrir el archivo.
1 .Crear un objeto listbox
2. Agregar los nombres de la pelcula en la columna Item T ext y la ruta de las pelculas
en la columna Item D
ata.
3.Crear un botn.
4.En el evento On Click de la ficha S cript del botn,aade el siguiente script:
selected = ListBox.GetS elected("ListBox1 ");
file = ListBox.GetItemD
ata("ListBox1 ",selected[1 ]);
File.Open(file,"",S W _S H OW NOR M AL)
Nota: S i tienes habilitada la opcin de M ultiple S election en tu listbox, el ejemplo de
arriba slo abrirel primer archivo seleccionado
Consejo: Q uiz
s podras aadir algo para prevenir errores que puedan ocurrir. U no de
esos errores sera si el usuario hace click en la listbox pero no selecciona nada. El script
de arriba comenzara bien, pero la lnea 2 fallara porque selected[1 ] sera nulo. P uedes
usar una declaracin ifpara que revise en busca de valores nulos:

18

if (selected) then
-- Hay por lo menos un item seleccionado, ponga sus acciones aqu
end
D
e 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
hoto clikeable.P ara lograr esto en AutoP lay M edia S tudio:
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 accin para cada H otspot object en el evento On Click para lograr la tarea
deseada.P or ejemplo,para abrir un Explorador W eb,usa la accin:
File.OpenU R L("http://www.indigorose.com/",S W _S H OW NOR M AL);

Consejo: Al pasar el ratn 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 opcin.

Crear un Unico Archivo Ejecutable


U na vez que hayas terminado la creacin de tu aplicacin, AutoP lay M edia S tudio
ofrece la opcin 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
aplicacin. Cuando tu aplicacin es cerrada, el directorio temporal y su contenido son
borrados.
P ara convertir tu proyecto en un archivo ejecutable:

19

1.
2.
3.
4.
5.

V e al men P ublish > Build.


S elecciona W eb/Email executable.
H az click en Next.
Introduce la ruta y el nombre de archivo deseados.
H az click en Build.

Nota: El seleccionar la opcin Encrypt data segmentno afecta la manera en la que el


usuario corre tu programa. M
s bien esta opcin de encriptado genera una contrasea 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 Aplicacin Multilenguaje


P ara 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 accin S ystem.GetD
efaultLangID
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 P reload y entonces saltar
a una p
gina en particular o incluso presentarle opciones disponibles que lo redirijan a
la seccin apropiada de una sola aplicacin.

Crear una Funcin Callback Personalizada


H abrocasiones en las que querr
s personalizar la manera en que la informacin es
desplegada a tus usuarios cuando ciertas acciones son ejecutadas. P ara hacer esto,
tendr
s que crear una funcin callback personalizada.
P ara ver un ejemplo de una funcin callback personalizada, favor de ver el tema
Ejemplos de Funciones Callback.

Crear una Tabla de Contenidos (Un Indice)


U na forma de navegar a travs de una aplicacin con multi-p
ginas es utilizar una
p
gina de T abla de Contenidos. En AutoP lay M edia S tudio esto se logra creando una
p
gina al principio de tu proyecto e incorporando un objeto navegante (por ejemplo un
botn)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:
P ara la primer p
gina:
1 . Crea dos botones.
2. En la pestaa Q uick Action del primer botn, elige S how P age como action to
run,elige S pecific P age y P age 1 como P roperties.
3. En la pestaa Q uick Action del segundo botn, elige S how P age como action to
run,elige S pecific P age y P age 2 como P roperties.
Nota: Es posible que quieras crear un botn 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. S implemente tienes que especificar cu
l p
gina deseas que se
muestre en las opciones de S how P age de la pestaa 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. P ara lograr esto en AutoP lay M edia S tudio primero
crea una m
scara de transparencia con un editor de im
genes externo (por ejemplo con
CorelD
raw o Illustrator).
1 . P ara 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 P roject > S ettings. Click en la pestaa Appearance, habilita
la casilla Custom M ask, luego haz click en Browse y selecciona tu imagen.
Ahora en tiempo de ejecucin,tu proyecto tomarla 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 aplicacin, puedes habilitar la opcin Fit to windowen el cuadro
de di
logo P roject S ettings para ajustar el ancho y el alto de la imagen de tu m
scara a
las dimensiones de tu ventana.

Desplegar Texto y/o Imgenes con Eventos MouseOver


(Ratn Encima)
La mayora de los objetos en AutoP lay M edia S tudio tienen dos eventos tiles para
efectos mouseover: On Enter y On Leave.
A manera de ejemplo, crearemos un botn que con mouseover (ratn encima)
desplegaruna imagen,y con mouseout (ratn fuera)ocultarla imagen:
1 . Crea un objecto de imagen.
2. Fija su estado visible por defecto como false. P ara hacer esto haz doble click
sobre la imagen para abrir sus propiedades, luego selecciona la pestaa
Attributes y desactiva la opcin V isible.
3. Ahora crea un objeto de botn.
4. En el evento On Enter del botn,introduce el siguiente script:
Image.S etV isible("Image1 ",true);
5. En el evento On Leave del botn,introduce el siguiente script:
Image.S etV isible("Image1 ",false);
Nota: Cuando el ratn del usuario est sobre el botn, el objeto de imagen aparecer
.
Cuando el ratn del usuario abandone el botn,el objeto de imagen desaparecer
.
Consejo: P ara 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.S etV isible por P aragraph.S etV isible.

Desplegar un Dilogo Guardar Como (Save As)


U n cuadro de di
logo Guardar Como es con frecuencia presentado para permitir al
usuario que seleccione una ubicacin para guardar un archivo.
P ara desplegar un cuadro de D
i
logo Guardar Como usando AutoP lay M edia S tudio:

22

1 . Crea una accin D


ialog.FileBrowse. Establece la propiedad FileOpen como
false:
file= D
ialog.FileBrowse(false,"S ave As","c:\\","All Files (*.*)|*.*|","","",false,true);
Nota: El archivo es una tabla. En el ejemplo de arriba, la seleccin de archivos
mltiples no estpermitida. P ara acceder a la ruta devuelta por la accin FileBrowse,
utiliza file[1 ] como una variable. Esto obtiene el valor desde la primera posicin 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 despus de que el
di
logo Guardar Como ha sido desplegado
File.Copy("c:\\example.exe",file[1 ],false,false,false,false,nil);

Detectar Cul Sistema Operativo est siendo Utilizado


AutoP lay M edia S tudio incluye una accin para detectar qu S istema Operativo est
corriendo:
1 . Agrega el siguiente script a cualquier evento en tu aplicacin para almacenar la
versin del S istema Operativo del usuario en una variable OS _Name:
OS _Name = "OS Name: "..S ystem.GetOS Name();
Nota: AutoP lay tiene otra funcin integrada: S ystem.GetOsV ersionInfo(), la cual
regresa informacin de la versin del S istema Operativo del usuario en una tabla.

Detectar qu versin de Internet Explorer est


Instalada
P ara detectar la versin de Internet Explorer que estinstalada en el sistema del usuario:
1 .H abilita la dependencia Internet Explorer
Nota: S i quieres detectar la versin de Internet Explorer, pero no requieres que el
usuario la tenga instalada,fija la versin requerida en 0.0.0.0
2.Inserta el siguiente S cript en el evento On S how de la primer p
gina:
if _InternetExplorerV er = = "0.0.0.0"then
D
ialog.M essage("Internet Explorer","Internet Explorer is not installed");
else

23

D
ialog.M essage("Internet Explorer","la versin Internet Explorer"..
_InternetExplorerV er .."estinstalada en este sistema");
end
Nota: El script anterior desplegarun cuadro de di
logo en tiempo de ejecucin
mostrando la versin del Internet Explorer que la computadora del usuario tenga
instalada.

Detectar el Final de una Pelcula Flash


En AutoP lay M edia S tudio es posible detectar el momento en que una pelcula Flash
finaliz usando un FS Command. Esto es til si, por ejemplo, quieres navegar a otra
p
gina una vez que tu pelcula Flash ha terminado.
P ara lograr esto:
1 . En M acromedia Flash: Crea una pelcula Flash la cual contenga un FS Command en
el fotograma final de la lnea de tiempo:
fscommand("quit","");
2.Inserta el siguiente cdigo dentro del evento On FS Command de tu objeto Flash
if e_FS Command = = "quit"then
-- Cualquier script que pongas aqu,se ejecutarcuando tu pelcula Flash termine.
end

Detectar si el Acceso a Internet est Disponible


S i tu aplicacin va a utilizar Internet en algn 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.
P ara lograr esto en AutoP lay M edia S tudio:
1 .Introduce el siguiente script dentro de un evento en tu aplicacin:
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
D
ialog.M essage("Error de Internet","No est
s conectado a Internet.Esta aplicacin
se cerrar
");

24

Application.Exit();
end

Este script verifica si el usuario estconectado a Internet.S i despus de 20 segundos el


programa no puede encontrar una conexin de Internet v
lida, lo notifica al usuario y
sale de la aplicacin.

Determinar cuando la Reproduccin de un Video ha


Finalizado
En AutoP lay M edia S tudio, es posible ejecutar una accin una vez que tu video ha
completado su reproduccin. Algunos usos para esto incluyen redirigir al usuario a tu
sitio W eb despus de que el video termin,o redirigirlo a otro video.
P ara lanzar tu sitio W eb cuando un video ha finalizado, coloca el siguiente S cript en el
evento On Finish del V ideo Object:
File.OpenU R L("http://www.indigorose.com/",S W _S H OW NOR M AL);

Determinar el Lenguaje del Sistema Operativo


En AutoP lay M edia S tudio, para determinar el lenguaje del S istema Operativo del
usuario y almacenarlo en una variable user_language:
user_language = S ystem.GetD
efaultLangID
;
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 S istema del usuario, es til asegurarse que se tiene
suficiente espacio libre en su disco duro para alojar dicho software.
P ara lograr esto en AutoP lay M edia S tudio:
1 .Inserta el siguiente cdigo dentro de cualquier evento de tu aplicacin:

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 = D
rive.GetFreeS pace("C:");
--comparar el espacio libre disponible con el espacio libre requerido
if space_required > space_available then
D
ialog.M essage("","Necesitas "..(space_required - space_available).."M Bm
s");
else
D
ialog.M essage("","T ienes "..(space_available - space_required).."M Bm
s que los
necesarios");
end
Nota: La variable space_required debes fijarla t.253 es un nmero arbitrario.

Determinar la Letra de la Unidad del Disco Duro


Primario
P ara determinar cu
l es el disco duro principal del usuario en AutoP lay M edia S tudio,
utiliza la accin D
rive.Enumerate, y toma nota de la primera unidad fija (es decir, el
disco duro principal).
Introduce el siguiente cdigo dentro de cualquier evento en tu aplicacin:
-- Obtener una lista de todas las unidades en el sistema del usuario
drives = D
rive.Enumerate();
-- Ir directo a la lista
for j in drives do
-- Obtener el tipo de unidad
type = D
rive.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
D
ialog.M essage("","El disco duro principal del usuario es "..first_hdd);

26

Determinar si una Red (LAN) est Presente


En AutoP lay M edia S tudio,para determinar si un usuario estconectado a una LAN:
1 .Inserta el siguiente cdigo dentro de cualquier evento en tu aplicacin:
lan = S ystem.GetLANInfo();
lan_exist = true;
for j in lan do
if lan[j] = = "U nknown"then
lan_exist = false;
end
end
if lan_exist then
D
ialog.M essage("","Est
s conectado a una LAN");
else
D
ialog.M essage("","No est
s conectado a una LAN");
end
Nota: Este ejemplo trabaja en W indows 98 P rimera Edicin, W indows 98 S egunda
Edicin, W indows 2000 y W indows XP . W indows 95 y W indows NT no se adaptan a
este modelo.P ara detectar una conexin LAN en todos los sistemas operativos, primero
detecta el sistema operativo del usuario e introduce un S cript de deteccin adecuado.

Dimensionar mi Aplicacin a Medidas de Pantalla


Particulares
La forma m
s f
cil de asegurar que tu proyecto se reproduzca en cualquier computadora
es disearlo al m
s bajo comn denominador. Cada sistema de computadora capaz de
correr un archivo generado en AutoP lay puede soportar una resolucin de 640x480.
Nuestro tamao de proyecto por defecto es compatible con una resolucin de 640x480.
S i deseas tener un proyecto que abarque la pantalla completa del usuario,no importando
su resolucin, la forma m
s f
cil es disear un proyecto separado para cada resolucin.
T ambin crear un proyecto maestro que determine la resolucin del usuario
(S ystem.GetD
isplayInfo),y tenerlo para lanzar la aplicacin al tamao apropiado.
S i estas dos opciones son inaceptables, AutoP lay incluye acciones para redimensionar y
reposicionar objetos de tu p
gina. D
el mismo modo, como en la versin 7, los objetos y
la ventana de tu aplicacin pueden ser redimensionables, y cada vez que la ventana es
redimensionada el evento del proyecto On S ize es detonado.

27

Duplicar Objetos
P ara duplicar un Objeto en AutoP lay M edia S tudio:
1 . S elecciona el objeto deseado (haciendo click izquierdo sobre l una vez).
2. V e al men Edit > D
uplicate. (T ambin puedes presionar Ctrl+ Dsi 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
P ara duplicar un objeto usando referencias relativas, usa thisen lugar del nombre del
objeto en todos los scripts. Como ejemplo, crearemos un objeto de botn que con ratn
encima cambia su texto a ratn,y con el ratn fuera cambia su texto a gato:
1 . Inserta el siguiente cdigo dentro del evento On Enter de tu botn:
Button.S etT ext(this,"R atn");
2. Inserta el siguiente cdigo dentro del evento On Leave de tu botn:
Button.S etT ext(this,"Gato");
Nota: Cuando este objeto es duplicado, el texto del nuevo objeto cambiar
, y dejarel
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. P uedes entonces
simplemente utilizar una accin File.Open para ver el archivo P D
F. S i requieres otra
opcin,por favor lee la siguiente informacin,pero debes estar al tanto que Indigo R ose
no puede proporcionarte m
s asistencia o gua legal sobre los detalles de
implementacin.
1 . Instala Acrobat R eader (4.0 o superior)en una P Csin Acrobat.
2. Arrastra la carpeta \Acrobat x.x\y todo su contenido dentro de tu carpeta de
distribucin.(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 IS O, 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 Electrnico de U suario Final del Acrobat R eader.(Este
es un archivo .T XT que R eader instala en \Acrobat x.x\R eader\)
-D
erechos 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 accin para abrir tu documento P D
F usando el lector en tu
CD
:
path_short = File.GetS hortName(_S ourceFolder);
File.R un("Acrobat 5.0\\R eader\\AcroR d32.exe",path_short ..
"\\AutoP lay\\D
ocs\\luabook1 .pdf","",S W _S H OW NOR M AL,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)


AutoP lay M edia S tudio tiene una opcin para correr tu aplicacin en modo full screen
(pantalla completa). Este modo no cambia de tamao tu proyecto a full screen, sino que
m
s bien llena el espacio circundante con un color de fondo de tu eleccin.
P ara habilitar esta opcin:
1.
2.
3.
4.

Elige el men P roject > S ettings.


En la pestaa Appearanceselecciona la opcin de Estilo K iosk.
S elecciona tu color de fondo deseado.
H az click en OK .

Ejecutar mi Aplicacin Slo Una Vez


P ara correr tu aplicacin slo una vez (por ejemplo,la primera vez que el usuario inserta
tu CD
-R OM , y no otra vez) coloca el siguiente cdigo en el evento On S tartup de tu
proyecto:
--recupera o regresa el valor del registro.S i 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.S aveV alue("Application_Name","First_T ime","yes");

29

D
ialog.M essage("M ensaje","Esta es la primera vez que este programa se ha
corrido");
else
Application.Exit();
end
Consejo: T ambin puedes utilizar W indow.Close(Application.GetW ndH andle(),
CLOS EW ND
_T ER M INAT E) en lugar de Application.Exit(). Esto cerrarla ventana
antes de que la ventana misma aparezca (es decir,el usuario no vernada).

Ejecutar un Archivo Ejecutable


AutoP lay M edia S tudio incluye una Q uick Action (Accin R
pida) para lanzar un
archivo ejecutable. Esto es til, por ejemplo, cuando creas una seccin de entrada para
tu instalador. Cuando el usuario hace click sobre un objeto etiquetado como Instalar,
tu aplicacin lanza tu programa de instalacin. Esto se logra en AutoP lay M edia S tudio
usando la Accin R
pida R un P rogram.
P uedes especificar slo un archivo a ejecutarse as como los argumentos de la lnea de
comandos y la carpeta de trabajo.

Ejecutar un Programa y Esperar a que ste Finalice


Al utilizar AutoP lay M edia S tudio, puedes lanzar un archivo ejecutable, y tener tu
aplicacin esperando hasta que el archivo ejecutable termine.
Como ejemplo, correremos el ejecutable ejemplo.exe, y tendremos la aplicacin
esperando hasta que ejemplo.exe finalice. Esto se logra utilizando la accin File.R un, y
ajustando la propiedad W aitForR eturn a true:
File.R un("c:\\ejemplo.exe","","",S W _S H OW NOR M AL,true);
Nota: Esta accin lanza ejemplo.exe y espera hasta que ejemplo.exe ha terminado.

Ejecutar una Aplicacin despus de un Reinicio del


Sistema
A manera de ejemplo, crearemos una aplicacin con dos botones: Instalar Acrobat, e
Instalar Aplicacion1 01 . El programa de instalacin de Acrobat requerirque el usuario
reinicie su computadora una vez que la instalacin se complete. P ara asegurar que la
aplicacin sea lanzada cuando el usuario reinicia su sistema, aade el siguiente cdigo
en el evento On Click del botn Instalar Acrobat:

30

reboot = Application.LoadV alue("S ettings","R eboot");


if reboot = = ""then
S hell.CreateS hortcut(S hell.GetFolder(S H F_S T AR T U P _COM M ON),"T emporary
S hortcut","Autorun.exe","","","Autorun.exe",0,S W _S H OW NOR M AL);
Application.S aveV alue("S ettings","R eboot","done");
else
S hell.D
eleteS hortcut(S hell.GetFolder(S H F_S T AR T U P _COM M ON),"T emporary
S hortcut");
Application.S aveV alue("S ettings","R eboot","");
end
Nota: Este script agrega un atajo temporal a la carpeta de arranque de W indows.
Cuando tu aplicacin es ejecutada despus de un reinicio, el atajo temporal es
eliminado.

Eliminar Archivos Sin Uso de Mi Proyecto


D
urante el desarrollo de una aplicacin,inevitablemente son incluidos en tu distribucin
archivos que al final est
n sin uso,y por ello est
n ocupando un precioso espacio.
P ara que lo entiendas mejor,durante la creacin de tu proyecto creas objetos tales como
botones, p
rrafos, etiquetas, etc., pero es muy probable que no te agrade cmo va
quedando el proyecto y borras algunos objetos. S in 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 S tudio,estos archivos pueden ser removidos autom
ticamente:
1 . Elige el men T ools > Optimize R esources.
2. S elecciona 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
opcin de eliminarlos.
Consejo: H abilita la opcin Confirm deletion para asegurarte que nada se borre sin tu
conocimiento.

Escribir Texto a un Archivo


Cuando se escribe informacin a un archivo de texto, hay dos opciones: el texto puede
ser aadido al final del archivo de texto, o la informacin actual en el archivo de texto
puede ser sobre-escrita. En AutoP lay M edia S tudio esto se logra cambiando el valor
Append a false en cualquier accin 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 accin:
T extFile.W riteFromS tring("c:\text.txt","la de da de da",false);

Hacer que la Informacin Persista a lo Largo de las


Sesiones
Con frecuencia es agradable aadir un toque personal a tu P royecto, tal como saludar al
usuario por su nombre cuando tu aplicacin se inicia.
Como ejemplo, crearemos una aplicacin 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 aplicacin sea corrida, le darla bienvenida al usuario con el
nombre que l haba introducido:
1 . Coloca el siguiente cdigo en el evento On S tartup o en el evento On P reload de
tu proyecto:
-- Carga el ltimo nombre utilizado por el usuario
user = Application.LoadV alue("Information","Name");
-- haba un nombre de usuario ya almacenado?
if user = = ""then
-- No! Advierte al usuario que ponga su nombre.
user = "U suario D
esconocido";
user = D
ialog.Input("Informacin R equerida","P or favor introduce tu nombre
completo:","",M B_ICONQ U ES T ION);
Application.S aveV alue("Information","Name",user);
end
-- D
evuelve un mensaje de bienvenida
D
ialog.M essage("Bienvenido","H ola "..user..",bienvenido a mi aplicacin");
Nota: Este ejemplo incita al usuario a introducir su nombre completo la primera vez que
ejecute tu aplicacin, y almacena ese valor en el registro. Cada subsecuente vez que el
usuario ejecute tu aplicacin un mensaje aparecerde pronto en la pantalla salud
ndolo
por su nombre.

Hacer un Explorador de Documentos


A manera de ejemplo, crearemos una aplicacin 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 botn Openpara abrir el documento.

32

1 . Crea un proyecto con un objeto ListBox,y dos objetos de botn.


2. Etiqueta el botn 1 como "Cargar"y el botn 2 como "Abrir".
3. Inserta el siguiente cdigo dentro del evento On Click del botn 1 :
--D
eshabilitar la actualizacin de la ListBox
ListBox.S etU pdate("ListBox1 ",false);
--Obtener la carpeta a explorar deseada
folder = D
ialog.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
--aadir el item a la ListBox,con el nombre visible y la ruta como datos
ListBox.AddItem("ListBox1 ",S tring.S plitP ath(file_path).Filename,file_path);
end
--permitir que la ListBox muestre el contenido actualizado
ListBox.S etU pdate("ListBox1 ",true);
4. Inserta el siguiente cdigo dentro del evento On Click del botn 2:
selected = ListBox.GetS elected("ListBox1 ");
for j,k in selected do
File.Open(ListBox.GetItemD
ata("ListBox1 ",k),"",S W _S H OW NOR M AL);
end

Hacer un Explorador de Imgenes


A manera de ejemplo, crearemos una aplicacin 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 botn Abrir para cargar la imagen
seleccionada dentro del objeto de Imagen.
1 . Crea un proyecto con dos objetos de Botn, un objeto ListBox y un objeto de
Imagen.
2. Etiqueta el Button1 como "Cargar"y el Button2 como "Abrir".
3. Inserta el siguiente cdigo dentro del evento On Click del Button1 :
--deshabilitar actualizacin de ListBox
ListBox.S etU pdate("ListBox1 ",false);
--obtener la carpeta a explorar deseada
folder = D
ialog.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 travs de los distintos tipos de imagen
for j,file_path in images[k] do -- da vueltas a travs de cada archivo de imagen
--aade el item a la listbox,con el nombre visible y la ruta como datos
ListBox.AddItem("ListBox1 ",S tring.S plitP ath(file_path).Filename,file_path);
end
end
--P ermitir que la listbox muestre el contenido actualizado
ListBox.S etU pdate("ListBox1 ",true);
4. Inserta el siguiente cdigo dentro del evento On Click del Button2:
selected = ListBox.GetS elected("ListBox1 ");
for j,k in selected do
Image.Load("Image1 ",ListBox.GetItemD
ata("ListBox1 ",k));
end

Hacer un Explorador de Imgenes Miniatura


La idea detr
s de una imagen miniatura es presentarle al usuario una pequea imagen
que cuando sea clickeada lo enlace a una imagen m
s grande. P ara lograr esto en
AutoP lay M edia S tudio,crea un objeto de imagen con la imagen que desees usar para la
miniatura, y c
mbiala de tamao a la dimensin deseada. Ahora crea una accin 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 (P age1 ) estartu
miniatura,en tu segunda p
gina (P age2)estartu 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 accin 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):
P age.Jump("P age2");
3. En tu segunda p
gina, podras incluir un botn de retorno que haga saltar atr
s
hacia la primer p
gina. U sa la siguiente accin para el evento On Click de este
botn:

34

P age.Jump("P age1 ");


Nota: S i 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 serla
imagen miniatura,la Image2 sertu imagen grande.D
ales el tamao adecuado a
las dos im
genes.
3. Fija la propiedad visible de Image2 a false.
4. Crea una accin On Click para la Image1 que muestre la Image2 cuando sea
clickeada:
Image.S etV isible("Image2",true);
5. Crea una accin para la Image2 que la oculte cuando sta sea clickeada (usa el
evento On Click):
Image.S etV isible("Image2",false);
Nota: S i deseas puedes incluir m
s im
genes, por cada imagen haz una miniatura y una
grande. P ara ver detalles y scripts de este ejemplo revisa el archivo de proyecto H acer
un Explorador de Im
genes M iniatura 2que esten la carpeta Ejemplos.

Hacer un Men Desplegable


P ara crear un men desplegable en AutoP lay M edia S tudio:
1 . Crea un proyecto con seis objetos label, y organzalos como sigue:

35

2. Inserta el siguiente cdigo dentro del evento On Click de la Label1 :


if visible then
Label.S etV isible("Label2",false);
Label.S etV isible("Label3",false);
Label.S etV isible("Label4",false);
Label.S etV isible("Label5",false);
Label.S etV isible("Label6",false);
visible = false;
else
Label.S etV isible("Label2",true);
Label.S etV isible("Label3",true);
Label.S etV isible("Label4",true);
Label.S etV isible("Label5",true);
Label.S etV isible("Label6",true);
visible = true;
end
3. Inserta el siguiente cdigo dentro de tus Funciones Globales:
visible = false;

Hacer un Proyector de Diapositivas


Consejo: AutoP lay M edia S tudio 7 ahora contiene un Objeto S lideS how que tambin
puede ser utilizado para esta funcionalidad.
El propsito de un proyector de diapositivas es mostrar im
genes a una velocidad
predeterminada. En AutoP lay M edia S tudio, esto se logra creando un proyecto con una
p
gina por cada imagen que desees mostrar.
1 . P ara cada p
gina en tu proyecto, crea un objeto de imagen conteniendo la
imagen apropiada.
2. Crea la siguiente accin en el evento On S how de cada p
gina en tu proyecto:
P age.S tartT imer(5000);--iniciar el cronmetro una vez cada 5 segundos.
3. Crea la siguiente accin en el evento On T imer de cada p
gina de tu proyecto:
P age.Navigate(P AGE_NEXT );
La nica p
gina que no tiene esta accin es la ltima, porque no hay m
s p
ginas a
donde saltar.
4. Crea la siguiente accin en el evento On S how de tu ltima p
gina:

36

P age.S topT imer();--detener el cronmetro


Nota: Los eventos On T imer y On S how 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 S tudio 7 ahora contiene un Objeto S lideS how que tambin
puede ser utilizado para esta funcionalidad.
A manera de ejemplo, crearemos un proyector de diapositivas con voz superpuesta para
cada imagen. Este proyecto requerirun 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:
-- seguirla 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 accin en el evento On S how de cada p
gina:
Audio.Load(CH ANNEL_U S ER 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.S etT ext("Input1 ",e_S tate);
if e_S tate = = "Finish"then
audio_count = audio_count + 1 ;
P age.Navigate(P AGE_NEXT );
end
Nota: Cuando sea corrida, esta aplicacin cargarla primer p
gina y reproducirel
archivo de audio. Cuando ese archivo de audio se complete, la aplicacin brincara la
prxima p
gina, y lanzarel archivo de audio. Esto contina hasta la ltima p
gina.
Cada imagen es mostrada mientras dure el archivo de audio.

37

Consejo: S i quieres tener msica de fondo escuch


ndose en tu aplicacin, inserta el
siguiente cdigo dentro del evento On S how de la primer p
gina (as cargar
s la msica
de fondo dentro de un canal diferente del que utiliza la msica superpuesta):
Audio.Load(CH ANNEL_BACK GR OU ND
, "AutoP lay\\Audio\\background.ogg, true,
true);
Audio.S etV olume(CH ANNEL_BACK GR OU ND
, (255 * 0.25)); --sets the volume to
25%

Hacer una Aplicacin Bsica 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 cdigo 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= "D
os",A3= "Cuatro",ACorrect= "T res"};
Q _02 = {Q uestion= "Cu
ntas patas tiene un gato de una pata?",A1 = "T res",
A2= "D
os",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 botn.
4. En el evento On P reload de la P
gina 1 ,inserta el cdigo siguiente:
P aragraph.S etT ext("P aragraph2",Q _01 .Q uestion);
Button.S etT ext("Button1 ",Q _01 .A2);
Button.S etT ext("Button2",Q _01 .A1 );
Button.S etT ext("Button3",Q _01 .ACorrect);
Button.S etT ext("Button4",Q _01 .A3);
5. Inserta el siguiente cdigo dentro del evento On Click del Botn 1 :
Correct.Q 1 = "Incorrecta";
P age.Navigate(P AGE_NEXT );
6. Inserta el siguiente cdigo dentro del evento On Click del Botn 2:
Correct.Q 1 = "Incorrecta";
P age.Navigate(P AGE_NEXT );
7. Inserta el siguiente cdigo dentro del evento On Click del Botn 3:
Correct.Q 1 = "Correcta";
P age.Navigate(P AGE_NEXT );

38

8. Inserta el siguiente cdigo dentro del evento On Click del Botn 4:


Correct.Q 1 = "Incorrecta";
P age.Navigate(P AGE_NEXT );
9. En la P
gina 2,crea un objeto de p
rrafo,y 4 objetos de botn.
1 0.En el evento On P reload de la P
gina 2,inserta el cdigo siguiente:
P aragraph.S etT ext("P aragraph2",Q _02.Q uestion);
Button.S etT ext("Button1 ",Q _02.A3);
Button.S etT ext("Button2",Q _02.A2);
Button.S etT ext("Button3",Q _02.A1 );
Button.S etT ext("Button4",Q _02.ACorrect);
1 1 .Inserta el siguiente cdigo dentro del evento On Click del Botn 1 :
Correct.Q 2 = "Incorrecta";
P age.Navigate(P AGE_NEXT );
1 2.Inserta el siguiente cdigo dentro del evento On Click del Botn 2:
Correct.Q 2 = "Incorrecta";
P age.Navigate(P AGE_NEXT );
1 3.Inserta el siguiente cdigo dentro del evento On Click del Botn 3:
Correct.Q 2 = "Incorrecta";
P age.Navigate(P AGE_NEXT );
1 4.Inserta el siguiente cdigo dentro del evento On Click del Botn 4:
Correct.Q 2 = "Correcta";
P age.Navigate(P AGE_NEXT );
1 5.Crea un objeto de p
rrafo en la ltima p
gina de tu proyecto.
1 6.Inserta el siguiente cdigo dentro del evento On P reload 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
P aragraph.S etT ext("P aragraph2",
"P regunta 1 : "..Correct.Q 1 .."\r\n"..

39

"P regunta 2: "..Correct.Q 2 .."\r\n"..


"R espondiste correctamente "..correct .."de "..possible .."posibles preguntas para
una calificacin de "..((correct/possible)*1 00).."% ."
);

Hacer una Imagen Semi-Transparente


En AutoP lay M edia S tudio es posible hacer que un objeto de Imagen sea translcido o
"transparente". Esto se logra bajando el valor configurado de la Opacidad (Opacity)en
el panel P ropiedades
1 . Crea un objeto de Imagen.
2. En el panel P ropiedades, cambia la configuracin de opacidad a la opacidad
deseada.

Nota: El nmero 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 Pgina


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.D
e modo que si cambias el fondo de la p
gina 1 , los fondos de las p
ginas 2 y 3
como consecuencia cambiar
n.
P ara lograr esto en AutoP lay M edia S tudio:
1 . Crea un proyecto con tres p
ginas.
2. Aade un fondo a la P
gina 1 (un color slido,un gradiente o una imagen).
Note: La P
gina 1 puede tener un color slido,un gradiente o una imagen como fondo.
3. V e a la P
gina 2.

40

4. En el panel P ropiedades, cambia la propiedad Inherit Background de P age2 a


P age1 .

5. Ahora ve a la P
gina 3.
6. En el panel P ropiedades, cambia la propiedad Inherit Background de P age3 a
P age1 .

Nota: T ambin puedes heredar objetos desde una p


gina en tu proyecto. P ara heredar
todos los objetos de la P
gina 1 , fija la categora Inherit Objects del P anel P ropiedades
(en tu p
gina deseada)a la P age1 .

41

Imprimir un Archivo
P ara imprimir un archivo desde tu aplicacin,utiliza la accin r
pida P rint D
ocument.
H az click en el botn Browse del campo D
ocument to print para seleccionar el
archivo a imprimir.
Nota: Esta accin 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


AutoP lay M edia S tudio incluye un objeto web para desplegar un sitio web dentro de tu
aplicacin.P ara aadir un sitio web a tu proyecto:
1 . Elije Object > W eb.
2. En el di
logo New W eb Object, introduce la direccin web deseada en la
configuracin 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 an ser capaz de cambiar sus propiedades y editar sus
acciones.Esto es conocido como apuntalarun objeto a la p
gina.
P ara apuntalar un objeto:
1 . S elecciona el objeto deseado.

42

2. H az click derecho sobre el objeto.


3. Elige P in.
Esto harque el objeto quede inmvil y no puedas desplazarlo a ninguna parte de la
p
gina. Aunque el objeto est apuntalado, an puedes editar sus propiedades haciendo
doble click sobre l.
T en bien claro que no es lo mismo Apuntalar (P in)que Bloquear (Lock).
P ara desapuntalar un objeto:
1 . S elecciona el objeto deseado.
2. H az click derecho sobre el objeto.
3. D
eshabilita P in.

Interactuar con Objetos Flash Incrustados


AutoP lay M edia S tudio es capaz de colectar FS _Commands de una pelcula Flash
incrustada. R ecibir
s el FS _Command, y luego completar
s una accin basada en este
comando,utilizando una declaracin if.
P or favor dirgete a la seccin Interactuar con objetos web incrustados para ver un
simple ejemplo de navegacin de tu proyecto basado en una entrada desde una fuente
externa.

Interactuar con Objetos Web Incrustados


In AutoP lay M edia S tudio, es posible navegar de tu proyecto usando un archivo H T M L
incrustado.
P or ejemplo, asumamos que quieres tener el siguiente archivo H T M L en un objeto web
(nombremos al archivo index.html):
<html>
<body>
<a href= "#P age2">Go to P age 2</a>
</body>
</html>
1 . Crea un objeto web en la p
gina de la aplicacin que cargue index.html.
Nmbralo "W eb1 ".
2. Inserta el siguiente script en el evento On P reload de la p
gina:
W eb.LoadU R L("W eb1 ","AutoP lay\\D
ocs\\index.html");

43

Las lneas anteriores redireccionan el objeto web llamado W eb1 hacia


AutoP lay\D
ocs\index.html. Esto es necesario debido a que la U R L en un objeto web
insistira travs de las p
ginas, y el evento On Navigate es llamado cuando el objeto
web se hace presente en la p
gina despus 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 an tendrla U R L
#P age2 en l, y nuestro script en el evento On Navigate (ver abajo) harque la
aplicacin 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 smbolo de nmero (#)
nP os = S tring.R everseFind(e_U R L,"#",true);
-- se encontralgn #?
if nP os then
-- obtener todo a la derecha del #
strP age = S tring.M id(e_U R L,nP os + 1 ,-1 );
--[[ saltar al nombre de la p
gina que extrajimos de
la U R L.S i no hay p
gina con ese nombre,
el P age.Jump no harnada.]]
P age.Jump(strP age);
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 accin S tring.R everseFind busca el smbolo # y, si lo encuentra, una accin
S tring.M id captura todo a la derecha del smbolo # en la cadena.La cadena resultante es
almacenada en una variable y luego es usada como el objetivo de una accin
P age.Jump.
Nota: Cuando el usuario clickea sobre el enlace '
Go to P age 2'en nuestro archivo de
ejemplo H T M L,la aplicacin saltara P age2.

Leer Lneas Especficas de un Archivo de Texto


P ara recuperar lneas especficas de un archivo de texto en AutoP lay M edia S tudio, usa
la accin R eadT oT able.
Como ejemplo, leeremos el archivo C:\test.txt dentro de una tabla variable, luego
devolveremos de la lnea 4 a la 1 0 en un objeto de p
rrafo
1 . Inserta el siguiente cdigo dentro de algn evento en tu aplicacin:
-- Fija el inicio y el fin de los nmeros de lneas 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 nmero de lnea actual
line = beginning_line;
-- Orbita a travs de la tabla hasta que la condicin endsea 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
-- S alida para el usuario
P aragraph.S etT ext("P aragraph1 ",strLinesOfT ext);

Mandar un E-mail con Asunto, Cuerpo y Archivo


Adjunto
P ara mandar un E-mail con varios campos llenos, utiliza la accin File.OpenEmail. Lo
siguiente
puede
ser
llenado
en:
T o,Cc,Bcc,S ubject,Body.
1 . P ara mandar un E-mail con las siguientes propiedades:
T o: user@ yourdomain.com
Cc: user2@ yourdomain.com
Bcc: user3@ yourdomain.com
S ubject: T u asunto aqu
Body: Lo que quieras como cuerpo del E-mail aqu
U tiliza la siguiente accin:
File.OpenEmail("user@ yourdomain.com?CC= user2@ yourdomain.com&BCC= user3@
yourdomain.com&S ubject= Y our subject here&Body= W hatever you want as your email
body here",S W _S H OW NOR M AL);
Nota: P ara 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
implementacin avanzada de la accin File.OpenEmail. Indigo R ose no puede ayudarte
con detalles de implementacin. D
ebes 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 diseo de AutoP lay, es posible mantener la proporcin dimensional
(proporcin entre anchura y altura)de tus objetos al redimensionarlos. Esto es til, por
ejemplo, cuando deseas cambiar de tamao un objeto de imagen pero no quieres que la
imagen parezca distorsionada.
P ara mantener la proporcin dimensional de cualquier objeto en el ambiente de diseo
de AutoP lay:
1 . S elecciona 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 K eep Aspect.
Nota: S i K eep Aspect tiene una marca de verificacin junto a l, entonces la opcin ya
estaba habilitada.
Nota: S i bien una etiqueta de men de click derecho del objeto tiene la opcin K eep
Aspect, estpermanentemente establecida para mantener su proporcin dimensional.
No es posible apagar esta opcin.
P ara mantener temporalmente la proporcin dimensional de un objeto, deja presionadas
las teclas Ctrl y S hift mientras redimensionas el objeto. El mantener temporalmente la
proporcin dimensional de un objeto slo aplica al redimensionamiento de un objeto
con el ratn, el cambio de las dimensiones en el panel P ropiedades con las teclas Ctrl y
S hift presionadas no mantendrla proporcin dimensional.

Mantener mi Aplicacin Siempre ms Arriba


Autoplay M edia S tudio tiene una opcin integrada para hacer que la ventana de tu
aplicacin siempre est m
s arriba que todas en el sistema del usuario. P ara lograr esto,
elige la opcin en el cuadro de di
logo P roject S ettings:
1 . Elige el men P roject > S ettings.
2. H abilita la opcin Always On T op.
3. H az click en OK .

Mostrar una Imagen en Splah


P ara desplegar una imagen en splash utilizando AutoP lay M edia S tudio:

46

1 . Inserta el siguiente cdigo dentro de cualquier evento en tu aplicacin:


D
ialog.S plashImage("AutoP lay\\Images\\splash.jpg",5,false);
Nota: Obviamente, primero deber
s cargar la imagen en la carpeta Images de
AutoP lay.
Consejo: P ara desplegar la imagen en splash antes de que tu aplicacin se cargue,
inserta el cdigo de arriba dentro del evento On S tartup de las Acciones del P royecto
(M en P rojectActions).

Obtener la Informacin del Usuario Registrado de la


Computadora
P ara detectar el usuario registrado del sistema,en AutoP lay M edia S tudio:
1 . Inserta el siguiente script en el evento On S tartup de tu proyecto:
user = S ystem.GetU serInfo();
Nota: El usuario es una variable de tabla. P ara mostrar esta informacin en una p
gina
de tu aplicacin,establece referencias para:
user.R egOwner el propietario registrado de la computadora
user.R egOrganization la organizacin registrada

Obtener la Ruta de una Carpeta del Sistema


AutoP lay M edia S tudio incluye una accin para obtener las trayectorias de varias
carpetas en tu computadora.P ara lograr esto,utiliza la accin S hell.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 cdigo dentro de un evento en tu programa:
path_to_desktop = S hell.GetFolder(S H F_D
ES K T OP );

Ocultar la Barra de Ttulo


P ara ocultar la Barra de T tulo de la aplicacin AutoP lay:

47

1 . V e al men P roject > S ettings.


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: P or el usuario en
tiempo de ejecucin,o por ti mismo en tiempo de diseo.
Ocultar un objeto en tiempo de ejecucin es til si no quieres que el usuario vea un
objeto en el inicio de la aplicacin. Es posible que desees mostrar el objeto m
s tarde
basado en una accin del usuario
Como un ejemplo,ocultaremos un objeto de botn (Button1 )en tiempo de ejecucin:
1 . Inserta el siguiente cdigo dentro del evento On S how de tu p
gina:
Button.S etV isible("Button1 ",false);
Consejo: P ara mostrar el objeto de botn, inserta el siguiente cdigo dentro de un
evento en tu aplicacin
Button.S etV isible("Button1 ",true);
Ocultar un objeto en tiempo de diseo es til cuando, por ejemplo, est
s trabajando en
un proyecto con muchos objetos,y deseas reducir el desorden.
P ara ocultar un objeto en tiempo de diseo:
1 . S elecciona el objeto deseado.
2. En el P anel P ropiedades,cambia el atributo V isible a false.
Consejo: P ara mostrar un objeto en el tiempo de diseo que estactualmente oculto,
cambia el atributo V isible a true.

Ocultar una Aplicacin en Tiempo de Ejecucin


AutoP lay M edia S tudio te permite crear una aplicacin que corra en el fondo (es decir,
que no es visible al usuario en la barra de tareas o en la bandeja del sistema). P ara
habilitar esta opcin:
1. D
irgete al men P roject > S ettings.
2. S elecciona la opcin H idden.
3. H az click en OK .

48

Consejo: P ara que realmente est oculta la ventana de la aplicacin, utiliza una accin
W indow.H ide

Pausar la Msica de Fondo


Cuando hay msica de fondo en una presentacin, algunas veces es necesario pausarla.
En AutoP lay M edia S tudio esto se logra usando la Accin R
pida P lay/P ause
Background M usic.
Esta accin r
pida pausarla msica de fondo si se estreproduciendo,y la reproducir
si esten pausa.
R ecuerda crear antes un botn y asignarle esta accin r
pida.

Recordar Preferencias de Tiempo de Ejecucin


A manera de ejemplo, asumamos que tu aplicacin pregunta al usuario si los videos
deberan estar visibles en la aplicacin. P ero solamente quieres preguntarle al usuario la
primera vez que corra el programa. En cada lanzamiento subsecuente de tu aplicacin,
deseas mostrar/ocultar el objeto de V ideo basado en la preferencia inicial del usuario.
P ara lograr esto en AutoP lay M edia S tudio:
1 . Inserta el siguiente cdigo dentro del evento On P reload de la p
gina que
contiene el objeto de V ideo:
visible = Application.LoadV alue("Application","V ideo");
if visible = = ""then
visible = D
ialog.M essage("V ideos visibles","Q uieres que los videos estn visibles?",
M B_Y ES NO);
Application.S aveV alue("Application","V ideo",visible);
end
if S tring.T oNumber(visible)= = 7 then
V ideo.S etV isible("V ideo1 ",false);
end
Nota: Este script no le da al usuario una segunda eleccin. U na vez que l elija yes/no,
esa eleccin serpermanente. S i quisieras ofrecer al usuario una segunda eleccin, o la
opcin para cambiar la configuracin m
s tarde,incluye el siguiente cdigo en el evento
On Click de un objeto de Botn:
visible = D
ialog.M essage("V ideos visibles","Q uieres que los V ideos estn visibles la
prxima vez que ejecutes el programa?",M B_Y ES NO);
Application.S aveV alue("Application","V ideo",visible);

49

Redondear un Nmero hacia Abajo


AutoP lay M edia S tudio incluye una accin incorporada para redondear cualquier
nmero hacia abajo del prximo nmero entero. P ara lograr esto, utiliza la accin
M ath.Floor.
your_number = 3.1 41 5;
your_rounded_number = M ath.Floor(your_number);
Nota: Este script ajustarla variable your_rounded_number a 3.

Redondear un Nmero hacia Arriba


AutoP lay M edia S tudio incluye una accin incorporada para redondear cualquier
nmero hacia arriba del prximo nmero entero.P ara lograr esto,utiliza la accin M ath.
your_number = 3.1 41 5;
your_rounded_number = M ath.Ceil(your_number);
Nota: Este script ajustarla variable your_rounded_number a 4.

Redondear un Nmero 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 M ath.Ceil.(V e Redondear un Nmero hacia Arriba).
S i quieres que todas las fracciones se redondeen hacia abajo (por ejemplo 2.1 -> 2.0,
2.5 -> 2.0)entonces utiliza M ath.Floor.(V e Redondear un Nmero hacia Abajo).
S i quieres que cualquier decimal igual o mayor que .5se redonde hacia arriba,y
cualquier decimal menor a .5se redonde hacia abajo (por ejemplo 2.1 -> 2.0,
2.5 -> 3.0),utiliza la siguiente accin:
n = 2.5;
rounded = M ath.R ound(n);

Referir Informacin a un Sitio Web


AutoP lay M edia S tudio tiene una funcin incorporada para mandar datos a un sitio web
y recibir una respuesta:

H T T P .S ubmit

50

P ara referir informacin a un sitio web,utiliza la accin H T T P .S ubmit.P or favor ten en


cuenta que tienes que desarrollar un script servidor para aceptar cualquier dato que ests
mandando a la web.
H T T P .S ubmit toma la respuesta de tu script servidor y la almacena en una cadena.
U na posible implementacin de esto sera lo siguiente:
1. D
esarrolla un script que pueda aceptar cualquier dato que desees pasarlo desde
AutoP lay,y regresa algn valor.
2. U sa la accin H T T P .S ubmit para referir tus datos a tu script (localizado en tu
servidor web).
3. P rocesa la cadena devuelta.
Nota: Esta es una muy compleja implementacin de AutoP lay M edia S tudio. T endr
s
que coordinarte con el desarrollador de tu sitio web para decidir sobre un plan de
implementacin.

Reiniciar el Sistema
P ara reiniciar el sistema del usuario desde tu aplicacin:
1 . Inserta la siguiente accin dentro de un evento en tu aplicacin:
S ystem.R eboot();
Nota: Esta accin reinicia la m
quina sin interaccin requerida por el usuario y sin dar
ninguna advertencia.

Repetir Cosas en Intervalos Especficos


Cuando hay una accin que debera repetirse en un intervalo predeterminado, utiliza un
evento On T imer en AutoP lay M edia S tudio:
1.
2.
3.
4.

H az doble click en la p
gina en uso.
Elige la pestaa S cript.
H az click en la pestaa del evento On T imer.
Aade aqu tu accin.

P ara comenzar ejecutando las acciones en el evento On T imer, utiliza la siguiente


accin:
P age.S tartT imer(5000) --lanza las acciones On T imer cada 5 segundos

51

Esta accin es ejecutada tpicamente ya sea por el evento On Click de un objeto,o como
una accin en el evento On S how de la p
gina
Nota: La accin P age.S tartT imer slo tiene que ser ejecutada una vez para iniciar el
cronmetro. Las acciones en el evento On T imer continuar
n siendo ejecutadas hasta
que la accin S topT imer sea llamada.
Consejo: P ara detener la accin de encendido del cronmetro, utiliza la accin
P age.S topT imer();

Reproducir Mltiples Archivos de Audio en Secuencia


En AutoP lay M edia S tudio es posible reproducir un archivo de audio despus de otro
usando el evento On Audio.
A manera de ejemplo, crearemos un proyecto que al ser ejecutado cargartres archivos
en una tabla y los reproduciruno tras otro hasta que la tercera cancin haya finalizado.
P ara lograr esto:
1 . Inserta el siguiente cdigo dentro de tus Funciones Globales (haciendo click en
P roject > 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 cdigo dentro del evento On S how de tu p
gina:
Audio.Load(CH ANNEL_U S ER 1 ,audio[audio_count],true,false);

3. Inserta el siguiente cdigo 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(CH ANNEL_U S ER 1 ,audio[audio_count],true,false);
end
end

52

Reproducir Mltiples Archivos de Video en Secuencia


En AutoP lay M edia S tudio es posible reproducir un video tras otro utilizando el evento
On Finish.
Como ejemplo,crearemos un proyecto con un objeto de Botn y un objeto de V ideo.El
usuario harclick en el botn y se cargar
n mltiples videos dentro de una tabla. El
proyecto entonces reproducirun video tras otro hasta que todos los videos hayan sido
reproducidos.
P ara lograr esto:
1 . Inserta el siguiente cdigo dentro de las Funciones Globales (haciendo click en
project > functions):
--ndice de tabla comienza en 1
video_count = 1 ;
2. Inserta el siguiente cdigo en el evento On Click del botn previamente creado:
video = D
ialog.FileBrowse(true,"Load V ideos","","","","",true,true);
V ideo.Load("V ideo1 ",video[video_count],true,false);
3. Inserta el siguiente cdigo dentro del evento On Finish del objeto de V ideo
previamente creado:
--Atraviesa la tabla
video_count = video_count + 1 ;
--S e asegura que un archivo v
lido sercargado
if video_count < T able.Count[video]+ 1 then
--carga el archivo
V ideo.Load("V ideo1 ",video[video_count],true,false);
end

Reproducir Msica de Fondo


R eproducir una msica suave de fondo en tu aplicacin puede servir para establecer un
estado de
nimo deseado para tu aplicacin
A manera de ejemplo, cargaremos un archivo de msica (que tenga extensin .ogg)en
el canal de audio de fondo de tu proyecto:
1 . Inserta el siguiente cdigo dentro del evento On S how de la primer p
gina del
proyecto:

53

--carga un archivo *.ogg en el canal de fondo,autom


ticamente lo reproduce,y lo hace
cclico
Audio.Load(CH ANNEL_BACK GR OU ND
,"AutoP lay\\Audio\\background.ogg",true,
true);
Nota: P ara reproducir una cancin despus de otra en tu msica de fondo, por favor
dirgete al tema Reproducir Mltiples Archivos de Audio en Secuencia.
Nota 2: R ecuerda que debes aadir el archivo de la msica de fondo a la carpeta Audio
de AutoP lay.Es decir,no solamente lo aadas en el S cript.
U na forma alternativa de aadir msica de fondo a tu aplicacin es usando la pestaa
Background M usic del cuadro de di
logo Audio S ettings. P ara acceder a este cuadro de
di
logo:
1.
2.
3.
4.

Elige P roject > Audio.


H az click en el botn Add.
S elecciona tu archivo de audio.
H az click en OK .

Nota: R epite los pasos 2 y 3 antes de hacer click en OK para aadir m


s de un archivo
de audio.

Reproducir un Archivo de Video AVI


AutoP lay M edia S tudio incluye un objeto de V ideo capaz de reproducir cualquier
archivo de pelcula que sea soportado por W indows M edia P layer.
P ara reproducir un archivo AV I en AutoP lay M edia S tudio, crea un objeto de V ideo en
la p
gina deseada:
1 . Elige Object > V ideo.
2. S elecciona un archivo AV I.
3. H az click en OK .
Nota: S i tu archivo AV I contiene codecs no estandarizados, por favor asegrate de
incluirlos con tu proyecto, as tus usuarios no experimentar
n ningn problema al
reproducir dicho archivo.

Reproducir un Video antes de que mi Aplicacin Inicie


AutoP lay M edia S tudio tiene una opcin para aadir un video introductorio a tu
presentacin.
P ara lograr esto:

54

1.
2.
3.
4.

Elige en el men P roject > S tartup M ovie.


H abilita la opcin P lay S tartup M ovie.
Agrega tu archivo de pelcula y configura los ajustes del proyecto.
H az click en OK .

Nota: S i deshabilitas la opcin Allow Click to S kip, la pelcula permanecervisible


hasta que se complete. S i esta opcin es habilitada, el usuario puede hacer click en tu
pelcula introductoria para detenerla e ir directamente a la aplicacin.

Reproducir un Video Utilizando el Modo Full Screen


AutoP lay M edia S tudio incluye una accin para reproducir un video en modo full
screen.
P ara lograr esto:
1 . Agrega el siguiente cdigo al evento On P lay de tu objeto de V ideo:
V ideo.S etFullS creen("V ideo1 ",true);
2. Agrega el siguiente cdigo 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
aplicacin.
Nota: Algunas veces al iniciar la aplicacin, el video no se mostraren Full S creen.
P ara lograr que se muestre en Full S creen,p
usalo y luego reincialo.

Reproducir un Video usando el Objeto de Video


Incrustado
AutoP lay M edia S tudio 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 P layer
(avi,mpg,wmv,etc).
P ara crear un objeto de V ideo:
1 . V e al men Object > V ideo.
2. S elecciona tu archivo de video.
3. H az click en OK .

55

Nota: Algunos codecs no son descargados autom


ticamente por W indows M edia
P layer. S i tu archivo de video utiliza un codec especializado, por favor asegrate
incluirlo con tu distribucin.

Reproducir una Animacin Flash


AutoP lay M edia S tudio incluye un objeto Flash incorporado para agregar archivos Flash
en tu Aplicacin
P ara lograr esto:
1 . Elige el men Object > Flash.
2. S elecciona tu pelcula Flash.
3. H az click en OK .
Nota: Los objetos Flash de AutoP lay hacen que se utilice el plugin M acromedia Flash
(que se puede descargar gratuitamente de www.macromedia.com). P uedes configurar tu
aplicacin para que detecte autom
ticamente Flash en la computadora del usuario y
requerir que una versin especfica o m
s reciente sea instalada (ver el tema Revisar en
Busca de Macromedia Flash).

Responder a Teclas Presionadas


En AutoP lay M edia S tudio existe un evento llamado On K ey. Este evento es lanzado
cuando una tecla es presionada. Esto es til si quieres que tu aplicacin, 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 especfica es
presionada. Como un de ejemplo, considera el Explorador de Internet. U n usuario
introduce una U R L dentro de una barra de direccin y cuando la tecla enter es
presionada,la p
gina que l requiries cargada.
P ara lograr este ejemplo en AutoP lay M edia S tudio:
1 . Crea un objeto input.En su evento On K ey,ingresa el siguiente cdigo:
-- e_K ey es una variable incorporada que obtiene lo generado por el evento On K ey.
-- 1 3 es el valor del cdigo de tecla virtual para la tecla [Enter].
if e_K ey = = 1 3 then
-- Carga la direccin que fue ingresada por el usuario:
W eb.LoadU R L("W eb1 ",Input.GetT ext("Input1 "));
end

56

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 Tamao Original


En el ambiente de diseo de AutoP lay, es posible restaurar un objeto a su tamao
original despus de que ste ha sido modificado. Esto es til cuando quieres, por
ejemplo, reanudar el tamao de un objeto de Imagen a las dimensiones originales del
archivo de imagen.
P ara restaurar el tamao original de un objeto:
1 . S elecciona 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 S ize.
Nota: Esto es tambin 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 S tudio tiene una opcin para buscar dependencias en tiempo de
ejecucin en el sistema del usuario, y opcionalmente puede requerir que las
dependencias existan antes de que el programa pueda continuar. P ara buscar Internet
Explorer:
1 . V e al menu P roject > D
ependencies.
2. S elecciona las dependencias que tu proyecto requiere (en este caso Internet
Explorer).
3. H az click en OK .

Revisar en Busca de Macromedia Flash


AutoP lay M edia S tudio tiene una opcin para buscar varias dependencias en tiempo de
ejecucin en el sistema del usuario, y opcionalmente puede requerir que las
dependencias existan antes de que el programa pueda continuar. P ara buscar
M acromedia Flash:
1 . V e al menu P roject > D
ependencies.

57

2. S elecciona las dependencias que tu proyecto requiere (en este caso M acromedia
Flash).
3. H az click en OK .

Solicitar al Usuario Confirmacin antes de Salir


En AutoP lay M edia S tudio es posible detener el cierre de tu aplicacin basado en una
accin del usuario, incluso despus de que el botn cerrar ha sido presionado, o la
accin Application.Exit ha sido usada. Esto es til si, por ejemplo, te preocupa que el
usuario accidentalmente cierre tu aplicacin, o si quieres permitir que el usuario guarde
sus cambios antes de salir.
P ara lograr esto, debes incluir una funcin (Q ueryAllowP rojectClose)en tus Funciones
Globales (P roject > Global Functions) que devuelva un true si el programa debiera
cerrarse,o un falsesi no lo tenga que hacer:
function Q ueryAllowP rojectClose() --esta funcin serllamada cuando el programa se
est cerrando
confirmation = D
ialog.M essage("Est
s S eguro?","Est
s seguro que quieres salir?",
M B_Y ES NO,M B_ICONEXCLAM AT ION,M B_D
EFBU T T ON1 );
if confirmation = = 6 then
-- El botn Y ES fue presionado,permitiendo cerrar el programa (devuelve un
true)
return true;
else
-- El botn Y ES no fue presionado,evitando cerrar el programa (devuelve un
false)
return false;
end
end
Nota: Esta funcin es llamada internamente por tu aplicacin cuando se le pide salir.S i
true es devuelto, tu aplicacin se cerrar
. S i false es devuelto, tu programa no se
cerrar
.
P ara usar esta funcin,deberas usar un script similar a ste:
if Q ueryAllowP rojectClose()then
Application.Exit();
end

58

Trabajar con Tablas y Archivos


En AutoP lay M edia S tudio, las tablas son frecuentemente utilizadas cuando se trabaja
con archivos. Especficamente, observaremos cmo son almacenados en una tabla los
resultados de una accin D
ialog.FileBrowse, y cmo 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 accin
D
ialog.FileBrowse almacena una ruta de archivo por fila en una tabla.Cuando se lee un
archivo de texto dentro de una tabla, cada lnea en el archivo de texto es una fila
separada en la tabla.

Ejemplo 1
U sando la accin D
ialog.FileBrowse, permitiremos al usuario explorar una carpeta y
seleccionar mltiples archivos.Abriremos cada archivo con su aplicacin por defecto:
-- P resenta al usuario un di
logo explorador de archivos (con el ajuste de seleccin
mltiple a true)
tFiles = D
ialog.FileBrowse(true,"M ultiple S elect","","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 presioncancelar,viaja a travs de la tabla de archivos.
for nIndex,sFile in tFiles do
-- Abre el archivo con el programa por defecto.
File.Open(sFile,"",S W _S H OW NOR M AL);
end
end
end
En el ejemplo anterior,la accin D
ialog.FileBrowse regresa una tabla conteniendo todos
los archivos que fueron seleccionados. S i el botn 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 lnea dos es la mejor de todas!!" dentro de la
segunda lnea del archivo de texto:
-- P resenta al usuario un di
logo explorador de archivos (con el ajuste de seleccin
multiple a false)
tFiles = D
ialog.FileBrowse(true,"S ingle S elect","","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 presioncancelar,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 lnea (fila)dos
T able.Insert(tT extFileContents,2,"La lnea dos es la mejor de todas!!");
-- Escribe la tabla alterada de regreso en el archivo de texto seleccionado (es decir,
agregarla frase "La lnea dos es la mejor de todas!!"en el segundo rengln del
archivo de texto seleccionado)
T extFile.W riteFromT able(tFiles[1 ],tT extFileContents,false);
end
end

Utilizar el Dilogo de Estado


En AutoP lay M edia S tudio es posible desplegar un di
logo de estado a tus usuarios
utilizando acciones incorporadas. Esto es til, por ejemplo, si tu aplicacin 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 Botn,y aade el siguiente cdigo en su evento On Click:
--ajusta los valores mnimo y m
ximo
minimum_value = 0;
maximum_value = 20000;
--configuracin de la ventana del estado de di
logo
S tatusD
lg.S how();--muestra la ventana del estado de di
logo
S tatusD
lg.S etT itle("Contando de "..minimum_value .."a "..maximum_value); -ajusta el ttulo
S tatusD
lg.S etM 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
S tatusD
lg.S etM eterP os(loop_control);--ajusta la posicin del contador a la variable

60

de control bucle
S tatusD
lg.S etS tatusT ext("Actualmente contando ...("..loop_control .."of "..
maximum_value ..")"); --ajusta el estado del texto para reflejar el nmero actual
loop_control = loop_control + 1 ;--incrementa la variable de control bucle
end
Nota: El cdigo anterior cuando es ejecutado contarhasta 20,000 y desplegarun
di
logo de estado mostrando el progreso del bucle.

Utilizar Eventos Timer


Cuando hay una accin que debera repetirse en un intervalo predeterminado, utiliza un
evento On T imer en AutoP lay M edia S tudio
1.
2.
3.
4.

H az doble click en la superficie de la p


gina.
Elige la pestaa S cript.
H az click en la pestaa del evento On T imer.
Aade tu accin aqu.

P ara que inicie la ejecucin de las acciones en el evento On T imer, utiliza la siguiente
accin
P age.S tartT imer(5000)-- lanza las acciones On T imer una vez cada 5 segundos
Esta accin es normalmente ejecutada ya sea por el evento On Click de un objeto, o
como una accin en el evento On S how de la p
gina.
Nota: La accin P age.S tartT 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
accin S topT imer sea llamada.
Nota 2: P ara detener la accin timer desde su inicio,utiliza la accin P age.S topT imer();

Utilizar un FSCommand para Provocar una Accin


En AutoP lay M edia S tudio es posible provocar una accin usando un FS Command
flash. Esto es til si, por ejemplo, quieres que tu aplicacin haga algo especfico al final
de tu animacin flash.
Como un ejemplo, crearemos una animacin flash en S wish (programa para hacer
animaciones Flash sin el Flash, muy sencillo y f
cil de usar) que mande un
FS Command cuando sta finalice de reproducirse. Cuando la animacin flash llegue al
final de su reproduccin,desplegaremos un mensaje de di
logo.
En S wish:

61

1 . En S wish, haz click derecho en el ltimo fotograma de la animacin y elige


FS Command del M en Contextual. En el panel Action, ver
s el FS Command
aadido.
2. H az click en '
FS Command'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: S plashFinished.
4. Guarda la animacin como un archivo swf.

En AutoP lay M edia S tudio:


1 . Crea un objeto flash y carga el archivo swf que creaste en S wish.
2. Aade las siguientes acciones en el evento On FS Command (en la pestaa
script):
if (e_FS Command = = "S plashFinished")then
D
ialog.M essage("T u T tulo Aqu","T u M ensaje Aqu");
end
Nota: e_FS Command es una variable incorporada conteniendo el ltimo FS Command
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) slo si
no hay otro autorun.exe corriendo en el sistema. P ara lograr esto, utiliza la accin
W indow.EnumerateP rocesses y coteja en cada proceso el nombre de archivo
autorun.exe.
1 .Inserta el siguiente cdigo en el evento On S how de tu p
gina:
-- Inicializar variables
instances_of_file = 0;
file_to_check_for = "autorun.exe";--poner todo en minsculas
processes = W indow.EnumerateP rocesses();
-- Ir directamente a la tabla de proceso
for j,file_path in processes do
-- D
ivide la ruta para obtener el nombre del archivo
file = S tring.S plitP ath(file_path);
-- compara el nombre del archivo con el archivo especificado en la variable de
inicializacin
if (S tring.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 aplicacin,muestre
el error,y cirrelo.
W indow.H ide(Application.GetW ndH andle());
D
ialog.M essage("Error","Another instance of Autorun.exe is already open.");
W indow.Close(Application.GetW ndH andle(),CLOS EW ND
_T ER M INAT E);
end

Volver a Cargar los Objetos de Imagen en Tiempo de


Ejecucin
P ara cargar una imagen dentro de un objeto de Imagen en tiempo de ejecucin,utiliza la
accin Image.Load.
Como ejemplo, cargaremos la imagen ejemplo.jpg (desde el directorio de Im
genes de
la carpeta de distribucin del proyecto)dentro del objeto de Imagen Image1 :
Image.Load("Image1 ","AutoP lay\\Images\\ejemplo.jpg");
Nota: P ara cargar esta imagen en tiempo de ejecucin,introduce el cdigo anterior en el
evento On S how de la p
gina que contiene tu objeto de Imagen.

63