Global y Event Variables Autoplay Media Studio v7.0 Manual

Global y Event Variables
Autoplay Media Studio v7.0 Manual
Autoplay Media Studio viene provisto de variables automatizadas, que se usan para representar
valores comunes del sistemas, como la ubicación de la carpeta temp del usuario (_ TempFolder) o
la ruta a Archivos de Programa (_ ProgramFilesFolder).
Hay dos tipos de variables incorporadas:
Las variables globales”Global variables” que pueden ser usadas en cualquier parte de su proyecto.
Las variables de evento “Event variables” que son locales para los acontecimientos. (Sus valores
están sólo disponibles para la duración de ese acontecimiento.)
Aviso: A menudo las variables son utilizadas como parte de una ruta llena donde usted necesita
ensamblar dos Strings. Por ejemplo, usted puede necesitar una ruta que consistente en la carpeta de
Archivos de Programa del usuario y una carpeta de programa "ApplicationX”.Para hacer esto, usted
utilizaría un concatenación entre los strings que consiste en dos puntos (..). el script quedaria asi:
_ProgramFilesFolder .. "\\ApplicationX"
Usted también puede usar la acción String.Concat para concatenar dos strings.
Nota: Hay también una serie de acciones disponibles que pueden usarse para recoger información
acerca del sistema del usuario que no puede ser parte de la lista de variables incorporadas. Por
ejemplo, las rutas adicionales de las carpetas de usos comunes pueden ser leídas usando la acción
Shell.GetFolder. Hay también una categoría del Sistema de acciones para otra información del
sistema.
Para mayor información sobre las variables, vea la seccion de Variables en el Guía de Programacion
“Scripting Guide”.
Variable Globales (GlobalVariables)
Las variables globales (o "las variables incorporadas") son variables cuyos valores están
automáticamente colocados en el inicio de la aplicacion de AutoPlay. Se usan para representar
valores comunes que podrían diferir entre sistemas. Estas variables son totalmente globales de cuál
manera que usted las puede usar en cualquier parte de su proyecto.
Aviso: Las variables incorporadas se encuentran enumeradas junto con todas las acciones y las
constantes cuando usted presione Ctrl +Space en el editor del scripts. Todas las variables
incorporadas comienzan con una línea subrayada, si usted mecanografía _ y entonces la prensiona
Ctrl +Space, usted vera las primera variable incorporada de la lista.
Las siguientes variables globales están disponibles en AutoPlay Media Studio:
_AutoTabOrder
Esta variable es valida para los siguiente objetos: input, listbox, combobox, radiobutton, checkbox,
richtext and tree.Con esta variable puede establecer si quieres que la tecla tabulador funciona
estableciendo true o false en la eventos de la pagina On Key. Esta variables esta acivada por defecto
asi que su uso es para desactivar entre otras cosas. (ej. _AutoTabOrder = false)
_CommandLineArgs
Una tabla numéricamente indexada que contiene las discusiones de la línea de comando pasó en la
aplicación AutoPlay.
_DesktopFolder
Es la ruta del directorio del escritorio. En Windows NT/2000/XP/Vista o superior, esta ruta esta
definida por el pefil del usuario.
_DesktopFolderCommon
Es la ruta del directorio del escritorio. En Windows NT/2000/XP/Vista o superior, esta ruta esta
definida en el pefil de todos los usuarios.
_DoFlashCheck
Una variable Boolean solió controlar aunque AutoPlay Media Studio revisará en busca del control
Flash Player ActiveX en runtime. Si está colocado para verdadero (automáticamente establezca
cuándo contiene el proyecto un Instante el objeto), la comprobación será realizado. Si está colocado
para falso, no la comprobación será realizado. Si el cheque es realizado y el control no es
encontrado (a base del versión predeterminado 6.0.0.0), AutoPlay exhibirá un diálogo de
notificación. _DoFlashCheck puede ser incrustado en Funciones Globales.
_IR_ProductID
Esta variable contiene el producto ID del producto de que el escrito fue echado a andar. Esto le deja
identificar el producto siendo echado a andar de escrito. Esto podría ser útil al hacer escritos
genéricos que son usados en varios productos Indigo Rose, pero eso tiene cosas diferentes para
hacer a base del producto siendo de lo que se escapó. AutoPlay Media Studio 7 devuelve a
"AMS70".
_NoExitScriptOnPageJump
Si el set para escrito verdadero, de acción en un acontecimiento seguirá ejecutado tras un
Page.Jump o Page.Navigate que la acción se llama. Si el set para falso, la ejecución de la acción que
el escrito en ese momento detendrá tras un Page.Jump o Page.Navigate es llamado. Esta variable es
colocada falso por defecto.
_ProgramFilesFolder
Variable para aceder directamente en el directorio de programs files.
_ShowIntroVideo
Una variable Boolean usada para el control ya sea el video del intro será exhibida en runtime. Si
está colocada para verdadera (por defecto) y el proyecto tiene un intro videograba especificado, el
video del intro será mostrado. Si está colocado para falso, el video será saltado. Esta variable debe
ser determinada ya sea en Funciones Global, o en el acontecimiento de Arranque.
_SoundInitialized
Una variable Boolean que se colocó para verdadera si el motor en buen estado exitosamente
inicializa en runtime o falso si deja de operar. (El fracaso a inicializar es una ocurrencia muy rara.
Esta variable es hecha disponible para esas que pueden requerir esta retroalimentación rara.)
_SourceDrive
El driver donde se esta aplicando el autoplay (ej. "C:" o "D:").
_SourceFilename
Nombre del archivo de la aplicación de Autoplay (ej. “autorun.exe”)
_SourceFolder
La ruta completa para la carpeta que la aplicación AutoPlay fue ejecutada. (ej. "C:\Downloads" o
"D:").
_SystemFolder
La ruta del directorio de Windows System (ej. "C:\Windows\System" y "C:\Windows\System32").
_tblErrorMessages
Una Tabla indexada por el error le pone código a contener todo los posibles mensajes de error. Por
ejemplo, acceder al índice de la mesa tblErrorMessages[1000] accederá a la cuerda de código de
error "El archivo especificado no podría ser encontrado". El Application.GetLastError que la acción
se usa para recuperar el código de error de la por último acción realizada.
_TempFolder
La ruta del directorio Temporal “Temp”.
_WindowsFolder
La ruta del directorio de Windows (ej. "C:\Windows").
Variables Globales si usas GlobalPaths Action Plugin
(Global Variables if use GlobalPaths Action Plugin)
_ExeFolder
Carpeta donde esta el programa exe ejecutandose.
_AutoPlay
La ruta de la carpeta que contiene todos los programas, por defecto la ruta donde estan Audio
Buttons, Docs,etc.) Nota: El nombre de estas variables pueden ser cambiadas con la accion
GlobalPaths.SetDataFolder.
_Audio
La ruta de carpeta de Audio de programa.
_Buttons
La ruta de carpeta de Botones de programa.
_DLLs
La ruta de carpeta de DLLs de programa. . (Nota: esta carpeta no viene creada por defecto y tienes
que crearla manualmente para poder usar esta variable).
_Docs
La ruta de carpeta de Docs de programa.
_Flash
La ruta de carpeta de Flash de programa.
_Fonts
La ruta de carpeta de Fonts de programa.
_Icons
La ruta de carpeta de Icons de programa.
_Images
La ruta de carpeta de Imagenes de programa.
_Plugins
La ruta de carpeta de Plugins de programa.
_Scripts
La ruta de carpeta de Scripts de programa.
_Video
La ruta de carpeta de Video de programa.
EventVariables
Algunos acontecimientos en AutoPlay Media Studio contienen variables cuyos valores están
automáticamente colocados cada vez que ese acontecimiento se desencadena. Estas variables son
llamadas variables de acontecimiento. Las variables de acontecimiento son locales para el
acontecimiento y pueden ser encontradas en algunos la página, diálogo y acontecimientos del
objeto. Cuando decimos son "locales," queremos decir que sus valores están sólo disponibles para
acciones creadas en ese acontecimiento.
Nota: Usted puede encontrar información adicional acerca de cada variable de acontecimiento
mirando la lista de acontecimientos "List of events".
Las siguientes variables de acontecimiento están disponibles en AutoPlay Media Studio:
e_Channel (Tipo: number)
El canal de audio cuyo estado tiene, cambió. Esta variable está sólo disponible adelante lo En el
acontecimiento de Audio. Uno de los siguientes valores del canal será devuelto:
CONSTANTE
VALOR DESCRIPCIÓN
CHANNEL_BACKGROUND 5
Canal de fondo.
CHANNEL_EFFECTS
0
Canal de efectos de sonido.
CHANNEL_NARRATION
6
Canal de narración.
CHANNEL_USER1
1
Canal del usuario 1.
CHANNEL_USER2
2
Canal del usuario 2.
CHANNEL_USER3
3
Canal del usuario 3.
CHANNEL_USER4
4
Canal del usuario 4.
CHANNEL_ALL
-3
Todos los canales de audio
e_Checked (Tipo: boolean)
True si el objteto tree esta checkado, falso si no esta checkeado. Esta variable solo es valida On
Check event.
e_Column (Tipo: number)
La columna (empieza en 0) de la celda ahora tiene foco en el objeto grid. Esta variable es solo
valida en objetos grid On Selection Changed event.
La columna (empieza en 0) de la celda cambiada en el objeto grid. Esta variable es solo valida en
objetos grid On Cell Changed event.
e_DialogHeight (Tipo: number)
La altura del diálogo actual. Esta variable solo es valida On Size event.
e_DialogWidth (Tipo: number)
La anchura del diálogo actual. Esta variable solo es valida On Size event.
e_Expanded (Tipo: boolean)
True si el modo del objeto tree a sido expandido, false si esta colapsado. Esta variable solo es valida
On Expanded event.
e_FilePath (Tipo: string)
La ruta completa para el archivo de imagen a que se cambió en el slideshow.
e_FSArgs (Tipo: string)
String que contiene el ultimo argumente FSCommand despedido dentro del objeto Flash. Esta
variable está sólo disponible On FSCommand event.
e_FSCommand (Tipo: string)
String que contiene el ultimo FSCommand despedido dentro del objeto Flash. Esta variable está
sólo disponible On FSCommand event.
e_ID (Tipo: number)
Usar la variable e_ID para cargar los aplicaciones del Menu.
e_Index (Tipo: number)
El índice basado de la diapositiva a que se cambió en el slideshow
e_ItemInfo (Tipo: table)
La información extendida acerca de la opción del menú actualmente seleccionada.
LLAVE
TIPO
DESCRIPCIÓN
Text
string
El texto del menu para interactuar con el.
ID
number El ID del objeto del menu para interactuar con el.
IconID
number Indice de iconos de la lista de images especificada en la barra de menu. Para
mostrar un icono en el objeto que desees del menu. Empieza en 0,
Enabled boolean True si el menu esta encendido, false si no lo esta.
Checked boolean True si el menu esta checkeado, false si no lo es.
e_Key (Tipo: number)
El código clave virtual de la llave que se presiono. Esta variable está sólo disponible On Key event.
e_Link (Tipo: string)
El texto del enlace que se a echo clic.Esta variable es solo valida en On Link event.
e_Max (Tipo: number)
El índice de carácter donde el texto del enlace termina. Esta variable está sólo disponible en On
Link y On Selection Changed events.
e_Min
(Tipo: number)
El indice de carácter donde el texto del enlace empieza. Esta variable está sólo disponible en On
Link y en On Selection Changed events.
e_Modifiers (Tipo: table)
Una tabla conteniendo valores de tres boolean que describen cuál el modificador teclea fue sujetado
abajo de mientras la llave se apretó. Una llave de modificador es una llave que puede ser mantenida
sujeta mientras otra llave se aprieta, "modificarla".
Hay tres valores / falsos verdaderos en la mesa, uno para cada quien mecanografían de llave de
modificador en el teclado: El desplazamiento, ctrl, y alt. Usted puede lograr acceso a estos valores
como e_Modifiers.shift, e_Modifiers.ctrl, and e_Modifiers.alt. Esta variable está sólo disponible
solo en On Key event
e_NewText (Tipo: string)
El texto que recién ha estado colocado para un modo en el objeto tree . Esta variable está disponible
en un objeto tree en On EditLabel event.
El texto nuevo de la celda en objeto grid. Esta variable está disponible en un objeto grid en On Cell
Changed event.
e_NodeIndex (Tipo: string)
El indice del modo tree object.
e_OldText (Tipo: string)
El texto que existió previamente antes del usuario editó el texto de un nodo en el objeto tree . Esta
variable está disponible en un objeto tree en On EditLabel event.
El texto que estaba en la celda antes de eso cambió en un objeto cuadriculado. Esta variable está
disponible en un objeto grid en On Cell Changed event.
e_PageHeight (Tipo: number)
La altura de la página actual. Esta variable está sólo disponible en On Size event.
e_PageWidth (Tipo: number)
La anchura de la página actual. Esta variable está sólo disponible en On Size event.
e_Row (Tipo: number)
La fila (empieza en el 0 ) de la celda que ahora tiene foco en un objeto grid. Esta variable está
disponible en el objeto grid en On Selection Changed event.
La fila (empieza en el 0) de la celda que cambió en un objeto grid. Esta variable está disponible en
el objeto grid en On Cell Changed event.
e_Selection (Tipo: number)
El índice de un artículo del comboxbox que está siendo seleccionado. (El primer artículo en la lista
tiene un índice de 1.) Esta variable está sólo disponible en On Select event de los combobox.
e_State (Tipo: string)
El string conteniendo al estado actual del canal de audio. Esta variable está sólo disponible solo en
On Audio event . Uno de los siguientes estados será devuelto:
VALOR TIPO DESCRIPCIÓN
Finish
string La pista del canal de audio alcanzado es fin.
Pause
string El canal de audio fue pausado usando la acción Audio.Pause.
Play
string El canal de audio fue encendido usando la acción Audio.Play.
Stop
string El canal de audio fue parado usando la acción Audio.Stop.
e_Type (Tipo: number)
El tipo de ajuste el tamaño eso ha ocurrido en On Size event.o el tipo del clic del boton de el raton
en On Mouse Button event.
On Size e_Type constantes:
CONSTANTE
VALOR DESCRIPCIÓN
SIZE_RESTORED
0
La aplicación a sido restaurada.
SIZE_MINIMIZED
1
La aplicación fue minimizada a la taskbar.
SIZE_MAXIMIZED 2
La aplicación fue maximizada.
On Mouse Button e_Type constantes:
CONSTANTE
VALOR DESCRIPCIÓN
LEFT_BUTTON_DOWN
0
El boton izquierdo del mouse a sido presionado.
LEFT_BUTTON_UP
1
El boton izquierdo del mouse a sido soltado.
RIGHT_BUTTON_DOWN 2
El boton derecho del mouse a sido presionado.
RIGHT_BUTTON_UP
El boton derecho del mouse a sido soltado.
3
e_URL (Tipo: string)
El string conteniendo el URL que ha terminado de cargando o está siendo navegado. Esta variable
está sólo disponible en On Loaded y On Navigate events.
e_WindowHeight (Tipo: number)
La altura, en pixeles, de la entera ventana de la aplicación, incluyendo el borde y la barra de títulos.
Esta variable está sólo disponible solo en On Size event.
e_WindowWidth (Tipo: number)
La anchura, en pixeles, de la entera ventana de la aplicación, incluyendo el borde y la barra de
títulos. Esta variable está sólo disponible solo en On Size event.
e_X (Tipo: number)
La posición horizontal del cursor del ratón, en pixeles, del lado izquierdo de la página o el diálogo.
Esta variable está sólo disponible solo en On Mouse Button y en On Mouse Move events.
e_Y (Tipo: number)
La posición verstical del cursor del ratón, en pixeles, del lado izquierdo de la página o el diálogo.
Esta variable está sólo disponible solo en On Mouse Button y en On Mouse Move events.
this (Tipo: string)
La String conteniendo el nombre del objeto, la página o el diálogo donde el acontecimiento es
hallado. Esta variable es útil para crear acciones genéricas o las funciones que no dependen de
nombres de pagina, dialog, u objeto específico. Por ejemplo:
Label.SetVisible (this, false);
Esta acción esconde el objeto de la etiqueta en el que fue creado. Por ejemplo, si la acción fuera
creada en el objeto denominado "Label1", escondería el objeto Label1. Si fuera creado en el objeto
llamado "Label2", escondería el objeto Label2.
Example 1: e_Channel, e_State
A menudo es necesario para poder detectar cuándo tiene una pista alcanzó su fin así es que usted
puede responder con algún tipo de acción. Este ejemplo ilustra cómo lanzarse a otra página cuando
una pista este sonando en el canal de audio de narración alcanza el fin. Usando este diseño, la
presentación visual podría ser controlada por una voz de audio encima.
1. Cree un proyecto de dos páginas con su segunda página llamada "Page2".
2. Añada el siguiente código en On Show event de su primera pagina. Necesitas un archivo
de audio para este ejemplo, así es que usted necesitará modificar esta acción así es que carga
un archivo real de audio dentro de su proyecto.
-- Carga una pista de audio en el canal de narración.
Audio.Load(CHANNEL_NARRATION, "AutoPlay\\Audio\\Lesson1.ogg", true, false);
Añade el siguiente codigo en On Audio en la primera pagina.
-- Si el tema del canal de audio de narración llega a su final, salta a otra página.
if ((e_Channel == CHANNEL_NARRATION) and (e_State == "Finish")) then
Page.Jump("Page2");
end
Carge una previsualizacion del proyecto, el archivo de audio se cagara al empezar el proyecto,y
cuando termine de sonar cargara la siguiente pagina.
Example 2: e_Key
En la mayoría de los casos, la interacción con una aplicación AutoPlay está consumada usando al
ratón. De cualquier forma que cabe también controlar algunos de la funcionabilidad a través del
teclado originándose de ciertas claves. Este ejemplo ilustra cómo la navegación puede ser
controlada por el teclado si un ratón no está disponible.
1. Crea un proyecto con dos paginas o mas.
2. Añada el siguiente codigo en On Key event “en todas las paginas”..
-- Si el usuario presion la Tecla Intro “ENTER”, salta a la siguiente pagina del proyecto.
if (e_Key == 13) then
Page.Navigate(PAGE_NEXT);
end
Cuando carges la previsualizacion de tu proyecto, cada vez que presione la tecla Intro"Enter", la
siguiente pagina sera mostrada.
Traducido por Ceone