Manual de Sora Script

8/18/2019 Manual de Sora Script

1/101

Manual de Referencias SoraScript

Manual de ReferenciasSora Script

0.1.1368

Centro de Estudios de Software Educativo CEnSoE | La Habana, 2008 1


2/101


Prefacio

El desarrollo de un sistema de autor ue brinde las !erramientas suficientes"ara la elaboraci#n de materiales di$itales educativos "or "arte de unn%mero am"lio & diverso de usuarios, es el ob'etivo fundamental "erse$uido"or el eui"o de desarrollo ue estuvo a car$o de la "ro$ramaci#n del

"resente software( La facilidad, fle)ibilidad & estabilidad de dic!o sistema, soncualidades ue !emos tratado de refle'ar en su dise*o funcional eim"lementaci#n( Las futuras versiones mostrar+n adem+s el siem"re"resente intento de satisfacer las necesidades de los usuarios & las nuestrascomo "ro$ramadores(

En este material se "retende !acer referencia a los comandos, estructuras,etc(, ue "ueden ser em"leados durante la "ro$ramaci#n escrita( uesto ueactualmente la !erramienta em"lea el int-r"rete de w).asic, a la $ranma&or/a de las funciones se les !a mantenido la sinta)is ori$inal de estelen$ua'e, mientras ue, adem+s se inclu&en un $ru"o im"ortante desentencias "ro"ias de la !erramienta, ue fueron adicionadas al int-r"rete

"ara el mane'o de los ob'etos & el entorno, fundamentalmente( esta fusi#nentre los comandos de w).asic & los "ro"ios del "ro&ector de HEduc es a loue llamamos Sora Scri"t(

anto las referencias ue se brindan como los e'em"los reco$idos en estemanual !an sido enfocados su"oniendo ue el lector tiene conocimientosb+sicos de la "ro$ramaci#n en .asic(

La documentaci#n ue se brinda "or "arte del autor del int-r"rete de w).asicfue un material del ue se e)tra'o una $ran "arte de lo ue au/ se e)"licasobre w).asic(



3/101


IMPORTANTE:Puesto que el compilador de wxBasic a sido adaptado para su

empleo en esta !erramienta de Autor" ad#ertimos que el usode comandos que no est$n reco%idos en este manual dereferencias puede ocasionar comportamientos impredeci&lesen las aplicaciones pro%ramadas &a'o este entorno(

Centro de Estudios de Software Educativo CEnSoE | La Habana, 2008


4/101


Agradecimientos

$rade3co la im"ortante "artici"aci#n de un $ru"o de com"a*eros &ami$os ue sin ellos este "roducto no tendr/a la calidad ue "osee4

La o"ortuna colaboraci#n del licenciado maur& -re3 orres & elin$eniero ndre&s Re&tor L#"e3 "or su labor "ara la soluci#n deim"ortantes dificultades(

El a"orte en el dise*o $r+fico de 5oenis Le#n Mesa(

Las o"ortunas su$erencias & se*alamientos del doctor Carlos E(E)"#sito Ricardo & del Master en Ciencias Cesar Laba*ino Ri3o,"oniendo siem"re a nuestra dis"osici#n sus e)"eriencias en el +rea dela inform+tica educativa(

ambi-n a todos los ue !an invertido un se$undo de su tiem"o eneste im"ortante "ro&ecto(



5/101


)ndice de contenido

Sobre el lenguaje y la Herramienta.....................................................7¿Qué es Sora Script?............................................................................7Fundamentos de WxBasic....................................................................7olecciones........................................................................................!"#étodos de colecciones.....................................................................!"

$rray...............................................................................................!%&able...............................................................................................!%'ist..................................................................................................!(

omentarios.......................................................................................!) *mbito de +ariables...........................................................................!)onstantes.........................................................................................,-

structuras c/clicas............................................................................,-F01...23&....................................................................................,-WH4' ... 25 WH4'...................................................................,!F01 $H...25 F01...................................................................,!

structuras condicionales..................................................................,,4F ... 'S4F ... 'S ... 25 4F....................................................,,Select case......................................................................................,6

rocedimientos sub............................................................................,"Funciones...........................................................................................,"lases.................................................................................................,(lases 4nternas de Sora Script..........................................................,)

lase ss1ect...................................................................................,)lase ssunto.................................................................................,8lase ssolor..................................................................................,8lase ss......................................................................................6-lase ss5im....................................................................................6"lase ssFuente...............................................................................6%lase ss2ull4magenBase................................................................67lase ss4magenBase.......................................................................67lase ssSonido................................................................................68

&rabajo con 9ic:eros..........................................................................."-

SH$15............................................................................................."!S&$&4..............................................................................................."!142& ;.............................................................................................",0tras 9unciones para el trabajo con 9ic:eros y directorios................",0tras Funciones de Sora Script........................................................."6

Funciones de na+egaci


6/101


clase ss5ialogo#ensaje..................................................................%!'os 0bjetos b=sicos del proyector.....................................................%,

lase SS0bjeto...............................................................................%6lase SS&abla.................................................................................%"lase SSti>ueta............................................................................%)

lase SSoligono............................................................................%)lase SStexto...............................................................................(-lase SS4magen..............................................................................(-lase SSHtml..................................................................................(!lase SS'ista..................................................................................(6lase SS1eloj.................................................................................("lase SSideo.................................................................................(%lase SS&exto.................................................................................((

Bases de datos...................................................................................(8lase ssBase5atos..........................................................................(8lase ss1esultado...........................................................................(8

aptura de e+entos............................................................................7!'os objetos b=sicos del proyector y las clases...................................)!l 1untime.........................................................................................)(alabras reser+adas...........................................................................)70peradores.........................................................................................))0peradores de asignaci


7/101


Sobre el lenguaje y la Herramienta

HEduc es una Herramienta libre, multi"lataforma 9:indows & Linu);

"ara el desarrollo de a"licaciones educativas( Cuenta con loselementos necesarios 9ob'etos de usuario; & un len$ua'e 9Sora Scri"t;suficientemente "otente "ara crear software de este ti"o( w).asic(sourcefor$e(net( Los autores de HEduc em"learon esteint-r"rete libre & a "artir de modificaciones reali3adas en el mismo,"ara ada"tarlo a la met+fora ue "ro"one el sistema & con la adici#nde un "ro&ector & ob'etos visuales & los m-todos "ara su mane'o, sur$eSora Scri"t ue mantiene como esencia a w).asic( or ello este manualde referencias !ar+ es"ecial -nfasis en la "ro$ramaci#n con estelen$ua'e 9w).asic; & tambi-n mostrar+ los nuevos elementos "ara lae)"lotaci#n de la met+fora ue "lantea HEduc & Sora Scri"t(

Fundamentos de Wxasic

Las "rinci"ales caracter/sticas del len$ua'e son4

• Es libre(• Multi"lataforma 9:indows & Linu);(• ?+cil de ense*ar & a"render, basado en .asic(• @nter"retado(•

El runtime ocu"a "oco es"acio en disco(En su sinta)is se revelan elementos de C, A.asic, Lua, !&ton &B.(E( Si bien no es un len$ua'e mu& "otente, los autores de HEduclo consideran suficiente "ara el desarrollo de recursos educativos &a"licaciones no mu& com"le'as( Dnido al !ec!o de ue w).asic es m+sfle)ible ue el .asic com%nmente conocido & !a sido dise*ado conmuc!as me'oras( Si a esto le sumamos las "osibilidades $r+ficas delentorno de HEduc, se "uede disfrutar de un ambiente de desarrolloestable, acorde a las necesidades de un am"lio $ru"o de usuarios(



8/101


¿!"mo #xasic se diferencia de otros asic?Los "rinci"ales elementos ue diferencian a w).asic del .asic son lossi$uientes4

•

*os tipos de datos simples no son pasados por referencial$unos ti"os de datos 9como el ti"o rra& & Fb'ects; son "asados a lasrutinas "or referencia, "ero los ti"os de datos sim"les 9como umber &Strin$; no lo son( Esto si$nifica ue si un "ar+metro de un ti"o de datosim"le, cambia en el interior de una rutina, no cambiar+ el valor de lavariable em"leada "ara la llamada( or e'em"lo4

Sub foo9 a ; a G a 10 ssMensa'e 9IEn foo9;, a G I J a; End Sub

b G 100 ssMensa'e 9Intes de llamar a foo9;, b G I J b; foo9 b ; ssMensa'e 9Ides"u-s de llamar a foo9;, b G I J b;

En al$unas versiones de .asic, cambiando el valor de a debe cambiarel valor de &( Este no es el caso de w).asic( Si se desea cambiar elvalor de &, necesita asi$narle el valor de retorno(

?unction foo9 a ; a G a 10 ssMensa'e 9IEn foo9;, a G I J a; End ?unction

b G 100 ssMensa'e 9Intes de llamar a foo9;, b G I J b; b G foo9 b ; ssMensa'e 9Ides"u-s de llamar a foo9;, b G I J b;

• *as funciones de#uel#en #alores mediante la pala&rareser#ada Return

ara devolver un valor desde una funci#n en w).asic, se necesita usarla "alabra reservada Return( Esta funciona como en +4 se sale de lafunci#n en este "unto, & devuelve el valor ue si$ue a dic!a "alabra4

?unction foo9 a ; Return a K 10 End ?unction

Si se uiere continuar "rocesando dentro de la funci#n, "uedeem"learse una variable tem"oral4

?unction foo9 a ;



9/101


=im tm" G a K 10 !acer al$o m+s Return tm" End ?unction

• *as funciones pueden de#ol#er m,ltiples #alores

l i$ual ue *ua & P-ton, w).asic "ermite funciones ue devuelvanm+s de un valor( or e'em"lo4

?unction double!eBalue9 a ; Return double t!e value and ori$inal value Return aK2, a End ?unction

newBalue, oldBalue G double!eBalue9 120 ;

w).asic !ace un c!eueo de la cantidad de ar$umentos de amboslados de la e)"resi#n, de forma tal ue le asi$nar+ a los miembrosi3uierdos las e)"resiones de la derec!a teniendo en cuenta el ordenres"ectivo( Si el n%mero de ar$umentos a la i3uierda es ma&or ue elde la derec!a, se le asi$na el valor Notin% al ar$umento restante( orotra "arte si el n%mero de e)"resiones o valores a asi$nar es ma&orue el de ar$umentos a la i3uierda, estos ser+n i$norados "or elcom"ilador, "or e'em"lo4

a, b G 10, 20, 0

En este caso, a a se le asi$na el valor 10, & a & el valor 20( Como no!a& variable "ara recibir el valor 0, este ser+ i$norado "or elcom"ilador( Similarmente4

a, b G 10

En este caso, a tomar+ el valor 10, & & el valor Notin%(

Si una funci#n no devuelve e)"l/citamente un valor, esta devolver+ "ordefecto el valor Notin%4

?unction doot!in$9; End ?unction

a G doot!in$9;

Esto !ace ue a la variable a se le asi$ne el valor Notin%(

• *as funciones pueden tener par.metros opcionales

Se "uede es"ecificar ue una rutina "uede tener "ar+metros

o"cionales( Si la rutina es llamada sin estos "ar+metros, ellos tomar+nlos valores "or defecto( or e'em"lo4



10/101


Sub !asF"tionalarms9 a, b, c G 10, d G 100 ;

ssMensa'e 9a J N N J b J N N J c J N N J d; End Sub

•

*as funciones pueden tener un n,mero #aria&le depar.metros

Se "uede es"ecificar ue una rutina ten$a un n%mero de variable de"ar+metros( Similar al comando printf de +4

Sub !asBariablearms9 a, b, ((( ;

• /eclaraci0n din.mica de #aria&les

En w).asic, no es necesaria la declaraci#n e)"l/cita de variables,"orue son creadas Nal vueloO "or el com"ilador en el momento deusarlas4

aStrin$ G Iesto es una cadenaI aumber G 12

Las variables declaradas fuera de las rutinas son autom+ticamente de+mbito $lobal4 $lobalBar G ISo& una variable $lobalI

Sub foo9; localBar G ISo& una variable localI

Referencia a la variable $lobal $lobalBar ssMensa'e 9$lobalBar;

Referencia a la variable local localBar ssMensa'e 9localBar;

End Sub

Como conveniente es esta o"ci#n, lo es m+s si se establece como

obli$atoria la declaraci#n e)"l/cita de variables( Esto "odr+ !acerseestableciendo la si$uiente declaraci#n4

F"tion E)"licit

Con Option Explicit !abilitado, se vuelve obli$atoria la declaraci#ne)"l/cita de las variables antes de usarlas4

=im $lobalBar G ISo& una variable $lobalI

Sub foo9; =im localBar G ISo& una variable localI



11/101


Referencia a la variable $lobal $lobalBar ssMensa'e 9$lobalBar;

Referencia a la variable local localBar ssMensa'e 9localBar;

End Sub

• No es sensi&le a ma-,sculas - min,sculas

El com"ilador de w).asic no detecta diferencia entre ma&%sculas &min%sculas, "or tanto los si$uientes casos si$nifican lo mismo4

A$%% es lo mismo ue a$%% A$Sin&'() es lo mismo ue a$S*+&'()ssMensa'e 1 2ola mundo34 es lo mismo ue ssMensa'e 1 2ola mundo34ssMensa'e 1True4 es lo mismo ue ssMensa'e 1TR5E4

• Tipos de datos

odos los valores en w).asic son almacenados "or defecto como6ariants( Sin embar$o se "ueden definir las variables con lossi$uientes ti"os4

•6ariant•Inte%er•Num&er•Strin%•/ateTime•O&'ect•Routine•Arra-•Ta&le•*ist

E)isten m-todos comunes "ara al$unos de estos ti"os de

datos4inte$er G


12/101


@f a G ot!in$ !en ssMensa'e 9Ia G ot!in$I; End @f

Este im"lementa los si$uientes m-todos4

isumericfromC!artoC!arisrue

*nteger Inte%er es un entero( En estas variables se almacenan valoresenteros( odas las o"eraciones matem+ticas son internamente !ec!as

con dou&le" incluso cuando ambos ti"os son declarados comoInte%er(

+umber Num&er es un n%mero con "unto flotante, almacena como un doublede +(

String

Strin% es una cadena de caracteres alfanum-ricos( Cuando se !aceuna "rueba de verdad, las cadenas vac/as devuelven un valor ?alse, &las no vac/as devuelven True(

Se "ueden incluir caracteres es"eciales dentro de la cadena usando elbacPslas! 97;4

Qn nueva l/neaQr retorno de carroQt tabQ comilla sim"leQI comilla dobleQQ bacPslas!

or e'em"lo4

strin$Con=osLineas G IEsta es la "rimera l/neaQnEsta es la se$undaI

Se "uede tratar una cadena como si esta fuera una colecci#n( Se "uedeiterar dentro de la cadena( or e'em"lo4

?or Eac! "osicion, letra @n I!ola, mundoI ssMensa'e 9 Iosici#nG I J "osicion J I letraG I J letra; End ?or



13/101


Se "uede adem+s usar /ndices en las cadenas como en un arra&, "ore'em"lo4

aG IHello, :orldI8

Le asi$nar+ 898 a la variable a, &4

aG IHello, :orldI147

Le asi$nar+ 8!ello8 a la variable a(

,ate-ime/ateTime re"resenta fec!a & !ora( Este es normalmente creado

asi$n+ndole una cadena con formato de fec!a4

=im m&=ate G ITan 12, 200I

Hasta a!ora s#lo se admite en traba'o con fec!as en @n$l-s(

Se "ueden e)traer las "artes de la fec!a llamando a varios m-todos dellen$ua'e4

5ear9m&=ate; Mont!9m&=ate; Mont!ame9m&=ate; :eePda&9m&=ate; =a&9m&=ate; =a&ame9m&=ate; Hour9m&=ate; Minute9m&=ate; Second9m&=ate;

El em"leo del m-todo ow9; "ermite obtener la fec!a actual(

.bject Cualuier dato declarado como una clase 9interna o de usuario; esalmacenada como un ti"o de dato O&'ects( Los Fb'ects son "asados"or referencia, no "or valor( ara crear una co"ia de un ob'eto se tieneue em"lear el m-todo +lone4

miCo"ia G Clone9ElFb'eto;

/utinasDna rutina 9Routine; es un m-todo o rutina definida "or el usuario(

Este es actualmente un ti"o de dato interno, no debe em"learse "arala versi#n actual del com"ilador(



14/101


!oleccionesDna colecci#n es un a$ru"amiento de datos 6ariant a los ue se"uede tener acceso mediante un valor clave( or e'em"lo, Arra-,

Ta&le, & *ist son todos, ti"os de datos de colecci#n( Estas "or tantotienen o"eraciones comunes 9en $eneral; a las colecciones( Se "uedeacceder a un elemento de la colecci#n es"ecificando el /ndice( ore'em"lo, esta es una colecci#n Ta&le4

=im mis$atos G UV

0ndicesDna tabla 9Ta≤ "odr/a ser esta4

mis$atos 1 G IC!esterI mis$atos 2 G IC!arlotteI mis$atos G IC!loeI

Si se im"rime el valor de la tabla4

ssMensa'e 9mis$atos;

Se obtendr+4 ;:8+ester8"


15/101


Array Dn rra& es una colecci#n de tama*o est+tico( Como las dem+scolecciones, es "asada "or referencia( Se em"lea el corc!ete "aradistin$uirlos de una llamada a rutina( Beamos una declaraci#n sim"lede un arra&4

=im mirra&10

Si el l/mite inferior del ran$o no es declarado, este se toma como cero(Dn arra& "uede tener !asta cuatro dimensiones4

=im mirra&7 o 20, W10 o 10

Dn arra& ue no !a&a sido declarado como un ti"o de dato, sus valoresse iniciali3an a cero( Es "osible declarar un valor inicial a un arra& "arasus elementos4

=im mirra&10 G ot!in$

Se "uede es"ecificar un ti"o de dato4

=im mirra&10 s umber

ambi-n es "osible !acer ambas cosas4

=im mirra&10 s @nte$er G 0

-ableDna tabla es una colecci#n no ordenada de tama*o din+mico( Comotodas las colecciones, es "asada "or referencia( Se "uede declarar unacolecci#n em"leando las llaves 9UV;( s/ se "odr/a declarar una tablavac/a4

=im miabla G UV

Dna colecci#n es inde)ada mediante valores, &a sea num-ricos

9@nte%er; o de cadena 9Strin%;( 9Los num-ricos son autom+ticamenteconvertidos a enteros;( or e'em"lo4

=im mis$atos G U 14IC!esterI, 24IC!arlotteI, 4IC!loeI, 64ITuliusI V

es lo mismo ue escribir4

=im mis$atos G UV mis$atos 1 G IC!esterI mis$atos 2 G IC!arlotteI mis$atos G IC!loeI

mis$atos 6 G ITuliusI



16/101


Fbserve ue si el elemento no e)iste en la lista, w).asic lo insertar+como un nuevo elemento de la colecci#n(

Si no se es"ecifica el /ndice en la declaraci#n, se asi$nar+nsecuencialmente los valores( or tanto lo anterior tambi-n "odr/a

escribirse como4

=im mis$atos G U IC!esterI, IC!arlotteI, IC!loeI, ITuliusI V

Se "uede acceder a un elemento es"ecificando el /ndice4

ssMensa'e9mis$atos 1;

Si el /ndice no e)iste en la tabla, se devolver+ un valor Notin%( Si lalista contiene otra lista, se "uede acceder a esta como en un arra&4

=im mis$atos G UV misc!icos IC!esterI, Icomida favoritaI G I"escadoI

@$ualmente se "odr/a escribir4

=im mis$atos G UV misc!icos IC!esterI G U Icomida favoritaI4I"escadoI V

ue es adem+s i$ual ue4

=im mis$atos G U IC!esterI4U Icomida favoritaI4I"escadoI V V

5 este "uede ser accedido similarmente4

ssMensa'e9mis$atos IC!esterI, I comida favorita I ;

@m"rime4 8pescado8

Como con las dem+s colecciones, se "uede iterar dentro de esta con laestructura re"etitiva ?or Eac:

?or Eac! indice, nombre @n mis$atos ssMensa'e9indice, nombre; End ?or

Es "osible remover elementos de la lista mediante el valor delelemento4

mis$atos(Remove9 ITuliusI ;

ara saber de la e)istencia de un /ndice en una tabla em"lee enm-todo HasXe&( B-ase m-todo HasXe&(

2ist Dna lista es una colecci#n ordenada de tama*o din+mico( Como las



17/101


dem+s colecciones esta es "asada "or referencia( Se "uede declararuna tabla em"leando los corc!etes 9;( El si$uiente e'em"lo muestrauna lista vac/a4

=im milista G

La construcci#n de una tabla es similar a la de una lista, e)ce"to uelos /ndices son im"l/citos( .asados en el orden4

=im mis$atos G IC!esterI, IC!arlotteI, IC!loeI, ITuliusI

Se "uede adicionar elementos a una lista con Append, ue loscolocar+ al final de la lista4

=im mis$atos G mis$atos(""end9 IC!esterI ;

mis$atos(""end9 IC!arlotteI ; mis$atos(""end9 IC!loeI ; mis$atos(""end9 ITuliusI ;

o con Prepend, ue los adiciona al inicio4

=im mis$atos G mis$atos(re"end9 ITuliusI ; mis$atos(re"end9 IC!loeI ; mis$atos(re"end9 IC!arlotteI ; mis$atos(re"end9 IC!esterI ;

o mediante Insert, es"ecificando la "osici#n a insertar el elemento4

=im mis$atos G mis$atos(@nsert9 1, ITuliusI ; mis$atos(@nsert9 2, IC!loeI ; mis$atos(@nsert9 , IC!arlotteI ; mis$atos(@nsert9 6, IC!esterI ;

Los elementos "ueden ser accedidos mediante los /ndices,comen3ando "or 1(El acceso a un elemento ue no e)ista "rovocar+ un error(

ssMensa'e9mis$atos ;

Es "osible acceder adem+s a un fra$mento de la lista4

ssMensa'e9mis$atos 24;

@$ual resultado se obtendr+ em"leando el m-todo slice4

ssMensa'e9Slice9mis$atos,2,;;



18/101


!omentarios

Los comentarios en Sora Scri"t "ueden establecerse en una l/neasim"le o en forma de bloues al estilo del len$ua'e C(

El cometario "ara una sola l/nea se establece mediante el s/mbolo decomilla sim"le 93; o al estilo de C con dos slas! 9>>;( mbos s/mbolosestablecen todo el te)to !acia la derec!a a "artir de ellos comocomentarios !asta el fin de l/nea4

esto es un comentario@@esto también

Los bloues de comentarios se inician con los s/mbolos >K & se cierrancon K>

@A ste es otro comentarioen 9orma de blo>ue A@

4mbito de 5ariables

Los +mbitos de variables de"enden del modo en ue se em"lee enruntime de HEduc 9ver el a"artado El Runtime;(

Si el runtime se emplea en modo script:

En el modo scri"t e)isten los +mbitos $lobal, de clase & local de"rocedimientos 9sub & function;( El +mbito $lobal es el ue est+ fuerade los "rocedimientos, las funciones & clases, es el +mbito m+s e)terno& su"erior(

En cuanto el com"ilador encuentra una declaraci#n 9e)"l/cita oim"l/cita; de variable, este verifica si no e)iste en el +mbito actual, eneste caso la crea, sino $enera un error(



19/101


Si e)isten dos variables de i$ual nombre ue "ertenecen a +mbitosdistintos ue se sola"an, tendr+ "rioridad la variable local ante la$lobal4

Esta es una declaraci#n en +mbito $lobal

=im m&Bar G Ivariable $lobalI?unction MiRutina9; Esta est+ declarada a nivel de rutina, local=im m&Bar G Ivariable de la rutinaI Se usa la versi#n local de m&BarssMensa'e9m&Bar;End ?unction

Si no se encuentra una variable en el +mbito actual se continuar+ lab%sueda en el +mbito $lobal4

Esta es una declaraci#n $lobal=im m&Bar G Ivariable de m#duloI

?unction MiRutina9; Se usa la variable $lobalssMensa'e9m&Bar;End ?unction

Si necesita em"lear m+s de una sentencia en una misma l/nea "odr+em"lear los dos "untos 94; "ara se"ararlas4

G224 bG Nte)toO4 ssMensa'e9;

Nota4 En modo scri"t las clases deben estar situadas al inicio del"rimer fic!ero de scri"t, evitando colocar "rocedimientos antes de lasclases(

Si el runtime se emplea en modo de pro-ecto:En modo de "ro&ecto los +mbitos de clase & local de "rocedimientos9sub & function; se mantienen "ero el $lobal a!ora desa"arece "ara darlu$ar a los +mbitos de Libro & de +$ina( Como cada "ro&ecto s#lo"osee un libro, este constitu&e el +mbito su"erior, mientras ue ale)istir un n%mero indeterminado de "+$inas cada una de ellas

constitu&e un +mbito en el ue coe)isten variables & "rocedimientos(



20/101


Nota4 En modo de "ro&ecto las clases deben estar situadas el +mbitode Libro(

!onstantesSintaxis4+ONST nom&reconstante @ expresi0n " nom&reconstante @ expresi0n >

=eclara una variable como constante( Las constantes son similares alas variables, s#lo ue no se les "uede modificar su valor(

=eclaro el nombre de mi "ro$ramaCFS ombrero$ G IMi ro$ramaI, Bersion G I1(0I

6structuras c7clicasw).asic "ermite crear estructuras re"etitivas de varias formas4

Las cl+sicas de .asic4?or ((( e)t:!ile ((( :end

F las ins"iradas en l$ol4?or ((( End ?or:!ile ((( End :!ile

F./888+69- Sintaxis4

?OR #aria&le @ startExpr TO endExpr STEP stepExpr>+ONTIN5EBREACEDIT ?OR statement >

E*SE statement >

EN/ ?OR NEDT #aria&le>

Este es un e'em"lo de un ciclo ue im"rime un n%mero entre 1 & 10

Ciclo de 1 a 10?FR i G 1 F 10

ssMensa'e9i;EY

Si el ciclo no es detenido "or el comando .REX, se e'ecutar+ lo ue seencuentra des"u-s del ELSE

?FR i G 1 to LE


21/101


ssMensa'e9IEncontradoZI;.REX

E= @?ELSE

ssMensa'e9Io fue encontradoI;E= ?FR

+ontinue "rovoca un salto al inicio del bucle donde se eval%anuevamente la expresi0n(

WH*26 888 6+, WH*269!I*E expresi0n

BREAC +ONTIN5E EDIT 9!I*E instrucciones >

E*SE instrucciones > EN/ 9!I*E 9EN/

Re"ite un con'unto de sentencias mientras la expresi0n sea verdadera(El comando .reaP termina inmediatamente el ciclo & +ontinue"rovoca un salto al inicio del bucle donde se eval%a nuevamente laexpresi0n(

or e'em"lo4 buscar un te)to en un fic!ero:H@LE F EF?9;

@D [1, te)to@? instr9 te)to, te)tobuscado ; HE

ssMensa'e9Ie)to encontradoI;.REX

E= @?ELSE

ssMensa'e9Ie)to no encontradoI;E= :H@LE

F./ 6A!H8886+, F./?OR EA+! #aria&le " #aria&le> IN expresi0n

+ONTIN5EBREACEDIT ?OR instrucciones >

E*SE instrucciones >

EN/ ?OR

Recorre una colecci#n 9table o list;( Si s#lo se es"ecifica una variable deciclo esta contedr+ el /ndice en cada ciclo, "or otra "arte si se em"leandos variables, entonces contendr+n el /ndice & el valor de esteelemento de la colecci#n( CF@DE, .REX & ELSE se com"ortan de lamisma forma ue en el ciclo ?FR(



22/101


@m"rime el valor & el /ndice de una lista?FR ECH Pe&, value @ list

ssMensa'e9Pe& J N O J value;E= ?FR

6structuras condicionales

*F 888 62S6*F 888 62S6 888 6+, *FI? expresi0n T!EN

instrucciones > E*SEI? expr T!EN

instrucciones > > E*SE

instrucciones > EN/ I?

E'ecuta un bloue de instrucciones de"endiendo del valor de unae)"resi#n evaluada en cada ciclo(

Sinta)is4If condición ten Uestas\instruccionesVelse Uotras\instruccionesVEnd if

"or e'em"lo4

if aG2 t!enbG0elsebG1end if

‘Se traduce si a es igual a ! entonces " tomar# valor 0$ sino se le asignar# valor 1

Las condicionales tambi-n "ueden escribirse en una sola l/nea aunueen este caso no "odr+ em"learse la sentencia else(

If condición ten instrucciones

+omentarios=e los dos formatos antes e)"uestos 9una sola l/nea o de bloue; em"lee laforma de una l/nea "ara condicionales cortas, mientras ue el formato debloue le brinda m+s facilidades "ara la "ro$ramaci#n de condicionales m+scom"le'as & "ara la lectura e inter"retaci#n "osterior del c#di$o(

or otra "arte mediante el em"leo del formato de una sola l/nea & de los dos"untos se "odr+n e'ecutar varias instrucciones en una sola condicional(

@f SG1 t!en SGS14 =G=14 TGT1



23/101


Dna e)"resi#n num-rica es tratada como verdadera si su resultado es distintode cero( En $eneral w).asic se encar$ar+ de reali3ar las conversionesnum-ricas necesarias, siem"re ue le sea "osible( Las e)ce"ciones son el ti"ode dato ot!in$ 9este siem"re es falso; & el strin$ 9cadena de caracteres;(Dna cadena de caracteres vac/a es tratada como %alse, de lo contrario ser+true.

Las si$uientes e)"resiones siem"re ser+n evaluadas como true

@? I0I HE ssMensa'e9 NEsto es verdadero "orue el strin$ no est+ vac/oO;

E= @?

Si se desea !acer una com"araci#n num-rica con un strin$ !a& uease$urarse de reali3ar la conversi#n "rimero4

@? BLDE9I0I; HE ssMensa'e9Iesto es falso, "orue el numero 0 es tratado como falseI; E= @?

Dsar ELSE @? en lu$ar de ELSE@? tambi-n se ace"ta(

@? a G 1 HEssMensa'e9IFneI;

ELSE @? a G 1 HEssMensa'e9IwoI;

ELSE@? a G HEssMensa'e9I!reeI;

ELSE

ssMensa'e9Ioo bi$ZI;E= @?

Select caseSE*E+T +ASE ((( EN/ SE*E+T

SE*E+T +ASE expresi0n +ASE caseTest " caseTest >

instrucciones > >+ASE E*SE

instrucciones > EN/ SE*E+T

ermite e'ecutar uno de varios bloues de instrucciones( l i$ual ue en C,s#lo un caso ser+ e'ecutado( Se "ueden utili3ar e)"resiones m%lti"les ointervalos en cada cl+usula mediante las si$uientes sinta)is de o"eradores4

@S G | ]^ | ] | ^ | ] | ^G e)"re)"r F e)"re)"r

"or e'em"lo4

SELEC CSE aCSE 1,



24/101


ssMensa'e9Iel valor es 1, o I;

CSE 6 F , 8ssMensa'e9Iel valor es 6, 7, , o 8I;

CSE @S ] 12

ssMensa'e9Iel valor es menor ue 12I;

CSE ELSEssMensa'e9Iel valor el al$%n otro, distinto a los anterioresI;

E= SELEC

Nota importante4 o de'e l/neas en blanco entre el Select case & el "rimer case(

Procedimientos subS5B ((( EN/ S5B

S5B name 1 ar% @ expr " ar% @ expr> " ((( 4 /IM #aria&le " #aria&le > STATI+ #aria&le " #aria&le > S!ARE/ #aria&le " #aria&le > RET5RN EDIT S5B instrucciones >

EN/ S5B

Dn "rocedimiento Sub es un bloue de c#di$o ue "uede ser e'ecutado avoluntad, en el momento ue se reuiera( Es esencialmente como unafunci#n, s#lo ue este no devuelve valores(

Los "rocedimientos "ermiten seccionar el c#di$o de un "ro$rama "ara $anaren claridad, eficiencia & robuste3(

Funciones?5N+TION ((( EN/ ?5N+TION

?5N+TION name 1 ar% @ expr"ar% @ expr> " ((( 4 /IM #aria&le " #aria&le > STATI+ #aria&le " #aria&le > S!ARE/ #aria&le " #aria&le > RET5RN expr " expr>

EDIT ?5N+TION instrucciones >EN/ ?5N+TION

Las funciones en w).asic brindan dos formas de devolver los valores( l estilo.asic4

?unction add9 a, b ;add G a bEnd ?unction

F al estilo C4

?unction add9 a, b ;Return a b



25/101


End ?unction

l i$ual ue C, se "uede i$norar el Return( Entonces la funci#n se com"ortar+como una rutina(

Ftro as"ecto interesante ue dota de m+s fle)ibilidad al len$ua'e es ue lasfunciones al i$ual ue las e)"resiones "ueden devolver m+s de un valor4

?unction suma9 a, b ;Return a, b, a bEnd ?unction

ara reco$er los tres valores ue devuelve tendremos ue em"lear tresvariables4

var,var.,sumaBarGsuma97,8;

=entro de los "ar+metros se "ueden incluir valores o"cionales( Si estosvalores no son incluidos en la llamada a la funci#n, se les asi$na losvalores "or defecto4

?DC@F ConF"cionales9 a, bG10, cGIcadena "or defectoI ;ssMensa'e9IaGI J a;ssMensa'e9IbGI J b;ssMensa'e9IcGI J c;

E= ?DC@F

Se "ueden em"lear variable est+ticas 9static; en la funci#n( Estas sonvariables ue retienen su valor a%n des"u-s de ue el com"ilador sal$ade la funci#n donde fue creada( 9vea S@C;

l$unos o todos los valores ue devuelve una funci#n "ueden seri$norados( Si una funci#n devuelve m+s valores ue los reueridos, losvalores e)tras son descartados( or otra "arte si la funci#n devuelvemenos valores ue los es"erados, las variables e)tras tomaran valorot!in$4

?DC@F return!reeBalues9;REDR 1, 2,

E= ?DC@F

i$nora todos los valoresreturn!reeBalues9;

i$nora el %ltimo valora, b G return!reeBalues

ot!in$ es asi$nado a da, b, c, d G return!reeBalues9;

w).asic "asa los valores mediante los "ar+metros a las funciones "or valor

9.&Bal; de modo ue siem"re se "asa una co"ia del valor de las variables,esto "ermite reali3ar la si$uiente o"eraci#n ue "rovoca un intercambio devalores4



26/101


a, b G b, a

!lasesw).asic "ermite un traba'o sim"le con clases ue "ueden contenercam"os, "rocedimientos, funciones, constructor, destructor, etc(Se debe tener "resente ue "ara los "ro&ectos de HEduc las clases sedeben situar en el libro, mientras ue si estamos en modo scri"t 9vera"artado El Runtime; las clases deben ser situadas al inicio del c#di$o& evitando ue se declaren "rocedimientos antes de estas(

Beamos los e'em"los4

creando una clase "untoCLSS unto

=@M ), &E= CLSS

creando un "unto" G unto9;"() G 10"(& G 20

En el e'em"lo anterior las clases se em"lean al estilo de las estructurasen C(

Los ob'etos son autom+ticamente destruidos cuando no !acenreferencia a nin$%n ob'eto( Si se desea crear un ob'eto"ermanentemente se debe crear mediante la "alabra reservada ew4

creando una clase "untoCLSS unto

=@M ), &E= CLSS

crea un "unto tem"oral & se le asi$na al$%n valor"1 G unto 9;

"1(), "1(& G 10, 20 crea un "unto "ermanente & se le asi$na al$%n valor"2 G E: unto 9;"2(), "2(& G 60, 80

destru&e el "unto tem"oral"1 G FH@<

Esto no destru&e el "unto "ermanente"2 G FH@<

ara destruir un ob'eto "ermanente em"lee el s/mbolo4 _

destruir el "unto



27/101


_ "2

Es "osible definir un iniciali3ador "ara una clase inclu&endo el m-todoew en esta4

crear una clase "untoCLSS unto=@M ), &

SD. E: 9 useY, use5 ;), & G useY, use5

E= SD.E= CLSS

Crear un "unto"1 G unto9 10, 20 ;

Cuando un ob'eto es destruido, la rutina ?@L@`E de este, es llamada4

crear una clase "untoCLSS unto=@M ), &

SD. E: 9 useY, use5 ;), & G useY, use5ssMensa'e9Iunto creado UI J ) J I, I J & J I;I ;

E= SD.

SD. ?@L@`E9;

ssMensa'e9I=estruido el "unto UI J ) J I, I J & J I;I ;E= SD.E= CLSS

Las clases de w).asic "ermiten un traba'o b+sico de !erencia & lacreaci#n de clases abstractas4

class "ersonadim nombre as strin$dim edad as inte$er

end class>>clase alumno ue !ereda de la clase "ersonaclass alumno in!erits "ersona

dim $rado as inte$er

sub new9nombre;me(nombreGnombre

end sub

end class

un\alumnoG alumno9NedritoO;



28/101


un\alumno(edadG16

En este e'em"lo tambi-n est+ "ermitido crear un ob'eto del ti"o"ersona4

una\"ersonaG"ersona9;una\"ersona(nombreGOTuanO

Si se desea crear clases abstractas, ue no "uedan ser instanciadasdirectamente sino ue el "ro$ramador s#lo "ueda em"learla "ara!eredar otras clases entonces se em"lea la "alabra reservada abstract(de esta forma la clase "ersona uedar/a4

abstract class "ersonadim nombre as strin$dim edad as inte$er

end class

=e esta forma la si$uiente l/nea $enerar+ un error4una\"ersonaG"ersona9;

!lases *nternas de Sora Script

!lase ss/ect Re"resenta un +rea rectan$ular a "artir de un "unto 9borde su"eriori3uierdo; & el anc!o & alto(

ssRect::ssRectssRect9) as inte%er, & as inte%er, alto as inte%er, anc!o as inte%er; asssRect

ssRect::o&tancoo&tanco14 as inte%er=evuelve el anc!o de un ssRect(

ssRect::o&taltoo&talto14 as inte%er=evuelve el alto de un ssRect(

ssRect::estancoestanco1w as inte%er4Establece el anc!o de un ssRect(ssRect::estaltoestalto1 as inte%er4Establece el alto de un ssRect(

ssRect::FssRectFssRect14



29/101


=estructor de la clase

!lase ssPuntoClase ue re"resenta un "unto en el "lano(

ssPunto::ssPuntossPunto9) as inte%er, & as inte%er; as ssPunto=onde x & y son las coordenadas del "unto(

ssPunto::o&tobt9; as inte%er, as inte%er=evuelve los valores de las coordenadas ) &(

E'em"lo4 dim " G ss"unto910,11; ),&G"(obt9;

ssPunto::estest9) as inte%er, & as inte%er;Establece los valores de las coordenadas ) &(

ssPunto::o&txobt)9; as inte%er=evuelve el valor de la coordenada ) del "unto(

ssPunto::o&t-obt&9; as inte%er

=evuelve el valor de la coordenada & del "unto(

ssPunto::FssPuntoFssPunto14=estructor de la clase(

!lase ss!olor Clase "ara la $esti#n de colores( Contiene los com"onentes ro'o, verde& a3ul de un color(

ss+olor::ss+olorss+olor9r as inte%er, v as inte%er, a as inte%er; as ss+olor=onde r$v$a son las las com"onentes ro'o, verde & a3ul ue caracteri3ana este color & sus valores est+n en el ran$o de 0 a 277(

ss+olor::aGulaGul14 as inte%er=evuelve el valor del com"onente a3ul de un ssColor(

ss+olor::#erde

#erde14 as inte%er=evuelve el valor del com"onente verde de un ssColor(



30/101


ss+olor::ro'oro'o14 as inte%er=evuelve el valor del com"onente ro'o de un ssColor(

ss+olor::oH oH14 as inte%er=evuelve 1 si el ssColor es v+lido a "artir del valor de sus com"onentesen el ran$o de 0 a 277(

ss+olor::estest9r as inte%er, v as inte%er, a as inte%er4Establece los valores de los com"onentes de un ssColor(

ss+olor::o&to&t14 as inte%er, as inte%er" as inte%er

=evuelve el valor de los com"onentes ro'o, verde & a3ul de un ssColor(E'em"lo4cGsscolor9100,277,170;r,v,aGc(obt9;

!lase ss!!Clase "ara la $esti#n de cadenas de caracteres(

ss++::ss++ss++14 as ss++

E'em"lo4dim cadena G ssCC9;

ss++::strin%strin%14 as strin%=evuelve el contenido de un ssCC como el ti"o de dato strin$(E'em"lo4dim cadena G ssCC9;cadena(a""end9Nte)toO;

dim str as strin$strGcadena(strin$9;

ss++::reser#arreser#ar9n as inte$er;Reserva "reviamente n b&tes de memoria en el ob'eto(

ss++::a%re%ara%re%ar9te)to as strin$;$re$a un te)to al final del contenido de un ssCC(

ss++::despuesprimerdespuesprimer9caracter as strin%; as strin%=evuelve el te)to ue e)iste a continuaci#n de la "rimera a"arici#n deun caracter en un ssCC(



31/101


Nota4 Solo se tomar+ en cuenta el "rimer caracter del strin$ enviadocomo "ar+metro en este m-todo(

ss++::despuesultimodespuesultimo9caracter as strin%; as strin%

=evuelve el te)to ue e)iste a continuaci#n de la %ltima a"arici#n deun caracter en un ssCC(Nota4 Solo se tomar+ en cuenta el "rimer caracter del strin$ enviadocomo "ar+metro en este m-todo(

ss++::antesprimeroantesprimero9caracter as strin%; as strin%=evuelve el te)to ue e)iste antes de la "rimera a"arici#n de uncaracter en un ssCC(Nota4 Solo se tomar+ en cuenta el "rimer caracter del strin$ enviadocomo "ar+metro en este m-todo(

ss++::antesultimoantesultimo9caracter as strin%; as strin%=evuelve el te)to ue e)iste antes de la %ltima a"arici#n de uncaracter en un ssCC(Nota4 Solo se tomar+ en cuenta el "rimer caracter del strin$ enviadocomo "ar+metro en este m-todo(

ss++::#aciar#aciar9;Bacia el contenido de un ssCC(

ss++::cmpcmp9str as ss++; as inte%er=evuelve 1 si la cadena es ma&or ue el ar$umento str, cero si soni$uales & W1 si es menor(

ss++::cmpnocasecmpnocase9str as ss++; as inte%erEsta com"araci#n distin$ue entre ma&%sculas & min%sculas(=evuelve 1 si la cadena es ma&or ue el ar$umento str, cero si soni$uales & W1 si es menor(

ss++::contienecontiene9str as ss++; as inte%er=evuelve 1 si el ob'eto ssCC contiene en cualuier "arte de la cadenael ar$umento str(

ss++::&uscar&uscar9caracter as strin%, desdeelfinal as inte%er; as inte%er.usca un caracter en la cadena & devuelve su "osici#n( =e noencontrarlo devuelve el valor ssF\EY@SE(Nota4 Solo se tomar+ en cuenta el "rimer caracter del strin$ enviado

como "rimer "ar+metro en este m-todo(



32/101


ss++::freqfreq9caracter as strin%; as inte%er=evuelve el n%mero de veces ue a"arece un caracter en la cadena(Nota4 Solo se tomar+ en cuenta el "rimer caracter del strin$ enviadocomo "ar+metro en este m-todo(

ss++::o&tcaractero&tcaracter9n as inte%er; as strin%=evuelve el caracter ue se encuentra en la "osici#n n de la cadena(

ss++::o&tstrin%o&tstrin%9; as strin%=evuelve el contenido de la cadena(

ss++::#acia#acia9; as inte%er

=evuelve 1 si la cadena esta vacia(ss++::esnumeroesnumero9; as inte%er=evuelve 1 si la cadena re"resenta un valor num-rico(

ss++::espala&raespala&ra9; as inte%er=evuelve 1 si la cadena es una "alabra(

ss++::ultimo

ultimo9; as strin%=evuelve el %ltimo caracter de la cadena(

ss++::iGquierdaiGquierda9n as inte%er; as strin%=evuelve los n "rimeros caracteres de la cadena(

ss++::lon%itudlon%itud9; as inte%er=evuelve la lon$itud de la cadena(

ss++::minusculasminusculas9; as strin%=evuelve la cadena convertida a min%sculas(

ss++::con#ertirminusculascon#ertirminusculas9;

ransforma el contenido del ssCC convirti-ndolo en min%sculas(

ss++::con#ertirma-usculascon#ertirma-usculas9;

ransforma el contenido del ssCC convirti-ndolo en ma&%sculas(

ss++::su&cadenasu&cadena9"os as inte%er, ncaracteres as inte%er; as strin%



33/101


=evuelve una subcadena a "artir del contenido del ssCC, ue comien3aen pos & tiene ncaracteres de lon$itud(

ss++::padpad9n as inte%er, car as strin%GO O, fromRi$!t as inte%er G true;

$re$a n caracteres car 9"or defecto G O O; en un e)tremo 9derec!o "ordefecto; de la cadena contenida en el ssCC(

ss++::a%re%arinicioa%re%arinicio9te)to as strin%;$re$a un te)to al inicio de la cadena contenida en un ssCC(

ss++::remo#erremo#er9n as inte%er;Elimina la "orci#n de la cadena contenida en un ssCC desde el caractern !asta el final(

ss++::remo#erultimoremo#erultimo9;Elimina el %ltimo caracter de la cadena(

ss++::reemplaGarreemplaGar9str1 as strin%, str2 as strin%, todos as inte%er G true; asinte%erReem"la3a la cadena str1 "or str2 en el contenido del ssCC( Si el"ar+metro todos es verdadero 9"or defecto lo es; se reem"la3an todaslas ocurrencias, de otro modo s#lo ser+ reem"la3ada la "rimera

ocurrencia( =evuelve el n%mero de reem"la3os !ec!os(ss++::derecadereca9 n as inte%er; as strin%=evuelve los n caracteres e)istentes al final de la cadena(

ss++::estcaracterestcaracter9 n as inte%er, c!ar as strin$;Establece el caracter de la "osici#n n en la cadena( Solo se em"lear+ el"rimer caracter del se$undo "ar+metro(

ss++::optimiGaroptimiGar9;Minimi3a la memoria del ssCC( Se em"lea "ara a'ustar la memoria de lacadena si se le reserv# anteriormente m+s de la realmente necesariamediante el m-todo reservar (

ss++::comienGaconcomienGacon9inicio as strin%, resto as ss++GDLL; as inte%erBerifica ue la cadena contenida en un ssCC comience con el te)to del"ar+metro inicio, de ser as/ le establece al "ar+metro resto 9si no esDLL; el resto de la cadena sin el "refi'o contenido en inicio( Entonces

devuelve 1, sino devuelve 0(



34/101


ss++::finaliGaconfinaliGacon9final as strin%, resto as ss++GDLL; as inte%erBerifica ue la cadena contenida en un ssCC finali3a con el te)to del"ar+metro %inal, de ser as/ le establece al "ar+metro resto 9si no esDLL; el resto de la cadena sin el surfi'o contenido en %inal( Entonces

devuelve 1, sino devuelve 0(ss++::anum&eranum&er9; as num&er=evuelve el contenido del ssCC a number(

ss++::trimtrim9fromRi$!t as inte%er G true;Elimina los es"acios vacios 9es"acios, saltos de l/nea, tabs, etc; en elestremo i3uierdo o en el derec!o 9derec!o "or defecto; de la cadenacontenida en el ssCC(

ss++::truncartruncar9"os as inte%er;Elimina los caracteres a "artir de la "osici#n pos en la cadena del ssCC(

ss++::ma-usculasma-usculas9; as strin%=evuelve el contenido del ssCC en ma&%sculas(

!lase ss,imClase "ara la $esti#n de dimensiones( Mu& em"leada en laconstrucci#n de ob'etos(

ss/im::ss/imss/im9 anc!o as inte%er, alto as inte%er; as ss/im

ss/im::o&tancoo&tanco14 as inte%er=evuelve el anc!o de un ss=im(

ss/im::o&talto

o&talto14 as inte%er=evuelve el alto de un ss=im(

ss/im::estest1anco as inte%er, alto as inte%er4Establece el anc!o & alto de un ss=im(

ss/im::estancoestanco1w as inte%er4Establece el anc!o de un ss=im(

ss/im::estaltoestalto1 as inte%er4



35/101


Establece el alto de un ss=im(

ss/im::Fss/imFss/im14=estructor de la clase(

!lase ssFuenteClase "ara el mane'o de fuentes(

ss?uente::ss?uentess?uente9dimension as inte%er, familia as inte%er, estilo as inte%er, $rosoras inte%er, subra&ado as inte%erG false, nombrefuente as strin%G II; asss?uente=onde4dimensi#n es el tama*o de la fuente(familia4 Las familias de fuentes constitu&en una forma de referirse a

fuentes sin es"ecificar el nombre( Ellas son4

ss?F?M@L5\=E?DL 9"redeterminada;ss?F?M@L5\=ECFR@BEss?F?M@L5\RFMss?F?M@L5\SCR@ss?F?M@L5\S:@SSss?F?M@L5\MF=ERss?F?M@L5\ELE5E

El estilo "uede tomar los valores4ss?FS5LE\FRMLss?FS5LE\SLss?FS5LE\@L@C

El $rosor "ude tomar los valores4ss?F:E@


36/101


o&tdimension9; as inte%er=evuelve el tama*o de la fuente(

ss?uente::o&testiloo&testilo9; as inte%er

=evuelve el estilo de la fuente(ss?uente::o&tsu&ra-adoo&tsu&ra-ado9; as inte%er=evuelve si la fuente tiene estilo subra&ado(

ss?uente::o&t%rosoro&t%rosor9; as inte%er=evuelve el $rosor de la fuente(

ss?uente::estnom&refuente

estnom&refuente9nombrefuente as strin%;Establece el nombre de la fuente(

ss?uente::estfamiliaestfamilia9familia as inte%er;Establece la familia de la fuente(La familia "uede tomar los valores4ss?F?M@L5\=E?DL 9"redeterminada;ss?F?M@L5\=ECFR@BEss?F?M@L5\RFMss?F?M@L5\SCR@

ss?F?M@L5\S:@SSss?F?M@L5\MF=ERss?F?M@L5\ELE5E

ss?uente::estdimensionestdimension9dimension as inte%er;Establece el tama*o de la fuente(

ss?uente::estestiloestestilo9estilo as inte%er;Establece el estilo de la fuente(

El estilo "uede tomar los valores4ss?FS5LE\FRMLss?FS5LE\SLss?FS5LE\@L@C

ss?uente::estsu&ra-adoestsu&ra-ado9subra&ado as inte%er;Establece el subra&ado de la fuente(

ss?uente::est%rosor

est%rosor9$rosor as inte%er;Establece el $rosor de la fuente(



37/101


El $rosor "ude tomar los valores4ss?F:E@


38/101


ss.@M\5E\Mss.@M\5E\CYss.@M\5E\@Css.@M\5E\@CFss.@M\5E\MCCDRSFRss.@M\5E\5

ssIma%enBase::xpmaima%en)"maima$en9datos as ta≤Car$a una tabla de valores ue contiene la informaci#n de una ima$en similaral formato )"m(E'em"lo4

cursor G UI11 17 1I,I c [E?E?E?I,I( c [....I,I c [8C8=0I,I c [?6?6?I,I[ c [?1?2?6I,

I c [E8EE?I,I c [==CE1I,IJ c [E??0?2I,IK c [...CI,IG c [EEE=I,IW c [=8==?I,I c [E=EE?1I,I^ c [?7??I,I, c [EE6EI,I c [=7==CI,I; c [E.ECE?I,IZ c [E1E2E8I,I_ c [==7=I,IU c [EEE=I,I c [=E=?E7I,I c [=1=2=I,

I> c [EE8ECI,I9 c [=C==EI,I\ c [CE=0=7I,I4 c [E7EEI,I] c [==.E1I,I c [CCC==2I,IV c [EE6E8I,I| c [==8=EI,I1 c [CC.=0I,I2 c [.C.=.EI,I c [=7==CI,I6 c [=2==I,I7 c [=0=1=I,I c [CEC?=7I,I c [=0=0=1I,I8 c [.=I,

I (( I,I((I,I[I,IJKKGGGKKWI,IK^,,,K^I,I;ZZZZZZZ_I,IUI,I>9999999\I,I4]]]]]]]I,IV|||||||1I,I22I,I 2666662 I,I 27772 I,I 22 I,I 8 IV

>>creando el ob'eto ss@ma$en.aseunaima$en Gss@ma$en.ase9ssull@ma$en.ase9;;>>car$ando los datos en el ob'eto ss@ma$en.ase



39/101


unaima$en()"maima$en9cursor;

ssIma%enBaseF::ssIma%enBase_ss@ma$en.ase9;=estructor de los ob'etos de esta clase(

E'em"lo4unaima$en Gss@ma$en.ase9ssull@ma$en.ase9;;_unaima$en

Nota importante:El em"leo de la clase ss@ma$en.ase es de $ran utilidad combin+ndolo con elob'eto @ma$en & bot#n del "ro&ector( =ic!os ob'etos contienen m-todos 9"ore'em"lo Est@ma$en@.; ue le "ermiten car$ar el contenido de unss@ma$en.ase( Esto %ltimo unido con el m-todo xpmaimagen "ermite tenerim+$enes em"otradas en las a"licaciones en forma de scri"t, eliminando as/las de"endencias e)ternas a estos recursos de ima$en & aumentando la

velocidad de car$a(

!lase ssSonidoClase "ara la re"roducci#n de sonidos de diversos formatos 9m", wav,etc; a nivel de libro( Esta clase es em"leada "articularmente "arare"roducir & control de sonidos ue "uedan ser escuc!ados durante lanave$aci#n entre "+$inas(

ssSonido::ssSonidossSonido9nombre as strin%, fic!ero as strin%; as ssSonidoConstructor de la clase ssSonido( ara construir un ob'eto ssSonido "uede

"asarse el "ar+metro fic!ero con el valor NO & lue$o em"lear el m-todocar$ar( El "ar+metro nombre ser+ el identificador em"leado "ara la ca"turade los eventos como mismo sucede con los ob'etos del "ro&ector(

ssSonido::reproducirreproducir9;@nicia la re"roducci#n de un ssSonido(

ssSonido::pausarpausar9;Hace una "ausa en la re"roducci#n de un ssSonido(

ssSonido::detenerdetener9;=etiene la re"roducci#n de un ssSonido(

ssSonido::o&t#olumeno&t#olumen9; as Num&er=evuelve el volumen de un ssSonido(

ssSonido::o&testadoo&testado9; as inte%er

=evuelve el estado actual de un ssSonido( Los valores devueltos"ueden ser4



40/101


SS\=EE@=FSS\DSSS\RERF=DC@E=F

ssSonido::car%ar

car%ar9 fic!ero as strin%; as inte%er=evuelve 1 si el ssSonido "udo car$ar un fic!ero(

ssSonido::posicionarposicionar9 "os as inte%er; as inte%er=evuelve 1 si el ssSonido "udo "osicionar su re"roducci#n en la"osici#n "os(

ssSonido::est#olumenest#olumen9 vol as num&er;Establece el volumen de ssSonido( Los valores admitidos van desde 0

!asta 1(

ssSonido::o&tposiciono&tposicion9; as inte%er=evuelve la "osici#n de re"roducci#n de un ssSonido(

ssSonido::o&tduraciono&tduracion9; as inte%er=evuelve la duraci#n de un fic!ero car$ado en un ssSonido(

-rabajo con fic:erosw).asic "ermite el tratamiento de fic!eros mediante acceso aleatorio,binario & secuencial(

OPENFE fic!ero ?FR modo S [canal

bre un fic!ero "ara lectura, escritura & escritura manteniendo sucontenido( Esta sinta)is es al$o inc#moda & anti$ua, "referiblementeem"lee ?F"en9;(

Los modos de abrir un fic!ero son4

• @n"ut Leer desde un fic!ero• Fut"ut Escribir en el fic!ero destru&endo el contenido anterior• ""end Escribir en el fic!ero manteniendo el contenido anterior

El canal es el n%mero ue identifica el fic!ero( Se "uede obtener uncanal libre llamando a la funci#n ?ree?ile9;(

Cierre un fic!ero mediante Close [ o ?close9;( Es "osible adem+s cerrartodos los fic!eros abiertos mediante Close(



41/101


co"iar Isource(t)tI a Ico"&(t)tIFE Isource(t)tI ?FR @D S [1FE Ico"&(t)tI ?FR FDD S [2

leer el "rimer fic!ero e ir co"i+ndolo al se$undo

:H@LE F EF?9 1 ;L@E @D [1, te)tR@ [2, te)t

:E=

cerrar los fic!erosCLFSE [1CLFSE [2

SHA/6,SHRE= variable U, variable V

=eclara una variable en una funci#n o Sub !aciendo referencia a unavariable $lobal de i$ual nombre, "ermitiendo acceder a la $lobalmediante dic!a variable local(

=@M MiBariable


42/101


acumular valores en resultresult G result n

E= @?

devolver el resultado acumulado

REDR result

E= ?DC@F

PRINT

R@ [ e)"r U e)"r , V

Escribe una cadena o el valor de una e)"resi#n en un fic!ero a trav-sdel !andler del fic!ero "reviamente abierto4

h abrir un fic!ero "ara escrituraFE Iout"ut(t)tI ?FR FDD S [1

h escribe te)to en el fic!eroR@ [1, NEsto es escrito en el fic!eroOR@ [1, N& tambi-n estoO

h cerrar el fic!eroCLFSE [1

.tras funciones para el trabajo con fic:eros ydirectorios

::ssconcatenarficerosssconcatenarfic!eros9fic!ero1 as strin%, fic!ero2 as strin%, fresultado as strin%; as inte%erConcatena dos fic!eros 9fic!ero1 & fic!ero2; en un uno 9fresultado; & devuelve 0 o 1 se$%n elresultado de la o"eraci#n(

::sscopiarficerossco"iarfic!ero9fic!ero1 as strin%, fic!ero2 as strin%, reescribirG1 as inte%er; as inte%erHace una co"ia de fic!ero1 en fic!ero2 con la o"ci#n de reescribir activada "or defecto(=evuelve 0 o 1 se$%n el resultado de la o"eraci#n(

::ssexistedirectoriosse)istedirectorio9directorio as strin%; as inte%erBerifica la e)istencia de un directorio(

::sssolodirectoriosssolodirectorio9directorio as strin%; as strin%=ada la direcci#n de un fic!ero, devuelve s#lo el directorio, eliminando el nombre del fic!erode la cadena "asada "or el "ar+metro directorio(

::ssdirectorioa&solutossdirectorioabsoluto9directorio as strin%; as inte%er=evuelve 1 si el "ar+metro "asado constitu&e un directorio absoluto(

::ssdirectoriosossdirectorioso9; as strin%=evuelve el directorio del sistema o"erativo(



43/101


::sso&tomessobt!ome9; as strin%=evuelve el directorio Home(

::ssestdirectoriotra&a'ossestdirectoriotraba'o9directorio as strin%;

Establece el directorio de traba'o del sistema(::sso&tdirectoriotra&a'ossobtdirectoriotraba'o9; as strin%=evuelve el directorio actual de traba'o del sistema(

.tras Funciones de Sora Script

continuaci#n se describen las funciones ue se adicionaron alcom"ilador ori$inal de w).asic "ara controlar los elementos ue

com"onen al "ro&ector & fundamentalmente "ara el traba'o con losob'etos, las "+$inas, el libro, etc(

?unciones de na#e%aci0n entre p.%inas

::ssna#e%arssnave$ar9 pag as inte%er; as inte%erermite nave$ar a una "+$ina conociendo su "osici#n 9"a$; en la lista de "+$inas( Si la"+$ina e)iste devuelve 1, sino 0(

::ssna#e%arapa%inassnave$ara"a$ina 9 pag as strin%; as inte%er

ermite nave$ar a una "+$ina conociendo nombre 9"a$;( Si la "+$ina e)iste devuelve 1, sino0(

::ssna#e%arsi%uientessnave$arsi$uiente 9; as inte%erermite nave$ar a la si$uiente "+$ina( Si la "+$ina e)iste devuelve 1, sino 0(

::ssna#e%aranteriorssnave$aranterior 9; as inte%erermite nave$ar a la "+$ina anterior( Si la "+$ina e)iste devuelve 1, sino 0(

::ssexistepa%ina

sse)iste"a$ina 9 pag as inte%er; as inte%erBerifica la e)istencia de una "+$ina conociendo su "osici#n 9"a$;( Si la "+$ina e)istedevuelve 1, sino 0(

::sso&tposicionpa%inassobt"osicion"a$ina 9 pag as strin%; as inte%er=evuelve la "osici#n de una "+$ina conociendo su nombre 9"a$;, si no e)iste devuelve W1(

::ssna#e%aam&itopa%inassnave$aambito"a$ina 9 pag as strin%;Esta funci#n se em"lea fundamentalmente en scri"ts ue son e'ecutados en el runtime "arasimular un cambio de +mbito de "+$ina( ara m+s informaci#n ver el a"artado El Runtime(

::sspa%inaestfondoss"a$inaestfondo9fic!ero as strin%; as inte%er



44/101


Establece la ima$en de fondo del "ro&ector( =evuelve 0 o 1 se$%n el resultado de lao"eraci#n(

.tras funciones

::ssestmodo#ideossestmodovideo9anc!o as inte%er, alto as inte%er, "colores as inte%er, refres! as inte%er;as inte%erermite cambiar la resoluci#n de la "antalla( Este m-todo "uede fallar "ara al$unasdistribuciones de Linu)( =evolver+ 1 si lo$ra !acer el cambio de resoluci#n, sino devuelve 0(

::sspantallacompletass"antallacom"leta9"com"letaGtrue as inte%er; as inte%erRedimensiona la a"licaci#n al tama*o de la "antalla, devuelve 1 si lo lo$ra, de lo contrariodevuelve 0(

::sspunteroo&tposicionss"unteroobt"osicion9; as inte%er, as inte%er

=evuelve la "osici#n del "untero del mouse en la a"licaci#n(

::ssredi&u'arssredibu'ar9;rovoca el redibu'ado de toda el +rea del "ro&ector

::ssredi&u'arrectan%ulossredibu'arrectan$ulo9) as inte%er, & as inte%er, anc!o as inte%er, alto as inte%er;rovoca el redibu'ado del +rea del "ro&ector com"rendida en el rect+n$ulo ue tiene ori$enen ),& con un anc!o & alto es"ec/fico(

::ssmostrarmarcossmostrarmarco9mostrarGtrue as inte%er;

Muestra u oculta un fondo tras la a"licaci#n(

::ssmarcoestcolorssmarcoestcolor9color as ss+olor;Establece el color del fondo tras la a"licaci#n ue "or defecto es ne$ro(

::sso&t#aram&ientessobtvarambiente9nombre as strin%; as strin%=evuelve el valor de una variable de ambiente(E'em"lo4>>este e'em"lo devuelve la ruta del directorio Home en linu) ssmensa'e9ssobtvarambiente9IHFMEI;;

::ssest#aram&ientessestvarambiente9nombre as strin%, valor as #ariant;Establece el valor de una variable de ambiente( Si no e)iste la crea(

::sseliminar#aram&ientesseliminarvarambiente9nombre as strin%;Elimina una variable de ambiente(

::ssfecamodificacionficerossfec!amodificacionfic!ero9fic!ero as strin%; as strin%=evuelve la fec!a de modificacion de un fic!ero(

::ssficeroderutassfic!eroderuta9ruta as strin%; as strin%

=evuelve el nombre de un fic!ero e)traido de una ruta 9no necesariamente debe e)istir dic!aruta;(E'em"lo4



45/101


ficGfic!eroderuta9N>!ome>usuario>leeme(t)tO;>>fic toma el valor Nleeme(t)tO

::ss&uscarprimerficerossbuscar"rimerfic!ero9ruta as strin%; as strin%=evuelve el "rimer fic!ero contenido en una ruta(

::ss&uscarproximoficerossbuscar"ro)imofic!ero9ruta as strin%; as strin%=evuelve el "r#)imo fic!ero contenido en una ruta(

E'em"lo4>>este e'em"lo "ermite recorrer cada uno de los fic!eros contenidos en >usr>local ss Gssbuscar"rimerfic!ero9I>usr>local>KI; tt G ss w!ile len9ss;^0 ssGssbuscar"ro)imofic!ero9; tt G tt J ss J IQnI end w!ile ssmensa'e9tt;

::ssreproducirwa#ssre"roducirwav9fic!ero as strin$,sinc as inte$erGSS\S@CRF@CF;Re"roduce un fic!ero de sonido de formato :B de forma sincr#nica o asincr#nicaEl "ar+metro sinc "uede tomar los valores4SS\S@CRF@CF re"roducci#n sincr#nicaSS\S@CRF@CF re"roducci#n asincr#nica

::sse'ecutarsse'ecutar9comandos as strin%, sinc as inte%er@J; as inte%erE'ecuta comandos(Los valores ue "uede tomar el "ar+metro sinc son40 E'ecuci#n asincr#nica

1 E'ecuci#n sincr#nica2 E'ecuci#n visible E'ecuci#n no des!abilitada

::ssresultadoe'ecucionssresultadoe'ecucion9comandos as strin%; as strin%=evuelve la salida de errores ue $enera un e'ecutable al cerrarse( Este m-todo "uede serem"leado "ara obtener informaci#n del funcionamiento de un "ro$rama e'ecutado alcerrarse(

::ssconsolassconsola9comandos as strin%; as inte%erE'ecuta un comando de consola & devuelve el resultado(

::ssaplicacionestmascarassa"licacionestmascara9fic!ero as strin%, color as ssColor, tolerancia as inte%er; as inte%erermite establecerle una m+scara a la a"licaci#n a "artir de un fic!ero de ima$en( Los"ar+metros ro'o, verde & a3ul son el color ue se tornar+ trans"arente de la su"erficie de laa"licaci#n( El "ar+metro tolerancia selecciona !asta ue intensidad del color seleccionado setornar+ trans"arente( =evuelve 0 o 1 si lo$ra reali3ar la o"eraci#n(

::ssaplicacionesttitulossa"licacionesttitulo9titulo as strin%;Establece el t/tulo de la ventana de la a"licaci#n

::ssaplicacionestpunterossa"licacionest"untero9"untero as inte%er | strin%;Establece el "untero de la a"licaci#n "as+ndole como "ar+metro el valor de un "untero"redeterminado o la direcci#n de una ima$en( Los "unteros "redeterminados son4



46/101


SS\DERF\MF Re"resenta una manoSS\DERF\E=@C@F untero de edici#n de te)toSS\DERF\RFH@.@=F S/mbolo de "ro!ibici#nSS\DERF\@ERRF


47/101


end if

::sspunteroestposicionss"unteroest"osicion9) as inte$er, & as inte$er;Sit%a el "untero del mouse en una "osici#n(

::sslanGarna#e%adorsslan3arnave$ador9direcci#n as strin$; as inte%erLan3a el nave$ador "or defecto con una direcci#n( =evuelve 0 o 1 se$%n el resultado de lao"eraci#n(

::sso&tmodo#ideossobtmodovideo9; as inte%er, as inte%er=evuelve la resoluci#n actual de la "antalla(E'em"lo4Lar$o, anc!oG ssobtmodo9;

::ssllamadassllamada9"adre as o&'ect, "rocedimiento as strin% (((; as inte%er

@ntenta reali3ar una llamada a un "rocedimiento( =evuelve 1 si lo consi$ue, de lo contrariodevuelve 0( El "ar+metro "adre "uede tomar el valor 0 9o not!in$; si el "rocedimieto al uese desea llamar se encuentra en el +mbito $lobal, sin# debe es"ecificarse el ob'eto al ue le"ertecene este "rocedimieto( Los dem+s "ar+metros son los "ar+metros ue se em"lear+"ara reali3ar la llamada & no "ueden ser un n%mero ma&or de 20(ota4Este m-todo es es"ecialmente %til "ara automati3ar llamadas & en la $eneraci#n de eventosde clases de usuarios en las ue interven$an o no ob'etos del "ro&ector(

::car%arrecursocar$arrecurso9as strin%;as inte%er$re$a e inter"reta un fic!ero de c#di$o en tiem"o de e'ecuci#n incor"orando el scri"t uecontiene al +mbito $lobal( El c#di$o incluido tendr+ acceso a los "rocedimientos, variables &clases del c#di$o &a inter"retados( ara e'ecutar un "rocedimiento ue se encuentre en un

fic!ero de c#di$o car$ado em"lee el m-todo ssllamada estableciendo el "rimer "ar+metro anot!in$ & es"ecificando el nombre del "rocedimiento & los "ar+metros 9ver ssllamada;(

::o&to&'etoobtob'eto9nombreob' as strin%; as ssO&'eto=evuelve el "untero !acia un ob'eto del "ro&ector cu&o nombre sea nombreob'(=e e)istir m+s de un ob'eto con dic!o nombre se tomar+ el "rimero se$%n el orden decreaci#n( Si no e)iste un ob'eto con dic!o nombre el ob'eto no modifica su valor(Nota4 Este m-todo es em"leado "ara obtener una referencia a los ob'etos creados en modode edici#n mediante el @=E de HEduc( Es el %nico modo de acceder a estos ob'etos desdescri"t(E'em"lo4

>>se su"one ue e)iste un ob'eto creado desde el ide de HEduc con nombre Nboton1O

dim botGobtob'eto9Iboton1I;if9bot; t!enbot(estte)to9IBerticalI;

bot(rotar90;end if

,i;logos comunesLos di+lo$os de Sora Scri"t son clases internas ue "ermiten el intercambio de informaci#nentre el usuario & las a"licaciones( Estos di+lo$os son4

ss=ialo$oColorss=ialo$o?ic!eross=ialo$o=irectorio

ss=ialo$oe)toss=ialo$o?uentess=ialo$oMensa'e



48/101


ssMensa'e

clase ss,ialogo!olor Clase "ara la selecci#n de colores "or el usuario(

ss/ialo%o+olorss=ialo$oColor44ss=ialo$oColor9color as ssColor; as ss/ialo%o+olorCrea un cuadro de di+lo$o "ara la selecci#n de colores( La a"ariencia del di+lo$o de"ender+del sistema o"erativo 9:indows o Linu);(

ss/ialo%o+olor::mostrarmostrar9; as inte%erMuestra un di+lo$o de color "reviamente creado & devuelve los valores SS\CER oSS\CCELR de"endiendo del bot#n "ulsado "or el usuario al cerrar el di+lo$o(

ss/ialo%o+olor::o&tcolorobtcolor9; as sscolor=evuelve el color seleccionado en la ventana de di+lo$o de color(

E'em"lo4 >>color inicial ne$ro colorGsscolor90,0,0; dialo$oGss=ialo$oColor9color; if dialo$o(mostrar9;GSS\CER t!en colorGdialo$o(obtcolor9; ssMensa'e9IEl color seleccionado fue4 ro'oÎ J color(ro'o9; J I verdeÎ J color(verde9; J I a3ulÎ Jcolor(a3ul9;; else ssmensa'e9Iccion canceladaI; end if

clase ss,ialogoFic:eroClase "ara la selecci#n de fic!eros "or el usuario(ss/ialo%o?icero::ss/ialo%o?iceross=ialo$o?ic!ero9t/tulo as strin%GNSeleccione un fic!eroO, directorio as strin%GNO, fic!eroas strin%GNO, filtro as strin%GNKO, estilo as inte%er G SS\.R@R, "os asssPuntoGssosicionor=efecto; as ss/ialo%o?icero


49/101


obtnombrefic!ero9; as strin%=evuelve el fic!ero "or defecto de di+lo$o(

ss/ialo%o?icero::o&tmensa'eobtmensa'e9; as strin%=evuelve el mensa'e ue ser+ mostrado en el di+lo$o(

ss/ialo%o?icero::o&trutaobtruta9; as strin%=evuelve la ruta com"leta 9directorio & nombre del fic!ero; del fic!ero seleccionado(

ss/ialo%o?icero::o&testiloobtestilo9; as inte%er=evuelve el estilo de creaci#n del di+lo$o(

ss/ialo%o?icero::o&tfiltroobtfiltro9; as strin%=evuelve el filtro del di+lo$o(

ss/ialo%o?icero::estdirectorioestdirectorio9dir as strin%;Establece el directorio "or defecto del di+lo$o(

ss/ialo%o?icero::estnom&reficeroestnombrefic!ero9fic!ero as strin%;Establece el fic!ero "or defecto del di+lo$o(

ss/ialo%o?icero::estmensa'eestmensa'e9mensa'e as strin%;Establece el mensa'e ue va a ser mostrado "or el di+lo$o(

ss/ialo%o?icero::estrutaestruta9ruta as strin%;

Establece la ruta ue ser+ devuelta cuando el di+lo$o sea cerrado(ss/ialo%o?icero::estestiloestestilo9estilo as inte%er;Establece el estilo ue tendr+ el di+lo$o al mostrarse(

ss/ialo%o?icero::estfiltroestfiltro9filtro as strin%;Establece el filtro ue tendr+ el di+lo$o "ara la selecci#n de los fic!eros(

ss/ialo%o?icero::mostrarmostrar9; as inte%erMuestra un di+lo$o de fic!ero "reviamente creado & devuelve los valores SS\CER oSS\CCELR de"endiendo del bot#n "ulsado "or el usuario al cerrar el di+lo$o(

clase ss,ialogo,irectorioClase "ara la selecci#n de directorios "or el usuario(

ss/ialo%o/irectorio::ss/ialo%o/irectorioss=ialo$o=irectorio9t/tulo as strin%GNO, directorio as strin%GNO,"os as sspunto Gssosicionor=efecto; as ss/ialo%o/irectorioMuestra un di+lo$o "ara la selecci#n de directorios(

ar+metros4t'tulo /tulo del di+lo$o(directorio =irectorio "or defecto en el ue abrir+ el di+lo$o(

pos osici#n donde a"arecer+ el di+lo$o(

ss/ialo%o/irectorio::o&tdirectorio



50/101


obtdirectorio9; as strin%=evuelve el directorio "or defecto o el seleccionado "or el usuario en el di+lo$o(

ss/ialo%o/irectorio::o&tmensa'eobtmensa'e9; as strin%=evuelve el mensa'e ue ser+ mostrado en el di+lo$o(

ss/ialo%o/irectorio::estmensa'eestmensa'e9mensa'e as strin%;Establece el mensa'e ue va a ser mostrado "or el di+lo$o(

ss/ialo%o/irectorio::estdirectorioestdirectorio9dir as strin%;Establece el directorio "or defecto del di+lo$o(

ss/ialo%o/irectorio::mostrarmostrar9; as inte%erMuestra un di+lo$o de directorio "reviamente creado & devuelve los valores SS\CER oSS\CCELR de"endiendo del bot#n "ulsado "or el usuario al cerrar el di+lo$o(

clase ss,ialogo-extoClase "ara la creaci#n de ca'as de di+lo$o de entrada de te)to(ss/ialo%oTexto::ss/ialo%oTextoss=ialo$oe)to9contenido as strin% , t/tulo as strin%G NEntre el te)toO, valor"ordefecto asstrin%GNO, "os as sspuntoG ssosicionor=efecto; as ss/ialo%oTexto


51/101


Muestra un di+lo$o de selecci#n de fuente "reviamente creado & devuelve los valoresSS\CER o SS\CCELR de"endiendo del bot#n "ulsado "or el usuario al cerrar eldi+lo$o(

clase ss,ialogo1ensajeClase "ara mostrar ca'as de mensa'es(

ss/ialo%oMensa'e::ss/ialo%oMensa'ess=ialo$oMensa'e9 contenido as strin% , t/tuloGNMensa'eO as strin%,iconoGSS\@@?FRMC@F as inte$er, botonesGSS\.CER as inte%er; asss/ialo%oMensa'eCrea un di+lo$o de mensa'es(

ar+metros4contenido Contenido del mensa'e(t'tulo /tulo de la ventana de mensa'e(icono @cono de la ventana, "uede tener los valores4SS\@EYCLMC@F Muestra un icono de e)clamaci#nSS\@ERRFR Muestra un icono de errorSS\@RE


52/101


E'em"lo

resultadoGssMensa'e9N=e acuerdogO,Ore$untaO,SS\@RE


53/101


l mismo tiem"o estos ob'etos "ertenecen a una clase su"erior de la cual!eredan muc!as de sus "ro"iedades & m-todos, esta clase es SSFb'eto( Es"or ello ue los m-todos comunes de todos los ob'etos 9como el de establecerla "osici#n o la visibilidad; e)isten en cada ob'eto "or !aberlos !eredados deSSFb'eto(

!lase SS.bjeto

sso&'eto::sso&'etosso&'eto14 as sso&'eto@nstancia de un ob'eto $en-rico(

sso&'eto::estposicionest"osicion9"os as ssPunto;Establece la "osici#n del ob'eto(

sso&'eto::o&tposicionobt"osicion9; as ssPunto=evuelve la "osici#n del ob'eto

sso&'eto::o&tposicionxobt"osicion)9; as inte%er=evuelve la coordenada ) de la "osici#n del ob'eto(

sso&'eto::o&tposicion-obt"osicion&9; as inte%er=evuelve la coordenada & de la "osici#n del ob'eto(

sso&'eto::rotarrotar9 an$ulo as inte%er;

Rota el ob'eto 9si el ti"o de ob'eto lo "ermite; !asta el +n$ulo es"ecificado(

sso&'eto::o&tan%uloobtan$ulo9; as inte%er=evuelve el +n$ulo de rotaci#n del ob'eto(

sso&'eto::mostrarmostrar9;Hace visible el ob'eto(

sso&'eto::ocultaroocultar 9;Fculta el ob'eto(

sso&'eto::est#isi&leestvisible9 visibleG1 as inte%er;Establece la visibilidad del ob'eto(

sso&'eto::o&t#isi&leobtvisible9; as inte%er=evuelve 1 si el ob'eto est+ visible, de lo contrario devuelve 0(

sso&'eto::estarrastradoestarrastrado9 arrastrado as inte%er;ermite el arrastrado del o"(eto.

sso&'eto::estdimensionesestdimensiones9 dimension as ss/im;Establece las dimensiones del ob'eto(



54/101


sso&'eto::estpunteroest"unteror9 "untero as inte%er;Establece el puntero del mouse "ara este o"(eto( Los "unteros dis"onibles son4

SS\DERF\MF Re"resenta una manoSS\DERF\E=@C@F untero de edici#n de te)toSS\DERF\RFH@.@=F S/mbolo de "ro!ibici#nSS\DERF\@ERRF


55/101


)om"re ombre del ob'eto en el "ro&ectorcolumnas %mero de columnas%ilas %mero de filas

pos "osici#n de la tabladimensiones dimensiones de la tabla

Nota4 El n%mero m+)imo de filas & columnas en 70(

ssta&la::adicionarcolumnasadicionarcolumnas9 ncol as inte%er;diciona ncol columnas a una tabla(

ssta&la::adicionarfilasadicionarfila9 nfil as inte%er;diciona n%il filas a una tabla(

ssta&la::eliminarcolumnaeliminarcolumna9 scolumna as inte%er;Elimina la columna scolumna una tabla(

::eliminarfilaeliminarfila9 sfila as inte%er;Elimina la fila s%ila de una tabla

ssta&la::estedicionestedicion9 edit as inte%er;Har+ editable o no en tiem"o de e'ecuci#n 9se$%n el valor 0 o 1 del "ar+metro edit* unatabla(

ssta&la::#aciarvaciar9nombretabla as strin%;Elimina el contenido de una tabla(

ssta&la::est#alorceldaestvalorcelda9 scolumna as inte%er, sfila as inte%er, valor as strin%;Establece el valor de una celda locali3ada en la columna scolumna & la fila s%ila de una tabla(

ssta&la::estcolorlineaestcolorlinea9 color as ss+olor;Establece el color de la l/nea de una tabla(

ssta&la::estfuenteceldaestfuentecelda9 scolumna as inte%er, sfila as inte%er, fuente as ss?uente;Establece la fuente de una celda locali3ada en la columna scolumna & la fila sfila de unatabla(

ssta&la::estfuente

estfuente9 fuente as ss?uente;Establece la fuente de todas las celdas de una tabla(

ssta&la::estcolorfuenteestcolorfuente9 color as ss+olor;Establece el color de la fuente de una tabla(

ssta&la::estcolorfuenteceldaestcolorfuentecelda9 sfila as inte$er, scolumna as inte$er, color as ss+olor;Establece el color de la celda locali3ada en la columna scolumna & la fila s%ila de una tabla

ssta&la::estcolorfondoceldaestcolorfondocelda9 scolumna as inte$er, sfila as inte$er, color as ss+olor;Establece el color de fondo de la celda locali3ada en la columna scolumna & la fila s%ila deuna tabla(



56/101


:: ssta&laestcolorfondoestcolorfondo9 rcolor as ss+olor;Establece el color de fondo de todas las celdas de una tabla(

ssta&la::estdimensioncolumnaestdimensioncolumna9 scolumna as inte%er, tam as inte%er;

Establece el tama*o tam de la columna scolumna de una tabla(:: ssta&laestdimensionfilaestdimensionfila 9 sfila as inte%er, tam as inte%er;Establece el tama*o tam de la fila s%ila de una tabla(

ssta&la::o&tfuenteceldaobtfuentecelda9 scolumna as inte%er, sfila as inte%er; as ss?uente=evuelve la fuente de la celda locali3ada en la columna scolumna & la fila s%il de la tabla(

ssta&la::o&tcolorfuenteceldaobtcolorfuentecelda9 scolumna as inte%er, sfila as inte%er; as ss+olor=evuelve el color de fuente de una celda locali3ada en la columna scolumna & la fila s%ila dela tabla(

ssta&la::o&tnumerocolumnasobtnumerocolumnas9; as inte%er=evuelve el n%mero de columnas de una tabla(

ssta&la::o&tnumerofilasobtnumerofilas 9; as inte%er=evuelve el n%mero de filas de una tabla(

ssta&la::o&tdimensioncolumnaobtdimensioncolumna9 scolumna as inte%er; as inte%er=evuelve el tama*o de la columna scolumna de una tabla(

ssta&la::o&tdimensionfilaobtdimensionfila 9 sfila as inte%er; as inte%er=evuelve el tama*o de la fila s%ila de una tabla(

ssta&la::o&tcolorlineaobtcolorlinea9; as ss+olor=evuelve el color l/nea de una tabla cu&o nombre es nom"reta"la( Si e)iste m+s de una tablacon dic!o nombre, se tomar+ en cuenta s#lo la "rimera se$%n el orden de creaci#n(

ssta&la::o&t#alorceldaobtvalorcelda9 sfila as inte%er, scolumna as inte%er; as strin%=evuelve el valor de una celda locali3ada en la columna scolumna & la fila s%ila de una tabla(

!lase SSoton

Hereda de SSFb'eto(

ss&oton::ss&otonssboton9nombre as strin%, fima$en as strin%, "os as ssPunto, dimensiones as ss/im; asss&otonCrea un ob'eto bot#n en el "ro&ector a "artir de un fic!ero de ima$en %imagen.

ss&oton::estima%en;estima$en19 fima$en as strin%;Establece la "rimera ima$en del bot#n a "artir de un fic!ero de ima$en(

ss&oton::estima%en;IB

[email protected] data as ssIma%enBase;Establece la "rimera ima$en del bot#n a "artir de un ob'eto ss@ma$en.ase(



57/101


ss&oton::estima%en<estima$en29 fima$en as strin%;Establece la se$unda ima$en del bot#n a "artir de un fic!ero de ima$en(

ss&oton::estima%en


58/101


!lase SS6ti


59/101


diciona un "unto al "ol/$ono(

sspoli%ono::insertarpuntoinsertar"unto9 "os as inte%er, "unto as ssPunto;@nserta un "unto en la "osici#n pos de lista de "untos del "ol/$ono(

sspoli%ono::eliminarpuntoeliminar"unto9 "os as inte%er;Elimina el "unto "erteneciente a la "osici#n pos de lista de "untos del "ol/$ono(

sspoli%ono::estestiloestestilo9 estilo as inte%er;Establece el estilo de relleno del "ol/$ono( El "ar+metro estilo "uede tomar los si$uientesvalores4

SS\FL@


60/101


=evuelve las coordenadas de un punto de la lista de "untos del "ol/$ono(

!lase SS!textoCa'a de te)to(

!ereda de SSO&'eto(

ssctexto::ssctextosscte)to9nombre as strin%" "os as ssPunto, lar$o as inte%er; as ssctextoCrea una ca'a de te)to en el "ro&ector(

ssctexto::esttextoestte)to9te)to as strin%;Establece el te)to de la ca'a de te)to(

ssctexto::estfuenteestfuente9fuente as ss?uente;Establece la fuente de la ca'a de te)to(

ssctexto::#aciavacia9; as inte%er=evuelve 1 si el ob'eto ca'a de te)to se encuentra vac/o( =e lo contrario devuelve 0(

ssctexto::#aciarvaciar9;Elimina el te)to de la ca'a de te)to(

ssctexto::estcolormarcoestcolormarco 9 color as ss+olor;Establece el color del marco de la ca'a de te)to(

ssctexto::estmarco#isi&leestmarcovisible 9 visible as inte%er;Establece la visibilidad del marco de la ca'a de te)to(

ssctexto::o&ttextoobtte)to9; as strin%=evuelve el te)to de la ca'a de te)to(

ssctexto::o&tfuenteobtfuente9; as ss?uente=evuelve la fuente de la ca'a de te)to(

ssctexto::o&tcolormarcoobtcolormarco 9; as ss+olor

=evuelve el color del marco de la ca'a de te)to(

!lase SS*magenFb'eto ima$en(

!ereda de SSO&'eto(

ssima%en::ssima%enssima%en9nombre as strin%, fic!ero as strin%, "os as ssPunto, dimension as ss/im; asssima%enCrea una ima$en en el "ro&ector(

ssima%en::estima%enestima$en9fic!ero as strin%;Establece la ima$en del ob'eto a "artir de un fic!ero de ima$en(



61/101


ssima%en::estima%[email protected] as ssIma%enBase;Establece la ima$en del ob'eto a "artir de un ob'eto ss@ma$en.ase(

ssima%en::estima%en<

estima$en29 fic!ero as strin%;Establece la ima$en de intercambio del ob'eto a "artir de un fic!ero de ima$en(

ssima%en::estima%en


62/101


estfic!ero9 fic!ero as strin%;Establece el fic!ero e intenta car$arlo(

sstml::estpa%inalest"a$ina9 fic!ero as strin%;Establece el fic!ero e intenta car$arlo

sstml::adicionarcodi%oadicionarcodi$o9 codi$o!tml as strin%;$re$a c#di$o !tml "ara ser inter"retado "or el ob'eto(E'em"lo4dim ob'eto G new ss!tml9Nmi!tmlO, NO, ss"unto910,10;, ssdim900,200;;ob'eto(adicionarcodi$o9NHola, mundoO;

sstml::estcodi%oestcodi$o9codi$o!tml as strin%;Establece el c#di$o !tml "ara ser inter"retado "or el ob'eto(

sstml::o&tpa%ina

obt"a$ina9; as strin%=evuelve el nombre del fic!ero car$ado actualmente del ob'eto(

sstml::o&ttitulopa%inaobttitulo"a$ina9; as strin%=evuelve el nombre interno de la "+$ina car$ada actualmente(

sstml::atrasatras9;rovoca una nave$aci#n !acia atr+s 9si es "osible;(

sstml::adelanteadelante9;

rovoca una nave$aci#n !acia adelante 9si es "osible;(sstml::puedeadelante"uedeadelante9; as inte%er=evuelve 1 si el ob'eto "uede nave$ar !acia delante de lo contrario devuelve 0(

sstml::puedeatras"uedeatras9; as inte%er=evuelve 1 si el ob'eto "uede nave$ar !acia atr+s de lo contrario devuelve 0(

sstml::&orraristorialborrar!istorial9;.orra el !istorial de nave$aci#n del ob'eto(

sstml::selecionartodoselecionartodo9;Selecciona todo el contenido(

sstml::o&ttextoselecionadoobtte)toselecionado9; as strin%=evuelve el te)to seleccionado en el ob'eto(

sstml::desconectar#inculosdesconectarvinculos9 des as inte%er;El ob'eto Html "ermite car$ar "+$inas ue conten$an v/nculos a otras "+$inas( l !acer clicsobre uno de estos v/nculos el ob'eto reali3ar+ dos acciones, la "rimera ser+ $enerar elevento LinPclicP & la se$unda, tratar de nave$ar a la direcci#n de este v/nculo( Si se necesita

ue el ob'eto s#lo res"onda al evento sin intentar nave$ar, entonces este m-todo "ermitedesconectar o reconectar dic!a nave$aci#n(



63/101


!lase SS2istaFb'eto Lista(

!ereda de SSO&'eto(

sslista::sslistasslista9nombre as strin%, "os as ssPunto, dimension as ss/im , estilo as inte%er GSS\L@S\FRML; as sslista

Crea un ob'eto lista en el "ro&ector(El "ar+me

Date post:	07-Jul-2018
Category:	Documents
Upload:	galaxia613
View:	220 times
Download:	0 times

Manual de Sora Script

Documents