Manual de Referència - Blocs.pdf

Documentació de Referència - Blocs 1/25

Documentació de ReferènciaAquestes pàgines descriuen els blocs que es poden utilitzar en crear les seves aplicacions de App

Inventor.

BlocsEls blocs que es poden utilitzar en crear les seues aplicacions d'App Inventor.

• Definició Blocs

• Blocs de text

• Llista de blocs

• Blocs de Matemàtiques

• Blocs Lògics

• Blocs de Control

• Blocs de Color

Nota: Tota la informació que hi ha en aquest document la podreu trobar a la pàgina http://appinventor.mit.edu/explore/content/reference-documentation.html, però en àngles.

http://appinventor.mit.edu/explore/content/definition-blocks.html

http://appinventor.mit.edu/explore/content/reference-documentation.html

http://appinventor.mit.edu/explore/content/color-blocks.html

http://appinventor.mit.edu/explore/content/math-blocks.html

http://appinventor.mit.edu/explore/content/list-blocks.html


Definició de Blocs

Taula de continguts

• procedureName • procedureWithResult • name • variable • |


Procedure ( Procediment )

Recull una seqüència de blocs en un mateix grup. Això permet reutilitzar la seqüència de blocs en diverses ocasions mitjançant una trucada al procediment. Si el procediment té arguments, s'especifiquen aquests arguments mitjançant l'ús

de blocs name. Quan es crea un procediment, App Inventor genera automàticament un bloc call i el col·loca al calaix My Definitions. S'utilitza el bloc call per iniciar el procediment.Quan es crea un nou bloc de procediment, App Inventor tria un nom únic de forma automàtica. Pot fer clic al nom i escriure per canviar-lo. El nom dels procediments en una aplicació han de ser únics. App Inventor no li permeten definir dos procediments en la mateixa aplicació amb el mateix nom. Podeu canviar el nom d'un procediment en qualsevol moment mentre vostè està construint l'aplicació, canviant l'etiqueta de nom al bloc. App Inventor automàticament modificarà el nom dels blocs call associats per tal de igualar.

procedureWithResult ( Procediment amb resultat )

Igual que un bloc procedure, però una trucada al procediment retorna un resultat. Després de l'execució del procediment, el resultat és retornat al bloc connectat al sòcol return.

name ( Nom )

Crea un argument amb nom que pot utilitzar quan es crida a un procediment. S'especifica l'argument col·locant el bloc name en la definició del procediment en el sòcol arg. Podeu especificar tants arguments com necessiti: cada vegada que s'omple un sòcol arg, un altre serà creat per donar cabuda al següent argument. Per nomenar l'argument, fa clic al "nom" i el tipus d'etiqueta per canviar-lo.Quan s'especifica arguments de procediment, App Inventor l'associa amb el bloc call generat per al procediment: els sòcols d'argument del bloc call mostrarà els noms dels arguments que ha especificat.Per a cada bloc name a definir, App Inventor crea una bloc value associat i el col·loca al calaix My Definitions. S'utilitza aquest bloc per referir-se al valor de l'argument que es passa al procediment en ser cridat.Nota: En la versió actual d'App Inventor, els noms dels arguments en una aplicació han de ser únics, fins i tot a través dels procediments. Per exemple, no pots tenir dos procediments name cadascun amb una variable anomenada "x". Quan intenta crear la segona "x" al bloc, App Inventor no acceptarà aquest nom. Aquesta restricció es relaxarà previsiblement en el futur.

variable ( Variable )

Crea un valor que es pot modificar, mentre una aplicació s'està executant, i li dóna aquest valor un name. Les variables són globals en el seu abast, el que significa que es pot fer referència a elles des de


qualsevol part de codi en l'aplicació, fins i tot des de dins dels procediments.Quan es crea un nou bloc de variable, App Inventor tria un nom únic de forma automàtica. Pot fer clic al nom i tipus per canviar-lo. Els noms de variables en una aplicació han de ser únics. App Inventor no permet definir dues variables en la mateixa aplicació amb el mateix nom.Quan es crea una variable, App Inventor crearà automàticament dos blocs associats, i els col·locarà al calaix My Definitions:

• El bloc global obté el valor de la variable.

• El bloc set global canvia el valor de la variable.Podeu canviar el nom d'una variable en qualsevol moment mentre vostè està construint l'aplicació, i els blocs associats passaran a denominar igual de forma automàtica.

| ( Sòcol fictici )

Aquest bloc proporciona un "sòcol fictici" que permet encaixar un bloc que tingui un connector a la part esquerra, en un lloc on no hi ha sòcol on encaixar, tal com una seqüència de blocs en la secció do d'un procediment o en la secció then-do

d'un bloc if. El bloc encaixat s'executarà, però la seva eventual resultat serà ignorat. Això pot ser útil quan es defineix un procediment que retorna un resultat.


Blocs de Text

Taula de continguts

• text • = • join • make text • length • text • text= • text> • trim • upcase • downcase • starts at • contains • split at first • split at first of any • split • split at any • split at spaces • segment • replace all


text ( Text )

Conté una cadena de text.

= ( és igual a )

Comprova si els dos valors encaixats són iguals. Si és així, retorna veritable (true), en cas contrari, retorna fals (false). Aquest mateix bloc es troba al calaix de components lògics i es repeteix aquí per conveniència.

Els arguments poden ser qualsevol cosa, no només text.

join ( Annexar )

Annexa la segona cadena encaixada a la primera. Per aquesta operació, i per a totes les operacions de text, els nombres poden ser tractats com si es tractés de text. Per exemple, utilitzant un bloc join

pot unir 1+1 amb 2x3, obtenint 26 com resultat (2 unit a 6).

make text ( convertir a text )

Tots els valors proporcionats s'uneixen en una cadena de text.

Length ( longitud )

Retorna la longitud de la cadena donada.

Text < ( Text < )

Indica si l'argument de Text que es proporciona com a Primera Cadena (els d'abans del símbol) és alfabèticament menor (anterior) que la cadena de text que es proporcionada com a Segona Cadena (els de després del símbol) . Si dues cadenes comencen amb els mateixos caràcters, la cadena més curta es considera la menor (el final de cadena és menor que qualsevol caràcter de l'altra). Els caràcters en majúscules precedeixen als caràcters en minúscules (i es consideren, per tant, alfabèticament menors).


Text = ( Text = )

Informa de si les cadenes de text són idèntics, és a dir, tenen els mateixos caràcters en el mateix ordre.Tingueu en compte que si vostè està comparant els quadres de text que contenen dígits, hi ha una diferència entre comparant amb igualtat numèrica ordinària (=) davant en comparar com cadenes de text ( text = ). Si es creen dos quadres de text, una amb els caràcters 123 i un amb els caràcters 0123 , llavors aquests seran numèricament iguals però no igual, com cadenes de text. Anar amb compte que, quan es tracta de comparacions com aquesta, hi ha una diferència entre una entrada en els dígits utilitzant quadres de nombre, davant entrar-hi com quadres de text. Suposeu que vostè crea dos quadres numèrics, amb 123 i un altre amb 0123 . Si es comparen aquests dos quadres utilitzant text = obtindrà el resultat que són iguals. La raó és que els dígits que entren en una caixa de nombre es converteix en un nombre, la cadena real de dígits no es conserva. Per tenir en compte la cadena real de dígits, a continuació, utilitzar un quadre de text.

Text > ( Text > )

Indica si l'argument text primera cadena és alfabèticament més gran que la segona cadena de text. Si dues cadenes comencen amb els mateixos caràcters, la cadena més curta es considera menor. Els caràcters en majúscules precedeixen als caràcters en minúscules.

Trim ( Retallar )

Retorna una còpia del seu argument de cadena de text amb qualsevol espais inicials o finals eliminats.

Upcase ( Majúscules )

Retorna una còpia del seu argument de cadena de text en majúscules.

Downcase ( Minúscules )

Retorna una còpia del seu argument de cadena de text convertit a minúscules.

Starts at ( Comença a )

Retorna la posició del caràcter on el primer caràcter de piece apareix per primera vegada en text , o 0 si no hi és. Per exemple, la ubicació de “ana” a Havana banana és 4.

Contains ( Conté )


Retorna true si piece apareix en text , en cas contrari, retorna false.

Split at first ( dividir en primera )

Divideix el text especificat com argument text en dues peces, amb la ubicació de la primera aparició de l'argument at com a punt de divisió, i retorna una llista de dues element que consisteix en la part de la cadena abans del punt de divisió i l'altra partvdesprés del punt de

divisió. La divisió de poma, plàtan, cirera, pera amb una coma com a punt de divisió retorna una llista de dos elements: el primer és el text de poma i el segon és el text plàtan, cirera, pera. Recordeu que la coma després que poma no apareix en el resultat, perquè aquest és el punt de divisió.

Split at first of any ( dividir en primera de qualsevol )

Divideix el text donat com argument text en una llista de dos elements, utilitzant la ubicació de qualsevol element de la llista proporcionada com argument at ( divideix en la primera ocurrència del primer element trobat).

Split ( dividir )

Divideix el text donat com a argument text en parts utilitzant l'element donat com a argument at com a punt de divisió. Produeix una llista de resultats. La divisió del text one, two, three, four proporcionant, (coma) en l'argument at retorna la llista (one two three four). La divisió one-potato, two-potato, three-potato,

four at -potato retorna la llista (one two three four).

Split at any ( dividir en qualsevol )

Divideix el text que figura en una llista, utilitzant qualsevol dels elements de at com el punt de divisió, i retorna una llista dels resultats. La divisió appleberry, banana, cherry, dogfood, amb una llista com argument at el primer element és una coma i el segon element és rry

retorna una llista de quatre elements: (applebe banana che dogfood).


Split at spaces ( dividir en espais )

Divideix el text especificat per qualsevol aparició d'un espai, produint una llista de les parts resultants.

Segment ( Segment )

Extreu la part del text a partir de start amb tants caràcters com s'indiqui en lenght (longitud).

Replace all ( Reemplaçar tot )

Retorna una nova cadena de text obtinguts mitjançant la substitució de totes les aparicions de la subcadena amb la substitució.


Llistes de Blocs

Taula de continguts

• make a list

• select list item

• replace list item

• remove list item

• insert list item

• length of list

• append to list

• add items to list

• is in list?

• position in list

• pick random item

• is list empty?

• copy list

• is a list?

• list to csv row

• list to csv table

• list from csv row

• list from csv table


make a list ( fer una llista )

Crea una llista dels elements donats. Si no es proporciona cap argument,

es crea una llista buida, que es poden afegir elements més tard.

select list item ( seleccionar l'element de llista)

Selecciona l'element en l'índex especificat en la llista donada. El

primer element de llista en l'índex 1.

replace list item ( reemplaçar element de la llista )

Inserts de reemplaçament a la llista que figura en la

posició d'índex . L'element anterior en aquesta posició es

retira.

remove list item ( eliminar elements de la llista )

Elimina l'element en la posició especificada de la llista.

insert list item ( inserir element de la llista )

Insereix un element en una llista en la posició especificada.

length of list ( longitud de la llista )

Retorna el nombre d'elements de la llista.

append to list ( afegir a la llista )

Afegeix els elements de la segona llista al final de la primera llista.


add items to list ( afegir elements a la llista )

Afegeix els elements proposats per al final de la llista. La diferència

entre això i afegir a la llista és que afegir a la llista pren els elements

que s'adjunten com una sola llista, mentre que afegir elements a la

llista es proporcionen els elements com a arguments individuals.

is in list? ( és a la llista? )

Si alguna cosa és un dels elements de la llista , retorna true, en cas

contrari, retorna false. Tingueu en compte que si una llista conté

subllistes, els membres de les subllistes no són en si mateixos els

membres de la llista. Per exemple, els membres de la llista (1 2 (3 4)) són

1, 2, i la llista (3 4), 3 i 4 no són ells mateixos membres de la llista.

position in list ( posició a la llista )

Retorna la posició de thing a la llista, o 0 si no és a la llista.

pick random item ( seleccionar un element a l'atzar )

Seleccions un element a l'atzar de la llista.

is list empty? ( és la llista buida? )

Si la llista no té elements, torna true, en cas contrari, retorna false.

copy list ( còpia llista )

Fa una còpia de la llista, incloent totes les còpies subllistes.

is a list? ( és una llista? )

Si thing és una llista, retorna true, en cas contrari, retorna false.


list to csv row ( llista a la fila csv )

Interpreta la llista com una fila d'una taula i retorna un fitxer CSV

(valors separats per comes), que representa la fila. Cada element

de la llista es considera com un camp, i es cita amb cometes dobles en el text CSV resultant. Els elements

estan separats per comes. El text de la fila retornada no té un final de línia ( retorn de carro) al final.

list to csv table ( llistar la taula csv )

Interpreta la llista en forma de taula, i retorna un fitxer CSV

(valors separats per comes) de text que representa la

taula. Cada element de la llista ha de ser en si mateix una llista que representa una fila de la taula

CSV. Cada element de la llista de fila es considera com un camp, i es cita amb cometes dobles en el text

CSV resultant. En el text retornat, els elements de les files es separen amb comes i les files estan

separades per CRLF –retorn de carro- (\ r \ n).

list from csv row ( llista des de fila csv )

Analitza un text en un arxiu CSV (valors separats

per comes) per produir una llista de camps. Un error

és que el text de fila continga salts de línia sense

escapament dins dels camps (diverses línies). Està bé que el text de fila acabe en un salt de línia simple o

CRLF.

list from csv table ( llista des de taula csv )

Analitza un text com una taula d'arxiu CSV (valors

separats per comes) per a produir una llista de files,

cadascuna de les quals és una llista de camps. Les

files poden ser separades per salts de línia (\ n) o CRLF (\ r \ n).


Blocs de Matemàtiques

Taula de continguts

• number • greater than • less than • less than or equal to • greater than or equal to • equals • + • − • × • / • sqrt • random fraction • random integer • random set seed • negate • min • max • quotient • remainder • modulo • abs • round • floor • ceiling • expt • exp • log • sin • cos • tan • asin • acos • atan • atan2 • format as decimal • is a number?


Number ( Nombre )

Especifica un valor numèric.

greater than ( més que )

Compara dos nombres donats. Si el primer és més gran, torna true, en cas

contrari, retorna false.

less than ( menys que )

Compara dos nombres donats. Si el primer és menor, retorna true, en cas

contrari, retorna false.

less than or equal to ( menys de o igual a )

Compara dos nombres donats. Si el primer és més xicotet o igual que el

segon, retorna veritable, en cas contrari, retorna fals.

greater than or equal to ( major o igual a )

Compara dos nombres donats. Si el primer és major o igual que el

segon, retorna veritable, en cas contrari, retorna fals.

Equals ( és igual a )

Comprova si dos valors donats són iguals. Si és així, retorna true, en cas contrari,

retorna false. Aquest és el mateix que el bloc al calaix de la lògica i es repeteix

aquí per conveniència. Els arguments poden ser qualsevol cosa, no només números.

+

Retorna la suma de dos nombres donats.

-

Retorna el resultat de restar el nombre de segons des del primer.


x

Retorna el producte de dos nombres donats.

/

Retorna el resultat de dividir el primer nombre entre el segon. Per exemple, 1

dividit per 3 és 0,3333.

sqrt

Retorna l'arrel quadrada del nombre donat.

random fraction ( fracció aleatòria )

Retorna un valor aleatori entre 0 i 1.

random integer ( sencer aleatori )

Retorna un valor enter aleatori entre els valors

donats, inclusivament. L'ordre dels arguments no

importa.

random set seed ( seqüències repetibles de nombres aleatoris )

Utilitzar aquest bloc per generar seqüències repetibles de nombres

aleatoris. Pot generar la mateixa seqüència de nombres aleatoris

cridant random-set-seed amb el mateix valor. Això és útil per provar

els programes que inclouen valors aleatoris.

Negate ( negar )

Retorna el negatiu del nombre donat.

Min

Retorna el més xicotet d'un conjunt donat de nombres.


Max

Retorna el major d'un conjunt donat de nombres.

quotient ( quocient )

Retorna el resultat de dividir el nombre primer per la part segona i rebutjant

qualsevol fraccionària del resultat.

Remainder ( resta )

Modulo ( mòdul )

Remainder (a, b) retorna el resultat de dividir a entre b i prenent la resta. Per

exemple, la resta (11,5) = 1, la resta (-11, 5) = -1, la resta (11, -5) = 1, i la resta

(-11, -5) = -1.

abs

Retorna el valor absolut d'un nombre donat.

Round ( arrodonir )

Arrodoneix el nombre especificat al sencer més proper i retorna el resultat. Si el

número està a mig camí entre dos nombres enters, s'arrodoneix a l'enter par.

Floor ( pis )

Calcula el nombre enter més gran que és menor o igual al nombre donat.

Ceiling ( sostre )

Retorna el nombre enter més xicotet que és major o igual al nombre donat.


expt

Provoca el primer nombre donat a la potència de la segona i retorna el resultat.

exp

Retorna e (2,71828 ...) elevat a la potència del nombre i retorna el resultat.

log

Retorna el logaritme natural d'un nombre donat.

sin

Retorna el sinus del nombre en graus.

cos

Retorna el cosinus del nombre en graus.

tan

Retorna la tangent del nombre en graus.

asin

Retorna l'arc sinus del nombre en graus.

acos

Retorna l'arc cosinus del nombre en graus.

atan

Retorna l'arc tangent del nombre en graus.


atan2

Retorna l'arc tangent de y/x, donats y i x.

format as decimal ( format decimal )

Donar format a un nombre com un nombre decimal

amb un nombre donat de posicions després del punt

decimal. El nombre de llocs ha de ser un nombre

enter no negatiu. El resultat és produït per

l'arrodoniment del nombre (si hi ha massa llocs) o

afegint zeros a la dreta (si hi ha massa pocs).

is a number? ( és un nombre )

Retorna true si l'objecte donat és un nombre, i false en cas

contrari.


Blocs Lògics

Taula de continguts

• true

• false • not • = • and • or


true ( Veritable )

Aquest bloc representa el valor constant veritable . Usi-lo per configurar els valors

booleans de propietat dels components, o com el valor d'una variable que representa

una condició.

false ( Fals )

Aquest bloc representa el valor constant fals . Usi-lo per configurar els valors booleans

de propietat dels components, o com el valor d'una variable que representa una

condició.

not ( No )

Aquest bloc realitza la negació lògica, torna fals si l'entrada és true, i true si l'entrada és

fals.

=

Aquest bloc comprova si els seus arguments són iguals.

• Dos nombres són iguals si són numèricament iguals, per exemple, 1 és igual a 1,0.

• Dos blocs de text són iguals si tenen els mateixos caràcters i en el mateix ordre, amb el mateix

cas. Per exemple, el plàtan no és igual al del Plàtan .

• Números i text són iguals si el nombre és numèricament igual a un nombre que es va a imprimir

amb aquest text. Per exemple, és igual a 12,0 el resultat d'unir el primer caràcter del 1A a l'últim

caràcter de Teafor2 .

• Dues llistes són iguals si tenen el mateix nombre d'elements i els elements corresponents són

iguals.

and ( i )

Aquest bloc comprova la totalitat d'un conjunt de condicions lògiques són true. El

resultat és true si i només si totes les condicions assajades són true. Quan es

connecta una condició en el sòcol test, apareix altre sòcul per afegir una altra condició. Les condicions es

proven d'esquerra a dreta, i la prova s'atura tan aviat com una de les condicions és fals. Si no hi ha

condicions per posar a prova, llavors el resultat si és true.

or ( o )

Aquest bloc comprova si qualsevol d'un conjunt de condicions lògiques són true. El

resultat és true si una o més de les condicions assajades són true. Quan es connecta

una condició en el sòcol test, apareix altre sòcul per afegir una altra condició. Les condicions es proven

d'esquerra a dreta, i la prova s'atura tan aviat com una de les condicions és true. Si no hi ha condicions

per posar a prova, llavors el resultat és fals.


Blocs de Control

Taula de continguts

• if

• ifelse • choose • foreach • for range • while • get start text • close screen • close screen with result


if ( Si )

Comprova una condició donada. Si la condició és true, executa les accions en una

determinada seqüència de blocs, en cas contrari, els blocs són ignorats.

ifelse ( Si-sino )

Comprova una condició donada. Si el resultat és true, porta a terme les

accions en la seqüència de blocs then-do, en cas contrari, porta a terme les

accions l'altra seqüència de blocs else-do.

choose ( Triar )

Comprova una condició donada. Si la condició és true, executa les

accions en la seqüència de blocs then-do i torna a continuació torna el

valor a then-return, en cas contrari, porta a terme les accions a l'altra

seqüència de blocs i torna el valor a else-retur.

foreach ( Per a cada )

S'executa els blocs al do secció per a cada element de la

llista a la llista . Utilitzeu el nom donat variable per fer

referència a l'element de llista actual.


for range ( Per al rang )

Executa el bloc a la secció do per a cada valor numèric en el rang de principi a fi, pas a pas el valor cada

vegada. Utilitzeu el nom donat variable per fer referència al valor actual.

while ( Mentre que )

Prova la condició test. Si és true, porta a terme l'acció indicada en do , llavors la

prova la condició test de nou. Quan la prova test és false, el bloc acaba.

get start text ( aconseguir text de començar )

Retorna el text passat a aquesta aplicació quan l'aplicació es va

iniciar, si s'escau.

close screen ( tancar pantalla )

Tanca l'aplicació.

close screen with result ( tancar pantalla amb resultat )

Tanca l'aplicació i estableix la variable

APP_INVENTOR_RESULT a el valor donat.


Blocs de Color

L'Editor de Blocs del calaix Colors conté diversos blocs corresponents als colors utilitzats. Pot connectar

aquests en els sòcols per mòduls que requereixen colors, com configurar el color del text o el color de

fons d'un component. Aquests mateixos colors també es poden seleccionar de les llistes desplegables de

color en el panell Propietats del dissenyador.

Ús de colors predefinits

Colors predefinits s'inclouen en el calaix de Colors.

Manual de Referència - Blocs.pdf

Documents

Transcript of Manual de Referència - Blocs.pdf