Você está na página 1de 81

MIT APP INVENTOR

O que ?

O MIT App Inventor uma ferramenta de programao baseada em


blocos que permite que qualquer um, mesmo iniciantes, comecem a programar
e construir aplicativos totalmente funcionais para dispositivos Android. Os
recm chegados ao App Inventor podem ter seus primeiros aplicativos criados
e rodando em uma hora ou menos, e podem programar aplicaes mais
complexas em um tempo significamente menor do que com linguagens de
programao mais tradicionais, baseadas em cdigo.
Inicialmente desenvolvido pelo professor Hal Abeson e uma equipe do
Google Education. App Inventor funciona como um Web Service administrado
por membros do MITs Center for Mobile Learning. MIT App Inventor possui
uma comunidade mundial de quase 3 milhes de usurios, representando 195
pases em todo o mundo. Mais de 100 mil usurio ativos semanalmente e que
j construram mais de 7 milhes de aplicativos para Android.
O App Inventor uma ferramenta de cdigo aberto que visa tornar a
programao e criao de aplicativos acessveis para uma grande variedade
de pblicos, como:

Educadores formais e informais que usaram MIT App Inventor para


apresentar a programao aos seus alunos de Computao, os membros do
clube de cincias, programas ps-escolares, oficinas, cursos, etc. Muitos
educadores tambm comearam a usar o MIT App Inventor para desenvolver
aplicaes em apoio dos seus prprios objetivos instrucionais.

Governo e funcionrios civis e voluntrios que tm aproveitado o


poder do MIT App Inventor para desenvolver aplicativos personalizados, muitas
vezes na resposta a desastres naturais e necessidades comunitrias.

Os pesquisadores que utilizam MIT App Inventor para criar aplicativos


personalizados para atender s suas necessidades de coleta e anlise de
dados em suporte de suas pesquisas em uma ampla variedade de campos
desde mdicos a social.

Entusiastas e empreendedores que tm uma idia que eles querem


transformar rapidamente em um aplicativo sem a curva de custo ou de
aprendizagem que a criao de aplicativos mais tradicional implica.
Uma linguagem de blocos para smartphones

App Inventor uma ferramenta de drag-and-drop (arrastar e soltar)


visual para a construo de aplicaes mveis na plataforma Android. Voc
pode projetar a interface do usurio (a aparncia visual) de um aplicativo
usando um construtor de interface grfica de usurio baseada na web (GUI),
assim como voc tambm pode especificar o comportamento do app reunindo
"blocos", como se voc estivesse trabalhando em um quebra-cabea.

O que voc pode fazer com o App Inventor?

Play
Criar aplicativos para o seu telefone divertido, e o App Inventor
promove a explorao e descoberta. Basta abrir o App Inventor em um
navegador web, conectar seu telefone, e comear a montar blocos como os da
figura 1.2. Voc pode ver imediatamente
e interagir com o aplicativo que voc est construindo no telefone.

Prottipos
Tem uma idia para um aplicativo? Em vez de escrev-la em um
guardanapo ou deix-lo de lado, construa um prottipo rpido. Prottipos so
incompletos e no verses completas de suas idias. Desta forma, o App
Inventor pode servir como um guardanapo eletrnico para desenvolvimento de
aplicativos mveis.

Construa aplicativos com utilidade pessoal


No estado atual do mundo de aplicativos mveis, ns estamos presos
com os aplicativos que nos so dados. Quem no se queixou de um app e
desejou que ele pudesse ser personalizado ou ajustado de alguma forma?
Com o App Inventor, voc pode construir um app exatamente como voc
quiser.

Desenvolver aplicativos completos


O App Inventor no apenas um sistema de prototipagem ou uma
interface desenhada para voc poder construir aplicativos completos,
aplicativos de uso geral. A linguagem fornece todos os principais fundamentos
de programao na construo de blocos para sua aplicao, como loops e
condicionais, mas em forma de blocos.
Ensinar e aprender
Se voc est no ensino fundamental, ensino mdio, ou universidade, o
App Inventor uma grande ferramenta de ensino e aprendizagem. timo
para a cincia da computao, mas tambm um timo ferramenta para a
matemtica, fsica, empreendedorismo, e qualquer outra disciplina. O
fundamental que voc aprende atravs da criao. Em vez de memorizar
frmulas, voc constri um aplicativo para, por exemplo, encontrar o hospital
mais prximo (ou shopping). Achamos que o App Inventor pode ser uma
grande ferramenta nas aulas de qualquer disciplina e em qualquer momento de
sua vida.

Porque o App Inventor a escolha certa

A maioria das pessoas diz que o App Inventor fcil de usar por causa
de seu visual, interface drag-and-drop. Mas o que isso significa? Por que que
o App Inventor to fcil de usar?

Voc no precisa se lembrar de sentenas e escrever instrues


Uma das maiores fontes de frustrao para programadores iniciantes
vem de ir digitando os cdigo e ter o computador lanando de volta mensagens
de erro indecifrveis. Essa frustrao desencoraja muitos iniciantes de
programao antes mesmo chegar ao mais divertido, resoluo de problemas
lgicos.

Voc escolhe a partir de um conjunto de opes


Com App Inventor, os componentes e os blocos so organizados em
partes que esto prontamente disponveis para voc. Voc programa
encontrando um bloco que ajuda a especificar a funcionalidade que voc quer
construir e arrastando-o para o programa. Voc no tem que se lembrar o que
as instrues so ou ao que se referem.

Apenas alguns blocos ligam um ao outro


Em vez de castigar os programadores com mensagens de erro
enigmticas, a linguagem de blocos do App Inventor restringe voc de fazer
muitos erros. Por exemplo, se um bloco de funo espera um nmero, voc
no pode ligar um texto. Isso no elimina todos os erros, mas com certeza
ajuda.

Voc lida diretamente com eventos


Linguagens de programao tradicionais foram projetados quando a
programao era como trabalhar com receitas, ou conjuntos de instrues.
Mas, com interfaces grficas, e especialmente com aplicativos mveis onde os
eventos podem acontecer a qualquer momento (por exemplo, receber uma
mensagem de texto ou chamada telefnica), a maioria dos programas no so
receitas, mas so em vez, conjuntos de manipuladores de eventos. Um
manipulador de eventos uma maneira de dizer: "Quando isso acontece, o app
faz isso. "Em uma linguagem tradicional, como Java, voc tem que entender
classes, objetos, e objetos especiais chamados ouvintes, para expressar uma
simples evento. Com App Inventor, voc pode dizer: "Quando um usurio clicar
neste boto..." ou "Quando um texto recebido... " arrastando um "When"
bloco.

Que tipos de aplicativos eu posso construir?

Voc pode construir muitos tipos diferentes de aplicativos com o App


Inventor. Use sua imaginao, e voc poder criar todos os tipos de aplicativos
teis.

Jogos
As pessoas muitas vezes comeam com a construo de jogos como
Mole Mash (Figura 1.3) ou aplicativos que deixam tirar fotos engraadas.
Conforme voc avana, voc pode construir suas prprias verses de jogos

mais complexos, como Pac-Man e Space Invaders.


Figura 1.3: Parte dos blocos para criao do jogo Mole Mash
Aplicativos Educativos
App Inventor no est limitada a jogos simples. Voc tambm pode criar
aplicativos que informam e educam. Voc pode criar um app de quizz para
ajudar voc e seus colegas a estudar para uma prova, ou mesmo um aplicativo
que permita que os usurios do seu aplicativo criar seus prprios quizzes.

Aplicativos de Localizao
Por o App Inventor fornecer acesso a um sensor de GPS, voc pode
construir apps para saber onde voc est. Voc pode criar um aplicativo para
ajudar a lembrar onde voc estacionou seu carro, um aplicativo que mostra a
localizao dos seus amigos ou colegas em um evento ou conferncia, ou o
seu prprio app de tour personalizado da seu escola, universidade, local de
trabalho, ou um museu.

Aplicaes de alta tecnologia


Voc pode criar aplicativos para escanear cdigos de barra, falar, ouvir
(reconhecer palavras), ouvir msica, fazer msica, reproduzir vdeo, detectar a
orientao do telefone e de acelerao, tirar fotos, e fazer chamadas
telefnicas. Smartphones so como canivetes para a tecnologia, e um grupo de
engenheiros do Google dedicou-se a fazendo que a tecnologia seja fcil de
controlar atravs App Inventor.

Aplicativos que controlam robs


Voc pode usar o telefone como um controle remoto para controlar
robs. O rob e o telefone podem se comunicar via Bluetooth, e os
componentes de Bluetooth do App Inventor permitem que voc crie aplicativos
para isso.

Aplicativos Complexos
App Inventor reduz drasticamente a barreira de entrada para a
programao e permite voc construir aplicativos de alta tecnologia em questo
de horas. A linguagem de blocos tambm fornece loops, condicionais, e outras
lgicas de programao necessrio para construir aplicativos com lgica
complexa. Voc vai se surpreender com o quo divertido tais problemas de
lgica podem ser quando voc est tentando construir um aplicativo.

Aplicativos habilitados para a Web


O App Inventor tambm fornece uma maneira para que seus aplicativos
possam se comunicar com a Web. Voc pode escrever aplicativos que puxam
dados do Twitter ou um feed RSS, ou um Navegador de Livros da Amazon que
permite verificar o custo online de um livro, digitalizando o seu codigo de barra.
Quem pode construir apps?

App Inventor est disponvel gratuitamente para qualquer um usar.


possvel us-lo online (em vez de diretamente no seu computador) e
acessvel a partir de qualquer browser. Voc no precisa sequer de um
telefone para us-lo: voc pode testar seus aplicativos em um emulador
Android includo. A partir de janeiro de 2011, havia dezenas de milhares de
usurios App Inventor ativos e centenas de milhares de Apps.

App Inventor e sua Linguagem de Blocos

Como j foi dito antes, o App Inventor uma ferramenta de construo


de aplicativos Android atravs da juno de conjuntos de blocos que
determinam como sua aplicao deve se comportar. Voc define a lgica de
seu aplicativo arrastando blocos especficos. Cada componente em seu projeto
tem seu prprio conjunto de blocos especficos para seu prprios eventos,
mtodos e propriedades. Abaixo (figura 1.7) temos uma viso geral de todos os
blocos de construo do Editor de Blocos disponveis na ferramenta.

Figura 1.7: Viso geral dos blocos de construo

Designer e Editor de Blocos

O App Inventor consiste no Designer e Editor de Blocos. Estes so


descritos em detalhe abaixo.
App Inventor Designer

Figura 1.8: Interface de criao do design de aplicativos.

Pallete (Paleta): Encontre seu componentes e arraste-os para a Viewer para


adicionar ao seu aplicativo.

Viewer (Espectador): Arraste componente da Paleta para o Espectador para


formar seu app e ver como ele vai ficar.
Designer Button (Boto Designer): Caso voc esteja em outra tela, clique em
Designer Button para voltar tela de design.

Properties (Propriedades): Selecione um componente na Lista de


Componentes para alterar suas propriedades como, cor, tamanho,
comportamento, etc.
App Inventor Blocks Editor (Editor de Blocos)
Figura 1.9: Interface para programar o comportamento do aplicativo, juntando
blocos.

Built-in Drawers (Blocos Embutidos): Procure por blocos com


comportamentos que voc queira adicionar ao seu app e arraste-os para a
Viewer.

Component-Specific Drawers (Componentes Especficos): Encontre blocos


para comportamentos especficos e arraste-os para a Viewer.

Viewer (Espectador): Arraste blocos do para a Blocks Viewer para construir


relaes e comportamentos para seu aplicativo.

Blocks Button (Boto Blocos): Caso voc esteja em outra tela, clique em
Blocks Button para voltar tela de construo de blocos.
Componentes App Inventor para Android
A seguir descreveremos os componentes que voc pode usar em App
Inventor para construir seus aplicativos.

Cada componente pode ter mtodos, eventos e propriedades. A maioria


das propriedades pode ser alterada por aplicaes - estas propriedades tm
blocos que voc pode usar para obter e definir os valores. Algumas
propriedades no podem ser alteradas por aplicativos - estas s tm blocos
que voc pode usar para obter os valores, no defini-las. Algumas
propriedades s esto disponveis no Designer.

Dos componentes mostrados a seguir, muitas propriedades so comuns,


ento as veremos separadamente. Propriedades especficas sero
comentadas nas reas correspondentes de seu componente. As propriedades
comuns so:

BackgroundColor

Retorna a cor de fundo do componente.

Enabled

Se definido, o usurio poder fazer alguma ao com componente (clique, por


exemplo).

FontBold

Se definido, o texto do componente exibido em negrito.

FontItalic

Se definido, o texto do componente exibido em itlico.

FontSize

Tamanho da fonte do texto do componente.

FontTypeface (designer apenas)

Tipo da fonte para o texto componente.

Height

Comprimento vertical do componente (-size y).

Image

Imagem a ser exibida no componente.


Shape (designer apenas)

Especifica a forma do componente (default, arredondado, retangular, oval). A


forma no ser visvel se uma imagem est a ser exibida.

ShowFeedback

Especifica se um feedback visual deve ser mostrado quando o componente for


clicado, como uma imagem no fundo.

Text

Texto a ser exibido no componente.

TextAlignment (designer apenas)

Orientao do texto do componente. Esquerda, centro ou direita.

TextColor

Cor de texto do componente.

Visible

Especifica se o componente deve estar visvel na tela. O valor true se o


componente est visvel e falso se estiver escondido.

Width

Comprimento horizontal do componente (-size x).

Hint

O texto que deve aparecer levemente em componentes que recebem texto do


usurio, para fornecer uma dica sobre o que o usurio deve digitar.

User Interface Components Componentes da interface do usurio.

Button Boto
Boto com a capacidade de detectar cliques. Muitos aspectos da sua aparncia
podem ser mudados, assim como se clicvel ( Enabled ).

Eventos:

Click()

Usurio clicou e soltou o boto.


GotFocus()

Indica que o cursor move sobre o boto de modo que agora possvel clicar
nele.

LongClick()

Usurio clicou e segurou o clique por um tempo.

LostFocus()

Indica que o cursor afastou-se do boto de modo que j no possvel clicar


nele.

TouchDown()

Indica que o boto foi pressionado.

TouchUp()

Indica que um boto foi liberado.

CheckBox - Caixa de seleo


Componentes CheckBox podem mudar seu estado de resposta quando o
usurio o seleciona.

Um componente CheckBox gera um evento quando for selecionado. Existem


muitas propriedades que afetam a sua aparncia que podem ser definidas no
Editor de Designer ou blocos.

Propriedades:
Checked

True (verdadeiro) se a caixa est marcada, False (falso) caso contrrio.

Eventos:
Click()

Usurio clicou na caixa de seleo.

GotFocus()

Indica que o cursor move sobre a caixa de seleo de modo que agora
possvel clicar nela.

LostFocus()

Indica que o cursor afastou-se do boto de modo que j no possvel clicar


nele.
DatePicker Selecionador de data
Um boto que, quando clicado, inicia um dilogo pop-up para permitir que o
usurio selecione uma data.

Propriedades:
Day

O dia do ms pra ser usado no DatePicker.

Month

O nmero do ms para ser usado no DatePicker.

MonthInText

Retorna o nome do ms em que foi passado usando o DatePicker, em formato


textual.

Year

O ano para ser usado no DatePicker.

Eventos:
AfterDateSet()

Evento que executado depois que o usurio escolhe uma data no dilogo.

GotFocus()

Indica que o cursor move sobre o boto de modo que agora possvel clicar
nele.

LostFocus()

Indica que o cursor afastou-se do boto de modo que j no possvel clicar


nele.

TouchDown()

Indica que o boto foi pressionado.

TouchUp()

Indica que um boto foi liberado.


Mtodos:
LaunchPicker()

Inicia o pop-up DatePicker.

SetDateToDisplay ( nmero do ano, nmero do ms, nmero do dia)

Permite ao usurio definir a data a ser exibida quando o DatePicker exibido.


Os valores vlidos para o campo do ms so 1-12 e 1-31 para o campo do dia.

Image
Componente para exibir imagens. A imagem a ser exibida, e outros aspectos
da aparncia da imagem, podem ser especificados no Designer ou no Editor de
Blocks.

Propriedades:
Animation

Esta uma forma limitada de animao que pode anexar um pequeno nmero
de tipos de movimento para imagens. Os movimentos permitidos so
ScrollRightSlow, ScrollRight, ScrollRightFast, ScrollLeftSlow, ScrollLeft,
ScrollLeftFast, e Stop.

Picture

Imagem a ser exibida.

Label - Etiqueta
As Labels so componentes utilizados para mostrar texto. Suas propriedades
podem ser definidas no editor de designer ou de blocos.

ListPicker Recebedor de listas


Um boto que, quando clicado, exibe uma lista de textos para que o usurio
escolha entre eles. Os textos podem ser especificados atravs do Designer ou
Editor de Blocks.

Propriedades:
Elements

Elementos da lista.

Obs: Apenas no editor de blocos.


ElementsFromString

Organizao do elemento na lista.

Selection

O item selecionado. Quando alterado diretamente pelo designer, a propriedade


SelectionIndex tambm alterada para o primeiro item no ListPicker com o
valor dado. Se o valor no for exibido, SelectionIndex ser definido como 0.

SelectionIndex

O ndice do item selecionado no momento, a partir de 1. Se nenhum item for


selecionado, o valor ser 0. Se for feita uma tentativa de defini-lo para um
nmero menor do que 1 ou maior que o nmero de itens na ListPicker,
SelectionIndex ser definido para 0, e Selection ser definido como texto vazio.

ShowFilterBar

Se definido, um Filtro de pesquisa ser exibido na ListPicker.

Title

Ttulo opcional exibido no topo da lista de opes.

ItemTextColor

A cor do texto dos itens do ListPicker.

ItemBackgroundColor

A cor de fundo dos itens do ListPicker.

Eventos:
AfterPicking()

Evento a ser gerado aps o ListPicker ser fechado.

BeforePicking()

Evento para ser gerado quando o boto do componente clicado ou a lista


mostrada usando o bloco Abrir. Este evento ocorre antes da lista de itens a ser
apresentada, e pode ser utilizado para preparar a lista antes de ser mostrada.

GotFocus()

Indica que o cursor move sobre o boto ListPicker de modo que agora
possvel clicar nele.
LostFocus()

Indica o cursor afastou-se do boto ListPicker de modo que j no possvel


clicar nele.

Mtodos:
Open()

Abre o ListPicker, assim como se o usurio clicar sobre ele.

ListView Lista de visualizao


Este um componente visvel que permite colocar uma lista de elementos de
texto em sua tela para exibir. Enquanto o ListPicker inicia em uma tela prpria,
o ListView tem seus elementos visualizados na tela em que colocado.

Aviso: Este componente no ir funcionar corretamente nas telas que so de


rolagem.

Propriedades:
Elements

Elementos de texto que constituem a lista.

ElementsFromString

Organizao do elemento na lista.

Selection

Retorna o elemento selecionado no ltimo ListView.

SelectionIndex

O ndice do item selecionado no momento, a partir de 1. Se nenhum item for


selecionado, o valor ser 0. Se for feita uma tentativa de defini-lo para um
nmero menor do que 1 ou maior que o nmero de itens na ListView,
SelectionIndex ser definido para 0, e a seleo ser definido como texto vazio.

ShowFilterBar

Se definido, um Filtro de pesquisa ser exibido no ListView. True mostrar o


filtro, False vai escond-lo.

Eventos:
AfterPicking()

Evento ser gerado aps um elemento ser escolhido na lista.


Notifier - Notificador
O componente Notifier exibe alertas dilogos, mensagens e alertas
temporrios. No visvel.

Propriedades:
NotifierLength (designer apenas)

Especifica a durao de tempo em que o alerta mostrado - ou "curta" ou


"longa".

Mtodos:
DismissProgressDialog()

Descartar uma caixa ProgressDialog exibida anteriormente.

LogError (recebe um texto para a mensagem)

Exibe uma mensagem de erro no log do sistema Android.

LogInfo (recebe um texto para a mensagem)

Exibe uma mensagem informativa no log do sistema Android.

LogWarning (recebe um texto para a mensagem)

Exibe uma mensagem de aviso no log do sistema Android.

ShowAlert (recebe um texto para a notificao)

Exibir uma notificao temporria.

ShowChooseDialog (recebe texto para a mensagem, o ttulo, o button1, o


button2, e um valor lgico (true ou false) para cancelable)

Mostra uma caixa de dilogo com dois botes, a partir do qual o usurio pode
escolher. Se cancelable receber true, haver um boto adicional CANCEL. A
"escolha" do parmetro para AfterChoosing ser o texto do boto que foi
pressionado, ou "Cancel" se o boto CANCEL foi pressionado.

ShowMessageDialog (recebe um texto para a mensagem, para o ttulo, e para


o buttonText)

Exibir um dilogo de alerta com um nico boto que dispensa o alerta.

ShowProgressDialog(recebe um texto para a mensagem, para o ttulo)

Mostra uma caixa de dilogo com um ttulo e mensagem opcional (usar cadeias
vazias, se eles no so desejados). Ele no pode ser cancelado pelo usurio,
mas deve ser cancelado pelo Programa App Inventor usando o bloco
DismissProgressDialog.
ShowTextDialog (recebe um texto para a mensagem, para o ttulo e um valor
lgico (true ou false) para cancelable)

Mostra uma caixa de dilogo onde o usurio pode digitar o texto, aps o qual o
evento AfterTextInput ser gerado. Se cancelable receber true, haver um
boto adicional CANCELAR. A "resposta" para AfterTextInput ser o texto que
foi digitado, ou "Cancelar" se o boto CANCELAR foi pressionado.

Eventos:
AfterChoosing (retorna choice (escolha))

Evento que inicia aps o usurio ter feito uma seleo para
ShowChooseDialog.

AfterTextInput(retorna response (resposta))

Evento que inicia aps o usurio responder a ShowTextDialog.

TextBox - Caixa de texto


Os usurios digitam o texto em um componente da caixa de texto.

Propriedades:
MultiLine

Se definido, ento esta caixa de texto aceita vrias linhas.

NumbersOnly

Se definido, ento esta caixa de texto aceita somente nmeros.

Eventos:
GotFocus()

Evento gerado quando esse componente est em foco, tal como quando
selecionado pelo usurio.

LostFocus()

Evento gerado quando este componente j no est em foco, como quando o


usurio toca em uma caixa de texto diferente.

Mtodos:
HideKeyboard()

Ocultar o teclado. Somente quando a propriedade MultiLine est definida.


TextBox de linha nica fecha o teclado quando o usurio pressiona a tecla
Concludo.
RequestFocus()

Define a caixa de texto como ativa.

PasswordTextBox Caixa de texto para senhas


Os usurios digitam senhas em um componente da caixa de texto de senha,
que pode esconder o texto que foi digitado na mesma.

Mtodos:
RequestFocus()

Define o PasswordTextBox ativa.

Eventos:
GotFocus()

PasswordTextBox tornou-se o componente focalizado.

LostFocus()

PasswordTextBox no mais o componente focalizado.

Screen - Tela
Componente de nvel superior que contm todos os outros componentes do
programa.

Propriedades:
AboutScreen

Informaes sobre a tela. Aparece quando "Sobre este aplicativo"


selecionado a partir do menu do sistema. Use-o para informar aos usurios
sobre o seu app. Em vrios aplicativos de tela, cada tela tem sua prpria
informao AboutScreen.

AlignHorizontal

Alinhamento horizontalmente dos componentes na tela. As opes so:


esquerda, centro e direita.

AlignVertical

Alinhamento vertical dos componentes na tela. As opes so: parte superior,


centro e parte inferior.
AppName (designer apenas)

Este o nome da aplicao instalado no visor do telefone. Se o AppName est


em branco, ele ser definido como o nome do projeto quando o projeto
construdo.

BackgroundImage

A imagem de fundo da tela.

CloseScreenAnimation

A animao para fechar a tela atual e voltar tela anterior. As opes vlidas
so padro, fade, zoom, slidehorizontal, slidevertical, e nenhum

Icon (designer apenas)

cone da aplicao.

OpenScreenAnimation

A animao para mudar para outra tela. As opes vlidas so padro, fade,
zoom, slidehorizontal, slidevertical, e nenhum

ScreenOrientation

A orientao do ecr solicitado, especificado como um valor de texto. Valores


utilizados so: paisagem, retrato, sensor, o usurio e no especificado.

Scrollable

Se definido, poder haver um deslocamento vertical no ecr.

Title

Ttulo da aplicao.

VersionCode (designer apenas)

Um valor inteiro que deve ser incrementado cada vez que um novo arquivo
Android Application Package (APK) criado para o Google Play Store.

VersionName (designer apenas)

Uma sequncia de caracteres que pode ser alterada para permitir que os
usurios do Google Play Store possam distinguir entre diferentes verses do
App.
Eventos:
BackPressed()

Evento gerado quando o boto responsvel pela funo de VOLTAR for


pressionado.

ErrorOccurred (recebe um componente para o campo component, um texto


para functionName, um nmero para errorNumber, um texto para message)

Evento gerado quando ocorre um erro. Apenas alguns erros iro gerar essa
condio. Para esses erros, o sistema ir mostrar uma notificao por padro.
Voc pode usar esse manipulador de eventos para prescrever um
comportamento de erro diferente do padro.

Initialize()

Evento gerado quando a tela inicializar.

OtherScreenClosed (recebe um texto para otherScreenName, any result)

Evento disparado quando outra tela fechou e o controle voltou a esta tela.

ScreenOrientationChanged()

Evento gerado quando a orientao do ecr mudar.

Slider - Deslizador
Um Slider uma barra de progresso que adiciona um polegar arrastvel.
Voc pode tocar o polegar (thumb) e o arrastar para a esquerda ou para a
direita para definir a posio polegar slider. Como o polegar Slider arrastado,
ele ir acionar o evento PositionChanged, relatando a posio do Slider. A
posio indicada do polegar deslizante pode ser utilizada para atualizar
dinamicamente outro atributo do componente, tal como o tamanho da fonte de
uma caixa de texto ou o raio de uma esfera.

Propriedades:
ColorLeft

A cor da barra para a esquerda do polegar.

ColorRight

A cor da barra para a direita do polegar.

MaxValue

Define o valor mximo do Slider. A alterao do valor mximo tambm redefine


Thumbposition como o meio caminho entre o mnimo e o (novo) mximo. Se o
novo mximo for inferior ao mnimo atual, em seguida, mnimo e mximo iro
ser definidos para este valor. Definir MaxValue redefine a posio do polegar
para o meio caminho entre MinValue e MaxValue e sinaliza o evento
PositionChanged.

MinValue

Define o valor mnimo do Slider. A alterao do valor mnimo tambm redefine


Thumbposition como meio caminho entre o (novo) mnimo e o mximo. Se o
novo mnimo for maior do que o mximo, mnimo e mximo iro ser definidos
para este valor. Definir MinValue redefine a posio do polegar para o meio
caminho entre MinValue e MaxValue e sinaliza o evento PositionChanged.

ThumbPosition

Define a posio do polegardo slider. Se este valor for maior que MaxValue,
em seguida, ele ser definido para o mesmo valor que MaxValue. Se esse
valor for menor do que MinValue, em seguida, ele ser definido para o mesmo
valor que MinValue.

ThumbEnabled

Define se deve ou no exibir o thumb do slider.

Eventos:
PositionChanged ( retorna um nmero para thumbPosition)

Indica que a posio do ponteiro da barra mudou.

Spinner
Um componente que exibe um pop-up com uma lista de elementos. Esses
elementos podem ser definidos no Designer ou Editor de Blocks.

Propriedades:
Elements

Retorna uma lista de elementos de texto do Spinner .

ElementsFromString

Define a lista de elementos do Spinner, passados em sequncia separada por


vrgulas.

Prompt

Texto com o ttulo atual para a janela de Spinner.


Selection

Retorna o item selecionado.

SelectionIndex

O ndice do item selecionado no momento, a partir de 1. Se nenhum item for


selecionado, o valor ser 0.

Eventos:
AfterSelecting(text selection)

Evento chamado aps o usurio seleciona um item na lista suspensa.

Mtodos:
DisplayDropdown()

Exibe a lista suspensa para a seleo, mesma ao como quando o usurio


clica no boto rotativo.

TimePicker Selecionador de tempo


Um boto que, quando clicado, inicia um dilogo pop-up para permitir que o
usurio selecione uma hora.

Propriedades:
Hour

A hora da ltima definio usando o TimePicker. A hora est em um formato de


24 horas. Se o ltimo conjunto de tempo foi 23:53, essa propriedade retornar
23.

Minute

O minuto da ltima hora definida usando o TimePicker

Eventos:
AfterTimeSet()

Este evento executado quando um usurio tiver definido a hora na caixa de


dilogo pop-up.

GotFocus()

Indica que o cursor move-se sobre o boto de modo que agora possvel clicar
nele.
LostFocus()

Indica que o cursor afastou-se do boto de modo que j no possvel clicar


nele.

WebViewer Visualizador web


Componente para visualizao de pginas da Web. A URL inicial pode ser
especificada no Designer ou no Editor de Blocks.

Propriedades:
CurrentPageTitle

Ttulo da pgina visualizada no momento

CurrentUrl

URL da pgina visualizada no momento. Isto poderia ser diferente do URL


inicial se novas pginas foram visitadas seguindo os links.

FollowLinks

Determina se deve seguir os links quando eles so batidos no WebViewer. Se


voc seguir os links, voc pode usar o GoBack e GoForward para navegar no
histrico do navegador.

HomeUrl

URL da pgina do WebViewer que dever ser aberta inicialmente.

IgnoreSslError

Determina se ignora ou no os erros de SSL. Defina como true para ignorar


erros. Use isto para aceitar certificados auto assinados a partir de sites.

PromptforPermission

Se definido, em seguida, solicitar que o usurio do WebView d permisso


para acessar a API de geolocalizao. Caso contrrio, a permisso
concedida.

UsesLocation (designer apenas)

Deve-se ou no dar a permisso ao aplicativo para usar a API de


geolocalizao Javascript.

WebViewString

Obtm Cordas do WebView, que visvel atravs de Javascript no WebView


como objeto window.AppInventor.
Mtodos:
CanGoBack()

Retorna true se o WebViewer pode voltar na lista de histrico.

CanGoForward()

Retorna true se o WebViewer pode ir para a frente na lista de histrico.

ClearCaches()

Limpar os caches WebViewer

ClearLocations()

Limpar permisses de localizao armazenadas.

GoBack()

Volte para a pgina anterior na lista de histrico. No faz nada se no houver


pgina anterior.

GoForward()

V em frente para a prxima pgina na lista do histrico. No faz nada se no


h nenhuma pgina seguinte.

GoHome()

Carrega o URL da pgina de origem. Isto acontece automaticamente quando a


URL HOME alterado.

GoToUrl (texto url)

Carregue a pgina no URL dado.

Layout componentes

HorizontalArrangement Arranjo Horizontal


Use um componente arranjo horizontal para organizar os componentes lado a
lado dentro dele.

VerticalArrangement Arranjo Vertical


Use um componente arranjo vertical para organizar os componentes um abaixo
do outro dentro dele.
TableArrangement - Arranjo em Tabela
Use de um componente arranjo em tabela para organizar os componentes em
tabela. Numa TableArrangement, os componentes so dispostos numa malha
de linhas e colunas, com no mais do que um componente visvel em cada
clula. Se vrios componentes ocupar a mesma clula, apenas o ltimo ser
visvel.

Propriedades:
Rows

O nmero de linhas na tabela.

Columns

O nmero de colunas na tabela.

Componentes de mdia - Media Components

Camcorder - Cmera de vdeo


Um componente para gravar um vdeo.

Eventos:

AfterRecording (clipe de texto)

Indica que um vdeo foi gravado com a cmera e fornece o caminho para a
imagem armazenada.

Mtodos:

RecordVideo ()

Grava um vdeo, em seguida, dispara o evento AfterRecoding.

Camera
Use um componente da cmera para tirar uma foto no telefone.

Propriedades:

UseFront

Especifica se a cmera frontal deve ser usada (quando disponvel). Se o


dispositivo no tem uma cmera frontal, esta opo ser ignorada e a cmera
vai abrir normalmente.
Mtodos:

TakePicture()

Abre a cmera do telefone para permitir que uma foto seja tirada.

Eventos:

AfterPicture (imagem do texto)

Chamado depois que a foto tirada. O argumento de texto de imagem o


caminho que pode ser utilizado para localizar a imagem no telefone.

ImagePicker Selecionador de imagem


Quando o usurio clica em um selecionador de imagem, a galeria de imagens
do dispositivo exibida, e o usurio pode escolher uma imagem.

Propriedades:

Selection

Caminho para o arquivo que contm a imagem que foi selecionada.

Eventos:
AfterPicking()

Evento iniciado aps a atividade do selecionador retornar seu resultado.

BeforePicking ()

Evento iniciado quando o componente clicado, mas antes da atividade do


selecionador ser iniciada.

GotFocus ()

Indica que o cursor move sobre o boto de modo que agora possvel clicar
nele.

LostFocus ()

Indica que o cursor afastou-se do boto de modo que j no possvel clicar


nele.

Mtodos:
Open()

Abre o selecionador, assim como se o usurio clicar sobre ele.


Player
Componente multimdia que reproduz a vibrao do telefone udio e controles.
Este componente melhor para arquivos de som longos, tais como msicas,
enquanto o componente sound mais eficiente para arquivos curtos, como
efeitos sonoros.

Propriedades:
IsPlaying

Retorna se a mdia est reproduzindo.

Loop

Se definido, o player reproduzir repedidas vezes.

PlayOnlyInForeground

Se definido, o player ir pausar a reproduo ao sair da tela atual; se falso


(opo padro), o player continuar reproduzindo mesmo que a tela atual
feche.

Source

Arquivo de mdia que ir reproduzir no player.

Volume

Define o volume para um nmero entre 0 e 100

Eventos:
Completed()

Inicia quando a mdia chega ao fim.

OtherPlayerStarted()

Este evento iniciado quando outro player comeou (e o atual player est
tocando ou pausado, mas no parado).

Mtodos:
Pause()

Suspende o player se ele estiver reproduzindo.

Start()

Reproduz a mdia.

Stop()

Para a reproduo de mdia e procura o incio da msica.


Vibrate (nmero em milissegundos)

Vibra para o nmero especificado de milissegundos.

Sound
Um componente multimdia que reproduz arquivos de som e, opcionalmente,
vibra para o nmero de milissegundos (milsimos de segundo) especificado no
Editor de Blocks.

Propriedades:
MinimumInterval

O intervalo mnimo entre sons. Um novo som s ir iniciar quando o intervalo


acabar.

Source

O nome do arquivo de som.

Mtodos:
Pause ()

Interrompe a reproduo do som se ele est sendo executado.

Play()

Inicia a reproduo do som.

Resume ()

Continua a reproduo do som depois de uma pausa.

Stop ()

Para de tocar o som se ele est sendo reproduzido.

Vibrate (nmero em milissegundos)

Vibra para o nmero especificado de milissegundos.

SoundRecorder Gravador de som


Componente multimdia que grava udios.

Eventos:
AfterSoundRecorded (som)

Inicia quando a captura de um som for terminada. Retorna o som capturado.


StartedRecording ()

Inicia quando o gravador iniciado, e pode ser interrompido.

StoppedRecording ()

Inicia quando o gravador parou, e pode ser iniciado novamente.

Mtodos:
Play ()

Inicia a gravao.

Stop()

Para a gravao.

SpeechRecognizer:
Use um componente de reconhecimento de voz para ouvir o discurso do
usurio e converter o som falado em texto usando o recurso de
reconhecimento de voz do Android.

Propriedades:
Result

O ltimo texto produzido pelo reconhecedor.

Mtodos:
GetText ()

Pede ao usurio para falar, e converte a fala em texto.

Eventos:
AfterGetting (resultado texto)

Inicia aps o reconhecimento de um texto. Retorna o texto.

BeforeGettingText ()

Inicia antes de o reconhecedor ser iniciado.


TextToSpeech Texto para fala
O componente TextToSpeech fala um determinado texto em voz alta.

Propriedades:
AvailableCountries

Lista dos cdigos de pases disponvel neste dispositivo para uso com
TextToSpeech.

AvailableLanguages

Lista das lnguas disponveis neste dispositivo para uso com TextToSpeech.

Country

Cdigo do pas a ser usado para gerao de fala. Isso pode afetar a
pronunciao. Por exemplo, Ingls Britnico (GBR) vai soar diferente de US
Ingls (EUA). Nem todo o cdigo do pas afetar todas as lnguas.

Language

Define o idioma do TextToSpeech. Isso muda a maneira que as palavras so


pronunciadas, no a verdadeira linguagem que falada.

Pitch

Define o passo para TextToSpeech. Os valores devem estar entre 0 e 2, onde


valores mais baixos iro baixar o tom de voz sintetizada e maiores valores iro
aument-lo.

Result

Resultado do TextToSpeech.

SpeechRate

Define a velocidade da fala para o TextToSpeech. Os valores devem estar


entre 0 e 2.

Eventos:
AfterSpeaking (resultado boolean)

Evento iniciado aps a mensagem ser falada.

BeforeSpeaking ()

Evento iniciado quando Speak chamado, antes que a mensagem falada.


Mtodos:
Speak (mensagem de texto)

Fala a mensagem dada.

VideoPlayer
Um componente capaz de reproduzir vdeos multimdia.

Os arquivos de vdeo devem estar em 3GPP (.3gp) ou MPEG-4 (.mp4)


formatos.

App Inventor for Android permite somente arquivos de vdeo com menos de 1
MB e limita o tamanho total de um aplicativo para 5 MB.

Propriedades:
FullScreem

Tela cheia.

Source

O "caminho" para o vdeo. Normalmente, este ser o nome do arquivo de


vdeo, que deve ser adicionado no Designer.

Volume

Define o volume a um nmero entre 0 e 100.

Eventos:
Completed()

Inicia quando o vdeo chega ao fim.

Mtodos:
getDuration ()

Retorna a durao do vdeo em milissegundos.

Pause ()

Pausa a reproduo do vdeo.

SeekTo (nmero ms)

Avana para o tempo solicitado (especificada em milissegundos) no vdeo.

Start()

Inicia a reproduo do vdeo.


YandexTranslate
Use este componente para traduzir palavras e frases entre diferentes idiomas.
Este componente precisa de acesso Internet, uma vez que ir solicitar
tradues para o servio Yandex.Translate.

Eventos:
GotTranslation (responseCode, traduo)

Evento disparado quando o servio Yandex.Translate retorna o texto traduzido.


Este evento tambm fornece um cdigo de resposta para o tratamento de
erros. Se o responseCode no 200, ento algo deu errado com a chamada, e
a traduo no estaro disponveis.

Mtodos:
RequestTranslation (languageToTranslateTo, textToTranslate)

Ao fornecer uma lngua-alvo para traduzir a (por exemplo, 'es' para o espanhol,
'en' para Ingls, ou 'ru' para russo), e uma palavra ou frase para traduzir, este
mtodo ir solicitar uma traduo para o Yandex.

Drawing and Animation Components Componentes de


desenho e animao

Canvas
Um painel retangular bidimensional sensvel ao toque, onde componentes
sprites podem ser movidos. Qualquer local na tela pode ser especificado como
um par de (x, y).

X o nmero de pixels de distncia da margem esquerda dos Canvas.

Y o nmero de pixels de distncia a partir da borda superior do Canvas.

Propriedades:
LineWidth

A largura de linhas desenhadas na tela.

PaintColor

A cor em que as linhas so desenhadas

TextAlignment

Determina o alinhamento do texto elaborado por DrawText () ou DrawAngle ()


com respeito ao ponto especificado por esta ordem.
Eventos:
Dragged (nmero startX, nmero startY, nmero PrevX, nmero prevY, nmero
currentX, nmero currentY, draggedSprite boolean)

Evento iniciado quando o usurio faz um arrasto de um ponto (PrevX, prevY)


para outro (x, y). O par (startX, startY) indica onde o usurio primeiro tocou a
tela, e "draggedSprite" indica se um sprite est sendo arrastado.

Flung (nmero x, nmero y, nmero de velocidade, nmero da posio, nmero


Xvel, nmero Yvel, flungSprite boolean)

Evento iniciado quando um gesto de arremessar (golpe rpido) feito na tela:


fornece a posio (x, y) do incio do arremesso, em relao ao canto superior
esquerdo da tela. Tambm fornece a velocidade (pixels por milissegundo) e a
orientao (0-360 graus), bem como a velocidade x e a velocidade y do vetor
do arremesso. O valor "flungSprite" verdadeiro se um sprite foi localizado
prximo ao ponto de partida do arremesso.

TouchDown (nmero x, nmero y)

Evento iniciado quando o usurio toca a tela no retira o dedo por determinado
tempo: fornece a posio (x, y) do contato, em relao ao canto superior
esquerdo da tela.

TouchUp (nmero x, nmero y)

Evento iniciado quando o usurio para de tocar a tela (levanta o dedo depois
de um evento TouchDown): fornece a posio (x, y) do contato, em relao ao
canto superior esquerdo da tela.

Touched (nmero x, nmero y, touchedSprite)

Quando o usurio toca a tela e, em seguida, imediatamente levanta o dedo:


fornece a posio (x, y) do contato, em relao ao canto superior esquerdo da
tela. TouchedSprite true se o mesmo toque tambm tocou um sprite, e false
caso contrrio.

Mtodos:
Clear ()

Limpa qualquer coisa feita no Canvas, mas no qualquer cor de fundo ou


imagem.

DrawCircle (nmero x, nmero y, nmero de raio)

Desenha um crculo (preenchido) nas coordenadas indicadas na tela, com o


raio dado.
DrawLine (nmero x1, nmero y1, o nmero de x2, nmero y2)

Desenha uma linha entre as coordenadas indicadas.

DrawPoint (nmero x, nmero y)

Desenha um ponto nas coordenadas indicadas.

DrawText (texto , nmero x, nmero y)

Desenha o texto especificado com relao s coordenadas especificadas


usando os valores das propriedades FontSize e TextAlignment.

DrawTextAtAngle (texto, nmero x, nmero y, nmero do ngulo)

Desenha o texto de partida especificado nas coordenadas especificadas no


ngulo especificado usando os valores das propriedades FontSize e
TextAlignment.

GetBackgroundPixelColor (nmero x, nmero y)

Obtm a cor do ponto especificado. Isso inclui o fundo e qualquer


desembainhado de pontos, linhas ou crculos, mas no sprites.

GetPixelColor (nmero x, nmero y)

Obtm a cor do ponto especificado.

Save ()

Salva uma imagem deste canvas para armazenamento externo do dispositivo.


Se ocorrer um erro, evento ErrorOccurred da tela ser chamado.

SaveAs (nome do arquivo de texto)

Salva uma imagem deste canvas para armazenamento externo do dispositivo


no arquivo chamado filename. Nome do arquivo deve terminar com um dos
formatos: .jpg, .jpeg, ou .png, que determina o tipo de arquivo.

SetBackgroundPixelColor (nmero x, nmero y, nmero da cor)

Define a cor do ponto especificado. Isso diferente de drawPoint por ter um


argumento para a cor.

Ball
Uma bola que pode ser colocado em um canvas, onde ela pode reagir a
toques, interagir com outros sprites ( ImageSprite s e outros Bolas) e a borda
da tela, e mover-se de acordo com seus valores de propriedade.
Propriedades:
Enabled

Controla se a bola se move quando sua velocidade diferente de zero.

Heading

Retorna a orientao da bola em graus.

Interval

O intervalo, em milissegundos, em que a posio da bola ser atualizada. Por


exemplo, se o intervalo de 50 e a velocidade de 10, ento a bola mover 10
pixels cada 50 milissegundos.

PaintColor

Cor da bola.

Raio

Raio da bola.

Velocidade

A velocidade na qual a bola se move.

A coordenada horizontal da borda esquerda do sprite, aumentando medida


que a bola move para a direita.

A coordenada vertical do topo do sprite, aumentando medida que a bola se


move para baixo.

Como a bola deve ser mergulhada em relao a outros sprites, com camadas
de nmero mais alto na frente de camadas inferiores de numerao.

Eventos:
CollidedWith (outro componente)

Evento iniciado quando a bola colide com outro sprite.

Dragged (nmero startX, nmero startY, nmero PrevX, nmero prevY, nmero
currentX, nmero currentY)

Evento iniciado quando o usurio arrasta a bola (PrevX, prevY) para outro (x,
y). O par (startX, startY) indica onde o usurio primeiro tocou a bola.
EdgeReached (nmero da borda)

Manipulador de eventos chamado quando o sprite atinge uma borda da tela.


Borda aqui representada como um nmero inteiro que indica uma das oito
direes: norte (1), Nordeste (2), a leste (3), Sudeste (4), sul (-1), sudoeste (-2),
oeste (-3) e noroeste (-4).

Flung (nmero x, nmero y, nmero de velocidade, nmero da posio, nmero


Xvel, nmero Yvel)

Evento iniciado quando um gesto de arremessar (golpe rpido) feito na bola:


fornece a posio (x, y) do incio do arremesso, em relao ao canto superior
esquerdo da tela. Tambm fornece a velocidade (pixels por milissegundo) e a
orientao (0-360 graus), bem como a velocidade x e a velocidade y do vetor
do arremesso.

NoLongerCollidingWith (outro componente)

Evento indicando que um par de sprites no colidiu.

TouchDown (nmero x, nmero y)

Evento iniciado quando o usurio toca a bola e no retira o dedo por


determinado tempo: fornece a posio (x, y) do contato, em relao ao canto
superior esquerdo da tela.

TouchUp (nmero x, nmero y)

Evento iniciado quando o usurio para de tocar a bola (levanta o dedo depois
de um evento TouchDown): fornece a posio (x, y) do contato, em relao ao
canto superior esquerdo da tela.

Touched (nmero x, y nmero, touchedSprite)

Quando o usurio toca a bola e, em seguida, imediatamente levanta o dedo:


fornece a posio (x, y) do contato, em relao ao canto superior esquerdo da
tela. TouchedSprite true se o mesmo toque tambm tocou um sprite, e false
caso contrrio.

Mtodos:
Bounce (nmero da borda)

Faz com que a bola de um salto (rebata). Para salto normal, o argumento da
borda deve ser o nico retornado pelo EdgeReached.

CollidingWith (outro componente)

Indica se uma coliso foi registrada entre este componente e o componente


passado por parmetro.
MoveIntoBounds ()

Se a bola excede os limites de uma rea especificada, este mtodo alinha o


tamanho da bola com o da rea.

MoveTo (nmero x, nmero y)

Move a bola para o local especificado pelas coordenadas x e y.

PointInDirection (nmero x, nmero y)

Se a bola estiver em movimento ou em contato com a borda do canvas e esse


mtodo for chamado, a bola mudar sua direo, passando pelo ponto dado
pelas coordenadas (x, y).

PointTowards (componente alvo)

Se a bola estiver em movimento ou em contato com a borda do canvas e esse


mtodo for chamado, a bola mudar sua direo, passando pelo componente
dado por target.

ImageSprite
Uma imagem que pode ser colocado em um canvas, onde ela pode reagir a
toques, interagir com outros sprites ( ImageSprites e Bolas) e a borda da tela, e
mover-se de acordo com seus valores de propriedade.

Propriedades:
Picture

A imagem do Sprite.

Rotates

Se definido, a imagem do sprite gira para coincidir com o ttulo do Sprite. O


sprite gira em torno do seu ponto central.

Eventos:
Os mesmos eventos do componente Ball.

Mtodos:
Os mesmos mtodos do componente Ball.
Sensor Components - Componentes de sensores

AccelerometerSensor -
Componente no visvel que pode detectar a agitao e medir a acelerao
aproximadamente em trs dimenses (podendo entender a inclinao do
dispositivo) usando unidades do Sistema internacional (SI) (m / s2 ).

Propriedades:
xAccel

0 quando o telefone est em repouso sobre uma superfcie plana, positivo


quando o telefone est inclinado para a direita (ou seja, o lado esquerdo
elevado), e negativa quando o telefone est inclinado para a esquerda (ou seja,
o seu lado direito levantado).

yAccel

0 quando o telefone est em repouso sobre uma superfcie plana, positivo


quando seu fundo levantado, e negativo quando seu topo levantado.

zAccel

Igual a -9,8 (gravidade da Terra em metros por segundo quando o dispositivo


est em paralelo ao cho com o visor virado para cima, 0 quando perpendicular
ao cho, e 9,8 quando virado para baixo. O valor tambm pode ser afetado em
aceler-lo com ou contra a gravidade.

Available

Indica se o acelermetro est disponvel no dispositivo.

MinimumInterval

O intervalo mnimo entre shakes (sacudidas) do dispositivo.

Sensibility

Um nmero que codifica o quo sensvel o acelermetro. As opes so: 1 =


fraco, 2 = moderado, 3 = forte.

Eventos:
AccelerationChanged (nmero xAccel, nmero yAccel, nmero zAccel)

Iniciado quando a acelerao do dispositivo alterada, nas dimenses X, Y


e/ou Z.

Shaking()

Inicia quando o dispositivo comea ou continua a ser sacudido.


BarcodeScanner - Leitor de cdigos de barra
Componente para leitura de QR Codes.

Propriedades:
Result

Resultado da verificao anterior.

UseExternalScanner

Se definido, o App Inventor ir procurar e usar um programa de digitalizao


externo, como "Bar Code Scanner".

Eventos:
AfterScan (resultado texto)

Iniciado aps a leitura de um qr code.

Mtodos:
DoScan ()

Comea uma varredura de cdigo de barras, utilizando a cmara. Quando a


pesquisa estiver concluda, o evento AfterScan ser gerado.

Clock - Relgio
Componente no visvel que fornece o instante no tempo usando o relgio
interno no phone.It, e pode disparar um temporizador em intervalos definidos
regularmente e executar clculos de tempo, manipulaes, e converses.

Propriedades:
TimerAlwaysFires

Se definido, dispara mesmo quando o aplicativo no est mostrando na tela.

TimerEnabled

Se definido, o cronmetro fica ativo.

TimerInterval

Intervalo entre eventos do cronmetro em ms (milissegundos).

Eventos:
Timer()

Evento que dispara de acordo com a propriedade TimerInterval. Se esta estiver


com a quantidade 1000 ms (1 segundo), ento o evento disparar de 1 em 1
segundo.
Mtodos:
AddDays(Instante, nmero de dias)

Adiciona o nmero de dias passado por parmetro, ao instante passado por


parmetro.

AddHours (Instante, nmero de horas)

Adiciona o nmero de horas passado por parmetro, ao instante passado por


parmetro.

AddMinutes (Instante, nmero de minutos)

Adiciona o nmero de minutos passado por parmetro, ao instante passado por


parmetro.

AddMonths (Instante, nmero de meses)

Adiciona o nmero de meses passado por parmetro, ao instante passado por


parmetro.

AddSeconds (Instante, nmero de segundos)

Adiciona o nmero de segundos passado por parmetro, ao instante passado


por parmetro.

AddWeeks (Instante, nmero de semanas)

Adiciona o nmero de semanas passado por parmetro, ao instante passado


por parmetro.

AddYears(Instante, nmero de anos)

Adiciona o nmero de passado por parmetro, ao instante passado por


parmetro.

DayofMonth (Instante)

Retorno o dia do ms no instante passado por parmetro.

Duration (incio, final)

Retorna a quantidade de milissegundos decorridos entre o incio (start) e o final


(end).

FormatDate (Instante, padro de texto)

Retorna a data no instante passado por parmetro no padro especificado.


FormatDateTime (instante, padro de texto)

Retorna a data e o horrio no instante passado por parmetro no padro


especificado.

FormatTime (Instante)

Retorna o horrio no instante passado por parmetro.

GetMillis (Instante)

O instante de tempo medido como milissegundos desde 1970.

Hour (Instante)

Retorna a hora no instante passado por parmetro.

MakeInstant (texto de)

Retorna vrias informaes especificadas pelos formatos MM / DD / AAAA hh :


mm : ss ou MM / DD / AAAA ou hh: mm

MakeInstantFromMillis (nmero de millis)

Um instante no tempo especificado pelos milissegundos desde 1970.

Minute (Instante)

Retorna os minutos no instante passado por parmetro.

Month (Instante)

Retorna o ms do ano no instante passado por parmetro, representado como


um nmero de 1 a 12.

MonthName (Instante)

Retorna o nome do ms no instante passado por parmetro.

Now ()

O instante atual do relgio do telefone.

Second (Instante)

Retorna os segundos no instante passado por parmetro.

SystemTime ()

Tempo interno do telefone.

WeekDay (Instante)
Retorna o dia da semana no instante passado por parmetro, representado
como um nmero de 1 (domingo) a 7 (Sbado).

WeekdayName (Instante)

Retorna o nome do dia da semana no instante passado por parmetro.

Year (Instante)

Retorna o ano no instante passado por parmetro

LocationSensor Sensor de Localizao


Componente no visvel de fornecimento de informaes de localizao,
incluindo longitude, latitude, altitude (se for suportado pelo dispositivo), e
endereo.

Propriedades:
Accuracy

Indica o nvel de preciso do dispositivo, em metros.

Altitude

Altitude do dispositivo Android, se disponvel.

AvailableProviders

Lista de fornecedores de servios disponveis, como o GPS ou de rede. Esta


informao fornecida como uma lista e em forma de texto.

CurrentAddress

Endereo fsico do dispositivo Android.

DistanceInterval

Determina o intervalo mnimo de distncia, em metros, que o sensor ir tentar


usar para o envio de atualizaes de localizao.

Enabled

Se definido, as informaes de localizao estaro disponveis.

HasAccuracy

Se definido, o dispositivo Android pode relatar seu nvel de preciso.

HasAltitude

Se definido, o dispositivo Android pode relatar sua altitude.


HasLongitudeLatitude

Se definido, o dispositivo Android pode relatar longitude e latitude.

Latitude

Latitude do dispositivo Android.

Longitude

Longitude do dispositivo Android.

ProviderLocked

O dispositivo no ir alterar o fornecedor de servios.

ProviderName

O prestador de servios atual. O provedor provavelmente ser GPS ou de rede.

TimeInterval

Determina o intervalo mnimo de tempo, em milissegundos, que o sensor ir


tentar usar para o envio de atualizaes de localizao.

Eventos:
LocationChanged (nmero latitude, nmero longitude, nmero de altitude)

Chamado quando o dispositivo Android relata um novo local.

StatusChanged (provedor de texto, estado do texto)

Chamado quando o estatuto do prestador de servios sofre alteraes.

Mtodos:
LatitudeFromAddress (LocationName)

Determina a latitude do endereo fornecido.

LongitudeFromAddress (LocationName)

Determina a longitude do endereo fornecido.

OrientationSensor Sensor de Orientao


Use um componente sensor de orientao para determinar a orientao
espacial do telefone.
Propriedades:
Available

Indica se o sensor de orientao est presente no dispositivo Android.

Azimute

Retorna o ngulo de azimute do dispositivo. 0 graus quando a parte superior do


dispositivo est a apontar para o norte, 90 graus quando se est apontando
para o leste, 180 graus quando se est apontando para o sul, 270 graus
quando ele est apontando para o oeste, etc.

Pitch

Retorna o ngulo de inclinao do dispositivo.

Roll

Retorna o ngulo de rolagem do dispositivo.

Magnitude

Retorna um nmero entre 0 e 1 que indica o quanto o dispositivo est inclinado.


D a magnitude da fora que seria sentida por uma bola ao rolar sobre a
superfcie do dispositivo.

Angle

Retorna um ngulo que diz a direo em que o dispositivo est inclinado. Ou


seja, ele informa o sentido da fora que seria sentida por uma bola ao rolar
sobre a superfcie do dispositivo.

Eventos:
OrientationChanged (nmero azimute, nmero de inclinao, nmero de rolo)

Chamado quando a orientao muda.

ProximitySensor - Sensor de proximidade


Um componente que pode medir a proximidade de um objeto (em cm) em
relao ao ecr de visualizao de um dispositivo.

Propriedades:
Available

Relata se o dispositivo tem um sensor de proximidade

Enable

Se ativado, a aplicao poder realizar tarefas com o sensor.


KeepRunningWhenOnPause

Se definido, ele ir manter sensor de proximidade mesmo quando o aplicativo


no estiver visvel.

Distance

Retorna a distncia do objeto ao dispositivo.

MaximumRange

Informa o alcance mximo de ProximitySensor do dispositivo.

Eventos:
ProximityChanged (nmero distncia)

Chamado quando a distncia (em centmetros) do objeto ao dispositivo sofre


alteraes.

Social Components - Componentes Sociais

ContactPicker Selecionador de contatos


Um boto que, quando clicado, exibe uma lista dos contatos para escolher
entre.

Propriedades
ContactName

O nome do contato.

EmailAddress

Endereo de e-mail principal do contato.

Eventos
AfterPicking ()

Evento iniciado aps uma seleo ser feita no ContactPicker.

BeforePicking ()

Evento iniciado quando o ContactPicker aberto, mas antes que uma seleo
seja feita.

GotFocus ()

Indica que o cursor move sobre o boto de modo que agora possvel clicar
nele.
LostFocus ()

Indica que o cursor afastou-se do boto de modo que j no possvel clicar


nele.

Mtodos:
Open()

Abre o selecionador, como se o usurio clicar sobre ele.

EmailPicker Selecionador de e-mail


Um EmailPicker uma espcie de caixa de texto. Se o usurio comea a
introduzir o nome ou endereo de e-mail de um contato, o telefone ir mostrar
um menu suspenso de opes que completam a entrada.

Mtodos:
RequestFocus ()

Define o EmailPicker ativo.

Eventos:
GotFocus ()

Indica que o cursor move sobre o boto de modo que agora possvel clicar
nele.

LostFocus ()

Indica que o cursor afastou-se do boto de modo que j no possvel clicar


nele.

PhoneCall - Telefonema
Um componente no visvel que faz uma chamada telefnica para o nmero
especificado na propriedade PhoneNumber.

Propriedades
PhoneNumber

Nmero do telefone.

Eventos
IncomingCallAnswered (phoneNumber)

Evento indicando que uma chamada telefnica respondida. phoneNumber o


nmero chamada telefnica.
PhoneCallEnded (status, phoneNumber)

Evento indicando que uma chamada de telefone foi encerrada. Se o status for
1, chamada de entrada perdida ou rejeitada; se o status 2, chamada
atendida antes de desligar; se o estado 3, chamada de sada desligou.
phoneNumber o nmero de telefone de entrada / sada.

PhoneCallStarted (status, phoneNumber)

Evento indicando que um telefonema foi iniciado. Se o status for 1, chamada de


entrada est tocando; se o status 2, chamada de sada discado.
phoneNumber o nmero de telefone de entrada / sada.

Mtodos:
MakePhoneCall ()

Faz uma chamada de telefone atravs do nmero na propriedade


PhoneNumber.

PhoneNumberPicker Selecionador de nmeros de telefone


Um boto que, quando clicado, exibe uma lista de nmeros de telefone dos
contatos para escolher entre.

Propriedades:
ContactName

O nome do contato

EmailAddress

Endereo de e-mail do contato.

PhoneNumber

Nmero de telefone do contato.

Eventos:
AfterPicking ()

Evento iniciado aps uma seleo ser feita no ContactPicker.

BeforePicking ()

Evento iniciado quando o ContactPicker aberto, mas antes que uma seleo
seja feita.
GotFocus ()

Indica que o cursor move sobre o boto de modo que agora possvel clicar
nele.

LostFocus ()

Indica que o cursor afastou-se do boto de modo que j no possvel clicar


nele.

Mtodos:
Open ()

Abre o selecionador, como se o usurio clicar sobre ele.

Sharing - Compartilhamento

Sharing um componente no visvel que permite o compartilhamento de


arquivos e / ou mensagens entre seu aplicativo e outros aplicativos instalados
em um dispositivo. O componente ir exibir uma lista dos aplicativos instalados
que podem lidar com as informaes fornecidas, e permitir que o usurio
escolha um para compartilhar o contedo com, por exemplo, um aplicativo de
e-mail, uma rede sociais, um aplicativo de mensagens de texto, e assim por
diante.

Mtodos:
ShareFile (arquivo)

Compartilha um arquivo atravs de qualquer aplicao capaz instalada no


telefone, exibindo uma lista dos aplicativos disponveis e permitindo que o
usurio escolha um da lista. O aplicativo selecionado ser aberto com o arquivo
inserido nele.

ShareFileWithMessage (arquivo, mensagem)

Compartilha um arquivo e uma mensagem atravs de qualquer aplicao


capaz instalada no telefone, exibindo uma lista de aplicativos disponveis e
permitindo que o usurio escolha um da lista. O aplicativo selecionado ser
aberto com o arquivo e mensagem inseridos nele.

ShareMessage (mensagem)

Compartilha uma mensagem atravs de qualquer aplicao capaz instalada no


telefone, exibindo uma lista dos aplicativos disponveis e permitindo que o
usurio escolha um da lista. O aplicativo selecionado ser aberto com a
mensagem inserida nele.
Texting
Um componente que ir, quando o SendMessage mtodo for chamado, enviar
a mensagem de texto especificado na mensagem de estabelecimento para o
nmero de telefone especificado na propriedade PhoneNumber.

Propriedades:
GoogleVoiceEnabled

Se definido, ento SendMessage tentar enviar mensagens atravs de Wi-Fi


usando o Google Voice. Isso requer que o app Google Voice esteja instalado e
configurado no telefone ou tablet, com uma conta do Google Voice. Se
GoogleVoiceEnabled falso, o dispositivo deve ter um servio de mensagens
de texto, a fim de enviar ou receber mensagens com este componente.

Message

A mensagem a ser enviada quando o mtodo SendMessage chamado.

PhoneNumber

O nmero para o qual a mensagem vai ser enviada.

ReceivingEnabled

Se definido como (OFF), as mensagens no sero recebidas. Se definido como


(Foreground), as mensagens sero recebidas quando o app estiver aberto. Se
definido como (Always), as mensagens sempre sero recebidas.

Eventos:
MessageReceived (nmero, MessageText)

Evento que gerado quando uma mensagem de texto recebida pelo telefone.

Mtodos:
SendMessage ()

Enviar uma mensagem de texto.

Twitter
Um componente no visvel que permite a comunicao com o Twitter.

Propriedades:
ConsumerKey

A chave do consumidor para ser usado para autorizao com o Twitter via
OAuth.
ConsumerSecret

O segredo do consumidor para ser usado para autorizao com o Twitter via
OAuth

DirectMessages

Esta propriedade contm uma lista das mensagens mais recentes que citam o
usurio logado. Inicialmente, a lista est vazia. Para configur-la, o programa
deve:

Chamar o mtodo Authorize.

Aguardar o evento IsAuthorize.

Chamar o mtodo RequestDirectMessages.

Aguardar o evento DirectMessagesReceived.

O valor dessa propriedade ser ento definido para a lista de mensagens


diretas recuperadas (e manter esse valor at qualquer chamada subsequente
para RequestDirectMessages ).

Followers

Esta propriedade contm uma lista de seguidores do usurio logado.


Inicialmente, a lista est vazia. Para configur-la, o programa deve:

Chamar o mtodo Authorize.

Aguardar o evento IsAuthorize.

Chamar o mtodo RequestFollowers.

Aguardar o evento FollowersReceived.

O valor dessa propriedade ser ento definido para a lista de seguidores (e


manter o seu valor at qualquer chamada subsequente para RequestFollowers
).

FriendTimeline

Esta propriedade contm as 20 mensagens mais recentes dos usurios


seguidos. Inicialmente, a lista est vazia. Para configur-la, o programa deve:

Chamar o mtodo Authorize.

Aguardar o evento IsAuthorize.

Especificar os usurios seguidos com um ou mais chamadas para o mtodo


Follow.
Chamar o mtodo RequestFriendTimeline.

Aguardar o evento FriendTimelineReceived.

O valor dessa propriedade ser ento definido para a lista de mensagens (e


manter o seu valor at qualquer chamada subsequente para
RequestFriendTimeline) .

Mentions

Esta propriedade contm uma lista de menes (referncias) do usurio


logado. Inicialmente, a lista est vazia. Para configur-la, o programa deve:

Chamar o mtodo Authorize.

Aguardar o evento IsAuthorize.

Chamar o mtodo RequestMentions.

Aguardar o evento MentionsReceived.

O valor dessa propriedade ser ento definido para a lista de menes (e


manter o seu valor at qualquer chamada subsequente para RequestMentions
).

SearchResults

Esta propriedade, que inicialmente vazia, est definida para uma lista de
resultados de pesquisa aps o programa:

Chamar o mtodo SearchTwitter.

Aguardar o evento SearchSuccessful.

O valor da propriedade ser, ento, o mesmo que o parmetro para


SearchSuccessful . Note que no necessrio chamar mtodo Authorize antes
de chamar SearchTwitter .

UserName

O nome de usurio do usurio autorizado. Vazio se no houver nenhum


usurio autorizado.

Eventos:
DirectMessagesReceived (mensagens de lista)

Este evento gerado quando as mensagens recentes solicitadas atravs do


RequestDirectMessages foram recuperadas. Uma lista de mensagens pode,
ento, ser encontrada no parmetro messages ou a mensagens de
estabelecimento.

FollowersReceived (lista Seguidores2)

Este evento gerado quando todos os seguidores do usurio logado


solicitados atravs do RequestFollowers foram recuperados. A lista dos
seguidores pode ser encontrada no parmetro followers2 ou na propriedade
Followers.

FriendTimelineReceived (lista linha do tempo)

Este evento gerado quando as mensagens solicitadas atravs do


RequestFriendTimeline foram recuperadas. O parmetro timeline e a
propriedade Timeline iro conter uma lista de listas, onde cada sub-lista contm
uma atualizao de status do formulrio (mensagem username)

IsAuthorized ()

Este evento gerado aps o programa chamar o mtodo Authorize, se a


autorizao foi bem sucedida. tambm gerado aps uma chamada para
CheckAuthorized se j temos um token de acesso vlido. Aps este evento ter
sido levantado, qualquer outro mtodo para este componente pode ser
chamado.

MentionsReceived (lista menciona)

Este evento gerado quando as menses do usurio logado solicitadas


atravs do RequestMentions foram recuperadas. Uma lista das menes pode
ser encontrada no parmetro mentions ou na propriedade Mentions.

SearchSuccessful (searchResults)

Este evento gerado quando os resultados da pesquisa solicitada atravs do


SearchSuccessful foram recuperados. A lista de resultados pode ento ser
encontrada no parmetro results ou na propriedade Results.

Mtodos:
Authorize()

Redireciona o usurio para acessar o Twitter atravs do navegador da Web,


usando o protocolo OAuth, se no tiver autorizao.

CheckAuthorized ()

Verifica se j tem acesso, e em caso afirmativo, provoca o manipulador de


eventos isAuthorized.
DeAuthorize ()

Remove a autorizao do Twitter a partir desta instncia do aplicativo em


execuo.

DirectMessage (usurio, mensagem)

Isso envia uma mensagem direta (privado) para o usurio especificado. A


mensagem ser aparada se exceder 160 caracteres.

Requisitos: Isso s deve ser chamado aps o evento isAuthorized ser


levantado, indicando que o usurio est registrado com sucesso no Twitter.

Follow(usurio)

Comea a seguir um usurio.

RequestDirectMessages ()

Requisita as 20 mensagens diretas mais recentes enviadas para o usurio


logado. Quando as mensagens so recuperadas, o sistema ir levantar o
evento DirectMessagesReceived e definir a propriedade DirectMessages lista
de mensagens.

Requisitos: Isso s deve ser chamado aps o evento isAuthorized ser


levantado, indicando que o usurio est registrado com sucesso no Twitter.

RequestFollowers ()

Obtm quem est seguindo voc.

RequestFriendTimeline()

Obtm as mais recentes 20 mensagens na linha do tempo do usurio.

RequestMentions()

Solicita as 20 mais recentes referncias ao usurio logado. Quando as


referncias so recuperadas, o sistema ir iniciar o evento MentionsReceived e
definir a propriedade Mentions lista de menes.

Requisitos: Isso s deve ser chamado aps o evento isAuthorized ser


levantado, indicando que o usurio est registrado com sucesso no Twitter.

SearchTwitter (texto)

Isto procura no Twitter o texto dado.

Requisitos: Isso s deve ser chamado aps o evento isAuthorized ser


levantado, indicando que o usurio est registrado com sucesso no Twitter.
StopFollowing (usurio)

Deixa de seguir um usurio.

Tweet (status)

Isso envia um tweet como o usurio conectado com o status especificado, que
ser cortado se exceder 160 caracteres.

Requisitos: Isso s deve ser chamado aps o evento isAuthorized ser


levantado, indicando que o usurio est registrado com sucesso no Twitter.

TweetWithImage (status, imagepath)

Isso envia um tweet como o usurio conectado com o status especificado e um


caminho para a imagem a ser carregada, que sero cortados se exceder 160
caracteres. Se uma imagem no for encontrada ou for invlida, a atualizao
no ser enviada.

Requisitos: Isso s deve ser chamado aps o evento isAuthorized ser


levantado, indicando que o usurio est registrado com sucesso no Twitter.

Storage Components Componentes de Armazenamento

File - Arquivo
Componente no visvel para armazenar e recuperar arquivos. Use este
componente para escrever ou ler arquivos em seu dispositivo. O
comportamento padro para gravar arquivos no diretrio de dados privado
associado sua App. O companheiro escreve arquivos de / sdcard /
AppInventor / dados para facilitar a depurao. Se o caminho do arquivo
comea com uma barra (/), em seguida, o arquivo criado em relao ao /
sdcard. Por exemplo, escrever um arquivo para /myFile.txt ir gravar o arquivo
em /sdcard/myFile.txt.

Eventos:
GotText (texto)

Evento indicando que o contedo do arquivo foi lido.

Mtodos:
AppendToFile (texto, fileName)

Acrescenta texto ao fim de um arquivo. Cria o arquivo se ele ainda no existir.


Consulte o texto de ajuda sob SaveFile para obter informaes sobre onde os
arquivos so gravados.
Delete (fileName)

Exclui um arquivo de armazenamento. Prefixar o nome do arquivo com / para


excluir um arquivo especfico no carto SD (por exemplo, /myFile.txt ir apagar
o arquivo /sdcard/myFile.txt). Se o nome no comea com a /, em seguida, o
arquivo localizado em armazenagem privada do programa ser excludo.
Iniciando o arquivo com // um erro porque os arquivos de ativos no podem
ser excludo.

ReadFrom (fileName)

L texto de um arquivo no armazenamento. Prefixar o nome do arquivo com /


para ler a partir de um arquivo especfico no carto SD (por exemplo,
/myFile.txt ir ler o arquivo /sdcard/myFile.txt). Para ler bens embalados com
uma aplicao (tambm funciona para o Companion) iniciar o nome do arquivo
com // (duas barras). Se um nome de arquivo no comear com uma barra, ele
ser lido a partir do armazenamento particular do aplicativo (por aplicativos em
pacotes) e de / sdcard / AppInventor / dados para o Companion.

SaveFile (texto, fileName)

Salva texto para um arquivo. Se o nome do arquivo comea com uma barra (/)
o arquivo gravado no sdcard (por exemplo, escrevendo para /myFile.txt ir
gravar o arquivo em /sdcard/myFile.txt). Se o nome do arquivo no comear
com uma barra, ele ser gravado no diretrio de dados privado do programa,
quando isso no ser acessvel a outros programas no telefone. H uma
exceo especial para o companheiro AI onde esses arquivos so gravados
em / sdcard / AppInventor / dados para facilitar a depurao. Note-se que este
bloco ir substituir um arquivo se ele j existe. Se voc quiser adicionar
contedo em um arquivo de usar o bloco de acrscimo.

FusionTablesControl
Um componente no visvel, que comunica com o Google Fusion Tables.
Fusion Tables permitem armazenar, compartilhar, consulta e visualizar tabelas
de dados; este componente permite que voc consulte, crie e modifique estas
tabelas.

Este componente utiliza a fuso V1.0 Tabelas API .

Aplicaes usando o Fusion Tables deve autenticar com os servidores do


Google. H duas maneiras onde isto pode ser feito. A primeira maneira utiliza
apenas uma chave de API que voc (desenvolvedor) pode obter. Com esta
abordagem os usurios finais tambm devem entrar para acessar uma tabela
de fuso.
A segunda abordagem a utilizao do servio de autenticao. Com essa
abordagem, voc cria credenciais e um especial "Conta de servio E-mail
Address" que permite que os usurios finais possam usar seus Fusion Tables
sem efetuar login; a conta de servio autentica todos os acessos.

Propriedades:
ApiKey

Sua Chave API do Google. Veja acima para obter detalhes sobre a obteno
de uma chave de API.

KeyFile

Especifica o caminho do arquivo de chave privada. Este arquivo de chave


usado para obter acesso API FusionTables atravs do servio de
autenticao.

Question

A consulta para enviar para o API Fuso Tables.

Para os formatos de consulta legais e exemplos, consulte o manual de


referncia v1.0 API FusionTables .

ServiceAccountEmail

A conta de servio do endereo de e-mail usado para autenticao Service.

UseServiceAuthentication

Indica se uma conta de servio deve ser usada para autenticao.

Eventos:
GotResult (resultado)

Indica que a consulta Fusion Tables concluiu o processamento e voltou com


um resultado. O resultado da consulta ser geralmente retornado no formato
CSV, e pode ser convertido para a lista usando o formato "lista da tabela csv"
ou "lista de linha CSV" blocos.

Mtodos:
ForgetLogin ()

Esquea as credenciais de login do utilizador final. No tem efeito sobre


Authentication Service.
GetRows (tableID, colunas)

Obtm todas as linhas de uma tabela Fuso especificado. O campo tableID


(obrigatrio) o id da tabela de fuso. O campo de colunas uma lista
separada por vrgula das colunas para recuperar.

GetRowsWithConditions (tableID, colunas, condies)

Obtm todas as linhas de uma tabela de fuso que cumprir determinadas


condies. O campo tableID (obrigatrio) o id da tabela de fuso. O campo
de colunas uma lista separada por vrgula das colunas para recuperar. O
campo de condies especifica quais linhas para recuperar da tabela (por
exemplo, as linhas em que um valor de coluna em particular no nulo).

InsertRow (tableID, colunas, valores)

Insere uma linha na tabela Fuso especificada. O campo tableID o ID da


tabela de fuso. O campo de colunas uma lista das colunas em que para
inserir valores separados por vrgulas. O campo de valores especifica os
valores a inserir em cada coluna.

SendQuery ()

Enviar a consulta para o servidor Fusion Tables.

TinyDB
TinyDB um componente no-visvel que armazena dados para um aplicativo.

Aplicativos criados com o App Inventor so inicializados a cada vez que so


executados. Isto significa que se um aplicativo define o valor de uma varivel e,
em seguida, o usurio fecha o aplicativo, o valor dessa varivel no ser
lembrado na prxima vez que o aplicativo executado. Em contraste, TinyDB
um persistente armazenamento de dados para o aplicativo. Os dados
armazenados em um TinyDB estaro disponveis cada vez que o aplicativo
executado. Um exemplo pode ser um jogo que salva a pontuao mais alta e
recupera-lo cada vez que o jogo jogado.

Mtodos:
ClearAll()

Limpar todo o armazenamento de dados no TinyDB.

ClearTag (tag)

Desmarque a entrada com a tag dada.

GetTags ()
Retorna uma lista de todas as marcas no TinyDB.

GetValue (tag, valueIfTagNotThere)

Recuperar o valor armazenado sob a tag dada. Se no existe essa tag, em


seguida, retornar valueIfTagNotThere.

StoreValue (tag, valueToStore)

Armazenar o valor sob a tag dada. O armazenamento persiste no telefone


quando o aplicativo for reiniciado.

TinyWebDB
Componente no visvel que se comunica com um servio Web para
armazenar e recuperar informaes.

Propriedades:
ServiceURL

O URL para o banco de dados com os quais o componente deve comunicar.

Eventos:
GotValue (tagFromWebDB, valueFromWebDB)

Indica que uma solicitao servidor GetValue foi bem sucedido.

ValueStored ()

Evento indicando que um pedido do servidor StoreValue foi bem sucedido.

WebServiceError (mensagem)

Indica que a comunicao com o servio Web sinalizou um erro.

Mtodos:
GetValue (tag)

Envia uma solicitao para o servio da Web para obter o valor armazenado
sob a tag dada. O servio Web deve decidir o que retornar se no houver
nenhum valor armazenado sob a tag. Este componente aceita tudo devolvido.

StoreValue (tag, valueToStore)

Envia uma solicitao para o servio da Web para armazenar o valor dado sob
a tag dada.
Connectivity Components - Componentes de conectividade

ActivityStarter
Um componente que pode lanar uma atividade usando o mtodo startActivity.

Atividades que podem ser iniciadas incluem:

Comeando outro App Inventor para o Android app. Para fazer isso, primeiro
descobrir a classe do outro aplicativo fazendo o download do cdigo fonte e
usando um explorador de arquivos ou descompacte o utilitrio para encontrar
um arquivo chamado "youngandroidproject / project.properties". A primeira
linha do arquivo vai comear com "principais =" e ser seguida pelo nome da
classe; por exemplo, principal = com.gmail.Bitdiddle.Ben.HelloPurr.Screen1 . (.
Os primeiros componentes indicam que ele foi criado por
Ben.Bitdiddle@gmail.com) Para fazer o seu ActivityStarter lanar este
aplicativo, defina as seguintes propriedades:

Iniciando o aplicativo de cmera, definindo as seguintes propriedades:

Ao: android.intent.action.MAIN

ActivityPackage: com.android.camera

ActivityClass: com.android.camera.Camera

Execuo de pesquisa na web. Assumindo que o termo que voc deseja


procurar "vampire" (sinta livre substituir sua prpria escolha), defina as
propriedades para:

Ao: android.intent.action.WEB_SEARCH

ExtraKey: query

ExtraValue: vampiro

ActivityPackage: com.google.android.providers.enhancedgooglesearch

ActivityClass: com.google.android.providers.enhancedgooglesearch.Launcher

Propriedades:
Action

Ao da atividade a ser lanada.

ActivityClass

Nome de classe da atividade a ser lanada.


ActivityPackage

Nome do pacote da atividade a ser lanada.

DataUri

URI passado para a atividade a ser lanada.

ExtraKey

Nome da chave de texto passado para a atividade.

ExtraValue

Valor de texto passado para a atividade.

Result

Valor devolvido pela atividade que est sendo iniciada.

ResultName

O nome usado para extrair o resultado retornado da atividade que est sendo
iniciada.

ResultType

Escreva informaes retornadas da atividade que est sendo iniciada.

ResultUri

URI (ou dados) informaes retornadas da atividade que est sendo iniciada.

Eventos:
AfterActivity (resultado)

Evento gerado aps o retorno de ActivityStarter.

ActivityCanceled ()

Evento levantado se este ActivityStarter retorna porque a atividade foi


cancelada.

Mtodos:
ResolveActivity()

Retorna o nome da atividade que corresponde a este ActivityStarter, ou uma


string vazia se nenhuma atividade correspondente pode ser encontrada.

StartActivity ()

Comece a atividade correspondente a esta ActivityStarter.


BluetoothClient
Componente cliente Bluetooth.

Propriedades:
AddressesAndNames

Os endereos e nomes de dispositivos Bluetooth emparelhados.

Available

Se Bluetooth est disponvel no dispositivo.

CharacterEncoding

A codificao de caracteres para usar ao envio e recebimento de texto.

DelimiterByte

O byte delimitador para usar quando passar um nmero negativo para o


parmetro numberOfBytes ao chamar ReceiveText, ReceiveSignedBytes, ou
ReceiveUnsignedBytes.

Enable

Se Bluetooth est ativado.

HighByteFirst

Se os nmeros de 2 e 4 bytes devem ser enviados e recebidos com o elevado


(ou mais significativo) primeiro byte. Verifique a documentao para o
dispositivo com o qual seu aplicativo estar se comunicando para a
configurao adequada. Esta tambm conhecida como big-endian.

IsConnected

Se est conectado.

Secure

Se invoca a SSP (emparelhamento seguro simples), que suportado em


dispositivos com Bluetooth v2.1 ou superior. Ao trabalhar com dispositivos
Bluetooth embutidos, esta propriedade pode precisar ser definida como False.
Para Android 2,0-2,2, esta configurao de propriedade ser ignorada.

Mtodos:
BytesAvailableToReceive ()

Devolve uma estimativa do nmero de bytes que pode ser recebido sem
bloquear.
Connect (endereo)

Conecte-se com o dispositivo Bluetooth com o endereo especificado e o perfil


de porta srie (SPP). Retorna true se a conexo foi bem sucedida.

ConnectWithUUID (endereo, uuid)

Conecte-se com o dispositivo Bluetooth com o endereo especificado e UUID.


Retorna true se a conexo foi bem sucedida.

Disconnect ()

Desligue a partir do dispositivo Bluetooth ligado.

IsDevicePaired (endereo)

Verifica se o dispositivo Bluetooth com o endereo especificado


emparelhado.

ReceiveSigned1ByteNumber ()

Receber um nmero de 1 byte assinado a partir do dispositivo Bluetooth ligado.

ReceiveSigned2ByteNumber ()

Receber um nmero de 2 bytes assinado a partir do dispositivo Bluetooth


ligado.

ReceiveSigned4ByteNumber ()

Receber um nmero de 4 bytes assinado a partir do dispositivo Bluetooth


ligado.

ReceiveSignedBytes (numberOfBytes)

Receber vrios valores de bytes assinados a partir do dispositivo Bluetooth


ligado. Se numberOfBytes inferior a 0, ler at um valor de byte delimitador ser
recebido.

ReceiveText (numberOfBytes)

Receber mensagens de texto a partir do dispositivo Bluetooth ligado. Se


numberOfBytes inferior a 0, ler at um valor de byte delimitador ser recebido.

ReceiveUnsigned1ByteNumber ()

Receba um nmero de 1 byte sem sinal a partir do dispositivo Bluetooth ligado.

ReceiveUnsigned2ByteNumber ()

Receber um nmero de 2 bytes sem sinal a partir do dispositivo Bluetooth


ligado.
ReceiveUnsigned4ByteNumber ()

Receber um nmero de 4 bytes sem sinal a partir do dispositivo Bluetooth


ligado.

ReceiveUnsignedBytes (numberOfBytes)

Receba vrios valores de byte sem sinal a partir do dispositivo Bluetooth ligado.
Se numberOfBytes inferior a 0, ler at um valor de byte delimitador ser
recebido.

Send1ByteNumber (nmero)

Envie um nmero de 1 byte para o dispositivo Bluetooth ligado.

Send2ByteNumber (nmero)

Envie um nmero de 2 bytes para o dispositivo Bluetooth ligado.

Send4ByteNumber (nmero)

Envie um nmero de 4 bytes para o dispositivo Bluetooth ligado.

SendBytes (lista)

Enviar uma lista de valores de bytes para o dispositivo Bluetooth ligado.

SendText (texto)

Enviar mensagens de texto para o dispositivo Bluetooth ligado.

BluetoothServer:
Componente de servidor Bluetooth.

Propriedades:
Available

Se o Bluetooth est disponvel no dispositivo Android.

CharacterEncoding

A codificao de caracteres para usar ao envio e recebimento de texto.

DelimiterByte

O byte delimitador para usar quando passar um nmero negativo para o


parmetro numberOfBytes ao chamar ReceiveText, ReceiveSignedBytes, ou
ReceiveUnsignedBytes.
Enable

Se o Bluetooth est ativado.

HighByteFirst

Se os nmeros de 2 e 4 bytes devem ser enviados e recebidos com o elevado


(ou mais significativo) primeiro byte. Verifique a documentao para o
dispositivo com o qual seu aplicativo estar se comunicando para a
configurao adequada. Esta tambm conhecida como big-endian.

IsAccepting

Se este componente BluetoothServer est aceitando uma conexo de entrada.

IsConnected

Se uma conexo Bluetooth foi feita.

Eventos:
ConnectionAccepted ()

Indica que uma conexo Bluetooth foi aceita.

Mtodos:
AcceptConnection (serviceName)

Aceitar uma conexo de entrada com o perfil de porta srie (SPP).

AcceptConnectionWithUUID (serviceName, uuid)

Aceitar uma conexo de entrada com um UUID especfico.

BytesAvailableToReceive ()

Devolve uma estimativa do nmero de bytes que pode ser recebido sem
bloquear.

Disconnect ()

Desligue a partir do dispositivo Bluetooth ligado.

ReceiveSigned1ByteNumber ()

Receber um nmero de 1 byte assinado a partir do dispositivo Bluetooth ligado.

ReceiveSigned2ByteNumber ()

Receber um nmero de 2 bytes assinado a partir do dispositivo Bluetooth


ligado.

ReceiveSigned4ByteNumber ()
Receber um nmero de 4 bytes assinado a partir do dispositivo Bluetooth
ligado.

ReceiveSignedBytes (numberOfBytes)

Receber vrios valores de bytes assinados a partir do dispositivo Bluetooth


ligado. Se numberOfBytes inferior a 0, ler at um valor de byte delimitador ser
recebido.

ReceiveText (numberOfBytes)

Receber mensagens de texto a partir do dispositivo Bluetooth ligado. Se


numberOfBytes inferior a 0, ler at um valor de byte delimitador ser recebido.

ReceiveUnsigned1ByteNumber ()

Receba um nmero de 1 byte sem sinal a partir do dispositivo Bluetooth ligado.

ReceiveUnsigned2ByteNumber ()

Receber um nmero de 2 bytes sem sinal a partir do dispositivo Bluetooth


ligado.

ReceiveUnsigned4ByteNumber ()

Receber um nmero de 4 bytes sem sinal a partir do dispositivo Bluetooth


ligado.

ReceiveUnsignedBytes (numberOfBytes)

Receba vrios valores de byte sem sinal a partir do dispositivo Bluetooth ligado.
Se numberOfBytes inferior a 0, ler at um valor de byte delimitador ser
recebido.

Send1ByteNumber (nmero)

Envie um nmero de 1 byte para o dispositivo Bluetooth ligado.

Send2ByteNumber (nmero)

Envie um nmero de 2 bytes para o dispositivo Bluetooth ligado.

Send4ByteNumber (nmero)

Envie um nmero de 4 bytes para o dispositivo Bluetooth ligado.

SendBytes (lista)

Enviar uma lista de valores de bytes para o dispositivo Bluetooth ligado.


SendText (texto)

Enviar mensagens de texto para o dispositivo Bluetooth ligado.

StopAccepting ()

Parar de aceitar uma conexo de entrada.

Web - Rede
Componente no visvel que fornece funes para HTTP GET, POST, PUT e
DELETE solicitaes.

Propriedades:
AllowCookies

Se os cookies de uma resposta devem ser guardados e utilizados em pedidos


subsequentes. Os cookies so suportados apenas na verso Android 2.3 ou
superior.

RequestHeaders

Os cabealhos de solicitao, como uma lista de sub-listas de dois elementos.


O primeiro elemento de cada sub-lista representa o nome do campo de
cabealho de solicitao. O segundo elemento de cada sub-lista representa os
valores do campo de cabealho do pedido, ou um valor nico ou uma lista que
contm vrios valores.

Responsefilename

O nome do arquivo em que a resposta deve ser salva. Se SaveResponse


verdadeiro e responsefilename est vazia, ento um novo nome de arquivo
ser gerado.

SaveResponse

Se a resposta deve ser salvo em um arquivo.

Url

O URL para a solicitao da web.

Eventos:
GotFile (url, responseCode, responseType, fileName)

Evento indicando que uma solicitao foi concluda.

GotText (url, responseCode, responseType, responseContent)

Evento indicando que uma solicitao foi concluda.


Mtodos:
BuildRequestData (lista)

Converte uma lista de sub-lists de dois elementos, representando pares nome


e valor, para uma cadeia formatada como application / x-www-form-urlencoded
tipo de mdia, adequado para passar para PostText.

ClearCookies ()

Limpa todos os cookies para este componente Web.

Delete ()

Realiza uma solicitao HTTP DELETE usando a propriedade Url e recupera a


resposta.

Get()

Executa uma solicitao HTTP GET usando a propriedade Url e recupera a


resposta.

HtmlTextDecode (htmlText)

Decodifica o dado valor de texto HTML. Entidades de HTML como & amp ;, & lt
;, & gt ;, & apos ;, e & quot; so alterados para &, <,>, ', e ". Entidades como o
& # xhhhh, e & # nnnn so alteradas para os caracteres apropriados.

JsonTextDecode (jsonText)

Decodifica o valor dado JSON codificado para produzir um valor AppInventor


correspondente. Uma lista JSON [x, y, z] decodifica a uma lista (xyz), um objeto
JSON com o nome A e B valor, (indicado como A: B entre chaves) descodifica
a uma lista ((AB)), que , uma lista contendo a lista de dois elementos (AB).

PostFile (caminho)

Executa uma solicitao HTTP POST usando a propriedade Url e dados do


arquivo especificado.

PostText (texto)

Executa uma solicitao HTTP POST usando a propriedade Url e o texto


especificado.

Os caracteres do texto so codificados usando codificao UTF-8.

PostTextWithEncoding (texto, codificao)

Executa uma solicitao HTTP POST usando a propriedade Url e o texto


especificado.
Os caracteres do texto so codificados usando a codificao dada.

PutFile (caminho)

Executa uma solicitao HTTP PUT usando a propriedade Url e dados do


arquivo especificado.

PutText (texto)

Executa uma solicitao HTTP PUT usando a propriedade Url e o texto


especificado.

Os caracteres do texto so codificados usando codificao UTF-8.

PutTextWithEncoding (texto, codificao)

Executa uma solicitao HTTP PUT usando a propriedade Url e o texto


especificado.

Os caracteres do texto so codificados usando a codificao dada.

UriEncode (texto)

Codifica o valor de texto determinado de modo que possa ser usada em um


URL.

XMLTextDecode (XmlText)

Decodifica a string XML dada para produzir uma estrutura de lista. Consulte a
documentao do App Inventor em "Outros temas, notas e detalhes" para obter
informaes.

Blocks Blocos

A seguir descreveremos um conjunto de blocos utilizados na programao para


app inventor. Estes blocos no so especficos de componentes, mas so
muito importantes para o desenvolvimento de uma aplicao completa.

Control Controle

If Se

Neste bloco uma condio ser avaliada, caso o programa declare esta
condio como verdadeira, o conjunto de blocos dentro do If-Se ser
executado.
For each number from - Para cada nmero de

Executa os blocos na seo "do" para cada valor numrico no intervalo do


incio ao fim, passando um valor de cada vez. Use o nome da varivel dada
para se referir ao valor atual.

For each item in list - Para cada item na lista

Executa os blocos na seo "fazer" para cada item na lista. Use dado nome de
varivel para se referir ao atual item da lista.

While - Enquanto

Executa os blocos na seo "fazer" enquanto o teste verdadeiro.

If / Then / Else Se / Ento / Se no

Se a condio que est sendo testada for verdade, retornar o resultado da


avaliao da expresso ligada ao slot 'then-return' caso contrrio retornar o
resultado da avaliao da expresso ligada ao slot 'else-return, no mximo,
uma das expresses do entalhe retorno ser ser avaliada.

Do - Faz

Executa os blocos em "fazer" e retorna um comunicado. til se voc precisa


executar um procedimento antes de retornar um valor a varivel.
Evaluate but ignore result - Avaliar mas ignorar o resultado

Executa o bloco de cdigo ligado e ignora o valor de retorno (se houver). til se
necessidade de chamar um procedimento com um valor de retorno, mas no
precisa do valor.

Open another screen screenName - Abra outra ScreenName tela

Abre uma nova tela em um aplicativo de tela mltipla.

Open another screen with start value Abra outa tela com valor inicial

Abre uma nova tela em um aplicativo de tela mltipla e passa o valor inicial
para a tela.

Get Star Value - Obter Valor Inicial

Retorna os valores que foram transmitidos a esta tela quando foi iniciado,
tipicamente por uma outra tela em um aplicativo de tela mltipla. Se nenhum
valor foi aprovado, retorna o texto vazio.
Close Screen - Fechar tela

Feche a tela atual.

Close screen with value - Fechar tela com valor

Fechar tela atual e retorna um resultado para a tela que abriu que este.

Close application - Fechar pedido

Feche todas as telas neste app e para o app.

Get plain start next - Se plancie comear no prximo

Retorna o texto simples que foi passado para esta tela quando foi iniciado por
outro app. Se nenhum valor foi aprovada, retorna o texto vazio. Para vrios
aplicativos em tela, use obter o valor iniciar em vez de se comear.

Logic Logico

True Verdadeiro

Retorna a varivel booleana verdadeiro.

False Falso

Retorna a varivel booleana falso.

Not No

Retorna verdadeiro se a varivel for falsa e vice-versa.

Equal - Igual

Testa se duas coisas so iguais. As coisas que esto sendo comparados


podem ser quaisquer coisas, no apenas nmeros. Os nmeros so
considerados para ser igual ao seu impresso a partir de cadeias, por exemplo,
o nmero 0 igual ao texto "0". Alm disso, duas cadeias que representam
nmeros so iguais se os nmeros so iguais, por exemplo "1" igual a "01".

And - E

Retorna verdadeiro se todas as entradas so verdadeiras.


Or Ou

Retorna verdadeiro se ao menos uma entrada for verdadeira.

Math Matemtica

Number - Nmero

Relate o nmero mostrado.

Equal - Igual

Testa se dois valores indicados so iguais. Se assim for, ele retorna true; caso
contrrio, retorna falso. Este o mesmo que o bloco na gaveta lgica e
repetido aqui por convenincia. Os argumentos podem ser qualquer coisa, no
apenas nmeros.

Sum - Soma

Retorna a soma dos dois ou mais nmeros.

Decrease - Diminuir

Devolver a diferena dos dois nmeros.

Multiplication - Multiplicao

Devolver o produto dos dois ou mais nmeros.

Division Diviso

Retorna o quociente entre 2 nmeros.

Power Potencia

Retorna o primeiro nmero elevado potncia do segundo nmero.

Random integer - Inteiro aleatrio

Retorna um valor inteiro aleatrio entre os valores indicados, inclusive. A ordem


dos argumentos no importa.

Random fraction Frao aleatria

Retorna um valor aleatrio entre 0 e 1.


Random set seed to - Semente conjunto aleatrio de

Utilize este bloco para gerar sequncias repetitivas de nmeros aleatrios.


Voc pode gerar a mesma sequncia de nmeros aleatrios, primeiro
chamando semente conjunto aleatrio com o mesmo valor. Isso til para
programas de testes que envolvem valores aleatrios.

Min / Max Minimo / Maximo

Retorna o menor de um determinado conjunto de nmeros.


Retorna o maior de um determinado conjunto de nmeros.

Square root (Sqrt) - Raiz quadrada

Retorna a raiz quadrada de um nmero.

Absolete - Absoluto
Retorna o valor absoluto do nmero fornecido.

Neg - negar

Devolve o negativo do nmero fornecido.

Round - Arredondar

Arredonda o nmero fornecido para o nmero inteiro mais prximo e retorna o


resultado. Se o nmero est a meio caminho entre dois nmeros inteiros,
arredondado para o nmero inteiro mesmo.

Ceiling - teto

Retorna o menor nmero inteiro que maior do que ou igual ao nmero dado.

Floor - Andar

Calcula o maior inteiro que menor ou igual ao nmero dado.

Modulo - Modulo

Modulo (a, b) o mesmo que o resto (a, b) quando a e b so positivos. Mais


geralmente, mdulo (a, b) definido por qualquer um e b, de modo que (Floor
(a / b) x b) + mdulo (a, b) = a. Por exemplo, mdulo (11, 5) = 1, mdulo (-11,
5) = 4, mdulo (11, -5) = -4, mdulo (-11, -5) = -1. Modulo (a, b) sempre tem o
mesmo sinal que b, enquanto a parte restante (a, b) sempre tem o mesmo sinal
que a.

Sin - Seno

Retorna o seno do nmero fornecido em graus.

Cos - Cosseno

Retorna o cosseno do nmero fornecido em graus.

Tan - Tangente

Retorna a tangente do nmero fornecido em graus.

atan2 Arco duplo

Retorna o arco tangente de y / x, y dado e x.

Convetrs to degrees radian - Converter radianos em graus

Retorna o valor de grau no intervalo (0, 360) correspondente ao seu argumento


radianos.

Format as decimal - Como formato decimal

Formatar um nmero como um nmero decimal com um determinado nmero


de casas aps o ponto decimal. O nmero de lugares deve ser um nmero
inteiro no negativo. O resultado produzido por arredondamento do nmero
(se houvesse muitos lugares) ou pela adio de zeros direita (se no eram
muito poucos).

Is a number? - um nmero?

Retorna verdadeiro se o objeto fornecido um nmero, e false de outra forma.

Convert number base 10 to hex - Converte um nmero base 10 para


hexadecimal

Leva um inteiro positivo na base 10 e retorna a sequncia de caracteres que


representa o nmero em hexadecimal.
Text Texto

Contm uma sequncia de texto.

Join - Junte-se

Acrescenta o segundo dada sequncia de caracteres para o primeiro. Para


esta operao, e todas as operaes de texto, os nmeros podem ser tratados
como texto. Por exemplo, usando um bloco de juno para juntar 1 mais 1 e 2
vezes resulta em 3 26 (2 juntou-se com 6).

Length - comprimento

Retorna o comprimento da string dada.

Is empty - Est vazio

Retorna true se o comprimento do texto 0, caso contrrio false.

Compare texts Comparar textos

o <

Informa se o primeiro argumento sequncia de texto alfabeticamente menor


que a segunda cadeia de texto. Se duas cordas comeam com os mesmos
caracteres, a cadeia mais curta considerada menor. Caracteres maisculos
precedem os minsculos.
o text =

Informa se as sequncias de texto so idnticas, ou seja, tm os mesmos


caracteres na mesma ordem.

o text>

Informa se o primeiro argumento sequncia de texto alfabeticamente maior


que o segundo texto. Se duas cordas comeam com os mesmos caracteres, a
cadeia mais curta considerada menor. Caracteres maisculos precedem os
minsculos.

Trim - Aparar

Retorna uma cpia do seu texto com todos os espaos esquerda ou direita
removidos.

Upcase Maisculas
Retorna uma cpia do seu argumento sequncia de texto convertidos em
maisculas.

Start at - Comea s

Retorna a posio do caractere onde o primeiro caractere da pea aparece


pela primeira vez no texto, ou 0 se no estiver presente. Por exemplo, a
localizao de ana em havana banana 4.

Contains - Contm

Retorna true se pea aparece no texto, caso contrrio, retorna false.

Split Dividido

o Split at first - dividir em primeiro

Divide o texto dado em duas partes usando o local da primeira ocorrncia de


pelo como o ponto de diviso, e retorna uma lista de dois itens que consiste na
pea antes de o ponto de diviso e a pea aps o ponto de diviso. Splitting
ma, banana, cereja, comida de cachorro com uma vrgula como o ponto de
diviso retorna uma lista de dois itens: a primeira a ma de texto ea
segunda a banana texto, cereja, comida de cachorro. Note que a vrgula aps
a ma no aparecer no resultado, porque esse o ponto de diviso.

o Split at first of any - dividir a primeira de qualquer

Divide o texto dado em uma lista de dois itens, usando o local de qualquer item
na lista como o ponto de diviso.

o Split - Dividido

Divide texto em pedaos utilizando pelo que os pontos de diviso e produz uma
lista dos resultados. Dividindo um, dois, trs, quatro em, (vrgula) retorna a lista
(um, dois, trs, quatro). Dividindo uma batata, batata-dois, trs batatas, quatro
no -batata, retorna a lista (um, dois, trs, quatro).

o split at any - dividir a qualquer

Divide o texto dado em uma lista, usando qualquer um dos itens em que o
ponto de diviso, e retorna uma lista de resultados. Maa diviso, banana,
cereja, dogfood com pelo como a lista de dois elementos cujo primeiro item
uma vrgula, e cujo segundo item rry retorna uma lista de quatro itens: (ma
ser de banana che dogfood).
split at spaces - dividida em espaos

Divide o texto dado em qualquer ocorrncia de um espao, produzindo uma


lista de peas.

Segment - Segmento

Extrai parte do texto comeando na posio incio e continuando por caracteres


de comprimento.

Replace all - Substitua tudo

Retorna uma nova sequncia de texto obtida pela substituio de todas as


ocorrncias da substring com a substituio.

Obfuscated text - Texto ofuscado

Produz texto, como um bloco de texto. A diferena que o texto no


facilmente detectvel que incluem informaes confidenciais, por exemplo,
chaves de API. Aviso: Este prev apenas vmuito baixo segurana contra
adversrios experientes.

Lists Listas

Create a empty list - Criar uma lista vazia

Criar uma lista com todos os nmeros de itens.

Make a list - Faa uma lista

Cria uma lista dos blocos de dados. Se voc no fornecer quaisquer


argumentos, isso cria uma lista vazia, que voc pode adicionar elementos
tarde.

Add items to list - Adicionar itens para a lista

Adiciona os itens dado ao final da lista. A diferena entre este e anexar a lista
que acrescentar lista leva os itens a serem acrescentados como uma nica
lista, enquanto adicionar itens lista tem os itens como argumentos individuais.

Is in list? - Est na lista?

Se coisa um dos elementos da lista, retorna true; caso contrrio, retorna


falso. Observe que, se uma lista contm sublists, os membros das sublists no
so eles prprios membros da lista. Por exemplo, os membros da lista (1 2 (3
4)) so 1, 2, e a lista (3 e 4); 3 e 4 no so eles prprios membros da lista.

Length of list - Comprimento da lista

Retorna o nmero de itens na lista.

Pick random item - Pegar item aleatrio

Escolhas um item de forma aleatria a partir da lista.

Index in list thing - ndice coisa em lista

Encontre a posio de coisa na lista. Se no estiver na lista, retornar 0.

Select list item - Selecione o item lista

Seleciona o item no ndice indicado na lista dada. O primeiro item da lista no


ndice 1.

Insert list item - Inserir item da lista

Insere um item em uma lista na posio especificada.

Replace list item - Substituir item da lista

Insere substituio na lista dada na posio de ndice. O produto anterior em


que a posio removida.

Remove list item - Remover item da lista

Remove o item na posio especificada na lista.

Append to list - Acrescentar lista

Adiciona os itens da segunda lista, para o fim da primeira lista.

Copy list - Cpia da lista

Faz uma cpia de uma lista, incluindo a cpia de todos os sub-listas.

Is a list? - uma lista?

Se coisa uma lista, retorna true; caso contrrio, retorna falso.


List to csv row list - Lista de linha csv lista

Interpreta a lista como uma linha de uma tabela e retorna um arquivo CSV
(valores separados por vrgula) texto que representa a linha. Cada item na lista
de linha considerado como um campo, e citado com aspas no texto CSV
resultante. Os itens so separados por vrgulas. O texto linha retornada no
tem um separador de linha no final.

List to csv table list - Lista mesa csv lista

Interpreta a lista como uma tabela em formato de linha principal e retorna um


arquivo CSV (valores separados por vrgula) texto que representa a mesa.
Cada item da lista em si deve ser uma lista representando uma linha da tabela
de CSV. Cada item na lista de linha considerado como um campo, e citado
com aspas no texto CSV resultante. No texto retornado, artigos em linhas so
separados por vrgulas e linhas so separados por CRLF (\ r \ n).

List from csv row text - Lista de linha csv text

Analisa um texto como um arquivo CSV (valores separados por vrgula) linha
formatada para produzir uma lista de campos. um erro para o texto da linha
para conter nova linha unescaped campos dentro (de forma eficaz, vrias
linhas). No h problema para o texto linha para terminar em uma nova linha
nica ou CRLF.

List from csv table text - Lista da tabela csv text

Analisa um texto como um arquivo CSV (valores separados por vrgula)


formatado tabela para produzir uma lista de linhas, cada uma das quais uma
lista de campos. As linhas podem ser separadas por novas linhas (\ n) ou CRLF
(\ r \ n).

Lookup in pairs - Pesquisa em pares

Espera-se uma determinada chave em uma lista de (chave, valor) pares e


retorna o valor associado. Retorna um padro especificado se no
emparelhar com essa chave. Cada par muito ser uma lista de exatamente dois
itens.

Variables Variveis

Initialize global name to - Inicializar nome global para

Este bloco usado para criar variveis globais. Leva em qualquer tipo de valor
como um argumento. Ao clicar no nome vai mudar o nome dessa varivel
global. As variveis globais so utilizadas em todos os procedimentos ou
eventos de modo que este bloco vai ficar sozinho.
As variveis globais podem ser alteradas enquanto um aplicativo est sendo
executado e pode ser referido e mudou a partir de qualquer parte do aplicativo,
mesmo dentro dos procedimentos e manipuladores de eventos. Voc pode
renomear este bloco em qualquer momento e quaisquer blocos associados
referentes ao nome antigo ser atualizado automaticamente.

Get - Obter

Este bloco fornece uma maneira de obter quaisquer variveis que voc possa
ter criado.

Set to - Definido como

Este bloco segue as mesmas regras que get. Apenas variveis no escopo
estaro disponveis na lista suspensa. Uma vez que uma varivel v
selecionada, o usurio pode anexar um novo bloco e dar novo valor a v.

Initialize Local name to - in (do) - Nome local para inicializar - em (fazer)

Este bloco um modificador que permite que voc crie novas variveis que so
usadas apenas no processo de executar na parte DO do bloco. Desta forma,
todas as variveis do presente procedimento iram iniciar todos com o mesmo
valor cada vez que o procedimento executado. NOTA: Este bloco difere do
bloco descrito abaixo porque um bloco de DO. Voc pode anexar
declaraes a ele. Demonstraes fazer as coisas. por isso que este bloco
tem espao dentro de blocos de instruo para ser anexado.
Voc pode renomear as variveis de participao neste bloco, em qualquer
momento e qualquer dos blocos correspondentes em outros lugares em seu
programa que se referem ao nome antigo ser atualizado automaticamente.

Initialize Local name to - in (return) - Nome local para inicializar - in


(regresso)

Este bloco um modificador que permite que voc crie novas variveis que so
usadas apenas no processo de executar na parte de retorno do bloco. Desta
forma, todas as variveis do presente procedimento iram iniciar todos com o
mesmo valor cada vez que o procedimento executado. NOTA: Este bloco
difere do bloco descrito acima, porque um bloco de retorno. Voc pode
anexar expresses a ele. Expresses retornar um valor. por isso que este
bloco tem uma tomada para ligar expresses.
Voc pode renomear as variveis de participao neste bloco, em qualquer
momento e qualquer dos blocos correspondentes em outros lugares em seu
programa que se referem ao nome antigo ser atualizado automaticamente.
Procedures Procedimentos

O que um procedimento?
Um procedimento um conjunto de instrues que executam uma tarefa ou
tarefas especficas. Ele tambm pode ser chamado de uma funo. A receita
para o po de banana um exemplo de um procedimento. O padeiro deve
seguir as instrues passo-a-passo para produzir o po.
Ns usamos procedimentos na App Inventor para criar novos blocos que
podemos usar repetidamente e ocupam menos espao do que todos os blocos
utilizados no processo inicial. Se estamos usando os mesmos conjuntos de
blocos mais de uma vez, estes blocos so chamados redundante.

O que um procedimento em App Inventor?


Um procedimento App Inventor recolhe uma sequncia de blocos em conjunto
num grupo. Voc pode ento usar a seqncia de blocos repetidamente
chamando o procedimento. Se o procedimento tem argumentos, voc
especificar os argumentos usando blocos do nome. Quando voc cria um
procedimento, o App Inventor gera automaticamente um bloqueio de chamada
e coloca-lo na gaveta minhas definies. Voc usa o bloqueio de chamadas
para chamar o procedimento.
Quando voc cria um novo bloco de procedimento, o App Inventor escolhe um
nome exclusivo automaticamente. Voc pode clicar sobre o nome e tipo de
mud-lo. Nomes de procedimentos em um aplicativo devem ser exclusivos.
App Inventor no vai deixar voc definir dois procedimentos no mesmo
aplicativo com o mesmo nome. Voc pode renomear um procedimento a
qualquer momento, enquanto voc est construindo o aplicativo, alterando a
etiqueta no bloco. App Inventor ir renomear automaticamente os blocos de
chamada associados ao jogo.

Vamos construir um procedimento para fazer o trabalho dos blocos de cdigos


redundantes. Na App Inventor, voc define um procedimento de uma forma
semelhante a como voc definir variveis. Da gaveta Procedimentos, arrastar
para fora ou um procedimento que bloquear ou ao procedimento de bloqueio
de retorno. Utilize este ltimo se o procedimento deve calcular algum valor e
devolv-lo. Depois de arrastar um bloco procedimento, voc pode mudar o seu
nome do "procedimento" padro clicando a palavra "processo" e digitar o novo
nome.

No tutorial MoleMash, voc cria um procedimento chamado MoveMole para


mover a toupeira para um local aleatrio na tela.
Depois de criar um procedimento, um bloco colocado na gaveta
Procedimentos embutido que permite que voc ligue para o seu procedimento.
Detalhes adicionais sobre blocos de procedimento do App Inventor podem ser
encontradas na pgina Procedimento Blocks.

O que um argumento?
Um argumento uma entrada para o nosso procedimento. Alguns
procedimentos exigem saber alguns pedaos de informaes que mudam a
forma como o processo executado. Vejamos o exemplo de banana po
receita. s vezes, o padeiro pode querer fazer dois pes de banana. Em
seguida, o padeiro seria o dobro da quantidade de cada ingrediente chamado
para na receita. Este casal ou 2 um argumento para o nosso procedimento
uma vez que este muda a quantidade de nossos ingredientes que se misturam.
Quando voc cria um procedimento, voc pode usar o boto modificador para
adicionar argumentos.

Ao passar o mouse sobre um argumento, voc vai ver um get e set bloco
aparecer. Arraste esses blocos em sua tela para us-los.
Este procedimento leva dois argumentos: x e y. Em seguida, ele retorna o
resultado da adio de x para y.