Global y Event Variables

Global y Event Variables Autoplay Media Studio v7.0 Manual Autoplay Media Studio viene provisto de variables automatizadas, que se usan para represent...
0 downloads 0 Views 143KB Size
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