Você está na página 1de 285

Visual Kit 5

Edio Standard/Professional

Verso 6.0.4.2






Guia do Usurio





















TODOS OS DIREITOS RESERVADOS - EBENDINGER LTDA.
Visual Kit 5 Verso 6.0.4.2
2
Contedo

Sobre este Manual ...............................................................................5
cones utilizados....................................................................................................................... 5
I. Introduo......................................................................................6
Um pouco de histria............................................................................................................... 6
Edies do Visual Kit5 ............................................................................................................ 7
Requisitos Tcnicos do Visual Kit 5........................................................................................ 7
Instalando o Visual Kit 5 no Windows..................................................................................... 8
Razes para no ter conseguido fazer a instalao. ............................................................... 12
Voc consegue instalar mas no roda. ................................................................................... 13
II. Conceitos Bsicos.....................................................................16
Sistemas, mdulos e entidades............................................................................................... 16
Campos .................................................................................................................................. 19
Registros ................................................................................................................................ 20
Tabelas ................................................................................................................................... 21
Relacionamento...................................................................................................................... 21
ndices e campos chave.......................................................................................................... 23
Operaes............................................................................................................................... 24
III. O Ambiente de Desenvolvimento.............................................25
Acessando o Visual Kit 5....................................................................................................... 25
Elementos do Ambiente......................................................................................................... 26
IV. Criando seu Primeiro Sistema Passo a Passo............................35
A proposta.............................................................................................................................. 35
Desenhando o sistema............................................................................................................ 35
Acessando o sistema gerado .................................................................................................. 48
Testando o sistema................................................................................................................. 49
Modificando o sistema........................................................................................................... 54
V. Desenhando o Formulrio.........................................................55
As ferramentas de desenho Designer-Bsica e Designer-Pro............................................... 55
Manipulando controles........................................................................................................... 56
VI. A Designer-Bsica....................................................................67
Principais controles................................................................................................................ 67
Incluindo funcionalidades nos controles................................................................................ 82
Acessando dados pelo vetor Vdados...................................................................................... 83
reas de relacionamento - acessando contedos de outras entidades. .................................. 86
Funes de validaes (pr e ps) ......................................................................................... 87
Criando validaes compostas............................................................................................... 97
VII. A Designer-Pro: Novos Recursos .........................................99
Principais controles da Designer-Pro.................................................................................... 99
Criando novas funcionalidades usando os eventos. ............................................................. 118
O Editor de Expresses........................................................................................................ 121
O Editor de Macros. ............................................................................................................. 125
Visual Kit 5 Verso 6.0.4.2
3
O Editor de Cdigos............................................................................................................. 135
VIII. Gerao de cdigos fontes dos formulrios.........................137
Gerando cdigos em Visual Basic ....................................................................................... 137
Gerando cdigos em Fox Pro............................................................................................... 139
IX. Personalizando apertura, o about e o manual.......................142
Imagem de apertura.............................................................................................................. 142
O logo do About ................................................................................................................... 143
O manual do sistema gerado................................................................................................ 143
X. Criando um Sistema Completo pela Designer-Bsica............144
A Proposta............................................................................................................................ 144
Analisando o Sistema........................................................................................................... 144
Passos na Criao do Sistema.............................................................................................. 162
XI. Criando Sistemas Utilizando os Sistemas Brinde...................167
Gerando o sistema brinde..................................................................................................... 167
Alterando o sistema brinde .................................................................................................. 169
XII. Aproveitando dados .............................................................171
Acessando uma tabela .DBF existente................................................................................ 171
Acessando uma tabela .MDB existente ............................................................................... 175
Importando dados de uma Planilha Excel (*.xls) ................................................................ 178
XIII. Instalando o Sistema Gerado em outro computador ............180
Instalando num nico computador....................................................................................... 180
Instalando um Sistema Multiusurio ................................................................................... 182
XIV. Voltando ao Ambiente de Desenvolvimento .......................186
Renomeia e Copia Entidades ............................................................................................... 186
XV. Criando Funes pelo FoxPro..............................................189
Criando funes especficas................................................................................................. 189
Criando funes de validao de campos ............................................................................ 196
XVI. Criando um Sistema no MS SQL Server 2000. ...................197
O SQL Server....................................................................................................................... 197
SQL Server- Visual Kit 5..................................................................................................... 197
Rodando pelo navegador de internet.................................................................................... 202
XVII. Funcionalidades bsicas dos Sistema Gerados .................206
Localizar entidades e campos do sistema ............................................................................ 206
Criando usurios (login e senha) para o sistema ................................................................. 207
Incluso, alterao e excluso de registros .......................................................................... 210
Consultas.............................................................................................................................. 212
Relatrios rpidos, etiquetas e transferncia........................................................................ 214
Senhas dentro da entidade.................................................................................................... 220
Indexao............................................................................................................................. 221
Outras opes teis .............................................................................................................. 222
XVIII. Consultas, Relatrios e Etiquetas Avanadas ...................228
Origem dos Dados : preparando os dados............................................................................ 228
Criando e personalizando Relatrios Report Designer..................................................... 235
Visual Kit 5 Verso 6.0.4.2
4
Criando e personalizando Etiquetas Label Designer........................................................ 241
Criando Cdigos de Barras .................................................................................................. 245
XIX. OLAP e Data Mining...........................................................254
OLAP- Processamento Analtico Online............................................................................. 254
Data Mining Inteligncia Artificial .................................................................................. 259
XX. Apndices ............................................................................266
A. Convertendo sistemas da verso 4.6 para a verso 6.0 do Visual Kit 5 ...................... 266
B. Atualizando o Visual Kit 5 e sistemas gerados............................................................ 267
C. Denominao das Tabelas, Mdulos, Entidades no Visual Kit 5................................ 269
D. Propriedade Formatos e Mscara de Edio................................................................ 270
E. Operadores ................................................................................................................... 273
F. Regras de nomenclaturas Ebendinger.......................................................................... 275


Visual Kit 5 Verso 6.0.4.2
5
Sobre este Manual

Este manual foi desenvolvido para os usurios do Visual Kit 5 Standard/Professional
verso 6.0. um guia tanto para pessoas sem conhecimentos profundos em programao e
anlise de sistemas como tambm para profissionais com experincia em desenvolvimento de
sistemas comerciais que desejem aumentar sua produtividade utilizando esta ferramenta.

Voc no precisa de experincia em programao para ler este manual de forma proveitosa e
aprender com ele. Todos os recursos disponveis so apresentados de forma clara, objetiva e
didtica sendo exemplificado para melhor compreenso do assunto.

O contexto tcnico deste manual abrange todos os recursos bsicos e intermedirios
disponveis na ferramenta de desenvolvimento do Visual Kit 5.

cones utilizados

Os cones so figuras para chamar sua ateno. Veja aqui o que os cones utilizados neste livro
significam.

Ateno! Mos ao alto! Trata-se de uma informao que voc deve tentar se lembrar.
s vezes porque uma informao til; outras vezes, porque voc pode ter problemas caso a
esquea.

Nota: Avisa o leitor que se trata de uma abordagem tcnica que pode ser pulada, caso
no seja de seu interesse.

Dica: Atalhos e dicas que podem poupar-lhe tempo e aborrecimentos.



Ateno! A primeira observao!
O Visual Kit 5 um programa que constantemente insere novos recursos com o objetivo de
satisfazer os usurios. Por isso, pode existir algum recurso que voc j tenha dentro do Visual
Kit 5 e no esteja descrito aqui ou a contrrio.


Visual Kit 5 Verso 6.0.4.2
6
I. Introduo

Bem-vindo a este maravilhoso mundo de desenvolvimento de sistemas usando o
Gerador de Sistemas Visual Kit 5!. Voc est fazendo parte de uma grande e crescente
comunidade de desenvolvedores que usam o Visual Kit 5 para criar os mais diversos sistemas.

O Visual Kit 5 oferece variados recursos que fazem dele um ambiente poderoso de
desenvolvimento de sistemas dos ltimos tempos.

Um pouco de histria

O Visual Kit 5 um produto da Ebendinger Systems Informtica Ltda., empresa de informtica
fundada em 1989, que enfocou desde seu inicio o usurio no especializado em programao
a maioria no planeta-, e tratou seus sistemas como produtos, dando-lhes garantia de
funcionamento e manuteno.

Em 1993, a Ebendinger lanou a primeira verso do produto o The Ebendinger Development
Kit Kit5 for DOS. E em curtssimo espao de tempo tornou-se lder no mercado de
Geradores de Sistemas. Em 1994, colocou no mercado a primeira verso de gerador de
sistemas para Windows e Macintosh: o Visual Kit5, que a cada ano foi enriquecido em
sucessivas verses. Formando parte deste processo, em 1997 abre uma filial nos EUA, com a
finalidade de se expandir no mercado mundial.

Em 2001 lanou a verso 6.0, com uma nova cara, compatvel com os novos sistemas
operacionais grficos com estrutura tree-view (em rvore). Tambm evoluiu para solues que
envolvem a gerao de sistemas para ambiente via internet e com recursos de OLAP e Data
Mining, em sintonia com as ltimas tendncias do mundo da informtica. No 2002 o Visual
Kit 5 alcanou um novo patamar, desdobrando-se em trs verses: Standard, Professional e
Enterprise orientadas para usurios no especializados, programadores e ambientes
empresariais respectivamente.

A empresa formada por duas divises: A Diviso Industrial - para o desenvolvimento e
comercializao de softwares e ferramentas que ajudam no desenvolvimento de aplicativos e
sistemas, e a Diviso de Consultoria para Sistemas Coorporativos, Business Intelligence, e
Portais Web. Por ltimo, existe uma outra rea referida a edio de livros: a Ebendinger
Editora.





Visual Kit 5 Verso 6.0.4.2
7
Edies do Visual Kit5

Voc poder adquirir o Visual Kit 5 em trs diferentes edies segundo suas necessidades e
conhecimentos.

Edio Standard

O Visual Kit 5 Standard uma excelente ferramenta de desenvolvimento de sistemas que no
exige do usurio profundos conhecimentos de informtica, programao ou anlise de dados.
Usando o Visual Kit 5, qualquer pessoa pode programar o sistema de seu interesse.

Os sistemas desenvolvidos so totalmente independentes e voc poder instal-lo em outros
computadores e comercializ-lo sem restrio nenhuma. Eles no precisaro do Visual Kit 5
para rodar.

Edio Professional

O Visual Kit 5 Professional possui todos os recursos da verso Standard e ainda a
possibilidade de gerar cdigo fonte dos formulrios em vrias nas linguagens de programao
Fox Pro e Visual Basic.

Edio Enterprise

O Visual Kit 5 Enterprise formado por 4 (quatro) ferramentas que o converte em um
poderoso sistema de desenvolvimento permitindo aumentar a produtividade e a qualidade dos
sistemas gerados por ele. Estas ferramentas so:

- Gerador automtico de Sistemas;
- Gerador de formulrios SCX e FRM;
- Gerador de formulrios avanados;
- Gerador de Sistemas Visual Kit 5 .

Acesse o site da Ebendinger (www.ebendinger.com.br) para obter maiores informaes sobre
as edies do Visual Kit 5.

Requisitos Tcnicos do Visual Kit 5

Computador/Processador IBM PC ou 100% compatvel.
Memria Quantidade recomendada para o Windows, que voc estiver
utilizando.
Sistema Operacional Windows 98 SE ou mais recente, com Internet Explorer 5.5 e
Service Pack 2 ou mais recente Windows NT 4.5 com Service Pack 6
ou mais recente. Windows 2000 com Service Pack 2 ou mais
recente.
Visual Kit 5 Verso 6.0.4.2
8
Voc no pode utilizar o Visual Kit 5 verso 6.0 em outras
configuraes de Windows.
As operaes de OLAP e Data Mining esto disponveis somente
para o Windows 2000 com Service Pack 2, e SQL Server 2000 com
Service Pack 1, ou superior.
No execute estas rotinas em outra configurao de Windows.
Disco Rgido Ocupa aproximadamente 120 MB.
Unidade Unidade de CD-ROM Obrigatria.
O Visual Kit 5 dever ser executado preferencialmente com 1024 x 768 pontos
de resoluo, configurados para o seu Monitor.
No usar esta resoluo de monitor, poder impedir a visualizao correta de
todas as janelas do Visual Kit 5.

Instalando o Visual Kit 5 no Windows

Instalar o Visual Kit 5 muito simples, basta seguir as instrues do programa instalador. O
Visual Kit 5 no atualiza os sistemas criados com um Visual Kit 5 de verso anterior. Os
sistemas brinde no so instalados pelo Visual Kit 5.

Voc tem espao livre suficiente? Certifique-se de que possui espao em disco suficiente para
a instalao. Ela requer cerca de 120MB de espao livre no seu disco rgido, no esquea que
aps a instalao, voc precisar de espao para salvar os sistemas que criar. Portanto, a
primeira coisa que precisa saber se possui 120MB ou mais de espao livre na unidade de
disco rgido. Se no tiver, elimine alguns arquivos que no v utilizar mais ou adquira uma
nova unidade de disco rgido.


Ateno: O programa Setup.exe ou WebApp.exe no instala o Visual Kit 5 em
computadores com menos de 32 MB de RAM ou com problemas no gerenciador de memria
do Windows, ou na cache do seu micro. Nestes casos, antes de instalar aumente a quantidade
de memria RAM do seu micro e/ou solucione os problemas, que existirem com o gerenciador
de memria ou memria cache. Micros com problemas fsicos na memria RAM ou memria
cache no podero executar o Visual Kit 5 corretamente



A continuao, descrevemos a instalao do Visual Kit 5 nos sistemas operacionais Windows
98 SE, NT, 2000 ou XP:

- Insira o CD-ROM na unidade de CD-ROM
Se o programa de instalao no for executado pelo autorun do Windows, execute os passos
abaixo:

Visual Kit 5 Verso 6.0.4.2
9
- Clique o boto Iniciar (Start).
- Selecione a opo Executar... (Run...)
- Digite d:\setup.exe tecle ENTER Se a unidade de CD-ROM est instalada no E:>
substitua a letra d: por e:
- Siga as instrues do programa instalador. Observe as seguintes perguntas.


Fig 1 Clique no boto Continue, para continuar a instalao.


Fig 2 Cadastre o seu nome e o nome de sua empresa, nos campos acima indicados.


Fig 3 Para confirmar o seu nome e o nome de sua empresa, pressione o boto Ok.
Visual Kit 5 Verso 6.0.4.2
10

Fig 4 Preparando instalao


Fig 5 No altere o diretrio do Visual Kit 5. Pressione o boto Ok, para continuar a instalao.


Fig 6 Clique no boto (computador) acima indicado, para continuar a instalao.

Visual Kit 5 Verso 6.0.4.2
11

Fig 7 Aguarde enquanto o instalador copia os arquivos para o seu computador.


Fig 8 Pressione o boto Ok, para concluir a instalao.


Fig 9 Executar o Visual Kit 5, selecione:
"Iniciar...","Programas","Ebendinger Visual Kit 5", e clique na opo "Ebendinger Visual Kit 5 6.0

Visual Kit 5 Verso 6.0.4.2
12

Fig 10 Inserindo nmero de serie.
Depois de instalado, ao abrir por primeira vez o Visual Kit 5, aparecer uma janela para inserir
o nmero de serie do produto. Este nmero de serie se encontra numa etiqueta colada na caixa
do CD. Digite com cuidado este nmero e clique no boto OK.

Se aparece a mensagem Execute o Visual Kit 5 novamente! significa que o nmero foi
aceito. A instalao foi totalmente concluida!. Caso contrario o numero foi digitado de maneira
errada, por favor tente novamente.


Razes para no ter conseguido fazer a
instalao.

Se voc est com dificuldades para instalar o Visual Kit 5, provvel que uma dessas razes
seja a causa de seu problema.

Espao em Disco Insuficiente:
Veja bem se possui espao livre suficiente para a instalao. Observe que, se estiver instalado
em uma unidade comprimida (como as criadas pelo Stacker, DriveSpace ou DoubleSpace), as
quantidades estimadas de espao em disco livre podero estar sem o desconto da compresso.

Voc no consegue acessar o CD:
Visual Kit 5 Verso 6.0.4.2
13
Normalmente os erros de acesso do CD durante a instalao significam que voc precisa
encontrar um driver de CD atualizado. Veja se est usando a ultima verso de seu driver CD.

Seu CD apresenta problemas:
Isso raramente acontece. O sintoma que o programa de instalao avisa que no consegue
encontrar um determinado arquivo. Entre em contato com o servio ao consumidor da
Ebendinger.

O programa de instalao se comporta estranhamente ou no roda:
Normalmente isso resultado de algum tipo de conflito entre o programa de instalao e outro
programa. Feche os programas inicializados automaticamente pelo Windows, como protetores
de tela, programas de agendas, programas de diretrios StartUp, etc. Sai e reinicie o Windows;
em seguida tente usar o programa de instalao novamente.

Equipamento defeituoso:
Se o seu equipamento possuir algum problema na memria RAM, cache, disco rgido, ou na
memria virtual do Windows, a instalao do Visual Kit 5 poder no se concluir com sucesso.

Voc consegue instalar mas no roda.

Em alguns casos, a instalao concluda com sucesso, mas Visual Kit 5 ou sistemas gerados
apresentam problemas na execuo.

- Defeitos fsicos no computador ou de configurao;
- Est sendo usada uma verso mais antiga do Visual Kit 5 em vez da nova. Leia nesta
seo como fazer a atualizao;
- Memria insuficiente na sua mquina ou voc est rodando muitos aplicativos ao
mesmo tempo.


Ateno: Se o problema apresentado se deve a defeitos fsicos no seu equipamento contate
um tcnico de hardware. A Ebendinger no oferece suporte a defeitos de hardware. O suporte
exclusivo ao Visual Kit 5.


Lembre-se:

1) No Windows 98 voc no poder executar as operaes OLAP, nem o Data Mining.
2) No Windows 2000 ou superior, voc poder executar o OLAP e o Data Mining,
somente se o programa PTSFULL.EXE for instalado. O programa ptsfull.exe pode ser
encontrado no CD-ROM de instalao do Visual Kit 5, diretrio \ADO.
3) Para visualizar corretamente todos os elementos que compe as janelas do Visual Kit 5
e sistemas gerados, configure o seu monitor para 1024 x 768 pontos de resoluo.
Visual Kit 5 Verso 6.0.4.2
14
4) Se voc alterar o diretrio de instalao do Visual Kit 5, ao tentar execut-lo, a
mensagem abaixo ser exibida:


Fig 11 Mensagem, exibida caso modifique o diretrio.
Para resolver este problema, execute o ajuste apresentado abaixo:

Fig 12 Arquivo Config.fpw aberto pelo Notepad.

Visual Kit 5 Verso 6.0.4.2
15
Abra o arquivo CONFIG.FPW, que se encontra no diretrio do Visual Kit 5, com o
NOTEPAD do Windows, e altere os parmetros como apresentado acima.

Este erro ocorrer sempre que voc copiar um sistema gerado pelo Visual Kit 5, de um
diretrio para outro, e no ajustar o arquivo CONFIG.FPW, informando o novo diretrio do
sistema gerado.

5) Se o sistema exibir qualquer mensagem, informando que um arquivo OCX no foi
instalado, significa que voc est utilizando uma configurao do Windows no
apropriada. Veja em Requisitos Tcnicos do Visual Kit 5.





Visual Kit 5 Verso 6.0.4.2
16
II. Conceitos Bsicos

Neste captulo abordaremos vrias definies e conceitos que ajudaro a compreender
o processo de desenvolvimento de sistemas ...

Sistemas, mdulos e entidades.

H muito, muito tempo atrs, antes do surgimento dos computadores e das bases de dados, os
dados eram armazenados em verdadeiros arquivos de ao. Realmente, no faz tanto tempo
assim, no mximo duas dcadas, mas nesse nterim assistimos a enormes mudanas
tecnolgicas na rea de hardware e software. Apesar das mudanas, muitos dos conceitos
bsicos de gerenciamento de dados continuam vigentes. Por isso, para comear, vamos
referenciar vrios conceitos usados neste manual e no Visual Kit 5 fazendo uso da analogia
com aqueles antigos arquivos.

Em primeiro lugar, os arquivos do computador so iguais aos arquivos de ao no sentido da
persistncia - no se perdem quando o programa termina ou quando desligamos o
computador... claro, tudo na vida tem um preo - existe o perigo do disco pifar ou ser
infectado por um vrus, mas da mesma forma que o arquivo de ao est sujeito a perigos
iminentes, como fungos e bactrias.

Cadastro
Contas

Fig 13 Sistema com dois mdulos

Visual Kit 5 Verso 6.0.4.2
17
O nosso sistema como um todo pode ser representado por esse antigo fichrio que aparece na
Fig 13.

Cada gaveta deste fichrio contm informaes de cadastros e contas diferentes e
razoavelmente independentes. Claro, est diviso muito subjetiva e depende muito da viso,
da maneira de trabalhar e das regras do dono do fichrio. Nos sistemas informatizados acontece
algo similar: os sistemas so divididos em sub-sistemas denominados tambm como
mdulos que ajudam a uma melhor organizao e administrao, principalmente nos
sistemas de grande porte.

Fazendo analogia, no exemplo da Fig 14 teramos um sistema composto por dois mdulos:
mdulo Cadastro e mdulo Contas.


Contas
Cadastro
Fornecedores
Clientes

Fig 14Mdulo Cadastro com duas entidades

Vejamos agora dentro da primeira gaveta: a encontramos dois tipos de pastas - a pasta com as
fichas dos clientes e a pasta com as fichas dos fornecedores. Estas pastas contm informaes
similares mas ao mesmo tempo se diferenciam, cada uma podendo apresentar dados que a
outra no possui. Por exemplo, na pasta dos clientes pode aparecer o estado civil e na pasta dos
fornecedores o tipo de produto que ele fornece. Junto com as fichas, podem aparecer diversos
relatrios associando as informaes contidas nas pastas. Exemplo: quantos clientes casados
foram cadastrados no ltimo semestre?

Continuando com nossa analogia, estas pastas formam as entidades dos sistemas. Temos
ento no mdulo Cadastro duas entidades: Clientes e Fornecedores. Importante ressaltar que
os relatrios tambm podem ser considerados entidades separadas.

Visual Kit 5 Verso 6.0.4.2
18
Vasculhando o arquivo, abriremos a pasta Clientes. Aqui, encontraremos as fichas dos clientes
composta por centenas de formulrios que contm dezenas de campos preenchidos com
informao do tipo: nome completo, sexo, data de nascimento, endereo, etc. Cada formulrio
descreve um determinado cliente.



Fig 15 Formulrios da Entidade Clientes

O formulrio o elemento mais valioso ele quem realmente guarda as informaes. Tudo
feito para cuidar e salvaguardar os formulrios e por isso, inclusive, que o arquivo de ao.

No desenvolvimento de sistemas, o mesmo formulrio visto acima, concebido de duas formas
diferentes: visual e de armazenamento. No visual, o objetivo mostrar o formulrio na tela do
computador de uma maneira amigvel para o usurio do sistema e chamado igualmente de
formulrio. Do ponto de vista de armazenamento, o formulrio vira uma tabela onde cada
coluna da tabela representa um campo (entrada de dados) do formulrio e cada linha representa
um registro preenchido para um determinado cliente.

Visualmente, a entrada e exibio de dados no formulrio feita atravs de controles ou
objetos grficos. Estes objetos so de diferentes tipos e funcionalidades, como: Caixa de
Textos (TextBox), Lista de Textos (ListBox), Caixa de Seleo (ComboBox), Caixa de Edio
(EditBox), Grupo de Opes (OptionGroup), Caixa de Verificao (CheckBox); Controle de
Rotao (Spiner), etc. Mais detalhes sobre os controles so mostrados nos Captulo V, VI, VII
deste manual.

Visual Kit 5 Verso 6.0.4.2
19


Fig 16 Formulrios impressos, formulrios e tabelas.

A principal tarefa dos formulrios a distribuio adequada de informaes atravs dos
controles ou objetos. No Visual Kit 5 voc poder desenhar os formulrios de maneira fcil
que automaticamente sero convertidos em tabelas. Cada formulrio poder ser adequado para
exibir informaes, a fim de permitir a insero, alterao, excluso de dados e demais
operaes e funcionalidades de seu sistema. Estas operaes podero ser realizadas tambm no
formato de tabela.

Na continuao reafirmaremos vrios conceitos abordados e colocaremos outros novos mais
especficos aos sistemas.

Campos

O campo a unidade elementar dos dados. Numa tabela, como vimos acima, dividida em
colunas e linhas, as colunas seriam o anlogo do campo. Geralmente o nome do campo/coluna
representa o tipo de informao que ele vai hospedar, ex.: o campo Data_Nascimento guardar
a data de nascimento do cliente.


Visual Kit 5 Verso 6.0.4.2
20

Nome
Sobrenome
Sexo
Estado
Cidade
Bairro
CEP

Fig 17 Os campos: unidade elementar de dados

Idealmente os campos devem ser utilizados para guardar peas do dado. Por exemplo a
informao nome do usurio pode ser dividida nos campos PrimeiroNome e Sobrenome em
lugar de um nico campo NomeCompleto ou a informao endereo do usurio pode ser
dividida em vrios campos: Estado, Cidade, Bairro, CEP, Logradouro, Nmero,
Complemento.

A importncia de dividir a informao em unidades elementares de dados pode ser ilustrada
neste exemplo: Suponhamos que o desenvolvedor est desenhando um sistema para cadastrar
clientes, e decidiu colocar o nome do usurio num nico campo chamado NomeCompleto. Se
depois requerido de um relatrio com a lista dos clientes ordenada pelo sobrenome, no vai
ser uma tarefa to fcil determinar qual parte se refere ao nome e qual parte se refere ao
sobrenome. Se o nome do cliente fosse dividido em dois campos PrimeiroNome e Sobrenome
ficaria muito simples criar o relatrio ordenando unicamente pelo campo Sobrenome.


Registros

Os registros so formados por uma coleo de campos, que representam uma entidade lgica.
Numa tabela, as linhas seriam o anlogo dos registro, cada linha representa um registro. Por
exemplo, o registro com as informaes dos clientes contm os campos Nome, Sobrenome,
Sexo, Estado, Cidade, Bairro, CEP, Nmero, Complemento. Todos os campos que compem
os registros so armazenados juntos (de maneira lgica
1
) e representam a informao de um
nico cliente.


1
Fisicamente, no disco rgido do computador esta informao pode estar separada, mas isto totalmente
transparente para os usurios do sistema.
Visual Kit 5 Verso 6.0.4.2
21

Nome Sobrenome Sexo Estado Cidade Bairro CEP

Fig 18 Registro: coleo de campos.


Tabelas

O principal componente de uma base de dados a tabela. A tabela por sua vez uma coleo
de registros. Da mesma maneira que o nome do campo representa o tipo de dado que ele
guarda, o nome da tabela deve representar o tipo de informao que ela contm. Por exemplo a
tabela que guarda os endereos dos clientes poderia se chamar Clientes.

Na prtica, os sistemas guardam mais de uma tabela que representam diferentes informaes.
O ideal seria que cada tabela tivesse uma nica informao. Por exemplo se numa tabela
contm o nome do cliente, outra tabela do sistema no precisa ter tambm essa informao.
Existem muitas razes para que isso seja dessa forma, a mais bsica de todas que, se por
exemplo o nome do cliente muda, voc teria que mudar em vrias tabelas. Ento, j que todas
as tabelas guardam uma nica informao, como posso combin-las para prover uma
informao til? A resposta est no relacionamento entre as tabelas.

Relacionamento

O relacionamento usado para interligar (linkar) duas tabelas e produzir uma informao til.
Duas tabelas so relacionadas entre si atravs do uso de campos comuns nicos em cada
registro. Estes campos so geralmente referenciados como campos chaves.

Um desenvolvedor de sistema que no queira usar mltiplas tabelas relacionadas, teria que usar
uma nica tabela com toda a informao embutida nela. fcil de perceber que administrar um
sistema dessa maneira ficaria muito difcil, alm de tornar o sistema muito menos prtico em
sua utilizao. Usando mltiplas tabelas relacionadas para representar dados mais complexos
pode parecer complicado, mas sem dvida, a melhor maneira de administrar um sistema.


Um-para-Um

Visual Kit 5 Verso 6.0.4.2
22
Uma das formas de relacionar tabelas a chamada de relacionamento Um-para-Um (One-to-
One). Neste tipo de relacionamento um nico registro de uma tabela relacionado exatamente
a um nico registro de uma outra tabela apenas. Um exemplo de relacionamento Um-para-Um
o seguinte: Suponhamos que temos uma tabela Clientes que contem informaes do cliente
do tipo: nome, endereo, nmero de telefone, etc. E uma outra tabela que contenha informao
relacionada a conta pessoal do cliente com informaes de tipo: nmero da conta, renda, saldo,
etc. Cada registro de endereo dos clientes pode ser associado com seu respectivo registro de
conta pessoal. Utilizando este tipo de relacionamento podemos descompor grande colees de
informaes.


Nome Sobrenome Sexo Estado Cidade Bairro CPF1
Conta Saldo CPF1
Nome Sobrenome Sexo Estado Cidade Bairro CPF2
Nome Sobrenome Sexo Estado Cidade Bairro CPF3
Conta Saldo CPF2
Conta Saldo CPF3

Fig 19 Relacionamento um para um

Um-para-Muitos

Outra forma de relacionar tabelas chamada de relacionamento Um-para-Muitos (One-to-
Many). Neste tipo de relacionamento, um registro na tabela relacionado a mltiplos registros
de uma outra tabela. Um exemplo de relacionamento um-para-muitos poderia ser uma tabela
principal que contm informao do endereo do cliente e uma tabela secundria que contm
informao dos pedidos dos clientes. Neste tipo de relacionamento podem existir mais de um
pedido para um mesmo cliente que so relacionadas a um nico registro da tabela de endereo
de clientes. Desta forma voc pode manter e controlar qualquer quantidade de pedidos de
clientes sem perder jamais o endereo. Esta flexibilidade o principal benefcio dos
relacionamentos.
Visual Kit 5 Verso 6.0.4.2
23

Nome Sobrenome Sexo Estado Cidade Bairro CEP CPF1
Ordem 1 Produto 1 CPF1
Ordem 2 Produto 2 CPF1
Ordem 3 Produto 1 CPF1

Fig 20 Relacionamento um para muitos


ndices e campos chave

Em um sistema relacional, os ndices so usados para ajudar a formar os relacionamentos entre
as tabelas e para aumentar a velocidade de acesso aos dados. Um ndice baseado nos campos
chave das tabelas. Existem dois tipos de campos chave que uma tabela pode conter: chave
primria e chave secundria.

A chave primria o nico campo usado para controlar os registros na tabela. A chave
primria deve ser nica, ou seja, uma tabela somente pode conter uma chave primria. Em
nossa tabela de endereos de clientes a chave primria pode ser o campo CPF ou um outro
campo que contenha algum cdigo que identifique o cliente, no podendo haver dois clientes
com a mesma chave primria. As chaves primrias so compiladas dentro de um outro arquivo
chamado de ndice, o qual acelera o acesso aos dados da tabela. Se voc sabe o cdigo do
cliente, o ndice permitir a voc rapidamente acessar aquele registro na tabela de clientes. Isto
possvel porque o arquivo ndice registra cada campo chave e um ponteiro do registro na
tabela.

Campos chaves podem ser usados para formar relacionamentos de uma maneira diferente a
explicada acima. Chaves quando usadas simplesmente para juntar duas tabelas so chamadas
de chaves secundrias ou estrangeiras. Uma tabela pode conter mais de uma chave
Visual Kit 5 Verso 6.0.4.2
24
estrangeira ou simplesmente no ter nenhuma. As chaves estrangeiras so usadas para formar
relacionamento entre as tabelas e elas no precisam ser nicas nas tabelas onde radicam.


Operaes

chamado de operaes, a tudo que possaa ser feito com os dados armazenados nas tabelas
dos sistemas. Existem operaes bsicas como Incluso, Alterao e Excluso de registros sem
as quais seria impossvel o gerenciamento do sistema. Outras operaes tem funcionalidades
mais especficas como: Consultas, Gerao de Etiquetas, Gerao de Relatrios, etc.

O visual Kit 5 brinda uma srie de operaes que o usurio pode escolher para incluir em cada
entidade desenvolvida. Estas operaes so:

1- Incluso
2- Alterao
3- Excluso
4- Consulta
5- Relatrio
6- Etiquetas
7- Indexao
8- Senhas
9- Transferncias
10- OLAP
11- Data Mining
12- Consultas avanadas

A explicao das funcionalidades de cada operao do Visual Kit 5 pode ser encontrada no
Captulo XVII


Visual Kit 5 Verso 6.0.4.2
25
III. O Ambiente de
Desenvolvimento

O Visual Kit 5 possui um Ambiente de Desenvolvimento especializado para desenhar
sistemas empresariais, pessoais, etc., por meio do qual voc poder criar os mdulos , as
entidades, as telas dos formulrios, relacionamentos entre campos, tabelas, etc. de uma forma
rpida e simples sem necessidade de programar, nem ter conhecimentos profundos em
informtica.

Basicamente o ambiente de desenvolvimento permite realizar as seguintes operaes:

- Gerar os arquivos executveis e complementares do sistema.
- Desenhar a interface amigvel do usurio atravs dos formulrios.
- Associar funcionalidades especficas aos controles dos formulrios.
- Modificar sistemas da biblioteca de sistemas (sistemas brinde).

Neste captulo, daremos um passeio pelo Ambiente de Desenvolvimento do Visual Kit 5,
apresentando todas as reas e suas respectivas tarefas. Nos demais captulos voc ter a
oportunidade de praticar e utilizar a maioria das possibilidades que o Visual Kit 5 oferece.

Acessando o Visual Kit 5

Para acessar o Ambiente de Desenvolvimento do Visual Kit 5 execute os seguintes
procedimentos:

1. D um clique no boto iniciar (Start) na barra de tarefas (Task Bar) do seu Windows
(ou pressione <CTRL>+<ESC>).
2. No menu apresentado, selecione Programas (Programs).
3. Em seguida, escolha Visual Kit 5 para abrir a pasta contendo os componentes
instalados do produto ou procure o folder intitulado Visual Kit 5.
4. Execute o cone intitulado PRINCIPAL.EXE.

Aps executar os procedimentos anteriores, ser exibido o ambiente, conforme mostra a Fig
21.


Visual Kit 5 Verso 6.0.4.2
26


Fig 21 Tela principal do Ambiente de Desenvolvimento do Visual Kit 5.


Elementos do Ambiente

Assim que voc inicia uma aplicao Visual Kit 5, apresentada a janela principal do ambiente
que aparece na figura anterior, aparecendo uma barra de menus horizontal, uma barra de
ferramentas em formato de botes na parte superior e um menu em formato de rvore
(TreeView) na lateral esquerda da tela. Veja a seguir uma breve descrio de cada um dos
elementos apresentados.

Janela Principal

Esta a janela superior do ambiente de desenvolvimento do Visual Kit 5. Ela a responsvel
pelo gerenciamento de todos os elementos no desenvolvimento. Por exemplo, se voc
minimiz-la, todos os elementos sero minimizados e fechando-a voc estar encerrando a
sesso atual do Visual Kit 5.



Visual Kit 5 Verso 6.0.4.2
27
Barra de Menus

Esta barra apresenta os diversos menus que o Visual Kit 5 possui. Cada menu, seguindo o
padro Windows, possui um conjunto de opes distribudas em subnveis. Cada subnvel
caracterizado por uma linha horizontal que separa uns dos outros. As opes de cada menu
podem ser visualizadas em duas tonalidades: preto opes habilitadas, e cinza, opes
desabilitadas. As opes desabilitadas indicam que as mesmas no podem ser acessadas antes
que alguma tarefa especfica seja realizada.

Ainda tratando dos padres dos menus, opes que possuem reticncias indicam que as
mesmas no sero executadas imediatamente, isto , sempre que elas forem acessadas ser
apresentada uma caixa de dilogo na qual o usurio dever especificar diversas opes
inerentes execuo da tarefa escolhida. Exemplo, se voc escolhe a opo Configurar
Impressora do menu Arquivo, a qual permite configurar a impresso. Esta opo apresentar
uma caixa de dilogo que lhe permite especificar diversos itens sobre a configurao de
impresso, como, por exemplo, o nome da impressora, o tipo de papel, etc.


Dica:
Note que cada menu ou opo possui uma letra sublinhada. Batizadas de mnemnicas. Tais
letras, quando pressionadas juntamente com a tecla ALT, permitem acessar a opo em questo
sempre que o menu estiver aberto.


Menu Arquivo

Este menu possui cinco opes inerentes a manipulao de arquivos:

- Abrir: abre a janela para a criao de um sistema novo, modificao de um j existente
ou gerao de um arquivo da biblioteca de sistemas (sistema brinde).
- Fechar: Fecha sistema aberto.
- Salvar: Armazena o sistema atual.
- Configurar Impressora...: exibe a caixa de dialogo padro para configurao de
impressoras.
- Sair: encerra a seo atual do Visual Kit 5.

Menu Editar

Encontrado em qualquer aplicao Windows, este menu contm diversas opes que sero
bastantes teis durante o processo de desenho dos formulrios.

Menu Ver

Visual Kit 5 Verso 6.0.4.2
28
Por meio do menu Ver, voc poder ativar ou desativar diversas opes do ambiente de
desenvolvimento

Menu Janela

Este o menu padro encontrado na maioria das aplicaes Windows. Por meio dele voc
poder distribuir as diversas janelas apresentadas Visual Kit 5.

- Organizar Tudo: Quando se possui mais de uma janela, esta opo faz com que as
janelas sejam organizadas da melhor forma possvel.
- Ocultar Tudo: Oculta as janelas e a TreeView (formato de rvore) de todo o sistema.
- Reexibir: Exibe as janelas e a TreeView de todo o sistema que foram ocultos a opo
anterior.
- Limpar: Atualiza a tela quando esta se encontra com algum lixo na imagem.
- Em Cascata: Organiza as janelas abertas do Visual Kit5 em forma de cascata.

Menu Help

Por meio deste menu voc pode obter ajuda sobre comandos e procedimentos do Visual Kit 5.
Esta ferramenta oferece um conjunto de informaes tcnicas sobre os diversos produtos da
Ebendinger.

Barra de Ferramentas

A barra de ferramentas contm cones que representam as tarefas mais utilizadas. No decorrer
deste manual, farei referncia ao uso particular das opes do menu, bem como das
ferramentas disponveis nas barras de ferramentas. Nesta etapa colocarei somente uma breve
descrio de cada uma das ferramentas disponvel na barra de ferramenta.

Incluso. Funo para registro das informaes (entrada).

Alterao. Funo para alterao das informaes j existentes (includas).

Excluso. Funo para excluir os registros (informaes) j existentes nas tabelas
(entidades) do sistema.

Consultas. Funo que permite visualizar o arquivo inteiro, fazer pesquisas, ordenaes
dos dados, clculos etc.

Relatrios. Funo para impresso ou visualizao dos dados de um determinado
arquivo.

Etiquetas. Funo para impresso de mala-direta.

Visual Kit 5 Verso 6.0.4.2
29
Indexao. Funo para ordenao dos dados de um arquivo. Esta funo ordena os
dados de arquivos padro DBF, segundo uma chave pr-definida.

Senhas. Funo de segurana. Permite o cadastramento de senhas para cada entidade do
sistema.

Transferncia. Permite a importao e exportao de dados. Gera ou importa arquivos de
diversos padres, entre eles arquivos Excel.

OLAP (OnLine Analytical Processing). Ferramenta para modelo de dados
multidimensionais chamados de cubos OLAP.

Data Mining (Minerao ou Explorao de dados). Cria modelos para predio usando
algoritmos de inteligncia artificial.

Sair. Encerra a execuo do sistema.

Menu TreeView

Este menu em forma de rvore, descreve os mdulos e entidades prprias do Visual Kit 5. O
sistema Visual Kit 5 contm trs mdulos: Gerador de Sistemas, Ferramentas e Documentos.

Mdulo de Gerador de Sistemas
Por meio deste mdulo o usurio pode acessar a todos os parmetros do sistema em
desenvolvimento.

Sistema Completo
Esta entidade est disponvel somente para a operao de Incluso. nela que so criados e
alterados os sistemas completos de maneira rpida e simples.

Mdulo
Arquivo onde so armazenados o nmero e nome dos mdulos do sistema a ser gerado ou
alterado. Exemplo: 01 - Controle de Estoque.

Entidade
Armazena o nmero, nome e quais operaes esto habilitadas por entidade.
Exemplo:
Mdulo: 01
Entidade: 001
Nome: Clientes.

Abertura de Arquivo
Contm as informaes sobre quais arquivos sero abertos, as chaves dos arquivos, o servidor
de banco de dados, quando for executada uma entidade.

Visual Kit 5 Verso 6.0.4.2
30
Atributos
Armazena todos os dados necessrios para manipulao dos campos de cada arquivo: linha,
coluna de exibio do campo na tela, formato, pr e ps-validao, cor, fonte, tamanho, estilo,
cabealho, mensagem de rodap etc. Alterar qualquer um destes dados implicar na alterao
automtica do sistema gerado.

Macro Clculo
Este arquivo armazena dados da macro clculo criada no sistema gerado na consulta e
relatrio.

Macro Relatrio
Este arquivo armazena dados da macro relatrio, etiqueta e transferncia criada no sistema
gerado.

Macro Indexao e Filtro
Este arquivo armazena dados da macro indexao e filtro, para consulta, relatrio, etiqueta e
transferncia criada no sistema gerado.

Chamada Externa Windows *.EXE
Este arquivo armazena o PATH (caminho de busca) e nome dos programas executveis que
podero ser chamados sem sair do sistema gerado. Exemplo:
C:\WINWORD\WINWORD.EXE.

Pr e Ps Validao
Este arquivo armazena a pr e ps-validao por registro para incluso, alterao e excluso de
dados. As validaes para relatrios, lay-outs, etiquetas e transferncias.

Log Alter. / Excluso do Sistema
Neste arquivo so cadastradas todas as alteraes e excluses realizadas nos dados do sistema
gerado. Permite o controle por usurio, data, hora, arquivo e dados alterados ou excludos.
Grava o contedo do campo antes e depois da alterao. Grava os registros que foram
excludos alm de quem excluiu.

Alias de Referncia de Arquivos
Apelidos para referenciar arquivos (tabelas) de base de dados no criada pelo Visual Kit 5.

Cubos OLAP
Armazena os dados para controlar a criao de Cubos OLAP.

Data Mining (DMM)
Armazena os dados para controlar a criao de modelos de Data Mining.

Objetos e Propriedades
Novo arquivo de controle de parmetros para a montagem das telas no sistema gerado.
Quando voc desenha uma tela no Visual Kit 5 ele grava neste arquivo os parmetros para
desenhar a tela e validar a entrada de dados.
Visual Kit 5 Verso 6.0.4.2
31

Modelos de Data Mining
Armazena informaes adicionais sobre os modelos de Data Mining.

Mdulo Ferramentas

Localizar
Utilize a janela Localizar para encontrar dados em todos os arquivos do sistema atravs de
palavras chave sem precisar abrir o arquivo

.
Fig 22 Janela Localizar

Executando o recurso Localizar:
- Feche todos os arquivos abertos;
- Selecione a operao Consultas;
- Na treeview do sistema gerado, abra "Ferramentas" selecione a opo Localizar.
- Localizando uma entidade (arquivo) ou campo de arquivo.
- No campo Localizar digite a palavra chave inteira ou um trecho. Exemplo: Clientes
ou Cli.
- Pressione o boto Iniciar Pesquisa.
- Na lista Entidades Encontradas clique sobre a entidade desejada.
- Pressione o boto Ok.

Visual Kit 5 Verso 6.0.4.2
32
Localizando uma informao dentro do arquivo:
- Clique com o mouse no campo Tipo de Pesquisa.
- No campo Contendo Texto digite a palavra chave inteira ou um trecho. Exemplo:
SILVA ou LVA.
- Pressione o boto Iniciar Pesquisa.
- Na lista Entidades Encontradas clique sobre a entidade desejada.
- Pressione o boto Ok.
- Nos dois casos acima descritos, o sistema executar a operao Consultas e
posicionar o cursor sobre o primeiro registro encontrado.

Propriedades
Utilizando a janela Propriedades no sistema gerado, voc pode criar usurios para o seu
sistema e configurar estes usurios.




Fig 23 Janela de Propriedades

Ateno !!!
Quando voc entra pela primeira vez na janela Propriedades o sistema cria de maneira
automtica um usurio com:
nome (login): administrador
senha: admini

Visual Kit 5 Verso 6.0.4.2
33


Fig 24 Confirma de deciso de criar senha de Adminstrador.

Executando as Propriedades
Feche todos os arquivos abertos.
Selecione na treeview do sistema gerado o item "Ferramentas" e a opo Propriedades.
Criando usurios
Clique na lista Usurios.
Pressione o boto Inserir.
Digite o nome do usurio e pressione o boto Ok.
Se o sistema gerado vai rodar em rede obrigatrio criar todos os usurios do sistema.
Incluindo / alterando a senha do usurio
Selecione o usurio na lista Usurios.
Pressione o boto Senha.
Digite a senha do usurio e pressione o boto Ok.
Excluindo usurios
Clique no nome do usurio na lista Usurios.
Pressione o boto Excluir.
Confirme a excluso.
Estabelecendo direitos de usurios, mdulos e/ou entidades
Selecione o usurio, mdulo e/ou entidade na lista correspondente.
Pressione o boto Direitos para Usurios, Mdulos e Entidades.
Clique uma vez sobre a operao que voc quer desabilitar na janela Direitos.
Pressione o boto Ok para confirmar os dados.
Desabilitando recursos e menus (configura tela e sistema)
Clique sobre o usurio na lista de Usurios.
Clique sobre o recurso/menu que voc deseja desabilitar para aquele usurio. A seta indica que
o recurso/menu est habilitado.
Criando um arquivo de log por usurio
Clique sobre o usurio na lista de Usurios.
Clique no campo Arquivo Log-Usurio e digite o path e nome do arquivo (TXT) onde sero
gravadas as informaes da utilizao do sistema.
Exemplo: \WINDOWS\RELLOG.TXT.
Criando um arquivo de recursos
Clique sobre o usurio na lista de Usurios.
Clique no campo Arquivo de Recursos e digite o path e nome do arquivo (*.DBF) onde sero
gravadas as informaes sobre os recursos do sistema.
Visual Kit 5 Verso 6.0.4.2
34
Exemplo: \VDEMOS\FOX01.DBF.
Se a execuo do sistema gerado for em rede (multi-usurio) obrigatrio criar um arquivo de
recursos para cada usurio do sistema.
Estabelecendo a execuo automtica de uma entidade
Clique no campo Mdulo da janela Executa Automaticamente e digite o nmero do
mdulo.
No campo Operao digite o nmero da operao 1 - para Incluso, 2 - para Alterao
etc.
No campo Entidade digite nmero da entidade que ser executada automaticamente.
Para sair aps a execuo do sistema, clique sobre o campo Executa e sai do sistema.
Sai da janela Propriedades clicando sempre no boto Ok.

Exibe Barra de Ferramentas
Mostra ou oculta a barra de ferramentas do sistema.

Mdulo Documentos

Neste mdulo sero apresentados os ltimos 10 (dez) arquivos recentemente manipulados. Isto
ser muito til quando voc tiver que acessar rapidamente operaes e arquivos que foram
abertos recentemente.

Acabamos de conhecer as reas bsicas do ambiente de desenvolvimento do Visual Kit 5.
Muito provavelmente nos prximos captulos voc ter que retornar a este para lembrar ou
localizar uma determinada opo.

A manipulao dessas opes ser apresentada de forma particular e com exemplos nos
prximos captulos. Na maioria das vezes, ser utilizado apenas um conjunto bsico de opes,
alm de serem bastante fceis de se utilizar. Para demonstrar que voc no ter dificuldades na
utilizao das opes do Visual Kit 5 vamos agora desenhar o nosso primeiro sistema.



Visual Kit 5 Verso 6.0.4.2
35
IV. Criando seu Primeiro
Sistema Passo a Passo

At o momento, voc j passou por trs captulos e nada de desenvolvimento. J est na
hora de ver como isto funciona!

Obviamente, voc ainda no possui toda a prtica do mundo nem conhece todos as
funcionalidades que o Visual Kit 5 brinda, mas para que voc tenha o gostinho de
desenvolver seu primeiro sistema, vamos juntos desenvolver um sistema bem simples que o
ajudar a entender melhor os conceitos e elementos apresentados nos captulos anteriores, bem
como nos prximos captulos deste manual.

Gostaramos de colocar que alguns recursos executados neste captulo no sero abordados em
profundidade, pois o nico intuito aqui o de oferecer uma leitura clara dos prximos
captulos.

A proposta

Para desenvolver um sistema, o primeiro passo entender o contexto do mesmo. Desta forma,
poderemos criar mecanismos mais simples tornando o sistema mais claro para o usurio final.
Esta uma regra fundamental que todo desenvolvedor deve cumprir; e agora voc um
desenvolvedor. Claro que neste exemplo a coisa ser muito mais simples; no entanto, no
podemos pular esta etapa de desenvolvimento.

O sistema que desenvolveremos de controle dos aniversariantes. Trata-se de uma pequena
interface contendo apenas um formulrio com dois campos. Nesta interface bsica, o usurio
colocar o nome da pessoa, a data de nascimento.

Desenhando o sistema

O Visual Kit 5 oferece diversos recursos para desenhar sistemas. Como nosso objetivo neste
captulo apenas mostrar o quanto voc capaz sem profundos conhecimentos do Visual Kit
5, utilizaremos aquele tradicional mtodo de receita de bolo.

Carregando o Visual Kit 5

Em primeiro lugar, voc dever abrir o Visual Kit 5, conforme explicado no captulo anterior.

Visual Kit 5 Verso 6.0.4.2
36
Gerando o diretrio do sistema

Pois bem, agora que voc j est dentro do Visual Kit 5, criaremos primeiramente o diretrio o
qual guardar todos os arquivos do nosso primeiro sistema. Execute o procedimento a seguir:

- Clique na TreeView para abrir a pasta Gerador de Sistema, como na figura abaixo.
- Clique em Sistema Completo e selecione a opo Incluso. Estaremos incluindo
um sistema. Veja na Fig 25.





Fig 25 Incluindo sistema



O Visual Kit 5 permite desenvolver sistemas comeando de zero ou a partir de uma biblioteca
de sistemas prontos (sistemas brinde). Por isso apresentada uma caixa de dilogos intitulada
Utiliza Sistemas Prontos / Cria Sistema Novo conforme mostra a Fig 26.

- Como vamos desenvolver um sistema desde o zero, escolhemos a opo "Cria Sistema
Novo".
- Selecione seguidamente a opo "Sistema Completo".
Visual Kit 5 Verso 6.0.4.2
37

Fig 26 Cria sistema novo.

Ao clicar na opo "Sistema Completo" o Visual Kit 5, abrir uma janela, solicitando que voc
digite o nome para o diretrio onde ser gerado o sistema novo. Digite \VCLIENTE


Ateno! Voc no pode gerar sistema no prprio diretrio do Visual Kit 5 nem como sub-
diretrio do Visual Kit 5.
Exemplo de diretrio correto: \VCLIENTE
Exemplo de diretrio invlido: \VISUAL KIT 5 6.0
Exemplo de diretrio invlido: \VISUAL KIT 5 6.0\VCLIENTE


Visual Kit 5 Verso 6.0.4.2
38

Fig 27 Definindo diretrio onde ser gerado o sistema.

O Visual Kit 5 exige a confirmao para poder criar o diretrio selecionado. Responda que
"Sim" / "Yes", para criar o diretrio do sistema novo. E pronto, o diretrio est criado!.




Fig 28 Confirmando criao do diretrio do sistema.

Seguidamente aparecer uma janela para o cadastramento dos dados gerais do sistema, veja na
Fig 29. Coloque o Nome do Desenvolvedor (voc !) , Nome do Sistema, Nome do
Cliente, Rodap dos Relatrios, Verso do Sistema, Idioma, Site e Driver. O
preenchimento nesta etapa obrigatrio, mas os valores podero ser mudado posteriormente.

Mantenha na opo "Driver" em Visual FoxPro. No troque por enquanto esta opo!. Vai
indicar o tipo de formato das tabelas geradas.


Visual Kit 5 Verso 6.0.4.2
39


Nota.
O Visual Kit 5 gera os sistemas baseados em bases de dados em dois formatos: Visual FoxPro
ou MS SQL Server.




Fig 29 Dados Gerais do Sistema.

Criao dos mdulos e entidades

Bom, at agora preparamos as condies iniciais para criar nosso sistema, chegou a hora da
prpria criao dos mdulos e suas entidades. Se tudo correu bem, devemos ter agora na tela
do computador a janela de criao dos Mdulos e suas Entidades, como mostra a Fig 30

Segundo j foi explicado no Captulo II, a estrutura dos sistemas criados pelo Visual Kit 5
constituda por mdulos e entidades. Neste exemplo criaremos a variante mais simples de um
sistema: um nico mdulo contendo uma nica entidade

Para criar o mdulo basta:
- Clicar no boto Cria Mdulo;
- Aparecer uma entrada de dados na parte inferior da janela Mdulos onde digitaremos
o nome do mdulo Cadastro;
- Tecle <ENTER> ou boto OK. Ser aberta uma janela de confirmao, selecione
Sim Yes, para confirmar o nome do mdulo. Veja na Fig 31.


Visual Kit 5 Verso 6.0.4.2
40

Nota.
No Visual Kit 5 os mdulos so enumerados na ordem de criao, ex. 01, 02, 03... etc. A
quantidade mxima de mdulos suportada pelo Visual Kit 5 99.



Fig 30 Janela de Definio das estruturas Mdulos e Entidades do sistema.

Fig 31 Definindo o primeiro mdulo (01): Cadastro.
Visual Kit 5 Verso 6.0.4.2
41

Em seguida cadastre a entidade do mdulo. Para cadastrar as entidades de um determinado
mdulo, clique sempre no nome do mdulo e em seguida pressione o boto "Cria Entidade".
Aparecer uma entrada de dados na parte inferior da janela Entidades onde digitaremos o
nome da Entidade Clientes;


Fig 32 Criando a Entidade

Ateno! Antes de criar uma entidade, selecione sempre mdulo clicando sobre o seu nome
na Lista de Mdulos.


Sempre que voc definir uma nova entidade o Visual Kit 5 solicitar a definio das operaes
bsicas que sero herdadas por meio da janela mostrada na Fig 33. Vamos confirmar neste
todas as operaes bsicas do Visual Kit 5 pressionando o boto "Ok".
Visual Kit 5 Verso 6.0.4.2
42

Fig 33 Definindo Operaes Bsicas que a entidade vai possuir.

Nota.
No Visual Kit 5 as entidades so enumeradas na ordem de criao, colocando primeiro o
nmero do mdulo a que elas pertencem. ex. 01001, 01002, 02001...a quantidade mxima de
entidades 999 em cada mdulo .

Chegou a hora de desenhar o formulrio associado entidade, sem dvida a parte mais criativa.
Para criar ou alterar o formulrio de uma entidade, sempre faa da seguinte maneira:
- Clique primeiramente no nome do mdulo que contm a entidade;
- Clique depois no nome da entidade para selecion-la;
- Clique no boto Ok;
- E confirme a seleo.

Desenhando o formulrio.

Depois que foi escolhida a entidade Clientes, aparecer trs elementos: uma tela de formulrio
que receber posteriormente os controles ou objetos e mais duas janelas: a Caixa de
Ferramentas e a janela de Propriedades. Veja na Fig 34.

Visual Kit 5 Verso 6.0.4.2
43

Fig 34 A tela do formulrio bsico e os recursos de desenho.
Por meio da caixa de ferramentas podemos escolher e inserir os controles nos formulrios, para
gerar a interface amigvel para o usurio de nosso sistema.

J as propriedades so as caractersticas relacionadas a cada controle ou objeto. O principal
papel das propriedades estabelecer como os controles devem ser apresentados e ou
manipulados na interface da aplicao.

Inserindo os controles.

Todos os objetos dentro do Visual Kit 5 possuem nomes. Por default, cada controle possui um
nome que identifica categoria da qual o mesmo faz parte. Neste captulo utilizaremos o nome
default, mas em captulos posteriores voc aprender que devemos alterar tais nomes para que
o desenvolvimento dos sistemas fique mais claro.

Neste nosso primeiro sistema, utilizaremos 2 controles bsicos Label e TextBox. Veja a seguir
os procedimentos necessrios para inseri-los e mov-los dentro do formulrio:




Visual Kit 5 Verso 6.0.4.2
44


Dica.
Para identificar um determinado controle dentro da caixa de ferramentas, mantenha o ponteiro
do mouse sobre o controle desejado por alguns segundos. Ser apresentada uma caixa de texto
amarelada (conhecida como ToolTip), contendo o nome da classe do controle em questo.


- D um clique no controle Label (Rtulo ou texto fixo) na caixa de ferramentas. Note
que o boto ser diferenciado do resto dos botes sinalando que ele est ativado.
- Seguidamente usando o ponteiro do mouse escolhemos aproximadamente o lugar
dentro do formulrio onde ficara o Label.
- Clique com o boto do mouse e o controle aparecer com as marcas de seleo
(pequenos quadrados negros).

Agora podemos alterar suas propriedades Alinhamento Esquerda, Alinhamento
Superior para posicion-lo no lugar exato dentro do formulrio e Descrio do Ttulo para
definir o texto que o mesmo apresentar. Veja os procedimentos necessrios.

- Na janela de propriedades localize e clique na propriedade Alinhamento Esquerda.
Aparecer uma entrada de dados na parte superior da janela.
- Digite o valor 60 no contedo da entrada de dados, assim o valor ser assumido pela
propriedade Alinhamento Esquerda e pressione ENTER.
- Em seguida, localize a propriedade Alinhamento Superior na janela de propriedades
e clique sobre ela. Aparecer novamente a entrada de dados na parte superior.
- Digite o valor 30 como contedo da propriedade Alinhamento Superior e pressione
ENTER.
- Localize agora a propriedade Descrio do Ttulo na janela de propriedades.
- Substitua o valor default digitando Nome do Cliente: como contedo desta
propriedade.

A Fig 35 exibe o formulrio aps a execuo dos procedimentos anteriormente mencionados.
Visual Kit 5 Verso 6.0.4.2
45

Fig 35 Inserindo o primeiro controle

Muito bom! Agora j temos um rtulo que informa ao usurio do sistema que ele dever digitar
o nome do cliente. Agora falta colocar a prpria entrada de dados para o nome do cliente.
Utilizaremos o controle tipo TextBox ou Caixa de Texto. Veja os procedimentos necessrios.

- De um clique no controle TextBox na janela de controles. Note que ele ficou ressaltado
na janela de ferramentas.
- Usando o ponteiro do mouse escolhemos aproximadamente o lugar dentro do
formulrio onde ficar o TextBox.
- D um clique com o boto do mouse e o TextBox aparecer na tela do formulrio.


Nota
Note que na janela de propriedades existem propriedades com um fundo azulado e
propriedades com fundo branco. As propriedades com fundo azulado so as relacionadas
estrutura dos dados e as propriedades de fundo branco so as relacionada estritamente com a
esttica ou parte visual do formulrio.


- Localize a propriedade Alinhamento Esquerda.
Visual Kit 5 Verso 6.0.4.2
46
- Digite o valor 180 como contedo da propriedade Alinhamento Esquerda e
pressione ENTER.
- Localize a propriedade Alinhamento Superior. Digite o valor 30 e pressione
ENTER.

Para alterar as dimenses de um objeto, basta de arrastar suas bordas no sentido desejado.
Embora seja esta a forma mais fcil, utilizaremos outra.

- Utilizando a barra de rolagem vertical da janela de propriedades, localize a propriedade
Largura do Campo e d um clique nela. Esta propriedade especifica o nmero
mximo de caractere que poder ser digitado .
- Digite o valor 220 como contedo e pressione ENTER. Observe como aumentou a
largura do campo.

Da maneira similar, incluiremos mais um controle Label e um controle TextBox para colocar a
data de nascimento do cliente. Veja os procedimentos necessrios.

- D um clique no controle Label.
- Usando o ponteiro do mouse escolha aproximadamente o lugar dentro do formulrio
onde ficar o Label (logo abaixo do Label anterior).
- Clique na propriedade Alinhamento Esquerda.
- Digite o valor 60 como contedo da propriedade Alinhamento Esquerda e pressione
ENTER.
- Na propriedade Alinhamento Superior digite o valor 80 como contedo e pressione
ENTER.
- Localize agora a propriedade Descrio do Ttulo na janela de propriedades.
- Digite Data de Nascimento: como contedo desta propriedade.
- D um clique no controle TextBox na caixa de ferramentas.
- Usando o ponteiro do mouse escolhemos aproximadamente o lugar dentro do
formulrio onde ficar o TextBox (do lado do Label).
- D um clique com o boto do mouse e o TextBox aparecer na tela do formulrio.
- Localize a propriedade Alinhamento Esquerda. Digite o valor 180 como contedo da
propriedade e pressione ENTER.
- Localize a propriedade Alinhamento Superior. Digite o valor 80 e pressione
ENTER.

At aqui tudo foi muito similar. Agora modificaremos uma nova e importante propriedade:
Tipo do Campo que coloca o tipo de dado que o campo armazenar. Localize esta
propriedade e d um clique nela. Observe que na parte superior aparecer uma entrada de
dados com a letra C como default. Clique nela e ser apresentado para seleo 6 (seis) tipos de
campos. Em nosso exemplo escolheremos o tipo D- Data:





Visual Kit 5 Verso 6.0.4.2
47


Nota
Os tipos de campos no Visual Kit 5 so indicados da seguinte forma:
C- Carter: Qualquer texto.
N- Numrico: Nmeros inteiros ou fraes.
L- Lgico: Valor booleano de Verdadeiro ou Falso.
M-Memo: Campo de tamanho variado.
G- Geral: (foto ou objeto OLE):
D- Data: data cronolgica constituda de dia, ms e ano.

Por enquanto voc terminou a fase de desenho deste primeiro sistema, e precisa agora salv-lo,
voc ficaria muito triste se a fora casse agora.


Fig 36 Desenhando o formulrio.

Salvando o sistema e fechando o desenho

Para salvar pressione o boto Salvar na janela Propriedades, e confirme a gravao do
arquivo.

Uma vez salvo o arquivo, voc poder sair da janela de desenho, e sair do Visual Kit 5 para
testar seu primeiro sistema . Veja os procedimentos necessrios.
Visual Kit 5 Verso 6.0.4.2
48

- Pressione o boto Fechar na janela de Propriedades.
- Aparecer uma mensagem de confirmao Deseja sair do sistema?: aperte Yes.
- Na Janela Mdulo e Entidades clique em Cancela.
- Aparecer uma mensagem de confirmao Voc no selecionou uma Entidade. Deseja
Selecionar uma Entidade? aperte No.
- Para sair da janela "Utilize Sistemas Prontos / Cria Sistema Novo", pressione o boto
Cancela.
- Para sair do Visual Kit 5, pressione o boto .

Acessando o sistema gerado

Vamos agora acessar o sistema que voc gerou com a ajuda do Visual Kit 5 e comprovar se
tudo est realmente funcionando... Para executar o sistema gerado siga as seguintes instrues:

- D um clique no boto Iniciar (Start) na barra de tarefas (Task Bar) do seu Windows
(ou pressione CTRL+ESC).
- Selecione a opo Executar (Run);
- Na opo "Abrir" (Open), digite: C:\vclientes\principal.exe e clique no boto Ok, para
executar o sistema gerado.


Fig 37 Executando o sistema gerado
Viu como simples? Finalmente chegamos ao final do desenvolvimento de nosso primeiro
sistema em Visual Kit 5.A Fig 38 exibe o sistema aps a execuo dos procedimentos
anteriores. Note que muito similar ao prprio Visual Kit 5.

Visual Kit 5 Verso 6.0.4.2
49

Fig 38 Visual do sistema gerado pelo visual Kit 5

Testando o sistema

Bom, chegou o momento de testar o nosso sistema. Est nervoso?...Vamos ver algumas das
funcionalidades do sistema que voc acabou de desenvolver com ajuda do Visual Kit 5. Nos
prximos captulos colocaremos detalhadamente todos os recursos gerados.

Incluindo dados
O primeiro, incluir dados, que a razo de ser de qualquer sistema. Vamos incluir
aproximadamente cinco nomes com suas datas de aniversrios.

Exemplo:
Maria 16/12/1964
Joo 20/02/1980
Luiza 13/05/1990
Pedro 03/11/1974
Gabriela 10/10/1959

Para realizar esta incluso siga os seguintes passos:
- D um clique duplo em cima do nome do mdulo Cadastro ou um clique em cima do
[+] associado ao mdulo.
- Vai aparecer a entidade Clientes que voc registrou.
- D um clique duplo em cima do nome da entidade Clientes ou um clique em cima do
[+] associado.
Visual Kit 5 Verso 6.0.4.2
50
- Vo aparecer as operaes que o Visual Kit 5 incluiu automaticamente para esta
entidade. Como tnhamos selecionado para incluir todas, foram includas as 12
operaes bsicas do Visual Kit 5..

Nota
O Visual Kit 5 inclui as seguintes operaes bsicas: incluir, alterar, excluir dados, fazer
consultas, pesquisas, imprimir relatrios, etiquetas, criar arquivos de exportao - importar
dados, criar cubos OLAP e definir modelos de Data Mining.


- D um clique em Incluso.
- Surpresa! Apareceu o formulrio que voc desenhou. Repare que foram includas vrias
teclas na parte de inferior do formulrio. Veja na Fig 39.
- Note tambm que existe um ponteiro situado no primeiro campo, sinalando de maneira
intermitente, que este campo est focado,ou seja, neste momento ele receber a
incluso dos dados.
- Digite ento o primeiro nome de nosso exemplo e pressione ENTER.
- O cursor agora pulou e est enfocando o seguinte campo da Data de Nascimento.
Digite a data de nascimento. Com isto, culmina a incluso do primeiro registro da lista.
- Para salvar, voc pode pressionar ENTER ou ento com o mouse clicar no cone
Salvar. Imediatamente os dados sero armazenados e o sistema ficar pronto para a
incluso de novos dados.
- Terminemos de incluir os quatros registros restantes.
- Para terminar a operao de incluso pressione a tecla ESC. Caso faa de outro jeito,
originar a mensagem Ateno: texto1 INVALIDO . Isto uma garantia para no gravar
um valor nulo (vazio) no primeiro campo da entidade, por ser este o campo chave.

Visual Kit 5 Verso 6.0.4.2
51

Fig 39 Viso do formulrio no sistema gerado.
Depois de incluir todos os dados do exemplo, vamos tentar incluir um segundo nome de Pedro.
Impossvel, o sistema no permite! Est aparecendo uma caixa de mensagem indicando
Ateno text1 J EXISTE. Observe na Fig 40. Sabe explicar o que aconteceu?.

Certo... esse campo chave primria, e como tnhamos falado no Captulo II, seu contedo
nico dentro da entidade. O Visual Kit 5 coloca por default como chave primria o primeiro
campo da entidade, e neste caso foi o nome do Cliente (coisa no recomendvel). por isso
que considerada uma boa prtica de desenvolvimento comear sempre por um campo-cdigo
que identifique o registro como um todo, como por exemplo, cdigo do cliente, ou cdigo do
produto, etc. Assim voc poder cadastrar vrios clientes com o mesmo nome e claro est
com cdigo diferente.

Visual Kit 5 Verso 6.0.4.2
52

Fig 40 Cadastrando cliente com o mesmo nome.

Nota
No Visual Kit 5 o primeiro campo do formulrio sempre campo Chave e portanto seu
contedo nico na dada entidade.


Consultando.
Usando esta operao voc poder dar consulta aos dados includos em formato de tabela.
Lembra que falamos que todo formulrio por trs contm uma tabela, onde cada coluna
representa cada campo e cada linha representa um registro.

Dando um clique nesta operao aparecer uma janela de consulta com os dados que acabamos
de cadastrar.

Esta janela possui muitas opes destinadas a fazer filtros, relatrios, etc. Voltaremos no
Captulo XVII para detalhar o funcionamento de todas estas opes.


Visual Kit 5 Verso 6.0.4.2
53

Fig 41 Consulta a dados cadastrados

Alterando dados
Esta operao permitir exclusivamente alterar dados. No poder nem incluir nem apagar
registros ou contedos dos campos. Siga os procedimentos para a alterao de dados.

- D um clique em Alterao.
- Voc pode digitar um dos nomes e pressionar ENTER.
- Aparecer a data de Nascimento referente da pessoa, a qual poder ser alterada.
- Nesta chamada, o Visual Kit 5 no permite alterar o campo chave.
- Tambm voc pode navegar pelos registros usando as teclas:
Exibe o primeiro registro do arquivo.
Exibe o registro anterior.
Exibe na tela o prximo registro.
Exibe o ltimo registro do arquivo.

Visual Kit 5 Verso 6.0.4.2
54
Excluindo dados
Esta operao permitir apenas excluir dados. No poder nem incluir nem alterar registros.

D um clique em Excluso.
Voc pode digitar um dos nomes e pressionar Enter.
Aparecer os dados da pessoa a qual poder ser excluda clicando o boto.

Excluso: (deleta) o registro exibido.

Modificando o sistema

Para incluir novas entidades ou alterar alguma propriedade do formulrio ou at para corrigir
algum erro, o sistema precisa ser reaberto novamente pelo Visual Kit 5. Todo desenvolvedor
sabe que grande parte do desenvolvimento destinado para fazer as atualizaes ou
modificaes que o cliente ou usurio do sistema exigir pelo resto da vida.

Reabrir o sistema muito fcil. Veja os procedimentos necessrios.

- Em primeiro lugar, voc dever abrir o Visual Kit 5.
- Clique na TreeView para abrir a pasta Gerador de Sistema
- Clique em Sistema Completo e selecione a opo Incluso.
- Abrir-se- uma janela, solicitando que voc indique o diretrio onde est o sistema a
modificar. O Visual Kit 5 exibe sempre o diretrio do ltimo sistema manipulado.
- Responda que "Sim"/"Yes", confirmando que esse realmente o diretrio do sistema a
modificar.
- Finalmente ser aberta a janela de Mdulo e Entidade, permitindo ter acesso e criar ou
modificar todos os mdulos e entidades do sistema.

Voc deve ter notado que muitos conceitos e funcionalidades no foram ainda abordados, isto
ser feito nos prximos captulos.

Visual Kit 5 Verso 6.0.4.2
55
V. Desenhando o Formulrio

A principal tarefa que o desenvolvedor Visual Kit 5 tem que realizar no
desenvolvimento de sistemas desenhar os formulrios. Voc dever criar formulrios que
sejam amigveis com o usurio, evitando muitos controles em um nica janela e usando
tambm cores agradveis (imagine s um formulrio com letras cor laranja no fundo
vermelho!!!).

No decorrer deste captulo, voc conhecer diversos controles que tm a mesma finalidade.
Isso poder causar dvidas do tipo: qual deles devo utilizar? Nesses casos, opte sempre pelo
controle que oferea maior claridade ao usurio e permita a compresso da tarefa a ser
executada por ele.

As ferramentas de desenho Designer-
Bsica e Designer-Pro

O Visual kit 5 possui duas ferramentas de desenho de formulrios: a Designer-Bsica e a
Designer Pro. A Designer Bsica -com menos recursos- garante a compatibilidade com
verses e releases anteriores do Visual Kit 5. J a Designer-Pro, possui uma serie de novos
recursos, tais como Grid e Boto, diversos assistentes de criao, assim como editores de
macros e cdigos.

Como descrevemos no captulo anterior, sempre que voc definir uma nova entidade, o Visual
Kit 5 solicitar a definio das operaes bsicas (veja na Fig 42). Neste momento voc poder
escolher qual das ferramentas usar: a Designer-Bsica ou a Designer Pro.


Ateno!
Quando selecionamos para a dada operao a Funo Bsica estaremos acessando a Designer-
Bsica. Se selecionamos Formulrio Externo, estaremos acessando a Designer-Pro.

Visual Kit 5 Verso 6.0.4.2
56

Fig 42 Escolhendo a Designer

Manipulando controles

Nesta seo, apresentaremos a caixa de controles ou caixa de ferramentas do Visual Kit 5 tanto
da Designer-Bsica como da Designer-Pro. Voc aprender inserir e manipular os controles ou
objetos dentro do formulrio.

Conhecendo a Caixa de Ferramentas

Conforme mencionamos anteriormente a caixa de ferramentas exibe os controles que podem
ser empregados para desenhar a interface dos formulrios. Cada formulrio poder ter diversos
controles, distintos ou no.

Cada controle indica um tipo de interface com o usurio e possui caractersticas particulares.
Os controles so identificados pelo nome comumente aceito nas linguagens de programao
Windows, como por exemplo TextBox, Option, ComboBox, etc.



Fig 43 Caixa de ferramentas da Designer-Bsica

Visual Kit 5 Verso 6.0.4.2
57

Fig 44 Caixa de ferramentas da Designer-Pro
Utilize este boto para desmarcar a seleo de objetos, na caixa de ferramentas.

Label: Criar um rtulo, usado para textos que voc no deseja que o usurio altere,
como por exemplo, a legenda que aparece ao lado das caixas de texto. Esta opo no
cria campos na entidade.

TextBox: Cria uma caixa de texto, usado para manter uma nica linha de texto a ser
digitada ou alterada pelo usurio. Esta opo a forma bsica de criar campos na
entidade.

EditBox: Cria uma caixa de edio, usado para manter mltiplas linhas de texto a
serem digitadas ou alteradas pelo usurio. O tipo de campo que ela cria
exclusivamente do tipo Memo.

Option: Cria um grupo de opes usado para exibir mltiplas opes entre as quais o
usurio pode selecionar apenas uma.

CheckBox Cria uma caixa de verificao, que permite ao usurio escolher entre uma
condio verdadeira ou falsa. Cria campo tipo lgico.

ComboBox: Cria uma caixa de combinao suspensa para que o usurio possa
selecionar um item da lista de item formada por uma outra entidade do sistema.
Portanto, a ComboBox dever obrigatoriamente ser relacionada a uma segunda
entidade.


ListBox: Cria uma caixa de listagem, usado para exibir uma lista de itens de onde o
usurio pode fazer uma seleo. A lista pode ser rolada se tiver um nmero de itens
superior ao que pode ser exibido de uma s vez. O controle ListBox dever
obrigatoriamente ser relacionado a uma segunda entidade que contenha a lista de itens.

Spiner: Cria um controle de rotao, usado para aceitar a entrada numrica que
pertence a determinado intervalo. O campo criado sempre de tipo numrico.
Utilizando o mouse pode-se somar ou subtrair 1 ao valor do campo.

Image: Exibe uma imagem grfica (arquivo externo formato .BMP) no seu formulrio.

Visual Kit 5 Verso 6.0.4.2
58
Grid: Cria um controle Grade, usado para exibir os dados em uma grade parecida com
uma planilha.

Boto: Cria um controle Boto, usado para emitir um comando.

Exibe: Controle de exibio. Usado para exibir na tela do formulrio o contedo de um
campo de outra entidade.









Adicionando controles ao formulrio
A caixa de ferramentas mostrada na Fig 44 permitir inserir ou desenhar os controles nos
formulrios. Est uma manipulao fundamental que voc dever aprender para poder criar
sistemas com o Visual Kit 5. Para adicionar:

- Selecione primeiro o controle desejado na caixa de ferramentas fazendo um clique no
cone correspondente
- Leve o ponteiro do mouse para o local desejado dentro do formulrio.
- De um clique no mouse e o controle ser desenhado no lugar indicado.

Selecionando controles
Sempre que tiver que alterar alguma caracterstica relativa a algum controle, antes de executar
os comandos ou procedimentos necessrios para tal, voc dever selecion-lo.

Para selecionar um nico controle d um clique no objeto desejado dentro do formulrio. Caso
o objeto desejado seja o prprio formulrio, d um clique em uma rea em que no haja
controles no mesmo.

Visualmente, um controle selecionado apresenta quadrados em sua volta. Tais quadrados so
denominados de marca de seleo. Veja na seguinte figura.


Fig 45 Marcas de seleo
Visual Kit 5 Verso 6.0.4.2
59

Para selecionar vrios controles dentro do formulrio voc pode fazer de duas maneiras. A
primeira da seguinte forma:

- Mantenha a tecla SHIFT pressionada;
- D um clique em cada um dos objetos a serem selecionados. Note que cada controle
que faz parte da seleo aparece rodeado de pequenos quadros negros.

Outra forma muito eficaz utilizando o ponteiro do mouse na caixa de ferramentas e arrast-lo
emoldurando todos os controles a serem selecionados. Os controles que estiverem com alguma
parte visvel dentro da moldura sero selecionados. Veja na seguinte figura.


Fig 46 Selecionando vrios objetos com o mouse.
Quando vrios controles so selecionados, a janela de propriedades mostrar somente as
propriedades comuns a todos, como mostra a Fig 47.

Visual Kit 5 Verso 6.0.4.2
60

Fig 47 Controles selecionados.

Dica
Sempre que um controle inserido no formulrio, este automaticamente j estar selecionado.


Posicionando controles
Aps compreender a seleo dos controles, outra tarefa relevante para o desenho do formulrio
posicion-los dentro da prpria janela do formulrio na posio desejada. Por meio da
seleo e posicionamento dos controles, voc poder desenhar sua interface de maneira que a
mesma atenda justamente s suas necessidades.

Ao mover um controle, automaticamente voc estar modificando os valores para as
propriedades Alinhamento Superior e Alinhamento Esquerda do mesmo.

Para mover os controles voc poder usar tanto o mouse como o teclado:

Usando o mouse:
- Selecione o controle desejado;
- D um clique no centro do controle e arraste o mouse para a posio desejada. No
caso de seleo de vrios controles, d um clique e arraste qualquer um deles e
todos sero movidos.
Usando o teclado:
- Selecione o controle desejado;
- Utiliza as teclas de direo correspondente ao sentido em que voc quer mover o
controle.

Visual Kit 5 Verso 6.0.4.2
61
Dimensionando controles
Esta tarefa ser necessria sempre que voc quiser desenhar controles com tamanhos diferentes
do default.. Os procedimentos so:

- Selecione o controle desejado;
- Coloque o ponteiro do mouse sobre uma das marcas de seleo (um dos quadros negros
que emolduram o objeto), conforme sentido desejado para a nova dimenso;
- Arraste o mouse, soltando o boto quando a moldura atingir a dimenso desejada.


Fig 48 Dimensionando controles (Antes e Depois)


Para dimensionar um controle usando o teclado, faa o seguinte:

- Selecione o controle a ser dimensionado;
- Mantenha a tecla SHIFT pressionada e pressione a tecla de direo correspondente ao
sentido desejado.

Excluindo controles
Para remover um ou mais controles do formulrio, faa desta maneira:

- Selecione o(s) controles desejado(s).
- Pressione a tecla DEL (Delete).

Copiando, Recortando e Colando controles
Existe uma forma de copiar, recortar e colar objetos dentro do formulrio. Os procedimentos
seguem o padro Windows: voc seleciona o controle que deseja copiar/cortar e depois executa
o comando de colagem na posio onde dever ser inserido:

- Selecione o controle que deseja copiar e/ou recortar;
- Acione o menu de contextos dando um clique com o boto direito do mouse;
- Selecione a opo Copiar ou a opo Cortar.

Para colar os objetos copiados, acionamos novamente o menu de contexto e selecionamos a
opo Colar.

Visual Kit 5 Verso 6.0.4.2
62

Fig 49 Menu de contextos.

Alinhamento de controles
s vezes, posicionar vrios controles alinhados resulta uma tarefa difcil de realizar
manualmente ou simplesmente chata. Voc poder alinhar os controles de uma maneira rpida
e fcil da seguinte forma:

- Acione o menu de contextos dando um clique com o boto direito do mouse em uma
rea do formulrio em que no haja controles no mesmo;
- Selecione a opo Ajustar Campos no menu de contextos. E pronto!


Fig 50 Antes e depois de ajustar os controles.

Definindo ordem de tabulao
A ordem de tabulao dos campos em um formulrio a ordem em que os objetos so
selecionados ou focados quando o formulrio j est em funcionamento. Foco o termo que
usamos para descrever o campo que detm o controle no momento. Quando um campo recebe
um clique ou ativado por meio da tecla TAB, ele ganha o foco.

Nesta fase de desenho, voc pode decidir a ordem de tabulao dos controles, que determinar
por sua vez a ordem em que ser feita a entrada de dados no sistema quando o formulrio entre
em funcionamento.

- D um clique com o boto direto do mouse em uma rea do formulrio em que no haja
controles no mesmo para acionar o menu de contextos;
- Com o ponteiro do mouse selecione Ordenar Tabulao na janela.;
Visual Kit 5 Verso 6.0.4.2
63
- Ao selecionar a Ordem de Tabulao sero apresentadas umas caixinhas com os
nmeros correspondentes ordem de acesso aos controles, conforme mostra a Fig 51;
- Clique vrias vezes em cima do nmero at que fique na ordem desejada.
- Pule para a prxima caixinha que automaticamente a anterior ficar fixada ficando de
cor cinzenta.


Fig 51 Ordem de tabulao.


Nota
Os campos chaves recebem o primeiro foco.
Os controles ou objetos que nunca ganham foco como o Label no precisam da ordem de
tabulao.



A janela de propriedades uma janela fundamental no desenvolvimento dos seus formulrios,
j que por meio dela voc personalizar tanto o visual dos controles como o funcionamento dos
mesmos.

Visual Kit 5 Verso 6.0.4.2
64
As propriedades simplesmente so as caractersticas especifcas de cada controle. A inteno
desta janela concentrar num lugar s todas as propriedades relativas ao controles, e assim
facilitar o acesso e manuseio das mesmas.

Em resumo, desenhar o formulrio consiste nos seguintes passos:
- Inserir os controles nos formulrios
- Distribu-los e dimension-los de forma clara e objetiva.
- Alterar os valores de suas propriedades para personaliz-los, incluindo tambm certas
regras de negcio.

Entendendo as Propriedades
Dois elementos formam parte de qualquer propriedade, o nome da propriedade, que identifica a
caracterstica a ser manipulada, e o valor que especifica seu contedo. Por exemplo:


Nome Valor
Altura 400
Largura 560
Alinhamento Esquerda 50
Alinhamento Direita 20


Cada tipo de controle tem um conjunto de propriedades que possuem um valor inicial ou
default. O que um valor default?. Se voc simplesmente inserir vrios controles no
formulrio conforme estudamos anteriormente sem alterar nenhum valor das propriedades dos
formulrios, salvar o sistema e rodar ele, o mesmo apresentar algumas caractersticas, como
por exemplo a cor cinza do fundo do formulrio, pois bem, tais caractersticas so os valores
default das propriedades.

A maioria das propriedades pode ficar default, e voc ter que ajustar e definir apenas os
poucos que interessam ao controle sendo definido.

Manipulando a Janela de Propriedades
Para acionar a janela de propriedades, basta selecionar o controle do qual voc deseja
visualizar as propriedades que automaticamente a janela de propriedades assumir os valores
do controle selecionado. O contedo da janela de propriedades poder variar com o tipo de
controle selecionado, pois cada controle possui um conjunto de propriedades particulares.

Caso voc selecione vrios controles de maneira conjunta, aparecer exclusivamente as
propriedades comuns dos controles selecionados.

Observe a Fig 52, vamos localizar as reas disponveis na janela de propriedades. Note que
existem propriedades com um fundo azulado e outras com fundo branco. As propriedades com
fundo azulado so as relacionadas ao banco de dados e as propriedades de fundo branco so as
relacionada estritamente com a esttica ou parte visual do formulrio.
Visual Kit 5 Verso 6.0.4.2
65

Fig 52 Apresentao da janela de propriedades

Coluna de Propriedades
A janela de propriedades est dividida em duas colunas. A primeira lista o nome de todas as
propriedades disponvel para o controle ou conjunto de controles selecionados.

Coluna de Valores
Esta coluna apresenta o valor atual da propriedade imediatamente sua esquerda. A alterao
da propriedade pode se executada de diferentes formas:

Caso o valor da propriedade seja uma seqncia de caracteres (string). Como exemplo vamos
mudar o valor default do ttulo da pgina do formulrio da seguinte maneira.

- Selecione a entidade
- Selecione a janela do prprio formulrio - d um clique em uma rea em que no haja
controles no mesmo.
- D um clique na propriedade Ttulo da Pgina. Note que aparecer uma entrada de
dados na parte superior da janela de propriedades.
- Digite o novo valor, por exemplo Testando.
- Clique no boto Salvar e confirme; ou clique em outra propriedade ou selecione outro
controle do formulrio.

Visual Kit 5 Verso 6.0.4.2
66
Algumas propriedades possuem valores preestabelecidos. Neste caso, voc poder alter-los
selecionando a propriedade de uma lista apresentada. Veja a seguir o exemplo de alterao
deste tipo de propriedade.

- Selecione a entidade
- Selecione um controle TextBox do formulrio.
- D um clique na propriedade Tipo de Campo. Note que aparecer uma ComboBox (
voc j sabe que uma ComboBox) com a lista das propriedades na parte superior da
janela de propriedades.
- Clique no novo valor, por exemplo campo tipo N- Numrico e pronto.

Existem tambm propriedades de manipulao de cores. Nestes casos apresentada uma
paleta de cores, basta dar um clique na cor desejada e pronto. Veja no exemplo:

- Selecione o prprio formulrio e d um clique em uma rea em que no haja controles
no mesmo.
- D um clique na propriedade Cor de Fundo. Esta propriedade altera a cor de fundo dos
controles.
- Note que aparecer um boto com reticncias na entrada de dados. Clique sobre ele e
ser apresentada uma paleta de cores.
- D um clique na cor desejada e pronto.

rea de Descrio
Para cada elemento listado na janela de propriedades que voc selecionar, a descrio
mostrada na parte inferior da janela. Note tambm que usar a janela de propriedades um
eficiente meio de aprender usando.

Visual Kit 5 Verso 6.0.4.2
67
VI. A Designer-Bsica

Principais controles

Como vimos anteriormente, o Visual Kit 5 traz consigo um conjunto de controles ou objetos.
Voc pode ser muito criativo utilizando o mesmo controle para diferentes finalidades, no
entanto, cada um deles possui uma representatividade especfica estabelecida nas aplicaes
Windows.

Nesta seo, voc ver as finalidades de cada controle e as propriedades inerentes a ele. Como
voc deve haver notado, algumas propriedades esto disponveis para vrios tipos de controles,
ento para no ser repetitivo, comentaremos tais propriedades uma nica vez.



Form Formulrio


Fig 53 Visual do objeto Form - tela do formulrio

A tela do formulrio, tambm chamada de objeto Form, basicamente o principal objeto da
interface criada pelo Visual Kit 5. Este objeto permitir que voc insira outros objetos nele
Visual Kit 5 Verso 6.0.4.2
68
com a finalidade de criar as telas de sua aplicao. Vejamos na seguinte tabela algumas das
propriedades do Form.

PROPRIEDADE DESCRIO
Altura Permite definir a altura do controle
Largura Similar a propriedade anterior, permite definir a largura do objeto.
Cor da Pgina Define a cor da pgina do formulrio.. Para a mudar a cor, localize o
boto com reticncias. Clique sobre ele e ser apresentada uma paleta
de cores padro Windows para seleo -veja na Fig 54. Selecione uma
cor e pronto veja na Fig 55.
Cor de Fundo Define a cor nas reas fora da pgina. Procedimento idntico ao
anterior.
Nmero de Pginas Define nmero de pginas dentro do formulrio. Veja na Fig 56. Esta
propriedade muito til quando o formulrio possui muitos campos que
no cabem numa tela s.



Fig 54 Mudando a cor da pagina do formulrio.

Visual Kit 5 Verso 6.0.4.2
69

Fig 55 Formulrio com nova cor de pagina




Fig 56 Formulrio com trs paginas.


TextBox.


Fig 57 Visual da TextBox

Este um controle simples, mas fundamental no desenvolvimento de sistemas. Podemos
afirmar que o TextBox um pequeno editor de textos (numa nica linha) que por meio dele
criamos as entradas de dados bsicas dos formulrios.

Quando voc insere um TextBox no formulrio, O Visual Kit 5 fornece os principais recursos
de texto para esse controle. Voc poder copiar, recortar e selecionar textos usando as teclas
padro do Windows. Na tabela veja algumas das propriedades disponveis para este controle.
Visual Kit 5 Verso 6.0.4.2
70

PROPRIEDADE DESCRIO
Nome do Campo Esta propriedade uma das mais importantes e est disponvel para todos
os controles do Visual Kit 5. Por meio dela voc poder atribuir um nome
que identificar o controle dentro do formulrio.
Nas tabelas associadas aos formulrios, os nomes das colunas vo assumir
o nome desta propriedade.
Por default, cada controle possui um nome, geralmente o mesmo texto da
propriedade Ttulo do Campo.
Nmero mximo de caracteres para o nome dez (10)
Tipo do Campo Define o tipo de dado que o campo armazenar. O Visual Kit 5
preestabelece a seleo dos valores desta propriedade.

C-Carter: Qualquer texto.
N-Numrico: Nmeros inteiros ou fraes. Intervalo de -
.99999999999E+19 at .9999999999E+20
L-Lgico: Valor booleano. Verdadeiro (T) ou Falso (F). O valor deste
campo pode ser mudado usando a propriedade de Ps-Validao como
veremos adiante.
M-Memo: Campo de tamanho variado. Refere-se a um bloco de dados.
G-Geral: (foto ou objeto OLE):
D-Data: data cronolgica constituda de dia, ms e ano. Intervalo
01/01/100 at 12/31/9999
Tamanho do
Campo
Especifica o nmero mximo de caracteres que o TextBox poder receber.
Caso o Tipo de Campo seja numrico a vrgula decimal contar como
caracter.
Decimais Especifica o nmero de dgitos direita da vrgula decimal. Propriedade
ativa somente quando o Tipo de Campo numrico.
Chave Primria Especifica se o campo associado ao controle chave primria. Verdadeira
chave primria ou Falso- no chave.
Pr-Validao No estritamente uma propriedade e sim uma funo que ser executada
antes do campo receber o foco. Estas funes sero debatidas em captulo a
parte.
Ps-Validao No estritamente uma propriedade e sim uma funo que ser executada
aps o campo perder o foco. Esta propriedade ser descrita em captulo a
parte.
Relacionamento Especifica com qual entidade este campo estar relacionado. Neste caso ele
receber as propriedades do campo chave da entidade relacionada. Durante
o funcionamento o TextBox poder receber unicamente valores includos
previamente no campo chave da entidade relacionada.
Posio do
Campo no
Arquivo
Especifica a ordem interna (no visual) do controle dentro do formulrio.
Coincide com a ordem do campo a coluna dentro da tabela associada ao
formulrio.
Ttulo do Campo Descrio do campo. Ser a maneira de como o campo aparecer nas
operaes de consultas e relatrios. No tem limite de caracter, mas
Visual Kit 5 Verso 6.0.4.2
71
procure sempre ser breve nas definies.
Formato do
Campo
Especifica o formato em que ser recebido e guardado o contedo do
TextBox.. Ver no Apndice
Mscara de
Edio
Especifica a mscara ou a maneira que o contedo ser exibido na tela do
computador ou em relatrios. Ver no Apndice
Formato de senha Especifica um caracter que dever ser apresentado sempre que houver uma
digitao dentro do TextBox. Independente do valor especificado para esta
propriedade sempre ser armazenado o valor real digitado pelo usurio.
Nome da Fonte Esta propriedade permite alterar caractersticas de letras que podem ser
utilizadas para o texto em questo. Para alterar o valor desta propriedade,
d um clique nela; isto exibir uma caixa de seleo para selecionar a
fonte.



ListBox


Fig 58 Visual do ListBox

O controle cria uma caixa de listagem, onde exibe uma lista de itens para que o usurio possa
selecion-los. Voc dever utilizar o ListBox sempre que tiver de fornecer vrias opes ao
usurio, como por exemplo, uma lista de profisses dentro de um cadastro de clientes. A lista
pode ser rolada se tiver um nmero de itens superior ao que pode ser exibido de uma s vez.


PROPRIEDADE DESCRIO
Relacionamento Identifica a entidade a que estar relacionado ao controle. Na entrada de
dados ser mostrada os nomes das tabelas segundo o padro Visual Kit
5.
Dica sobre o campo Insira aqui o texto que ser apresentado em uma caixa de texto
amarelada (conhecida como ToolTip), quando o ponteiro do mouse fica
sobre o controle por alguns segundos


O controle ListBox dever obrigatoriamente estar relacionado a uma segunda entidade que
gerenciar e armazenar a lista de itens. Esta entidade dever contar com no mnimo dois
campos: o campo chave primria da lista - por exemplo o cdigo da profisso- , mais um outro
campo, - por exemplo nome da profisso. Na lista do controle ListBox aparecer sempre o
Visual Kit 5 Verso 6.0.4.2
72
segundo campo da entidade relacionada, mas gravar na entidade atual o campo chave da
entidade relacionada. Para maior compresso implementaremos o seguinte exemplo.

Exemplo de sistema com entidades relacionadas.

A proposta lembre-se sempre de fazer a proposta antes de comear a desenvolver qualquer
sistema: Vamos criar um sistema composto por um mdulo e duas entidades. O mdulo
Cadastro e as entidades Clientes e Profisso. O objetivo da entidade Clientes ser gerenciar
diferentes informaes referentes a clientes, por exemplo: nome completo, profisso, sexo, etc.
Como exigncia, o contedo do campo profisso deve constar numa lista pr-estabelecida de
profisses. O objetivo da entidade Profisso ento ser precisamente gerenciar esta lista.

- Crie um mdulo e as duas entidades da mesma maneira explicada no captulo IV


Fig 59 Criamos o Mdulo Cadastro com as Entidades Clientes e Profisso

Desenhemos primeiramente o formulrio da entidade Profisso.
- Insira dois controles TextBox com seus respectivos rtulos (Label) identificativos.
- O primeiro campo, ser o cdigo da profisso e campo chave primria. Mude a
propriedade Nome do Campo para CodProf por exemplo e o Ttulo do Campo para
Cdigo da Profisso.


Fig 60 Formulrio da entidade Profisso

Visual Kit 5 Verso 6.0.4.2
73

Ateno: importante mudar a propriedade Nome do Campo dos campos chaves. Se
deixar os valores default, ao ser relacionado o campo em outra entidade, pode ser que coincida
com algum outro nome default dessa entidade, aparecendo dois campos com o mesmo nome.
Isto causar um erro na execuo. Recomendamos colocar nomes para cada campo que o
identifiquem segundo o tipo de informao que vai gerenciar.


- Desenhemos agora o formulrio Clientes. Coloquemos os controles TextBox para os
campos Cd. do Cliente e Nome.
- Insira um controle ListBox. Este campo estar relacionado com a entidade Profisso,
portanto, preciso definir o relacionamento.


Fig 61 Formulrio da Entidade Clientes
Para inserir a propriedade de relacionamento:

- D um clique sobre a propriedade Relacionamento. Aparecer uma entrada de seleo
com as tabelas do sistema (neste caso a entidade Profisso ou 01002- segundo padro
Visual Kit 5, veja no Apndice 0).
- D um clique sobre ela e ser relacionada.
- Salve agora o sistema. Antes de fechar a seo de desenho aparecer a janela de tabelas.
D um clique no boto OK.

Visual Kit 5 Verso 6.0.4.2
74

Fig 62 Fechando a seo de desenho de formulrio
Vejamos como ficou nosso sistema relacionado. Vamos execut-lo como foi explicado no
captulo IV.

Primeiramente, escolhemos a entidade Profisso para cadastrar vrias profisses. Cadastre
vrias profisses. Na Fig 90 aparece a consulta de algumas profisses cadastradas como no
exemplo.


Fig 63 Profisses cadastradas.
Vamos incluir agora diferentes clientes e ver como funciona o relacionamento entre as
entidades. O formulrio dos clientes ficou como mostra a Fig 91. Ele possui uma lista para
seleo, com as profisses cadastradas no passo anterior...Bonito eh!...

Visual Kit 5 Verso 6.0.4.2
75

Fig 64 Formulrios de Clientes com ListBox

Cadastramos vrios clientes, use nome de amigos, namorada, familiares, etc... Vamos dar uma
olhada usando a operao de Consulta e ver como esto sendo gravados os dados?. A primeira
e a segunda coluna gravaro o cdigo e o nome do cliente respectivamente, j a terceira coluna
ficou com o cdigo da chave das profisses. Veja na Fig 92.


Fig 65 Consulta da Entidade Clientes.







Visual Kit 5 Verso 6.0.4.2
76


ComboBox:


Fig 66 Visual do controle ComboBox

O ComboBox combina uma caixa de texto (TextBox) com uma listagem de opes (ListBox).
Como o ListBox, o ComboBox permite exibir uma lista de opes para o usurio, mas com a
seguinte diferena:

- No ListBox o usurio dever sempre dar um clique no item desejado e, no ComboBox, o
usurio poder tanto selecion-lo quanto digit-lo no TextBox por ele apresentado.
- Um ListBox sempre apresentar uma poro da lista, estar sempre aberto ocupando
mais espao no formulrio. O ComboBox poder ser apresentado fechado.
- Voc dever utilizar o ComboBox sempre que quiser exibir uma lista de opes ao
usurio e no houver muito espao livre em sua interface, ou caso voc deseje oferecer
duas formas de o usurio especificar o item desejado: selecionado-o ou digitando-o.

O ComboBox igual que o ListBox precisa de uma outra entidade que controlar e armazenar a
listagem das opes. Por tanto, um controle que precisa estar relacionado com outra entidade.

Para ver como funciona, vamos criar um outro sistema idntico ao anterior, substituindo o
controle ListBox pelo ComboBox . Tudo feito da mesma maneira, para tanto vamos pular a
descrio, mas no esquea de colocar a propriedade de relacionamento.



Fig 67 Colocando o controle ComboBox
Vejamos como funciona este controle:
- Voc clica no controle e aparece a lista de profisses, veja na Fig 96;
Visual Kit 5 Verso 6.0.4.2
77
- Selecione a profisso;
- E o controle fechado novamente como mostra a Fig 97.



Fig 68 Cadastrando Clientes usando o ComboBox


Fig 69 No final da seleo o ComboBox fecha novamente.

Visual Kit 5 Verso 6.0.4.2
78


CheckBox e OptionGroup


(a) (b)
Fig 70 Visual dos objetos CheckBox (a) e OptionGroup (b)

O CheckBox e o Option so controles que permitem disponibilizar opes ao usurio,
funcionando como um flag que poder ser ativado ou desativado.

Eles so bastante semelhantes, no entanto, o Option sempre dever ser utilizado em grupo,
permitindo oferecer opes ao usurio, para que ele possa selecionar uma entre vrias
disponveis. J o CheckBox uma caixa de verificao individual, que pode conceitualmente
ser usada em grupo colocando-a juntas, onde o usurio pode ativar ou desativar quantos
CheckBox forem necessrios.

Seguindo o exemplo de cadastro de clientes, um controle Option poderia identificar o sexo,
masculino ou feminino, j um conjunto de CheckBox indicaria por exemplo se o cliente possui
casa prpria, carro, carto de crdito, plano de sade, etc.

A incluso do objeto CheckBox muito similar ao objeto TextBox, basta selecion-lo e inseri-
lo no formulrio. Observe que este controle tem certas propriedades que podem parecer iguais,
mas que representam coisas bem diferentes:


PROPRIEDADE DESCRIO
Nome do Campo Identifica o campo dentro do formulrio e da tabela associada.
Nmero mximo de caracteres para o nome dez (10).
Ttulo do Campo Descreve o campo em operaes de consultas e relatrios.
Texto o rtulo associado ao controle que aparece na tela do formulrio.


Quando inclumos um Option na tela do formulrio, aparecer uma janela Assistente de
Criao. Nesta janela definimos o nmero de opes no grupo e a descrio das opes. Veja
na Fig 71. Caso precise fazer alteraes no controle depois de inserido, selecione-o e clique
com o boto direito do mouse, aparecer um menu conforme aparece na Fig 72; clique agora
em Editar e aparecer novamente a janela Assistente de Criao.

Visual Kit 5 Verso 6.0.4.2
79

Fig 71 Janela Assistente de Criao do controle Option


Fig 72 Editando o controle Option

Vejamos na Fig 73 como foi complementado nosso formulrio com as novas entradas de
dados.
.
Visual Kit 5 Verso 6.0.4.2
80

Fig 73 Formulrio Clientes com ComboBox, Option e Checkbox

Na Fig 74 mostramos a consulta de vrios clientes cadastrados usando este formulrio. Note
que somente foi criado um campo para o controle Option onde: o nmero 1 indicar sexo
feminino e o nmero 2 o sexo masculino. Por outro lado para cada CheckBox foi criado um
campo, onde T-(True) indica Verdadeiro que significa que foi selecionada e F (False) Falso
que indica que ficou vazia. Viu que fcil!.


Fig 74 Consulta de clientes cadastrados na entidade Clientes.





Visual Kit 5 Verso 6.0.4.2
81



Spinner


Fig 75 O controle Spinner.

O Spinner um controle de rotao, usado para aceitar entrada numrica que pertence a
determinado intervalo.

PROPRIEDADE DESCRIO
Valor Mximo Valor numrico mximo que o controle atinge
Valor Mnimo Valor numrico mnimo que o controle atinge



Imagem



Fig 76 Imagem
PROPRIEDADE DESCRIO
Imagem Caminho da imagem




Fig 77
Visual Kit 5 Verso 6.0.4.2
82

Incluindo funcionalidades nos controles

Quando desenvolvemos sistemas, com certeza, vamos querer que ele realize algumas cositas
ms... alm da incluso, alterao e excluso de dados. Por exemplo: preenchimento
automtico do campo, uso de clculo de vrios campos, impedir que um campo fique vazio,
aceitar um valor numrico num determinado intervalo, etc.

Para poder colocar funcionalidades deste tipo, basta preencher uma (ou as duas) das
interessantes propriedades de Pr-validao e Ps-validao com pequenos cdigos que
descrevemos neste captulo.

Quando este cdigo colocado na Pr-validao de um determinado campo, ele executado
quando o campo focado ou acessado. Os cdigos colocados na Ps-validao sero
executados aps a sada do mesmo. Pode ser que determinado campo tenha simultaneamente
Pr e Ps-validao.


Nota
Foco: Diz-se que um controle num formulrio ganha ou perde o foco quando ele se torna ou
deixa de ser o objeto atualmente selecionado, seja por ao do usurio ou programaticamente.
Esses eventos so temporalmente vizinhos.



Veja na Fig 78 onde so localizadas a Pr-validao e Ps-validao na janela de
propriedades.

Visual Kit 5 Verso 6.0.4.2
83

Fig 78 Pr-Validao e Ps-Validao na janela de propriedades.

Algumas das funcionalidades a serem criadas usando as funes pr e/ou ps-validao de um
determinado campo precisaram acessar o contedo de outros campos do formulrio. Como,
estando focado em um determinado campo, acessar o contedo de outro campo? Isto ser
respondido ainda neste captulo.

Acessando dados pelo vetor Vdados

No Visual Kit 5, para poder acessar e manipular os dados dos campos durante a pr ou a ps-
validao, usado um registro chamado de vetor vdados.


Nota
Vetor: uma coleo de dados que compartilha o mesmo nome e possui um nmero, chamado
de ndice, o qual permite identificar o elemento que desejamos manipular.

A quantidade de elementos deste vetor coincide sempre com a quantidade de campos que o
formulrio contm. Na Fig 79 colocamos um exemplo abstrato de um simples formulrio com
quatro campos para melhor entendimento.
Visual Kit 5 Verso 6.0.4.2
84


Fig 79 ndices do vetor vdados.
Neste caso o vetor vdados formado por quatro (4) elementos. Os elementos do vetor so
acessados de duas formas, de maneira direta e de maneira referenciada.

Na primeira, o vetor indicar o contedo dos campos atravs de ndices da seguinte forma:

Campo1 vdados[1]
Campo2 vdados[2]
Campo3 vdados[3]
Campo4 vdados[4]

Na janela de propriedades existe uma propriedade chamada de Posio do Campo no
Arquivo que indicar a posio do campo dentro do vetor vdados. Esta posio pode ser
modificada mudando a ordem de tabulao, descrita anteriormente.

A outra variante para acessar o valor do campo atravs do vetor vdados, fazendo referncia
com o prprio campo focado -dono das propriedades de pr ou ps-validao- e que
explicaremos a continuao usando um exemplo.

No exemplo colocaremos as duas maneiras de acessar o vetor vdados: usando o ndice direto e
referenciando pelo campo focado. Neste momento no necessrio entender como feito o
Visual Kit 5 Verso 6.0.4.2
85
clculo no exemplo, e sim compreender como os dados devem ser manipulados atravs da
estrutura vdados.

Suponha que voc tenha uma entidade de vendas, onde existe os seguintes campos: cdigo do
cliente, valor do produto, a porcentagem do desconto cedido e logo aps um campo onde
entrar o resultado do clculo total com o desconto. Para calcular o valor do campo Total de
maneira automtica inserimos na propriedade Pr-Validao do prprio campo o seguinte
cdigo:


Fig 80 Exemplo usando o vetor vdados
Usando o ndice direto:

AltVal(vdados, 4, (vdados[2] - (vdados[2] * vdados[3])/100))

onde, vdados[2] o Valor da Compra e vdados[3] o Desconto.

Vejamos agora usando o ndice referenciado ao campo focado (neste caso o campo Total). O
acesso feito da seguinte forma:

Cdigo do cliente Vdados(i-3)
Valor da compra Vdados(i-2)
Desconto Vdados(i-1)
Total Vdados(I) Campo focado na pr-validao

A propriedade Pr-Validao tem agora o seguinte cdigo:

AltVal(Vdados, I, (Vdados[i-2] - (Vdados[i-2] * vdados[i-1])/100))

Partindo do princpio que o cursor acabou de focar ou entrar no campo Total (Vdados[i]), o
clculo ser realizado a partir do campo Valor da Compra (Vdados[i-2]) porque est a duas
Visual Kit 5 Verso 6.0.4.2
86
posies acima do campo com o foco, e do campo Desconto que o campo anterior
(Vdados[i1]).

As duas formas, so anlogas e do o mesmo resultado. A diferena radical que, se por acaso,
decidido incluir mais um campo seguido ao cdigo do cliente, com por exemplo o Nome do
Cliente, ser preciso modificar o cdigo feito usando o ndice direto. J o cdigo feito usando o
ndice referenciado no precisar ser mudado, se mantida a ordem dos campos acessados na
pr-validao.


reas de relacionamento - acessando
contedos de outras entidades.

Na seo anterior vimos como fcil acessar o contedo dos campos dentro de um mesmo
formulrio ou entidade. Vejamos agora a maneira de acessar campos de outras entidades
relacionadas.

O acesso a campos de outras entidades e feito atravs das reas de Relacionamento. Quando
uma entidade do sistema aberta, automaticamente so disponibilizadas diferentes reas de
memrias do computador. aberta uma rea para a prpria entidade e tantas quantos
relacionamentos tenha com outras entidades.

reas de relacionamento so diferentes reas de memrias do computador que so
disponibilizadas para cada relacionamento do formulrio que o usurio esteja usando no dado
momento. Estas reas so identificadas com nmeros inteiros, ex. 1; 2; 3; etc. e o nmero vai a
depender da ordem no formulrio dos campos com relacionamento. Por exemplo:

a) rea 1: rea aberta para a prpria entidade.
b) rea 2: rea para a primeira entidade relacionada pelo campo, segundo a Posio do
Campo no Arquivo ou ordem de tabulao.
c) rea 3: rea para a segunda entidade relacionada. E assim por diante.

Vejamos no exemplo: digamos que voc criou uma sistema com trs entidades: Clientes,
Produtos e Pedidos. E que a entidade Pedidos como de supor est relacionada com Clientes e
com Produtos. Se dentro do formulrio Pedidos o campo de relacionamento com Clientes tem
o valor da propriedade Posio do Campo no Arquivo menor que o do campo de
relacionamento com a entidade Produtos, ento quando acessamos o formulrio Pedidos, as
reas abertas estaro da seguinte maneira.

a) rea 1: rea aberta para Pedidos.
b) rea 2: rea aberta para Clientes.
c) rea 3: rea aberta para Produtos.

Visual Kit 5 Verso 6.0.4.2
87
Agora, para acessar um campo especfico da entidade relacionada utilizada a seguinte
notificao:
letra_area->nome_campo.

onde, a letra_area a letra do abecedrio (Ingls) correspondente ao nmero da rea de
relacionamento, e o nome_campo o nome do campo especfico que queremos acessar.

Seguindo o exemplo anterior, se por exemplo, dentro do formulrio Pedidos usamos alguma
Pr ou Ps-validao que precisa manipular o campo Nome da entidade Cliente e o campo
Tipos da entidade Produtos, estes campos sero identificados da seguinte maneira:

Campo Nome de Cliente: b->Nome
Campo Tipo de Produtos: c->Tipos

Vejamos agora como estes conceitos aqui abordados so usados nas funes de validao.

Funes de validaes (pr e ps)

Nesta seo colocaremos as validaes que podem ser inseridas na Pr e Ps Validao na
janela de propriedades.

Exibe caixa de mensagem: Funo ferrmsg()
Exibe caixa com mensagem na parte superior direita do monitor.


Fig 81 Caixa da mensagem
Sintaxe:
ferrmsg("texto da mensagem", segundos)
em que:
- texto da mensagem: expresso em caracter (string) que ser apresentada como
mensagem na caixa exibida pela funo.
- segundos: especifica a quantidade de segundos que a mensagem vai permanecer.

Observaes:
- O texto da mensagem. deve estar entre aspas duplas (...).
- Caso voc queira colocar o contedo de um campo numrico na mensagem, dever
utilizar a funo str() que transforma o valor numrico em caracter. Veja nos exemplos.
- Caso no seja colocado o valor em segundos, o programa aguardar at ser pressionada
uma tecla.
- Esta funo ideal para colocar mensagem e erro para o usurio.

Exemplos
Visual Kit 5 Verso 6.0.4.2
88
ferrmsg(Data invalida) : exibir a mensagem e aguardar at o operador pressionar alguma
tecla
ferrmsg(Hora invalida,2): exibir a mensagem por 2 segundos
ferrmsg(voc digitou+ str(vdados(I))): Far uma concatenao da expresso em caractere
com o campo numrico usando o signo de soma.


Contedo automtico - Funo altval()
Esta funo insere ou altera automaticamente o contedo de um campo acessando atravs do
vetor vdados.

Sintaxe:
altval(vdados,I,Novo valor)
em que:
- vdados: o vetor de entrada de dados do sistema.
- I: posio ou ndice atual do campo;
- Novo Valor: valor que ser atribudo ao campo.

Vejamos em exemplos concretos como funciona esta funo:

Retorna clculos matemticos
altval(vdados, I, ( (vdados[I-1] * 8) / 100 ) )
Neste caso, estamos atualizando o campo atual com 8% do valor do campo anterior. Este
campo e o campo anterior devem ser de tipo NUMRICO.

altval(vdados, I, ( vdados[I - 1] * vdados[I - 2] ) )
Neste caso, atualiza o campo atual com a multiplicao dos campos anteriores. Este campo e
os campos anteriores devem ser de tipo NUMRICO.

Somar dias a um campo data
altval(vdados, I, vdados[I] + 15 )
Neste caso, soma 15 dias data digitada. Este campo dever ser um campo do tipo DATA.

Retorna o dia de uma data
altval(vdados, I, day( date() ) )
Neste caso, pega o dia da data do sistema. Este campo dever ser um campo do tipo
NUMRICO.

Retorna o ms de uma data
altval(vdados, I, month( date() ) )
Pega o ms da data do sistema. Este campo dever ser um campo do tipo NUMRICO.

Retorna o ano de uma data
altval(vdados, I, year( date() ) )
Visual Kit 5 Verso 6.0.4.2
89
Neste caso estamos pegando o ano da data do sistema. Este campo dever ser um campo do
tipo NUMRICO.

Retorna hora do sistema
altval(vdados, I, time() )
Neste caso, coloca a hora do computador no campo atual. Este campo dever ser um campo do
tipo CARACTER com 5 posies.

Retorna contedo de entidade relacionada.
altval(vdados, I, B->NOME )
Coloca o campo NOME de uma entidade relacionada no campo atual. Este campo dever ser
um campo de tipo e tamanho idnticos ao campo da entidade relacionada.


Coloca valor default - Funo rep_()
Preenche o campo automaticamente com o valor passado como parmetro. Agilizando a
digitao do usurio do sistema. Caso necessrio, este valor poder ser modificado pelo
ousurio.

Sintaxe:
rep_(exprCN)
em que:
exprCN- o contedo a ser colocado como default.

Exemplos:
rep_( "RIO DE JANEIRO" ): Coloca RIO DE JANEIRO no campo. Ideal para casos como:
formulrio de cadastro de clientes onde a maioria more em uma cidade em especfica. rep_(
021 ): Repete 021 em campo numrico. Ex.: cdigo de rea.
rep_( date() ) Repete a data de hoje sempre que teclar ENTER.


Cria cdigo seqencial automtico - Funo seq_()
Cria um cdigo seqencial.

Sintaxe:
seq_()
em que:

Esta funo cria um nmero seqencial tanto em campos caracteres como em campos
numricos. Ao teclar ENTER no campo, ela pega o ltimo valor digitado no arquivo e
acrescenta um, seno aceita o valor digitado.
Ideal para ser utilizada em campos que armazenam algum cdigo tipo Cdigo do Cliente.


Visual Kit 5 Verso 6.0.4.2
90
Impede campo vazio-Funo !empty()
Verifica se um campo ou no vazio. Retorna TRUE (.T.) se o campo for vazio, independente
do seu tipo (caractere, numrico, data...).

Sintaxe:
!empty( exprC )
em que:
exprC: referencia ao campo pelo vetor vdados

Exemplo
!empty ( vdados[I] ) ; Impedir que o campo atual fique vazio, ideal para campos importantes
e usurios no atenciosos ...


Limita o contedo do campo
Em determinadas ocasies queremos colocar determinadas condies ou limites, por exemplo:
o tipo de caracter que poder ser armazenado ou um valor numrico em determinado intervalo.
Vejamos em exemplos como pode ser feito.

Aceita S (Sim) ou N(No)
(vdados[I] $ "SN")
A funo $ verifica se uma seqncia de caracteres est contida na expresso. Retorna TRUE
(.T.) se a seqncia for encontrada.

Aceita valor num intervalo
O intervalo criado usando os operadores lgicos AND e OR que significam respectivamente
E e OU.

(vdados[I] >= 1 .and. vdados[I] <= 10)
Aceita valor no campo atual no intervalo maior ou igual a 1 e menor ou igual a 10. Ou seja,
vdados[I] deve ser ao mesmo tempo maior ou igual que 1 e menor ou igual a 10.

(vdados[I] > 100 .or. vdados[I] < 10)
Aceita valor no campo atual se o valor for maior que 100 ou menor que 10.

Aceita um perodo de datas
(vdados[I] >=(date()-15) .and. vdados[I] <= date())
Aceitas datas entre dos ltimos 15 dias







Visual Kit 5 Verso 6.0.4.2
91
No permite contedo duplo - Funo dup_chk()
Faz pesquisa indexada para verificar se o registro que est sendo digitado se existe ou no no
arquivo. Se o registro j existir, exibe mensagem de erro e no permite a incluso.

Sintaxe:
dup_chk(vdados[I], rea,"mensagem,tipo,I,impre[,order])
em que:
- vdados[I]: o vetor vdados indexando o campo em que contm o valor que ser
pesquisado;
- rea: rea de relacionamento onde o arquivo que ser pesquisado foi aberto;
- "mensagem: mensagem de erro (entre aspas) que ser exibida.
- tipo: varivel ou valor lgico. Verdadeiro se a operao a ser executada for incluso.
Falso se for outra operao. A varivel tipo recebe um valor lgico e uma palavra
reservada do sistema. proibido criar um campo chamado tipo.
- I: indexador, que indica em qual elemento do vetor vdados o sistema est efetuando a
entrada de dados. Este argumento representado pela letra "I" maiscula.
- Impre: varivel lgica, que recebe um valor: Verdadeiro se a operao a ser executada
for de impresso, Falso se for outra operao. A varivel impre recebe uma palavra
reservada do sistema. proibido criar um campo chamado impre.
- order: argumento opcional e representa a ordem do indexador (set order).

Observao:
Esta funo retorna um valor lgico: verdadeiro se o valor pesquisado foi localizado, falso se
no.


Exibe contedo na tela Funo prt ()
Imprime na tela do formulrio usando um controle Label (Rotulo), o contedo de um campo da
entidade atual ou relacionada.

Sintaxe:
ptr(linha,coluna, contedo,fonte,tamanho,label,page)
em que:
- linha: Posio superior do objeto Label
- coluna: Posio a esquerda do objeto Label
- contedo: Pode ser o prprio contedo a ser exibido, ou algum campo referenciado
pelo vetor vdados ou campo relacionado pela rea
- fonte: Tipo de fonte a ser usada. Arial, Courier, etc.
- tamanho: Tamanho da fonte. Numero inteiro
- label: nome do Label usado para a impresso. Ex: Label005
- page: Como o formulrio pode possuir inmeras pginas. Este nmero indica a pgina
onde est o controle Label

Exemplo:
prt(162,68,vdados[I],"Arial",8,"label003",1)
Visual Kit 5 Verso 6.0.4.2
92
Imprime na janela do formulrio na posio (162,68) o contedo do campo atual.

prt(162,68,b->nome,"Arial",8,"label003",1)
Exibe na janela do formulrio, o contedo de um campo de uma entidade relacionada aberta na
rea 2. Ideal em casos deste tipo: Uma entidade de Pedidos, relacionada a uma entidade de
Clientes pelo cdigo do cliente. Digitando o cdigo do cliente em Pedidos, imprime o nome do
cliente na tela.


Salta campo - Funo slt()
Salta campo slt() . A funo slt(fieldN,scrN) pula para o campo desejado.

Sintaxe:
slt(fieldN,scrN)
em que:
- FieldN Campo para onde ir o cursor.
- ScrN Tela onde est o campo

Exemplo
slt(15,1) : O cursor pula para o campo 15 do formulrio 1


Pesquisa se chave existe Funo dbseek( )
Faz uma pesquisa indexada e retorna TRUE se encontrou a chave e FALSE se no encontrou a
chave. Esta funo pode ser utilizada em qualquer campo que possua um indexador ativo.

Sintaxe:
dbseek( Expr, [ ExprN1 ], [ExprN2 ] )
em que:
- Expr: Campo referenciado pelo vetor vedados e que ser pesquisado.
- ExprN1: rea de abertura para pesquisas em entidades relacionadas.
- ExprN2: ordem do indexador ativo.

Exemplos:
dbseek(vdados[I],2): Pesquisa na rea 2 se vdados[I] existe como chave.
dbseek(vdados[I],1,2) Pesquisa na rea 1 order 2 se vdados[I] existe como chave.


Busca ltima ocorrncia da chave - Funo bprx( )
Busca a ltima ocorrncia de uma chave na rea e order especificados.

Sintaxe:
bprx( ExprC1, ExprN1, ExprN2, ExprC2 )
em que:
- ExprC1: Chave para pesquisa.
Visual Kit 5 Verso 6.0.4.2
93
- ExprN1: rea de abertura.
- ExprN2: Order (set order).
- ExprC2: Campos que sero comparados com a chave.

Enquanto a chave for igual aos campos l arquivo, quando encontrar alguma diferena retorna
1 registro e volta. Se no for encontrado nenhum registro que satisfaa a condio retorna
EOF() TRUE.

Exemplo
bprx( vdados[1]+vdados[2], 1,1 "CONTA+BANCO" )


Altera contedo de outras entidades - Funo chg_data ()
Altera dados em entidades relacionadas com a entidade ou formulrio atual

Sintaxe:
chg_data(expN1 , expC1 , expL, expC2 , fieldN, expCN3 )
em que:
- expN1: rea de abertura do arquivo que ser atualizado;
- expC1: Chave para pesquisa da primeira ocorrncia no arquivo que ser atualizado;
- expL: Se argumento verdadeiro (.T.) a atualizao ser efetuada no primeiro registro
encontrado. Se argumento (.F.) a atualizao ser efetuada sob uma determinada
condio referenciada no prximo parmetro;
- expC2: Condio para atualizao de um grupo de registros;
- fieldN: Nmero do campo que ser atualizado.
- expC3: Expresso caracter ou numrica que ser atribuda ao campo destino.

possvel alterar dados em um nico registro ou num grupo de registros (while).

Exemplo
chg_data(2 , vdados[1] , .t. , , 7, B->QUANTIDADE+vdados[I] )
Neste exemplo, estaremos alterando o campo nmero 7, da entidade aberta rea 2,
relacionada pela chave vdados[ 1 ], e somando ao campo QUANTIDADE do arquivo na
rea 2 o valor digitado em vdados[ I ] da entidade atual.


Calcula o mdulo 11 - Funo mod11( )
Calcula o mdulo 11 de um campo e grava o dgito verificador (DV) no prximo campo

Sintaxe:
mod11(exprC, [ExprC] )

A funo mod11() calcula o mdulo 11 do campo passado como parmetro e coloca o valor
calculado (dgito verificador de 1 posio) no campo atual.
Visual Kit 5 Verso 6.0.4.2
94
O segundo parmetro opcional, deve ser uma letra. Ser o dgito verificador em caso de resto
igual a 10.

Exemplos:
mod11( vdados[I-1] ) Calcula o mdulo 11 do campo anterior e coloca o resultado no campo
atual.
mod11( vdados[I-1], P ) Calcula o mdulo 11 do campo anterior e coloca o resultado no
campo atual. Se resto igual a 10: DV igual a P.


Verifica hora - Funo validtime( )
Verifica se o contedo da varivel passada uma hora vlida

Sintaxe:
validtime(vdados[I])
em que:

Exemplo: 14:00.
O formato deste campo deve ser: @R 99:99.
Esta funo retorna um valor lgico: verdadeiro se a hora digitada for vlida, falso se no for.


Altera variveis do sistema - Funo altvar( )
Altera valor de varivel de programa do Visual Kit 5.

Sintaxe:
altvar(t_n, Novo valor)
em que:
- t_n: varivel que ser alterada.
- Novo valor: valor que ser atribudo ao campo.

Variveis so pequenos espaos de memria que armazenam valores para uso geral sendo que
valor armazenado poder ser modificado durante a execuo do programa. O Visual Kit 5
dispe cinco (5) variveis numricas (s armazenam nmeros) para serem utilizadas em
clculos gerais como totalizaes nos sistemas criados. Estas variveis so representadas
como: t_1; t_2; t_3; t_4 e t_5 e so todas inicializadas com valor zero.

Elas servem para armazenar valores entre os registros das tabelas, enquanto a incluso estiver
rodando, ou seja, caso o usurio feche a incluso e a abra novamente, as variveis perdero os
seus valores armazenados.


Alterar tamanho campo memo -Funo altmemo ()
Altera o tamanho da linha do campo tipo Memo na impresso de lay-out.

Visual Kit 5 Verso 6.0.4.2
95
Sintaxe:
altmemo(ExprN)
em que:
- ExprN: novo nmero de colunas por linha no campo tipo Memo.

O valor default de colunas por linha no campo tipo Memo de 78, voc pode alterar este valor
utilizando esta funo. No esquea de retornar ao valor original com altmemo(78).

Exemplo:
altmemo(90) Altera o valor da linha de 78 para 90.


Seleciona rea de relacionamento - Funo dbselect( )
Seleciona uma rea de trabalho.

Sintaxe:
dbselect( ExprN )
em que:
- ExprN: Nmero inteiro que indica a rea de relacionamento.

No esquea que sempre que for selecionada uma rea de trabalho voc deve retornar a rea
atual com dbselect( 1 ).

Exemplos:
dbselect( 2 ) seleciona rea 2.
dbselect( 3 ) seleciona rea 3.


Retorna ao registro atual - Funo goatu( )
Posiciona o ponteiro do arquivo no registro que est sendo includo ou alterado.
Esta funo deve ser utilizada sempre que voc alterar atravs da pesquisa o ponteiro do
registro atual para outro registro no arquivo corrente. Se voc alterar o ponteiro do arquivo e
no retornar, poder ocorrer um erro no momento da gravao do registro.


Vai para o incio do arquivo - Funo dbgotop( )
Posiciona o ponteiro do arquivo no primeiro registro.

Sintaxe:
dbgotop()



Visual Kit 5 Verso 6.0.4.2
96
Vai para o final do arquivo - Funo dbgobottom( )
Posiciona o ponteiro do arquivo no ltimo registro.

Sintaxe:
dbgobottom( )



Movimenta o ponteiro do arquivo - Funo dbskip( )
Movimenta o ponteiro do arquivo.

Sintaxe:
dbskip( [ ExprN ] )
em que:
- ExprN: um nmero inteiro. Se positivo, movimenta o ponteiro para frente, se
negativo, movimenta o ponteiro para trs. O valor indica os nmeros de registros.

Exemplos
dbskip( 2 ) movimenta o ponteiro dois registros para frente.
dbskip( - 3) movimenta o ponteiro trs registros para trs.


Grava dados em campo - Funo fieldput( )
Grava dados num determinado campo.

Sintaxe:
fieldput( FieldN, Valor )
em que:
- FieldN: nmero inteiro que indica o campo.
- Valor: Contedo a ser gravado.

Exemplo
fieldput( 2, "EBENDINGER" ): grava no campo nmero 2 do formulrio atual o nome
EBENDINGER.
fieldput(3, "BRASIL"): grava no campo nmero 3 do arquivo atual o nome BRASIL.


Exibe um controle objeto-imagem no formulrio Funo
prt_image( )
Exibe qualquer dado na tela. Este dado pode ser um campo do arquivo atual, campos de
arquivos relacionados, valores numricos, caracter, data e qualquer informao que possa ser
exibida no monitor

Sintaxe:
Visual Kit 5 Verso 6.0.4.2
97
prt_image( ExprN1, ExprC1, ExprN2 )

em que:
- ExprN1: Nmero que representa a posio no arquivo do campo que contm o
caminho da Imagem. ex: c:\widows\imagem.bmp
- ExprC1: Nome do controle imagem criado pelo Visual Kit 5. ex: "image001"
- ExprN2: Nmero da pgina onde ser exibida a imagem.

Exemplo:
prt_image(2,"image001",1)

Observao: A imagem somente ser exibida ao passar pelo campo que contm esta funo.
No colocar a funo Prt_image() antes do campo que contm o caminho da Imagem.


Criando validaes compostas

Usando o operador AND
Voc pode digitar uma ou mais funes no campo Pr ou Ps validao de Campo, usando o
operador AND para separar as funes.

Exemplo: seq_() and ferrmsg(Ao final salve tudo)



Usando o operador iif()
O operador iif(), tambm conhecido como operador condicional poder determinar qual funo
executar avaliando primeiramente uma expresso lgica.

Sintaxe:
iif(ExprL, validao1, validao2)
em que:
- ExprL: Expresso lgica que deve retornar Verdadeiro ou Falso.
- validao1: Validao a executar caso ExprL seja verdadeira
- validao2: Validao a executar caso ExprL seja falsa.

Observaes:

- A expresso lgica ExprL pode ser composta de vrias sub-expreses usando os
operadores AND (E) e OR (OU)
- Uma prpria validao , ex. validao1 pode conter outro operador iif()

Exemplos:

Visual Kit 5 Verso 6.0.4.2
98
a) iif(vdados[4]>1000,altval(vdados,4,vdados[4]* 5 ),altval(vdados,4,vdados[4]* 25))

Se o contedo do quarto campo for maior que 1000, multiplica o valor por 4, do contrrio
multiplica por cinco.

b) iff(vdados[3]>=1 and vdados[3]<10, ataval(vdados,3,vdados[3]*10),
ferrmsg(Nmero fora do intervalo!!))

Se o contedo do terceiro campo maior ou igual que 1 e menor que 10, ento multiplic-lo
por 10, caso contrrio exibe caixa de mensagem.

c) iff(vdados[3]>=1 and vdados[3]<10, iif(vdados[4]>1000,altval(vdados,4,vdados[4]*
5 ),altval(vdados,4,vdados[4]* 25)),ferrmsg(Nmero fora do intervalo!!))

Se o contedo do terceiro campo maior ou igual que 1 e menor que 10, ento fazemos outra
avaliao iif: (Se o contedo do quarto campo for maior que 1000, multiplica o valor por 4,
caso contrrio multiplica por cinco); do contrrio exibe caixa de mensagem.



Visual Kit 5 Verso 6.0.4.2
99
VII. A Designer-Pro: Novos
Recursos

Nesta seo abordaremos os recursos da DesignerPro, que consiste em novos
controles na caixa de ferramentas, assim como novos assistentes de criao e os editores de
Expreses, Macros e Cdigo.

Para acessar a DesignerPro sempre que voc definir uma nova entidade selecione
Formulrio Externo (veja a Fig 42). Ser aberta uma interface muito similar Designer
Bsica mais com muitos mais recursos.

Como voc deve ter notado, alguns controles esto disponveis em ambas designers, caso no
exista mudana na nova designer, no estaremos comentando o controle.

Repetiremos para vrios controles exatamente os mesmos procedimentos que na Designer-
Bsica. Note a diferena usando os assistentes de criao.

Principais controles da Designer-Pro



Novo ListBox


Fig 82 Visual do ListBox

O controle cria uma caixa de listagem, onde exibe uma lista de itens para que o usurio possa
selecion-los. Voc dever utilizar o ListBox sempre que tiver de fornecer vrias opes ao
usurio, como por exemplo, uma lista de profisses dentro de um cadastro de clientes. A lista
pode ser rolada se tiver um nmero de itens superior ao que pode ser exibido de uma s vez.


PROPRIEDADE DESCRIO
Relacionamento Identifica a entidade a que estar relacionado o controle. Na entrada de
dados ser mostrada os nomes das tabelas segundo o padro Visual Kit
Visual Kit 5 Verso 6.0.4.2
100
5.
Dica sobre o campo Insira aqui o texto que ser apresentado em uma caixa de texto
amarelada (conhecida como ToolTip), quando o ponteiro do mouse ficar
sobre o controle por alguns segundos

O controle ListBox dever obrigatoriamente estar relacionado a uma segunda entidade que
gerenciar e armazenar a lista de itens. Exemplo de uma entidade com dois campos: o campo
chave primria da lista - por exemplo o cdigo da profisso- , mais um outro campo, - por
exemplo, nome da profisso.

Voc poder escolher atravs de um Assistente de Criao- os campos que apareceram na
lista do controle ListBox. Este controle sempre gravar na entidade atual o campo chave da
entidade relacionada, inclusive quando esta no for selecionada para ser exibida no controle.
Para maior compresso implementaremos o seguinte exemplo.

Exemplo de sistema com entidades relacionadas.

A proposta lembre-se sempre de fazer a proposta antes de comear a desenvolver qualquer
sistema: Vamos criar um sistema composto por um mdulo e duas entidades. O mdulo
Cadastro com as entidades Clientes e Profisso. O objetivo da entidade Clientes ser gerenciar
diferentes informaes referentes a clientes, por exemplo: nome completo, profisso, sexo, etc.
Como exigncia o contedo do campo profisso deve constar numa lista pr-estabelecida de
profisses. O objetivo da entidade Profisso ento ser precisamente gerenciar esta lista.

- Crie um mdulo e as duas entidades da mesma maneira explicada no captulo IV


Fig 83 Criamos o Mdulo Cadastro com as Entidades Clientes e Profisso

Desenhemos primeiramente o formulrio da entidade Profisso.
- Insira dois controles TextBox com seus respectivos rtulos (Label) identificativos.
- O primeiro campo, ser o cdigo da profisso e campo chave primria. Mude a
propriedade Nome do Campo para CodProf por exemplo e o Ttulo do Campo para
Cdigo da Profisso.

Visual Kit 5 Verso 6.0.4.2
101

Fig 84 Formulrio da entidade Profisses


Ateno: importante mudar a propriedade Nome do Campo dos campos chaves. Se
deixar os valores default, ao ser relacionado o campo em outra entidade, pode ser que coincida
com algum outro nome default dessa entidade, aparecendo dois campos com o mesmo nome.
Isto causar um erro na execuo. Recomendamos colocar nomes para cada campo que o
identifiquem segundo o tipo de informao que vai gerenciar.


- Desenhemos agora o formulrio Clientes. Coloquemos os controles TextBox para os
campos Cd. do Cliente e Nome.
- Insira um controle ListBox. Este campo estar relacionado com a entidade Profisso,
portanto, preciso definir a propriedade Relacionamento

Para inserir a propriedade de relacionamento:
- D um clique sobre a propriedade Relacionamento. Aparecer uma entrada de seleo
com as tabelas do sistema (neste caso a entidade Profisso 01002- segundo padro
Visual Kit 5, veja no Apndice C).


Visual Kit 5 Verso 6.0.4.2
102
Fig 85 Formulrio da Entidade Clientes

Ateno: A novidade: o Assistente de Criao


Selecionada a entidade relacionada, aparecer uma janela Assistente de Criao, onde voc
complementar o desenho deste controle. Esta janela est dividida em duas pginas: Campos e
layout (veja na Fig 86).

Na pgina Campos voc seleciona os campos a serem includos no controle. Ela dispe de
duas listas lado a lado. Na lista a esquerda (Campos Possveis) aparecem todos os campos
disponveis, e na lista da direita (Campos Selecionados) mostra todos os campos selecionados
para exibio no controle. Voc usa os botes no meio das duas listas para passar campos de
uma lista para outra:

- Faa um clique sobre algum campo da lista Campos Possveis
- Clique no boto que indica a direo [>]. O campo agora aparece na lista da esquerda.

Desta maneira voc poder escolher vrios campos. Veja nas figuras Fig 86 e Fig 87.



Fig 86 Assistente de Criao.

Visual Kit 5 Verso 6.0.4.2
103

Fig 87 Campos selecionados para ser apresentados.

Na segunda pgina (layout) voc seleciona a aparncia do controle. Aqui voc encontrar (veja
na Fig 88) o visual de como ficar o controle e definir certas caractersticas:
- Auto preenchimento ao digitar: Ativa ou desativa o auto preenchimento para os itens
existentes na primeira coluna do controle. Opo til para listas muito grandes.
- Ordenada: Ativa ou desativa a classificao automtica para os itens existentes na
primeira coluna do controle.
- Largura da Lista: Define a largura da lista.


Fig 88 Layout do controle.

- Selecione Auto preenchimento...
- Clique no boto esquerdo do mouse em Aplicar para salvar as modificaes.
Visual Kit 5 Verso 6.0.4.2
104


Nota
Caso posteriormente- voc precise acessar a janela Assistente de Criao para fazer alguma
modificao no controle j includo, basta abrir o formulrio da entidade pelo Visual Kit 5 e
clicar o boto direito do mouse no controle. Aparecer o menu de contexto como exibido na
Fig 89. Escolha a opo Editar e voc acessar novamente o Assistente de Criao.


Fig 89 Menu de contexto para o ListBox


Vejamos como ficou nosso primeiro sistema com entidades relacionadas. Vamos a execut-lo
da mesma maneira como foi explicado no Captulo IV quando criamos o primeiro sistema.

Primeiramente, abra a entidade Profisso para cadastrar vrias profisses. Cadastre vrias
profisses. Na Fig 90 aparece uma consulta feita aps o cadastramento de algumas profisses a
maneira de exemplo.


Fig 90 Profisses cadastradas.
Inclua agora diferentes clientes e veja como funciona o relacionamento entre as entidades
atravs do controle ListBox. O formulrio dos clientes ficou como mostra a Fig 91. Ele possui
uma lista para seleo, com as profisses recm cadastradas no passo anterior...Bonito eh!...

Visual Kit 5 Verso 6.0.4.2
105

Fig 91 Formulrios de Clientes com ListBox

Cadastre vrios clientes, use nome de amigos, namoradas, familiares, etc... Vamos dar uma
olhada usando a operao de Consulta e ver como esto sendo gravados os dados?. A primeira
e a segunda coluna gravaro o cdigo e o nome do cliente respectivamente, j a terceira coluna
referente ao controle ListBox- ficou com o cdigo da chave das profisses. Veja na Fig 92.





Fig 92 Consulta da Entidade Clientes.







Visual Kit 5 Verso 6.0.4.2
106


Novo ComboBox:


Fig 93 Visual do controle ComboBox

O ComboBox combina uma caixa de texto (TextBox) com uma listagem de opes (ListBox).
Como o ListBox, o ComboBox permite exibir uma lista de opes para o usurio, mas com a
seguinte diferena:

- No ListBox o usurio dever sempre dar um clique no item desejado e, no ComboBox, o
usurio poder tanto selecion-lo quanto digit-lo no TextBox por ele apresentado.
- Um ListBox sempre apresentar uma poro da lista, estar sempre aberto ocupando
mais espao no formulrio. O ComboBox poder ser apresentado fechado.
- Voc dever utilizar o ComboBox sempre que quiser exibir uma lista de opes ao
usurio e no houver muito espao livre em sua interface, ou caso voc deseje oferecer
duas formas de o usurio especificar o item desejado: selecionado-o ou digitando-o.

O ComboBox igual que o ListBox precisa de uma outra entidade que controlar e armazenar a
listagem das opes. Portanto um controle que precisa estar relacionado.


Ateno:
Tanto o controle ComboBox como ListBox gravaro na tabela da entidade atual o campo chave
da tabela da entidade relacionada. Inclusive quando esta no for selecionada para ser exibida
no prprio controle.


Os passos no desenho do ComboBox so muito similares aos descritos para o ListBox. Para ver
como funciona, vamos criar um sistema idntico ao anterior, substituindo o controle ListBox
pelo ComboBox . Tudo feito da mesma maneira, portanto vamos pular as partes iguais.

Visual Kit 5 Verso 6.0.4.2
107

Fig 94 Colocando o controle ComboBox

- Selecione o controle ComboBox e insira-o no formulrio.
- Selecione como entidade relacionada Profisses;
- Aparecer o Assistente de Criao como no ListBox
- Voc selecionar primeiramente os campos e depois definir o layout do controle.

J a pagina do layout ( veja na Fig 95) se difere um pouco. Aqui voc definir as seguintes
caractersticas:
- Auto preenchimento ao digitar: Ativa ou desativa o auto preenchimento para os itens
existentes na primeira coluna do controle. Opo til para listas muito grandes.
- Igualar a largura com a lista: Ativa ou desativa a opo de igualar a largura do
controle largura da lista dos itens.
- Largura da Lista: Define a largura da lista.
- Campo de retorno na tela: Define qual campo ficar exibido na tela depois que feita
a seleo pelo usurio. Note que no exatamente o campo que ficar gravado
internamente na entidade. O campo que ser gravado na tabela associada entidade o
campo chave da entidade relacionada.


Visual Kit 5 Verso 6.0.4.2
108

Fig 95 Layout do ComboBox

Vejamos como funciona este controle. Abra o sistema gerado e selecione a entidade Clientes.
- Inclua um contedo para os campos Cd Cliente e Nome;
- Clique no controle ComboBox e aparecer a lista de profisses cadastrada na entidade
Profisses (veja na Fig 96);
- Selecione uma profisso;
- O controle fechado novamente como mostra a Fig 97.


Fig 96 Cadastrando Clientes usando o ComboBox

Visual Kit 5 Verso 6.0.4.2
109

Fig 97 No final da seleo o ComboBox fecha novamente.

Para ver como foram gravados os dados internamente clique em Consulta. Os dados gravados
tero o mesmo formato mostrado na Fig 92.



Grid


Fig 98 Controle Grid grade
O controle Grid ou grade dar um acabamento profissional aos formulrios criados por voc.
Ele permite a apresentao de dados num formato tabular linhas x colunas, semelhantes a uma
planilha. Inserido no formulrio de uma entidade, as colunas do Grid exibiro o contedo de
outros controles da mesma entidade ou de entidades relacionadas.

Para definir as caractersticas do controle na etapa de desenho, voc usar tanto a janela de
propriedades como um assistente de criao que descreveremos seguidamente.

Internamente o objeto Grid no criar campos na tabela da entidade, servindo unicamente
como uma consulta dentro do formulrio.

Visual Kit 5 Verso 6.0.4.2
110


Ateno:
Para inserir um controle Grid no formulrio, preciso que a chave primria da entidade seja
chave composta, ou seja, pelo menos dois campos devem ter a propriedade Chave Primaria
como Verdadeira e pelo menos uma das chaves esteja relacionada.


Algumas das propriedades particulares deste objeto so:

PROPRIEDADE DESCRIO
Barras de Rolagem Sempre que voc trabalha com mltiplas linhas e/ou colunas deve
ativar a barra de rolagem, permitindo que o usurio possa percorrer
todas as linhas e/ou colunas. Valores:
0- Nenhuma
1- Horizontal
2- Vertical
3- Ambos
Exibe Linhas na Grade Exibe as linha horizontais e verticais na grade.
0- Nenhuma
1- Horizontal
2- Vertical
3- Ambos
Largura da Linha Se refere largura das linhas da grade
Cor da Linha Especifica a cor a ser utilizada para as linhas da grade
Altura da Linha Alturas da linhas na grade

Vejamos no seguinte exemplo como funciona este controle.

Exemplo de entidade com chave composta.

A proposta: Criar um sistema simples para cadastrar os jogadores de futevlei da Copa
Mundial referenciando pelo nome da seleo e o nmero da camisa do jogador.

Criaremos para este caso trs entidades: Seleo, Camisa e Cadastro. Na entidade
Seleo cadastraremos todas as selees que participaram do campeonato. Na entidade
Camisas cadastramos todos os nmeros das camisas. E na entidade Cadastro, realizamos o
registro propiamente dito dos jogadores, usaremos para isso o recurso Grid, nesta entidade os
campos chaves rero os referentes a Seleo e a Camisa.

Visual Kit 5 Verso 6.0.4.2
111

Fig 99 Estabelecendo a estrutura do sistema com as trs entidades.

Para simplificar, as entidades Selees e Camisas estaro compostas unicamente pelo cdigo e
o nome da seleo e o cdigo e nmero da camisa respetivamente. Veja como exemplo a
prxima figura.


Fig 100 Formulario da entidade Camisa.

O formulrio da entidade Cadastro estar composto por:
- dois controles ComboBox relacionados respetivamente as entidades Seleo e Camisa.
importante colocar tambem na segunda ComboBox a propriedade Chave Primria
como Verdadeira.
- Um campo TextBox para a incluso do nome do atleta.
- E a Grid que permitir mostrar todos os registros a medida que estamos cadastrando.

Visual Kit 5 Verso 6.0.4.2
112

Fig 101 O primeiro e segundo campo dever ser definido como chave.




Fig 102 Assistente de Criao da Grid. Escolha dos campos para exibio

Visual Kit 5 Verso 6.0.4.2
113

Fig 103 Pgina de Layout no Assistente de Criao



Fig 104 Visual final do formulrio

Visual Kit 5 Verso 6.0.4.2
114

Fig 105 Sistema Gerado



Fig 106 Cadastrando as Selees.
Visual Kit 5 Verso 6.0.4.2
115

Fig 107 Cadastrndo as camisas



Fig 108 Inserindo o primeiro registro da entidade Cadastro

Visual Kit 5 Verso 6.0.4.2
116

Fig 109 Inserindo outros registros



Fig 110 Resultado das inseres.



Visual Kit 5 Verso 6.0.4.2
117

Boto


Fig 111 O controle boto.

PROPRIEDADE DESCRIO
Ao Clicar Comando a executar quando realizado um clique sobre o boto
Ao Clicar Duas Vezes Comando a executar quando realizado um clique duplo sobre o
boto
Figura Imagem que aparecer no boto
Descrio do Boto Texto que aparecer em cima do boto


Exibe



Fig 112 Controle Exibe


Picture



Fig 113 O controle Picture


Calendario

Visual Kit 5 Verso 6.0.4.2
118

Fig 114


Link



Fig 115


Criando novas funcionalidades usando os
eventos.

Neste seo abordaremos os recursos que permitem colocar novas funcionalidades aos
controles descritos anteriormente. Estas funcionalidades esto associadas s aes que o
usurio do sistema gerado realizar sobre determinados controles.


Ateno!
A Designer-Pro no utiliza as opes de Pr e Ps Validao descrita no captulo anterior.
Estas funcionalidades so realizadas atravs das aes dos eventos que descreveremos nesta
seo.


Entendendo os eventos

Visual Kit 5 Verso 6.0.4.2
119
No desenvolvimento de sistemas, podemos definir que os eventos so aes reconhecidas
pelos controles. As aes podem ser: clicar o boto direito do mouse em cima de um controle
Boto ou usar a tecla TAB fazendo que um determinado TextBox perca ou ganhe o foco, etc.

Cada controle disponvel no Visual Kit 5 possui um conjunto de eventos a ele relacionado, por
exemplo, Ao Clicar, Ao Clicar Duas Vezes, Ao receber o foco, etc. comum encontrar
eventos que esto disponveis em vrios objetos diferentes. Veja na janela de propriedades da
Fig 116 onde que esto localizados tais eventos.


Fig 116 Localizao dos eventos na janela de propriedades.

Bom, onde que voc se encaixa nesta histria? Pois voc poder definir a ao do seu
sistema a tais eventos. O Visual Kit 5 possui dois teis recursos o Editor de Macros e Editor
de Cdigo - que permitiro definir as funes que voc quer que o sistema execute quando
acontecer um evento registrado. Por exemplo: exibir uma mensagem, clculos diversos,
colocar todo contedo em maisculas, aceitar um valor numrico num determinado intervalo,
etc.

O que torna a ferramenta de desenvolvimento Visual Kit 5 to poderosa a profuso de
controles possveis, suas propriedades, os eventos que cada um deles pode responder e os
procedimentos que podem ser definidos. Mas, voc deve ir aprendendo aos poucos, medida
que voc vai precisando usar esse ou aquele controle, propriedade ou evento.

Consideremos algumas definies importantes.

Visual Kit 5 Verso 6.0.4.2
120
Evento: um acontecimento no ambiente de execuo, reconhecido por um controle para o
qual voc pode definir uma ao. O exemplo clssico de um evento o clique do mouse. Voc
controla o comportamento do controle no momento em que ele detecta o evento o clique do
mouse- , escrevendo uma ao ou procedimento.

Aes: So procedimentos que um controle capaz de executar. Os controles j incluem
procedimentos caractersticos de seu funcionamento, mas voc pode criar e acrescentar outros.
Os procedimentos so funes que ficam ligadas aos controles. Por exemplo, podemos criar
uma funo associada ao evento Ao Clicar de um controle TextBox, que exibir uma janela
com uma determinada mensagem. No Visual Kit 5 estas funes so definidas usando o editor
de macros ou o editor de cdigos, que veremos a seguir.

Macros: So procedimentos criados a partir de funes preestabelecidas pelo Visual Kit 5 e
disponibilizadas para que o usurio possa us-las de maneira simples.

Cdigos: O Visual Kit 5 disponibiliza um editor de cdigo na linguagem FoxPro para a
criao dos procedimentos dos eventos. Este cdigo ser compilado pelo prprio Visual Kit 5,
e possui todas as funcionalidades desta linguagem.

Foco: Diz-se que um controle em um formulrio ganha ou perde o foco, quando ele se torna ou
deixa de ser o objeto atualmente selecionado, seja por ao do usurio ou programaticamente.
Esses eventos so temporariamente vizinhos. A maioria dos controles possuem o evento
Receber e Perder foco.

Os principais eventos

Ao desenvolver sistemas com o Visual Kit 5, voc trabalha com os eventos disponveis na
janela de propriedades. Voc no pode criar, modificar ou eliminar eventos, mas se pode
escrever as funes do evento que executado quando eles ocorrem.

A lista de eventos mais comuns no Visual Kit 5, e que so reconhecidos pela maioria dos
controles est descrita na seguinte tabela:

Evento Quando acontece
Ao Clicar Usurio clica o boto primrio do mouse.
Ao Clicar Duas Vezes Usurio d uma dupla-clicada sobre o controle.
Ao Clicar com o boto direito Usurio clica com o boto secundrio.
Ao Perder o Foco O controle perde o foco, seja por ao do usurio usando o
mouse ou teclado (TAB).
Ao Receber o Foco O controle recebe o foco, seja por ao do usurio usando o
mouse ou teclado (TAB).
Ao Digitar Usurio pressiona tecla para digitar.

Visual Kit 5 Verso 6.0.4.2
121
Para definir os procedimentos para uma determinada ao voc deve clicar em cima do evento
especfico e escolher qual dos recursos usar para a edio ou criao da funcionalidade:
Expression, Macro ou Code?. Veja na Fig 117.



Fig 117 Selecionando o modo de edio do procedimento dos eventos

O Editor de Expresses

Usando o Editor de Expresses voc poder criar todo tipo de expresses, tanto numricas
como de caractere. Voc poder manipular no somente o contedo ou valor do campo, mas
tambm todas as restantes caractersticas visuais como posio dentro do formulrio, cor e
formato de fonte, visibilidade, etc. Poder criar tambm expresses lgicas de tipo SE
ENTO.

Expresses matemticas

Para mostrar que muito fcil implementar expresses em geral usando este editor, vejamos o
seguinte exemplo. Vamos criar um formulrio composto por trs campos mais o campo chave,
e onde o contedo do terceiro campo seja a soma dos dois restantes. Usaremos o evento Ao
Receber o Foco do ltimo campo para executar automaticamente a soma.

Depois de desenhar o formulrio como mostra a Fig 118 siga os seguintes procedimentos para
implementar a soma.
Visual Kit 5 Verso 6.0.4.2
122

- Clique sobre o campo que receber a soma e selecione o evento Ao Receber o Foco.
- Ser aberta a janela da Fig 119 .



Fig 118 Chamando o Editor de Expresses para o evento Ao Receber o Foco


Esta janela composta por duas paginas: a pagina de criao de expresses simples e a pagina
de expresses com condies ou lgicas. Como nosso exemplo uma simples soma sem
avaliao de condies usaremos a primeira pagina.

A pagina de expresses composta por quatro quadros: um superior onde ficara gravada a
expresso propriamente dite e trs quadros inferiores que ajudaro selecionar os valores que
queremos manipular. No meio da janela aparece uma serie de botes com smbolos
matemticos que facilitam a elaborao da expresso.

No primeiro quadro inferior so colocados para seleo todos os controles do formulrios da
entidade atual e das entidades relacionadas. No segundo quadro sero exibidas as propriedades
do campo selecionado e no terceiro quadro so colocados os valores predefinidos para
determinadas propriedades.

Vejamos a continuao os procedimentos para conformar a expresso:

- Clique sobre o objeto relativo ao terceiro campo (Total) que receber o valor da soma;
- Imediatamente o segundo quadro inferior mostrar todas as propriedades deste
controle;
Visual Kit 5 Verso 6.0.4.2
123
- Faa um duplo-clique sobre a propriedade Valor do Campo;
- Automaticamente ser inserida uma expresso no quadro superior que indicar em
cdigos esta propriedade associada ao dado objeto do formulrio;
- Clique no boto igual a = para formar a expresso tipo C=A+B
- Clique agora no controle Valor_1. As propriedades do quadro sero as relativas a este
controle.
- Faa novamente um duplo-clique sobre a propriedade Valor do Campo deste controle.
- Clique no boto + para conformar a soma.
- Clique no segundo somando - o controle Valor_2 - e faa um duplo clique sobre Valor
do Campo
- A expresso est conformada!!! Salve a expresso clicando sobre o boto com o cone
de disquetes.



Fig 119 Editor de Expresses
Visual Kit 5 Verso 6.0.4.2
124

Fig 120 Expresso Conde soma conformada

Salve o sistema e abra para test-lo. Digite o campo chave e seguidamente os valores dos
elementos nos respectivos campos. Quando o ultimo campo receba o foco (que foi o evento
escolhido) dever aparecer automaticamente o valor da soma. Veja na figura Fig 121



Fig 121 Testando a expresso.




Visual Kit 5 Verso 6.0.4.2
125



O Editor de Macros.

Uma maneira simples de desenvolver as funcionalidades dos eventos dos controles atravs
das Macros. As Macros so procedimentos que voc poder conformar atravs de vrias
funes bases preestabelecidas pelo Visual Kit 5.

A conformao das Macros feita por uma interface, onde voc colocar simplesmente- os
dados de entrada sem necessidade de programar.


Nota:
Voc poder inclusive desenvolver macros associadas a um controle que utilize dados do
contedo de um outro campo, faa alguma ao com eles, e retorne o resultado em terceiro
outro campo.


Para que voc possa entender melhor, realizaremos um pequeno teste, o qual o ajudar
compreender definitivamente o que so eventos e procedimentos de eventos. Execute os passos
a seguir:

- Abra um novo sistema composto por um mdulo e uma entidade.
- Selecione a entidade como tipo Formulrio Externo na operao incluso veja na Fig
42.
- Insira dois controles TextBox no formulrio apresentado.

Muito bem, agora imagine uma ao que o usurio executaria sobre o segundo controle, por
exemplo, um clique do mouse, e quando este ocorrer, uma janela de mensagem ser aberta.

- Selecione o evento Ao clicar do segundo controle. Veja na prxima figura.
- Selecione Macro, como forma de definir as aes do evento. Ser aberta ento uma
janela de Seleo de Macros como mostra a Fig 123.




Visual Kit 5 Verso 6.0.4.2
126

Fig 122 Inserindo dois controles e selecionando o evento Ao Clicar.


Fig 123 Janela de seleo das macros.

- Clique no boto Novo para cadastrar uma nova macro. Posteriormente todas as macros
cadastradas estaro disponveis numa lista para seleo nesta janela, podendo tambm
ser reeditadas ou excludas.
- Aparecer neste momento, o Editor de Macros como mostra a Fig 124. Clicando na
primeira linha da lista das aes, voc definir a primeira ao desta macro,
selecionando uma das funes bsicas (veja Fig 125). Neste exemplo criaremos uma
nica ao com a funo MESSAGEBOX Caixa de Mensagem.
Visual Kit 5 Verso 6.0.4.2
127


Fig 124 Janela de edio das Macros.


Fig 125 Selecionando as funes bases.


Nota:
Voc poder definir vrias funes numa nica macro, basta cadastr-la nas outras linhas da
lista de aes. A ordem de execuo definida pela ordem na lista


- Depois de selecionada a funo MESSAGEBOX aparecer no lado direito da janela
uma interfase com as entradas de dados relativa a esta funo. E na parte inferior um
explicativo para a dada funo. (Veja na Fig 126).
- Digite na primeira entrada a mensagem a ser exibida, por exemplo Meu primeiro
evento. Na segunda entrada de dados coloque o nome do ttulo que aparecer na parte
superior da janela que ser aberta, exemplo Testando o evento clique.

Visual Kit 5 Verso 6.0.4.2
128

Fig 126 Funo MESSAGEBOX
- Digite, por ltimo, um nome para a macro que voc acabou de definir, por exemplo
teste_clique. Veja como ficou na seguinte figura.


Fig 127 Definindo macro teste_clique
- Clique agora no boto Salvar (cone disquete ) e posteriormente no boto Sair (cone
porta). Voc criou a primeira macro.
- Aparecer novamente- a janela de seleo de Macros, mas com a nova macro recm
cadastrada por voc. (Veja na prxima figura)

Visual Kit 5 Verso 6.0.4.2
129

Fig 128 Macros disponveis para seleo.

- Clique em cima da macro e clique no boto Selecionar, desta forma estamos atribuindo
ao evento esta macro.
- Salve o formulrio e feche o desenho do sistema. Saia do Visual Kit 5 e abra o sistema
gerado neste exemplo.
- Clique sobre o segundo controle... deve aparecer uma caixa de mensagem da seguinte
forma:


Fig 129 Testando o primeiro evento.

Funes bases cadastradas.

O Visual Kit 5 contm vrias funes cadastradas para a elaborao das Macros. O nmero de
funes ir aumentando em novas atualizaes da ferramenta.

Visual Kit 5 Verso 6.0.4.2
130

Exibe janela com mensagem


Fig 130 Funo WAIT WINDOW



Construir uma expresso como macro

Usando esta funcionalidade voc poder para construir diversas expresses usando operadores
descritos no Apndice E.


Fig 131 Criando expresses

Visual Kit 5 Verso 6.0.4.2
131

Transforma em maisculas

UPPER - Retorna uma expresso especfica de caracter em maiscula. Cada letra minscula (a
z) na expresso de caracter convertida -no retorno- em maiscula (A Z). Valor de retorno:
Caracter


Fig 132 UPPER
A primeira entrada de dados indicada pelo rtulo Objeto que receber a macro define o
campo que receber o resultado da macro. A segunda entrada Maisculas indica o campo
que servir como entrada.


Transforma em minsculas

LOWER - Retorna uma expresso especfica em caracteres minsculos. Cada letra maiscula
(A Z) numa expresso de caracter convertida no -retorno- em minscula (a z). Valor de
retorno: Caracter

Visual Kit 5 Verso 6.0.4.2
132

Fig 133 Funo LOWER



Operador condicional

O operador iif(), conhecido como operador condicional poder determinar qual funo executar
avaliando primeiramente uma expresso lgica. Ele retornar dois valores dependendo da
expresso lgica. Valores de retorno: Caracter, Numrico e Data

Condio: Especifica a expresso lgica, ou seja, a expresso que ser avaliada. Se a condio
for avaliada de verdadeira (.T.), retornado o valor da entrada Valor para condio
verdadeira. Se a condio avaliada de falsa (.F.), o Valor para a condio falsa
retornado.

O lugar de retorno definido no primeira entrada: Objeto que receber a macro.

Visual Kit 5 Verso 6.0.4.2
133

Fig 134 Funo iif


Retorna uma quantidade especfica de caracteres

LEFT: Retorna uma quantidade especfica de caracteres esquerda de uma seqncia de
caracteres ou expresso string

RIGHT: Retorna uma quantidade especfica de caracteres direita de uma seqncia de
caracteres ou expresso string.

Valores de retorno : Caracter

Parmetros:
Primeira entrada de dados: Especifica o campo que receber o retorno da funo.
Segunda entrada: Especifica o campo que contm expresses em caracteres o qual os
caracteres da esquerda/direita sero retornados.
Terceira entrada: Especifica o nmero de caracteres retornados da expresso. Esta funo
retornar a expresso inteira se este nmero maior que a largura da expresso. Retornar
vazio se este nmero negativo ou 0.

Obsev.
LEFT: Os caracteres so retornados comeando pelo primeiro caracter esquerda e continuam
at o nmero especificado.
RIGHT: Os caracteres so retornados comeando pelo ltimo caracter direita e continuam at
o nmero especificado.

Exemplo:
LEFT('Silva, PE', 2) retorna Si
RIGHT('Silva, PE', 2) retorna PE
Visual Kit 5 Verso 6.0.4.2
134


Fig 135 Funo LEFT


Retira espaos em branco

Este grupo de funes retorna a expresso especificada com os espaos em branco removidos.
- LTRIM : Retira espaos esquerda.
- RTRIM : Retira espaos direita.
- ALLTRIM : Retira espaos direita e esquerda.


Fig 136 Funo LTRIM

Exemplo: Rio de Janeiro
LTRIM: Rio de Janeiro
Visual Kit 5 Verso 6.0.4.2
135
RTRIM: Rio de Janeiro
ALLTRIM: Rio de Janeiro



Retorna o Valor Absoluto de um campo numrico

Valor de retorno: Numrico

Exemplo
ABS(-45) Retorna: 45


O Editor de Cdigos.

O Visual Kit 5 Professional possui o recurso de processador de textos para a digitao de seus
cdigos.

Para cada evento na janela de propriedades, estar disponvel a janela Editor de Cdigos, onde
voc digitar seus cdigo em linguagem Visual FoxPro e no final depurar o cdigo sinalando
as linhas com erro.


Fig 137 O Editor de cdigos
Visual Kit 5 Verso 6.0.4.2
136

Utilizando o menu Edit para auxiliar a digitao de cdigos.
Alm dos recursos j mencionados, a janela de cdigos permite todo o trabalho de um editor de
textos padro Windows. Desta forma sempre que a janela de Editor de Cdigos estiver ativa,
vrios recursos auxiliares estaro disponveis no ambiente de desenvolvimentos.

A maioria das opes disponveis no menu Edit funciona como recursos auxiliares digitao
de cdigos. Por meio das opes Recortar, Copiar, Colar e Limpar voc pode recortar, copiar
colar e apagar, respectivamente, o texto selecionado na janela de Editor de Cdigo. A opo
Seleciona Tudo, quando em uma janela de cdigos, permite selecionar todo o texto disponvel
na mesma.


Visual Kit 5 Verso 6.0.4.2
137
VIII. Gerao de cdigos fontes
dos formulrios




O Visual Kit 5 Professional possui todos os recursos da verso Standard e ainda a
possibilidade de gerar o cdigo fonte dos formulrios das entidades em Fox Pro e Visual Basic.

O objetivo principal da Edio Professional aumentar a produtividade dos programadores.
Utilizando os recursos do Visual Kit 5, o programador vai poder desenhar de maneira fcil os
formulrios que podero ser incrementados com as linguagens de programao.


Ateno!
Depois de gerados os cdigos dos formulrios e o usurio ter incrementado e compilado com
os recursos oriundos das respectivas linguagens de programao, futuras modificaes devem
ser feitas diretamente pelos linguagem de programao e no pelo Visual Kit 5.



Gerando cdigos em Visual Basic

Respeito a gerao dos cdigos dos formulrios em VB importante ter em conta o seguinte:

- O cdigo dos formulrios em Visual Basic gerado exclusivamente para os formatos
de tabelas Access e SQL-Server. Por tanto a entrada de dados Driver da janela de
Dados do Sistemas deve estar definida para um destes drivers.

- Para compilar o cdigo gerado dos formulrios necessrio ter instalado o compilador
Visual Basic no seu computador. E preciso indicar o caminho onde se encontra o
compilador Visual Basic, este caminho definido na janela Dados do Sistemas na
entrada de dados Diretrio do Visual Basic. (veja na figura abaixo)

Visual Kit 5 Verso 6.0.4.2
138

Fig 138 Visual da janela Dados do Sistema da Edio Professional.

Ateno!
Caso no tenha instalado o Visual Basic os cdigos sero gerados sem compilar.


- O cdigo ser gerado para os formulrios das entidades definidas como Formulrio
Externo em Visual Basic na janela Entidades como mostra a seguinte figura.



Fig 139 Definindo entidade para gerao de cdigo fonte em VB
Visual Kit 5 Verso 6.0.4.2
139
Depois de desenhado o formulrio da entidade, o Visual Kit 5 gera o cdigo em diretrios
especficos. Todos os formulrios so gravados no sub-diretrio do prprio sistema gerado em
PARAMETERS\FORM\D01, D02... D99 de acordo com o mdulo ao qual pertence a entidade,
no diretrio do sistema gerado.

O formulrio gerado em formato .SCX com nome corresponde com a seguinte regra:
Exemplo: F010022501.SCX

Colunas Descrio
F De Formulrio
01 Especifica o nmero do mdulo (01) a que pertence
002 Especifica a entidade (002).
2 Com abertura de arquivo. Repete o byte usado nesta coluna no nome da
funo especfica Primitiva.
5 Relatrio. Repete o byte usado nesta coluna no nome da funo especfica
Primitiva.
01 Formulrio de nmero 01.


Gerando cdigos em Fox Pro

A diferena da gerao em Visual Basic, o cdigo em Fox Pro gerado para todos os formatos
disponveis no Visual Kit 5. E para realizar a compilao no necessrio ter instalado o
compilado Fox Pro.

O cdigo ser gerado para os formulrios das entidades definidas como Formulrio Externo
em Visual Fox Pro na janela Entidades como mostra a seguinte figura.

Visual Kit 5 Verso 6.0.4.2
140

Fig 140 Definindo entidade para gerao de cdigo fonte em FoxPro

Depois de desenhado o formulrio da entidade, o Visual Kit 5 gera o cdigo em diretrios
especficos. Todos os formulrios so gravados no sub-diretrio do prprio sistema gerado em
PARAMETERS\FORM\D01, D02... D99 de acordo com o mdulo ao qual pertence a entidade,
no diretrio do sistema gerado.

O formulrio gerado em formato .SCX com nome corresponde com a seguinte regra:
Exemplo: F010022501.SCX

Colunas Descrio
F De Formulrio
01 Especifica o nmero do mdulo (01) a que pertence
002 Especifica a entidade (002).
2 Com abertura de arquivo. Repete o byte usado nesta coluna no nome da
funo especfica Primitiva.
5 Relatrio. Repete o byte usado nesta coluna no nome da funo especfica
Primitiva.
01 Formulrio de nmero 01.


Visual Kit 5 Verso 6.0.4.2
141

Fig 141 Formulrio gerado pelo Visual Kit 5




Fig 142 Formulrio aberto pelo Visual Fox Pro


Visual Kit 5 Verso 6.0.4.2
142

IX. Personalizando apertura, o
about e o manual

Aqui abordaremos certos procedimentos que daro um toque pessoal a os sistemas gerados
pelo Visual Kit 5.

Quando gerado um sistema pelo Visual Kit 5, so gerados alem dos arquivos relacionados
aos formulrios e tabelas, uma serie de arquivos complementares. Modificando determinados
arquivos complementares voc poder: colocar uma imagem prpria na abertura do sistema
gerado; colocar uma imagem logo no About e colocar um manual especfico do sistema criado

Imagem de apertura

J vimos que, quando comeamos o desenvolvimento de um sistema precisamos definir certos
dados gerais na janela Dados do Sistema.

O ltimo dado desta janela o Exibe Tela de Abertura (veja na Fig 143). Se voc marca para
sim, o sistema gerado quando aberto mostrar automaticamente (por poucos segundos) a
mesma imagem de abertura do prprio Visual Kit 5.


Fig 143 Janela Dados do Sistema
Esta imagem de abertura gravada no arquivo show.bmp na prpria pasta do sistema gerado
no seguinte caminho: C:\teste\parameters\bmp (no exemplo o nome do sistema teste)
Visual Kit 5 Verso 6.0.4.2
143
Voc pode substituir o arquivo show.bmp por outro com a imagem que desejada, mas o nome
deve ser mantido.

O logo do About

Automaticamente o sistema gerado com uma janela de About (Sobre) mostrada na Fig 144,
com os dados cadastrados na janela Datos do Sistema (veja a figura anterior)


Fig 144 Janela About

Voc pode incluir uma imagem no quadro branco. Usando o mesmo caminho da seo
(C:\teste\parameters\bmp) localize o arquivo logo.bmp. Abra este arquivo e inclua a
imagem desejada ou substitua por outro mas com o mesmo nome.

O manual do sistema gerado

No sistema gerado, quando voc clica no boto Help no menu e escolhe a opo Help... o
sistema abrir um manual predefinido em formato HTML.

Voc pode modificar ou colocar um novo manual especfico do sistema que voc desenvolveu.
Para isso basta substituir na prpria pasta do sistema gerado o contedo do arquivo
C:\teste\parameters\user manual\html\default.htm (no exemplo o nome do sistema
teste)
Visual Kit 5 Verso 6.0.4.2
144

X. Criando um Sistema
Completo pela Designer-
Bsica

Neste captulo desenvolveremos um sistema com caractersticas bem reais. Usaremos
exclusivamente recursos prprios do Visual Kit 5 e mostraremos a melhor maneira de
desenvolver sistemas.

A Proposta

Um amigo, dono de uma pequena empresa, sabendo que voc comprou o Visual Kit 5 quer que
voc desenvolva um pequeno sistema para ele. Ele precisa de um sistema de gesto
empresarial que controle o cadastro de clientes e fornecedores, o estoque de materiais, o
movimento de estoque; que gerencie as contas a pagar e receber - luz, gua, telefone, etc - e o
movimento de todas as contas de correntes bancrias.

Ele quer que o sistema fique dividido em dois subsistemas: um gerenciado pelo funcionrio-
estoquista e o outro - relativo s contas - pela sua secretria. E que ele possa acessar os dois
plenamente.

Analisando o Sistema

Primeiramente marque uma reunio com seu amigo para obter maiores informaes e analisar
como organizado o fluxo da empresa . Ele explica que:

O funcionrio-estoquista mantm quatro arquivos diferentes: um arquivo de clientes com os
dados pessoais como nome, endereo, sexo, etc.; outro dos fornecedores de materiais com os
dados de endereo, contato, telefone, etc. Este funcionrio controla tambm um arquivo de
Estoque de Materiais onde tem cadastrado todos os materiais com os dados como: fornecedor
do produto, preo unitrio, tamanho, etc. (em muitos casos um nico fornecedor oferece vrios
materiais). E por ltimo o arquivo de entrada e sada dos materiais do estoque, ou seja, o
movimento do estoque como produto, data, hora, quantidade, etc.

Veja a Fig 145, aqui representamos esquematicamente os quatro arquivos e seus
relacionamentos. O arquivo Estoque que armazena cada material est relacionado com o
arquivo de Fornecedores onde um fornecedor pode oferecer vrios produtos (relacionamento
Visual Kit 5 Verso 6.0.4.2
145
um-para-muitos veja no Captulo II ), portanto, aparece em vrios registros do arquivo
Estoque, na figura indicado em vermelho. Por outro lado o arquivo Movimento de Estoque est
relacionado, tambm um-para-muitos com o arquivo de Estoque, j que um determinado
produto tem vrias entradas e sadas (assinalado em azul).



C-C F-D





Clientes
Fornecedores
Estoque de Materiais Mov. do Estoque


F-C
F-B
F-A
C-B
C-A




Fig 145 Estoquista

Por sua vez, a secretria leva uma lista com todos os tipos de contas que a empresa trabalha, e
um arquivo onde registra os Pagamentos / Recebimentos para cada tipo de conta. Para tanto,
existe um relacionamento um-para-muitos entre estas duas entidades, onde por exemplo a
conta da luz se paga mensalmente (veja na Fig 146 o relacionamento indicado em vermelho).

Tambm ela guarda uma arquivo com a lista de bancos que a empresa se relaciona com dados
como: nome do banco, endereo, gerente, telefone, etc.. E controla os movimentos da conta
corrente de cada banco relacionamento um para muitos-, colocando valor do dbito ou
crdito, a data e hora, etc.



C-C





Contas
Pagto/Recebimento
Bancos
Mov. Conta Corrente.


C-B
C-A



B-D
B-C
B-B
B-A

Fig 146 Secretaria

Visual Kit 5 Verso 6.0.4.2
146
Projetando este panorama para as definies estudadas do Visual Kit 5, a estrutura do sistema
poderia estar composta por dois mdulos englobando entidades que tenham a ver uma com
outras, por exemplo:

MDULO ENTIDADES
01: Controle de Estoque 001 - Clientes
002 - Fornecedores
003 - Estoque de Materiais (relacionado com Fornecedores)
004 - Movimento do Estoque (relacionado com Estoque)
02: Contas a Pagar / Receber 001 - Contas
002 - Pagamentos / Recebimentos (relacionado com Contas)
003 - Bancos
004 - Movimento de Conta Corrente (relacionado com Bancos)

considerada uma boa prtica de desenvolvimento de sistemas, definir - antes de comear
desenhar propriamente os formulrios-, a estrutura dos mesmos, ou seja, definir quantos
campos vai ter o formulrio; o tipo de dados que vai guardar, se caractere ou numrico, etc.; o
tamanho mximo de caracteres no campo; o tipo de controle na entrada de dados (TextBox,
ComboBox); os relacionamentos; as validaes; etc. Esta fase chamada de Anlise de
Sistemas.
Uma maneira simples de fazer esta anlise, colocar em tabelas toda esta informao.
melhor deter-se um pouco na confeco destas tabelas, porque depois ser mais fcil e
produtivo criar os formulrios seguindo um roteiro definido. Vejamos a continuao, as tabelas
com as estrutura para cada entidade:

Visual Kit 5 Verso 6.0.4.2
147
Estrutura do Mdulo 01 - Controle de Estoque

B01001- Clientes
POSIO NOME TIPO TAMANHO MSCARA FORMATO
TIPO DE
CONTROLE
PS VALIDAO OBSERV.
1

Codigo Caractere 5 99999 !X TextBox
dup_chk(vdados[I],1,"Cdigo
",tipo,I,impre)
Cdigo do Cliente (Chave
Primria = .T. Verdadeiro.
2 Nome Caractere 45 XXX... (45) !X TextBox
3 Sexo Numrico
2
Decimal:0
- - Option; 2 opes 1-Fem; 2-Masc
4 EstCivil Numrico
2
Decimal:0
- - Option; 4 opes
Estado civil
Solteiro, Casado,...
5 Data_Nasc Data 8 ##/##/#### D
Spiner
(min=0; max=10)
Data de Nascimento
6 Filhos Numrico
2
Decimal:0
- - TextBox Numero de filhos
7 Endereo Caractere 40 XXX... (40) !X TextBox
8 Bairro Caractere 15 XXX... (15) !X TextBox
9 Cidade Caractere 25 XXX... (25) !X TextBox
10 UF Caractere 2 XX !X TextBox Estado
11 CEP Caractere 8 99999-999 R TextBox
12 Telefone Caractere 14
(9999)9999-
9999
R TextBox
13 Fax Caractere 14
(9999)9999-
9999
R TextBox
14 Valor_Pago Numrico
10
Decimal:2
9,999,999.99 R TextBox
15 carro CheckBox
16 casa CheckBox
17 plano CheckBox
18 cartao CheckBox
Visual Kit 5 Verso 6.0.4.2
148
19 Descrio Memo 4 EditBox
Edio de outras Descries
dos clientes


Antes de comear a desenhar o sistema, voc precisa tambm ter uma idia aproximada do visual dos formulrios. Adiantamos aqui as
telas finais dos formulrios, para que o ajudem a desenvolver este sistema.


Fig 147 Formulrio da entidade Clientes
Visual Kit 5 Verso 6.0.4.2
149
B01002 - Fornecedores

POSIO
NOME DO
CAMPO
TIPO TAMANHO MSCARA FORMATO
TIPO DE
CONTROLE
PS VALIDAO OBSERV.
1

Cd_Fornec Caractere 5 99999 !X TextBox dup_chk(vdados[I],1,"Cdigo",tipo,I,impre)
Cdigo do
Fornecedor (Chave
P).
2 Nome Caractere 45 XXX...(45) !X TextBox
3 Endereo Caractere 40 XXX...(40) !X TextBox
4 Bairro Caractere 15 XXX...(15) !X TextBox
5 Cidade Caractere 25 XXX...(25) !X TextBox
6 UF Caractere 2 XX !X TextBox Estado
7 CEP Caractere 8 99999-999 R TextBox
8 Contato Caractere 20 XXX...(20) !X TextBox
9 Telefone Caractere 14
(9999)9999-
9999
TextBox
10 Fax Caractere 14
(9999)9999-
9999
TextBox
11 Observaes Memo
EditBox Edio de
observaes
Ficar em nova
pagina.

Visual Kit 5 Verso 6.0.4.2
150


Fig 148 Fig 149



Visual Kit 5 Verso 6.0.4.2
151

B01003 - Estoque de Materiais

POSIO
NOME DO
CAMPO
TIPO TAMANHO DECIMAIS MSCARA FORMATO
TIPO DE
CONTROLE
PS VALIDAO OBSERV.
1

Cod_Materi Caractere 5 99999 K TextBox dup_chk(vdados[I],1,"Material",tipo,I,impre)
Cdigo do
Material
(Chave)
2 Nome Caractere 45 XXX...(45) !X TextBox
3 Cod_Fornec Caractere 5 ComboBox dup_chk(vdados[I],2,"Fornecedor",.f.,I,impre)
Cd
Fornecedor
relacionado
com
Fornecedores
(01002)
4 Cor Caractere 10 XXX...(10) !X TextBox
5 Tamanho Numrico 10 9,999,999.99 R TextBox
6 Estoq_Mini Numrico 6 999.99 K TextBox
Estoque
Mnimo
7 Quantidade Numrico 6 999.99 K TextBox iif(vdados[I]>=vdados[I-1],.T.,.F.)
No pode ser
menor que
estoque
mnimo
8 Preco_Unit Numrico 12 2 999,999999.99 R TextBox
Preo
Unitrio
9 Preco_Vend Numrico 12 2 999,999999.99 R TextBox
Preo de
Venda

Visual Kit 5 Verso 6.0.4.2
152

Fig 150 Formulrio da entidade Estoque de Materiais.
Visual Kit 5 Verso 6.0.4.2
153

B01004- Movimento do Estoque

POS
NOME
DO
CAMPO
TIPO
TAMA
NHO
MSCARA FORMAT Controle Pr validao Ps validao OBSERV.
1

Cod_Mate
ri
Caract
ere
5 99999 K ComboBox
dup_chk(vdados[I],1,
"Cdigo",tipo,I,impr
e) .and.
dup_chk(vdados[I],2,
" Cdigo
",.f.,I,impre)
Cd do Material (Chave) relacionado
com arquivo de Estoque (01003)
2 Data Data 8 ##/##/#### D TextBox Data Movimento (Chave)
3 Hora
Caract
ere
5 99:99 R TextBox Hora Movimento (Chave)
4 Sai_Entra
Caract
ere
1 X !X TextBox (vdados[I] $ SE) S para Saida. E para Entrada.
5
Quantidad
e
Num
rico
6 999999 K TextBox
iff(vdados[I]=E,ch
g_data(2,vdados[1],.t
.,,7,B-
>QUANTIDADE+v
dados[I]),chg_data(2,
vdados[],.t.,,7,B-
>QUANTIDADE-
vdados[I]))

6
Preco_Ven
d
Num
rico
12
Decimal:
2
999,999,999.
99
R TextBox Preo de Venda
7 Total
Num
rico
12
Decimal:
2
999,999,999.
99
R TextBox
altval(vdados,I,v
dados[I-
1]*vdados[I-2])
Quantidade * Preo de Venda



Visual Kit 5 Verso 6.0.4.2
154

Fig 151 Formulrio da entidade Movimento de Estoque.
Visual Kit 5 Verso 6.0.4.2
155
Estrutura do Mdulo 02 Contas a Pagar/Receber

B02001 - Contas

POSIO
NOME
DO
CAMPO
TIPO TAMANHO MSCARA FORMATO
Tipo de
Controle
Ps validao OBSERV.
1

Cod_Conta Caractere 5 99999 K TextBox seq_().and.dup_chk(vdados[I],1,"COD_CONTA",tipo,I,impre)
Cdigo da
Conta (Chave).
Incluso
seqencial
2 Nome Caractere 45 XXX...(45) !X TextBox



Fig 152 Formulrio Contas

Visual Kit 5 Verso 6.0.4.2
156
B02002 - Pagamentos/Recebimentos

POSIO
NOME DO
CAMPO
TIPO TAMANHODECIMAIS MSCARA
Tipo de
Controle
Pr validao Ps validao OBSERV.
1

Cod_Conta Caractere 5
ComboBox Cdigo da Conta
(Chave) relacionado
com arquivo de
Contas (02001)
2 Data Data 8 ##/##/####
TextBox Data Pag/Rec
(Chave)
3 Hora Caractere 5 99:99
TextBox Hora Pag/Rec
(Chave)
4 Pagou_Rec Caractere 1 A
TextBox (vdados[I] $
PR)
P para
pagamento. R
para Recebimento.
5 Valor Numrico 12 2 9,999,999,999.99
TextBox Valor Pago /
Recebido
6 Multa Numrico 12 2 9,999,999,999.99 TextBox Valor da Multa
7 Total Numrico 12 2 9,999,999,999.99
TextBox altval(vdados,I,vdados[I-
1]+vdados[I-2])

Valor + Multa


Visual Kit 5 Verso 6.0.4.2
157

Fig 153
Visual Kit 5 Verso 6.0.4.2
158
B02003 Bancos


POSIO NOME DO CAMPO TIPO TAMANHO MSCARA TIPO DE CONTROLE PS VALIDAO OBSERV.
1

Num_Banco Caractere 5 TextBox
seq_().and.dup_chk(vdados[I],1,"Num_Banco",t
ipo,I,impre)

chave
2 Nome Caractere 45 TextBox
3 Endereo Caractere 40 TextBox
4 Bairro Caractere 15 TextBox
5 Cidade Caractere 20 TextBox
6 UF Caractere 2 TextBox
7 CEP Caractere 8 99999-999 TextBox
8 Gerente Caractere 20 TextBox
9 Telefone Caractere 14 (9999)9999-9999 TextBox
10 Fax Caractere 14 (9999)9999-9999 TextBox


Visual Kit 5 Verso 6.0.4.2
159

Fig 154

Visual Kit 5 Verso 6.0.4.2
160
2004 - Movimento de Conta Corrente


POSIO
NOME DO
CAMPO
TIPO TAMANHO DECIMAIS MSCARA Tipo de Controle Ps validao OBSERV.
1 Num_Banco Caractere 5
TextBox
Nmero do Banco
(chave).
Relacionamento:
02003
2 Conta Caractere 12 999999999999
TextBox Numero de conta
corrente.(chave)
3 Num_cheque Caractere 12 999999999999 TextBox
4 Data Data 8 ##/##/#### TextBox
5 Db_Cred Caractere 1
TextBox (vdados[I] $
DC)
D para Dbito
C para Credito
6 Valor Numrico 12 2 9,999,999,999.99
TextBox Valor do
credito/debito.


Visual Kit 5 Verso 6.0.4.2
161

Fig 155 Formulrio Movimento de Conta corrente



Visual Kit 5 Verso 6.0.4.2
162
Passos na Criao do Sistema

Continuando, colocaremos de maneira geral todos os passos para a criao do sistema usando
o Visual Kit 5.

- Em primeiro lugar, inicialize o Visual Kit 5
- Abra a pasta Gerador de Sistema, clique em Sistema Completo e selecione a opo
Incluso -> Sistema Completo. Gere o diretrio para o sistema. \Controle de
Empresa.
- Preencha os dados gerais do sistema.
- Crie os mdulos Controle de Estoque e Contas a Pagar/Receber como foi explicado no
captulo IV. Veja na figura seguinte.


Fig 156 Criao dos Mdulos

- Clique em Controle de Estoque e cadastre as entidades. Veja na Fig 157.
- Clique logo em Contas a Pagar/Receber e cadastre as entidades correspondentes. Veja
na Fig 158.


Fig 157 Cadastrando as entidades de Controle de Estoque.

Visual Kit 5 Verso 6.0.4.2
163

Fig 158 Cadastrando as entidades de Contas a Pagar/Receber.

- Quando voc cria uma entidade, o Visual Kit 5, solicita a confirmao de quais
operaes bsicas sero herdadas pela Entidade. Selecione as operaes.
- Para desenhar o formulrio de Clientes. Clique no mdulo Controle de Estoque e
posteriormente clique na entidade Clientes. Confirme a seleo segundo aparece na Fig
159.


Fig 159 Selecionando a Entidade Clientes.
- Insira os controles no formulrio.
- Distribu-los e dimension-los de forma agradvel e objetiva.
- Altere os valores de suas propriedades para personaliz-los segundo a tabela de
definio da estrutura.
- Faa o mesmo para as outras entidades do sistema.

Veja alguns conselhos importantes durante o desenho dos formulrios.:

- Se durante o desenho da tela, um dos campos ocupar uma rea maior que a janela, voc
poder com o mouse redimensionar o campo. Veja exemplo na figura abaixo:

Visual Kit 5 Verso 6.0.4.2
164

Fig 160 Redimensionando o controle.
- Sempre que o campo for chave, selecione a propriedade "Chave Primria" e altere o
valor para .T. - Verdadeiro.


Fig 161 Colocando Chave primaria.
- Sempre que houve relacionamento preencha o campo indicado abaixo, com o nmero
do mdulo e da entidade relacionada.


Fig 162 Colocando relacionamento.
- No esquea de salvar, pressione periodicamente boto Salvar, e no final de cada
desenho do formulrio;
- Se tudo correu bem, o sistema gerado ficou como mostra a Fig 163.
Visual Kit 5 Verso 6.0.4.2
165

Fig 163 Sistema Gerado

Dica: Gere sistemas brindes e navegue por eles, para entender o funcionamento do Visual
Kit 5 e dos sistemas gerados.


Visual Kit 5 Verso 6.0.4.2
166
Personalizando Sistemas
Visual Kit 5 Verso 6.0.4.2
167
XI. Criando Sistemas Utilizando
os Sistemas Brinde

Para desenvolver sistemas voc no precisa comear de zero. O Visual Kit 5
disponibiliza uma biblioteca de sistemas prontos para funcionar. Esta biblioteca contem
dezenas de sistemas que abarcam diversas reas de negcios, por exemplo: Turismo, Protocolo,
Contabilidade, etc.

Os sistemas brinde so um novo conceito de desenvolvimento de sistemas. O Visual Kit 5 cria
um sistema completo sem a necessidade de nenhuma interferncia,- basta selecionar o sistema
da lista -, posteriormente voc pode alterar este sistema personalizando-o e comercializando-o
sem nenhuma restrio.

Tambm possvel importar sistemas desenvolvidos com o Visual Kit 5, para fazer parte da
biblioteca ou lista de Sistemas Prontos. Ou seja a tendncia que com o aumento de sua
biblioteca de sistema, aumente sua produtividade e facilidade no desenvolvimento de sistemas.

A lista completa dos sistemas voc encontra na pagina da Ebendinger, onde voc poder
abaixar para seu computador. Os usurios cadastrados podem baixar gratuitamente sistemas
brinde liberados no futuro.

Gerando o sistema brinde

Os procedimentos para criar sistemas baseados nos sistemas brinde similar ao procedimento
de criar sistemas novos visto anteriormente:

- Clique na TreeView para abrir a pasta Gerador de Sistema,
- Clique em Sistema Completo e selecione a opo Incluso.
- apresentada uma caixa de dilogos intitulada Utiliza Sistemas Prontos / Cria Sistema
Novo conforme mostra a Fig 164..
- Selecione Gerar Sistema Brinde.


Fig 164 Selecionando Gerar Sistema Brinde
Visual Kit 5 Verso 6.0.4.2
168
- Aparecer a lista dos sistemas brinde disponveis. Utilize a barra de rolagem vertical da
janela para ter acesso a todos os sistemas. (Veja na Fig 165).
- Selecione o sistema brinde desejado.


Fig 165 Lista de Sistemas Brinde
- Ao clicar se abrir uma janela, solicitando que voc digite o nome do diretrio onde
ser gerado o sistema. O Visual Kit5 coloca j um nome default que pode ser usado
diretamente ou mudado.
- No final da criao aparece uma janela informando que o a gerao foi concluda (veja
na Fig 166)


Fig 166 Sistema Gerado com Sucesso.

Visual Kit 5 Verso 6.0.4.2
169

Alterando o sistema brinde

Se voc deseja fazer alguma modificao ao sistema gerado pela biblioteca, basta abrir o
sistema pelo Visual Kit 5, que voc ter acesso a todos os formulrios. Veja os procedimentos:

- Abra o Visual Kit 5.
- Clique na TreeView para abrir a pasta Gerador de Sistema
- Clique em Sistema Completo e selecione a opo Incluso.
- Na janela digite o caminho do diretrio onde est o sistema a modificar ou localize
clicando no boto com reticncias. (veja na Fig 167). Por default nesta janela sempre
aparecer o ltimo sistema editado pelo Visual Kit 5.



Fig 167 Localizando o sistema gerado


- Automaticamente ser aberta uma janela como aparece na seguinte figura. Faa um
duplo clique no diretorio c:\ ; aparecero todas as pastas; selecione ento a pasta do
sistema desejado

Visual Kit 5 Verso 6.0.4.2
170

Fig 168 Localizando pasta do sistema

- Confirme. Finalmente ser aberta a janela de Mdulo e Entidade, permitindo ter acesso
para modificar todos os mdulos e entidades do sistema.


Ateno
A Ebendinger no oferece suporte aos sistemas brinde, uma vez que eles foram cedidos sem
nenhum custo aos usurios do Visual Kit 5.


Visual Kit 5 Verso 6.0.4.2
171
XII. Aproveitando dados


Muitas vezes j possumos uma base de dados que desejamos aproveitar para criar um
sistema completo. Neste captulo aprenderemos como fazer isto de forma simples e rpida
mostrando os formatos mais usados: DBF, MDB (Access) e XLS (Excel).

Acessando uma tabela .DBF existente

Realize a modo de teste o siguente exemplo:

1) Crie um Banco de Dados, por exemplo: em Fox-Pro e nomeie-o de ExemploDBF.
2) Crie uma Tabela e nomeie-a de B01001
3) Entre no Visual kit5, clique em Gerador de Sistemas > Sistema Completo > Incluso.
4) Agora clique em Cria Sistema Novo > Sistema Completo.
5) Nomeie a pasta do sistema de c:\SistemaExemplo.(Ver figura)


Fig 169

6) Agora crie um Mdulo e chame-o de Cadastro( Ver Fig.02)
Visual Kit 5 Verso 6.0.4.2
172
7) Crie uma Entidade e chame-a de Usurios(Ver Figura)



Fig 170

8) Saia do Visual Kit5, entre no diretrio c:\ e localize a pasta que contm o Banco de Dados
criado no exemplo (c:\ExemploDBF)

9) Copie o Banco e cole-o na pasta do sistema criado no caminho:
c:\SistemaExemplo\d01\dbf (Ver Figura)

Visual Kit 5 Verso 6.0.4.2
173

Fig 171



10) Depois de realizar a cpia entre novamente no Visual Kit5
11) Clique em Abertura de Arquivo > Incluso ( Ver Figura)


Fig 172



Visual Kit 5 Verso 6.0.4.2
174

12)Digite os dados desta maneira (ver figura)


Fig 173
N do Mdulo= 01
N da Entidade= 001
Num_Ope= 1
Nova_Area= 001
Table_File= d01\dbf\B01001
Index_Key= codigo
Index_File= d01\dbf\B010011
Data_Base_= (em branco)
DB_DRIVE_= 04
DB_SERVER_= (em branco)
PORT_SERV_= 1433
WSID= LOCALHOST

13) Agora salve, feche o Visual kit5 e rode o SistemaExemplo







Visual Kit 5 Verso 6.0.4.2
175
Acessando uma tabela .MDB existente

Siga os seguintes passos:

Crie um Banco de Dados Acess e salve-o como "mdbbase.mdb".
Crie uma Tabela e nomeie-a de "Clientes".
Crie pelo menos 2 campos na tabela e inclua alguns registros.

1) Entre no Visual Kit5, crie um Sistema e chame-o de "Exemplo_Acess" e em seguida
clique em OK (ver Figura)


Fig 174











Visual Kit 5 Verso 6.0.4.2
176

2) Crie um Mdulo "Cadastro" e uma Entidade "Clientes" e depois feche o Visual Kit5 (ver
Fig02)


Fig 175

2) Entre na Pasta "Exemplo_Acess" ,clique na pasta "DataBase"
3) Exclua o arquivo "mdbbase.mdb" existente (ver Fig03)


Fig 176
Visual Kit 5 Verso 6.0.4.2
177


5) Salve o Banco criado por voc em Acess com o nome de "mdbbase.mdb"

6) Entre no Visual Kit5 e depois clique em "Abertura de Arquivo" >"Incluso". Digite os
seguintes dados: (ver Fig04)

N do Mdulo = 01
N da Entidade = 001
Num_Ope = 1
Nova_Area = 001
Table_File = B01001
Index_Key = PK_CLIENTE
Index_File = B010011
Data_Base_ = C:\EXEMPLO_ACESS\DATABASE\MDBBASE.MDB
DB_DRIVE_ = 08
DB_SERVER_ = ACESS
PORT_SERV_ = 1433
WSID = LOCALHOST


Fig 177

7) Salve e feche a Tela de "Abertura de Arquivo"

8) Clique em "Alias de Referncia de Arquivos">"Incluso"

9) Digite os seguintes dados:
Visual Kit 5 Verso 6.0.4.2
178

o nmero referente a Tabela.TABLE_FILE=B01001
o nome da Tabela do Banco Acess criado que no exemplo "CLIENTES"(ver Figura)



Fig 178
10) Salve e feche o Visual Kit5

11) Entre no Diretrio C e localize a pasta criada (c:\Exemplo_Acess)

12) Clique em "Principal.exe"

Importando dados de uma Planilha Excel
(*.xls)

1) Entre no Sistema Gerado por voc, e escolha a Entidade que receber os dados da planilha
e clique na opo Transferncia. ( ver Fig01)

A entidade deve ter a mesma quantidade de campos que a tabela Excel. Lembre que
geralmente na entidade o primeiro campo chave. Por tanto coloque a primeira coluna da
planilha Excel seja chave Exemplo um nmero sequencial.

2) Mude a opo Formato Arq. Transferncia para XLS Excel ( ver Fig01)
3) Mude para Importa (para importar a planilha) ( ver Fig01)
4) Clique em Processar ( ver Fig01)
5) Digite o caminho onde est gravada a Planilha. Ex: c:\Book1.xls
Visual Kit 5 Verso 6.0.4.2
179


Fig 179

6) Clique em Consulta para conferir os dados na tabela
7) Clique em Salvar Entidade para que os dados sejam salvos na entidade desejada.
8) Digite o nome da Entidade e clique em OK ( ver Fig02)


Fig 180

Visual Kit 5 Verso 6.0.4.2
180
XIII. Instalando o Sistema Gerado
em outro computador

Bom, ate aqui voc aprendeu a desenvolver sistemas usando o Visual Kit 5 e test-lo no
seu prprio computador. Vamos agora, impressionar algum, instalando um sistema gerado por
voc no computador de essa pessoa. Que tal?...

Instalando num nico computador

Para executar um sistema gerado com o Visual Kit 5 na mquina de outro usurio voc precisa
realizar os seguintes procedimentos:

- Localize no CD-ROM do Visual Kit 5 o sub-diretrio chamado conf_usu (veja Fig
181). Nele voc encontrar um programa executvel chamado webapp.exe. (Veja na
Fig 182).


Fig 181 Contedo do CD Visual Kit 5

Visual Kit 5 Verso 6.0.4.2
181

Fig 182Subdiretrio CONF_USU do CD Visual Kit 5

- Execute o programa webapp.exe na mquina onde voc vai instalar o sistema gerado,
ou seja aquela pessoa que voc quer impressionar. Este programa instalar todas as
bibliotecas necessrias para o bom funcionamento do sistema gerado pelo Visual Kit 5;
- Uma vez instaladas as bibliotecas, voc precisar simplesmente copiar o diretrio
completo do sistema gerado para o computador deste usurio final. E pronto!


Ateno!
Se voc gravou o sistema gerado num CD-ROM para ser instalado no outro computador, no
esquea -depois de gravado no computador- colocar o atributo Ready-only (somente leitura)
desativado. As instrues so as seguintes:


- Abra o programa Explorer do Windows. Clique com o boto direito do mouse encima
da pasta do sistema gerado.
- Aparecer uma janela como mostra a Fig 183



Fig 183 Janela no aberta no Explorer

- Selecione Properties (Propriedades).
- Ser aberta uma nova janela com as diferentes propriedades do subdiretrio.
- Localize o atributo Ready-only (somente leitura) e desative-o ficando como mostra a
Fig 184.

Visual Kit 5 Verso 6.0.4.2
182

Fig 184 Propriedades do subdiretrio

Caso essa pessoa no tenha um leitor de CD, voc pode copiar para 8 (oito) disquetes o
instalador que se encontra no sub-diretrio \conf_usu\disk144 do CD Visual Kit 5. E executar
o instalador no computador do usurio final a partir de disquetes.


Nota:
Caso o sistema tenha funes especficas, voc no precisa copiar os programas fontes (*.PRG)
para o computador do usurio.


Instalando um Sistema Multiusurio

Os sistema gerados pelo Visual Kit 5 so sistemas multiusurios, ou seja voc pode rodar o
mesmo sistemas em vrios computadores usando uma estrutura cliente-servidor.

Visual Kit 5 Verso 6.0.4.2
183

Servidor
Clientes

Fig 185 Esquema de estrutura Cliente-Servidor.

Segue os procedimentos para colocar um sistema gerado em uma rede de multiusurios.

- Copiar todo diretrio do Sistema Gerado no computador servidor.
- Criar um mapeamento de rede nas estaes de trabalho de cada usurio apontando para
este diretrio do servidor.
- Criar um diretrio nas estaes de trabalho.
- Copiar os seguintes arquivos: principal.exe, vn5.app e config.fpw que se encontram
no diretrio do sistema gerado, em cada diretrio criado nas estaes de trabalho do
passo anterior.
- Abrir o arquivo CONFIG.FPW de cada estao de trabalho usando o programa
Notepad (Bloco de Notas) -veja na Fig 186- para fazer uma simples modificao.

Visual Kit 5 Verso 6.0.4.2
184

Fig 186 Abrindo o arquivo CONFIG.FPW pelo Notepad.
O arquivo CONFIG.FPW dos sistema gerados tem o formato mostrado na Fig 187 . Mude a
letra C:\ que indica o path para a letra em que foi feito o mapeamento de rede nas estaes de
trabalho.


Fig 187 Arquivo CONFIG.FPW inicial

Por exemplo, se o mapeamento foi feito usando a letra H:\, o path no arquivo CONFIG.FPW
ficar da seguinte forma:

Visual Kit 5 Verso 6.0.4.2
185

Fig 188 Arquivo CONFIG.FPW modificado.

Visual Kit 5 Verso 6.0.4.2
186
XIV. Voltando ao Ambiente de
Desenvolvimento


No Captulo III descrevemos brevemente o ambiente de desenvolvimento do Visual Kit
5. Agora que j voc tem certa experincia com o a ferramenta, voltemos descrever
determinadas opes muito teis quando desenvolvemos sistemas.

Renomeia e Copia Entidades

comum, que durante o desenvolvimento de um sistema, voc precise mudar uma entidade de
mdulo, ou simplesmente renomea-la ou aproveitar uma entidade j desenvolvida em outro
sistema e copi-la para o sistema que est em desenvolvendo, etc. Todas estas opes esto
disponveis no ambiente de desenvolvimento do Visual Kit 5, vejamos como proceder:

- Clique na TreeView para abrir a pasta Gerador de Sistema, logo em Sistema
Completo e selecione a opo Incluso.
- Aparecer a janela Utiliza Sistemas Prontos / Cria sistema Novo (veja na Fig 189).
Selecione a opo Renomeia / Copia Entidade.
- Ser aberta uma janela intitulada Renomeia / Copia Entidade (veja na Fig 190)


Fig 189 Acessando a opo Renomeia / Copia Entidade

Para renomear ou copiar entidades basta preencher as entradas de dados desta janela. Tendo
sempre em conta que na entrada Mdulo e Entidade voc colocar a numerao o padro usada
pelo Visual Kit 5. (veja no apndice C)

Visual Kit 5 Verso 6.0.4.2
187

Fig 190 Janela Renomeia e Copia Entidade

Nota
Voc poder renomear e/ou mudar as entidades dentro de um mesmo sistema atravs da opo
Entidade->Consulta no menu TreeView do ambiente de desenvolvimento. Esta opo ser
descrita ainda neste captulo.


Vejamos o exemplo da Fig 191, aqui estamos copiando a Entidade: 001 do Mdulo: 01 do
sistema teste1 para o mdulo 02 entidade 003 do mesmo sistema.


Fig 191 Copiando entidades dentro do mesmo sistema

Ateno!
Est opo no permitir copiar encima de uma outra entidade j existente, por isso verifique
primeiro se no mdulo receptor no existe uma entidade com o mesmo nmero.

Visual Kit 5 Verso 6.0.4.2
188

Para copiar entidades para outros sistemas - e desta forma aproveitar entidades prontas j
desenvolvidas - basta colocar o nome do sistema na entrada de dados Para.... Por exemplo
teste2 veja na prxima figura. Aqui ser copiada a entidade 001 do mdulo 01 do sistema
teste1 para o mdulo 01, entidade 002 do sistema teste2.


Fig 192 Aproveitando entidades prontas.


Ateno!
Quando copiamos entidades usando esta opo, estaremos copiando somente a estrutura da
entidade, ou seja, o desenho do formulrio, as propriedades e validaes e nunca os dados
cadastrados.

Se voc precisa copiar tambm os dados cadastrados, precisar realizar uma
exportao/importao de dados.


Visual Kit 5 Verso 6.0.4.2
189
XV. Criando Funes pelo
FoxPro

Como temos visto ate agora, o Visual Kit 5, tm uma ampla gama de funes e
recursos para desenvolver sistemas. No entanto, voc pode desenvolver novas funcionalidades
utilizando a linguagem de programao Microsoft Visual FoxPro for Windows verso 6.0.

Neste capitulo abordaremos os procedimentos a ser feitos para desenvolver funes no FoxPro
e embuti-las no Visual Kit 5, portanto vai requer conhecimentos de programao. Se voc no
programador, pule por favor este captulo.

Voc poder criar tanto funes especificas associadas as operaes Incluso, Excluso,
Alterao, etc. como funes de Pr ou Ps-Validao de campos.

Criando funes especficas.

Existem dois tipos de funes especficas que podem ser criadas:

- Funo Com Abertura de Arquivos: Esta funo abre os arquivos que voc tenha
especificado previamente no Visual Kit 5, no menu Abertura de Arquivos e em
seguida executa o programa que voc desenvolveu em Visual FoxPro.
- Funo Sem Abertura de Arquivos: No abre nenhum arquivo definido pelo Visual Kit
5 - totalmente independente.

A continuao descrevemos os procedimentos para criar as funo especificas.

- Execute o Visual Kit 5.
- Crie a entidade que ter como base a funo especfica. Veja no exemplo da Fig 195.
Visual Kit 5 Verso 6.0.4.2
190

Fig 193 Criando Entidade para funo especifica.

- Na janela de Entidades, selecione para a operao Incluso o tipo de funo
especifica: com abertura ou sem abertura de arquivos. Para as restantes operaes
desabilite as funes bsicas do Visual Kit 5. Veja a Fig 194.
- Pressione o boto Ok, para criar a funo especfica.
- O Visual Kit 5 criar automaticamente um arquivo com nome que segue uma regra
especifica que a continuao descreveremos. Este arquivo receber o cdigo da funo
que voc deseja incluir
- Indicar tambm em qual diretrio se encontra este arquivo, como mostra a Fig 195.
- Pressione o boto Ok, para confirmar.


Visual Kit 5 Verso 6.0.4.2
191

Fig 194 Escolhendo o tipo de funo especifica.



Visual Kit 5 Verso 6.0.4.2
192

Fig 195 Indicando o arquivo da funo especifica.

- Utilizando o Visual FoxPro localize o projeto do sistema gerado e dentro dele o arquivo
gerado (.PRG);
- O Visual Kit j inclui cdigos iniciais neste arquivo gerado. Veja Fig 197;
- Complemente com cdigos de programao o contedo de este arquivo.
- Insira no projeto PRINCIPAL.PJX o programa (.PRG) que voc criou;
- Compile o programa;
- Agora, voc pode executar o sistema gerado com a funo especfica embutida em seu
cdigo executvel.



Nota:
Sempre que criada uma entidade do tipo funo especfica, o Visual Kit 5 cria no diretrio
\<sistema gerado>\source\<nmero do mdulo> o arquivo (.PRG) vazio contendo o nome
codificado.

No Visual FoxPro v.6.0 para:
- Abrir o projeto PRINCIPAL.PJX utilize o menu Arquivo, opo Abrir;
- Adicionar o programa (PRG) utilize o boto Adicionar
Visual Kit 5 Verso 6.0.4.2
193
- Modificar o programa (PRG) utiliza o boto Modificar;
- Compilar o projeto usa o boto Construir





Fig 196 Arquivo gerado automaticamente pelo Visual Kit 5 para incluso do cdigo da funo especifica.

Visual Kit 5 Verso 6.0.4.2
194

Fig 197 Viso do Arquivo criado listo para a incluso de cdigos.

Regra do nome da funo especfica

O Visual Kit 5 denomina as funes especificas seguindo um determinado padro. Veja no
seguinte exemplo


FUNCTION E0100121()
comandos...
comandos...
RETURN


- O primeiro caractere do nome da funo sempre letra "E".
- Os prximos dois dgitos indicam o nmero do mdulo, Ex 01, 02, 03;
- Os prximos trs dgitos indicam o nmero da entidade. Ex: 001, 002, 003
- O prximo dgito indica o tipo de funo especfica: "2" para funo especfica com
abertura de arquivo; "3" para funo especfica sem abertura de arquivo; "1" para
operao bsica mais funo especfica.
Visual Kit 5 Verso 6.0.4.2
195
- O ultimo digito indica o nmero da operao bsica que ir chamar a funo especfica:
1 para Incluso;
2 para Alterao;
3 para Excluso;
4 para Consultas;
5 para Relatrios;
6 para Etiquetas;
7 para Indexao;
9 para Transferncia.

Cuidados na manipulao de arquivos

O Visual Kit 5 gera sistemas multiusurio, por isso, tome alguns cuidados na manipulao de
arquivos para evitar problemas com o sistema gerado. Quando uma funo especfica
executada o controle total do programa ser efetuado pela sua funo, e no pelo sistema
gerado.

Para desenvolver funes especficas com manipulao de dados em arquivos, observe com
ateno os seguintes comandos:

set exclusive (on/off)
Determina se a base de dados e os arquivos de ndices sero abertos de forma compartilhada
(off) ou exclusiva (on). O valor default deste comando nos sistemas gerados pelo Kit 5 off
(arquivos compartilhados).

set printer to <destino>
Determina o destino (alvo) da impresso. A impresso pode ser enviada para a impressora ou
arquivo.

unlock [all]
Libera o travamento lgico de arquivos e registros na Work Area que foram marcados pelas
funes de travamento.

flock()
Posiciona o arquivo para uso exclusivo do terminal que solicitou o travamento lgico. Retorna
.t. se obteve sucesso.

rlock()
Posiciona o registro para uso exclusivo do terminal, que solicitou o travamento lgico. Retorna
.t. se obteve sucesso.

use <arquivo> index <arq. indice> exclusive
Este comando deve ser utilizado para abrir um arquivo de dados e associ-lo a um arquivo de
ndice para uso exclusivo. Qualquer outro usurio que tente o travamento lgico deste arquivo
ou de um registro do mesmo no obter sucesso.

Visual Kit 5 Verso 6.0.4.2
196
Para os comandos: pack, reindex, zap, index on os arquivos devero ser abertos sempre em
modo exclusivo:


Nota:
- Sempre que uma operao de escrita for necessria (replace), deve ser efetuado o
travamento lgico. Para as outras situaes opcional;
- NUNCA coloque o arquivo de ndice na sintaxe do comando USE;
- O campos GERAL (imagem) tem que ser o ltimo campo do arquivo.


Criando funes de validao de campos

Como vimos anteriormente, as funes de validao de dados so as funes chamadas pelas
Pr e Ps-Validao dos campos. O Visual Kit 5 possui varias funes de validao, mas voc
pode ampliar este nmero criando outras - usando o Visual FoxPro.

Voc dever abrir o projeto do Sistema Gerado pelo FoxPro e criar o cdigo da funo. Est
funo acessar os valores dos campos atravs do vetor vdados. Veja no seguinte exemplo a
forma de como fazer isto:

FUNCTION mult5
external array vdados
vdados[I] = vdados[I]*5
RETURN .t.

Compile o projeto pelo Visual Kit 5 e inclua na Pr ou Ps-Validao a funo criada,
exemplo: mult5()

Visual Kit 5 Verso 6.0.4.2
197
XVI. Criando um Sistema no MS
SQL Server 2000.

Neste capitulo abordaremos como criar um sistema no Banco de Dados MS SQL
Server 2000 usando o Visual Kit 5.

O SQL Server

Sai do marco deste manual a explicao do que o MS SQL Server e como us-lo, por isso
faremos s uma breve descrio maiores informaes voc poder encontrar em muitos
livros especializados.

O SQL Server um sistema de gerenciamento de bancos de dados cliente/servidor de alto
desempenho com alta integrao com o Windows NT. Suas caractersticas so: Integrao com
os servios de multithreading [mltiplas linhas]; agendamento; Monitor de Desempenho; log
de eventos do Windows NT.

Com uma replicao nativa permite disseminar informaes para vrios locais, reduzindo a
dependncia de um servidor nico, e deixando a informao necessria mais prxima de quem
realmente precisa dela. Tem uma arquitetura paralela, que executa as funes de banco de
dados simultaneamente para diversos usurios e tira proveito de sistemas com mltiplos
processadores.

Possui um gerenciamento centralizado de todos os servidores atravs de uma arquitetura de
gerenciamento distribuda, com uma interface visual.

SQL Server- Visual Kit 5

Antes de criar um sistema pelo Visual Kit 5 no SQL-Server, necessrio cumprir determinados
requisitos:

- Ter j uma Base de Dados (Database) criada no SQL-Server
- Ser usurio cadastrado no Database.
- Ter permisso de criar tabelas no Database.





Visual Kit 5 Verso 6.0.4.2
198

Nota:
O Visual Kit 5 no cria diretamente o Database, pois envolve questes de segurana cujo
critrio varia de administrador para administrador do Base de Dados.



Aps certificar que voc usurio cadastrado e tem permisso de criar tabelas no Database,
deve se criar ou cadastrar o mesmo usurio (login) e senha no ambiente do Visual Kit 5, para
isto basta:

- Ir em Ferramentas no menu TreeView do Visual Kit 5
- Selecionar Propriedade;

Aparecer uma janela (veja na Fig 198) confirmando a criao do login e senha do
administrador do Visual Kit 5. Clique em YES.




Fig 198 Criando usurio ADMINISTRADOR


Crie -como administrador do Visual Kit 5- um novo usurio com login e senha igual ao
cadastrado no SQL-Server.

Visual Kit 5 Verso 6.0.4.2
199

Fig 199 Incluindo novo usurio e senha no Visual Kit 5

Aps isto feito, tudo est pronto para comear a desenvolver sistemas no MS SQL-Server.
Como voc j aprendeu:

- Clique em Sistema Completo -> Incluso -> Cria Sistema Novo -> Sistema Completo e
crie o novo diretrio do sistema.
- Na janela de Dados do Sistemas, preencha os dados gerais do sistema, com uma nica
diferena, selecione na opo Driver -> Microsoft SQL-Server ao invs do Visual
FoxPro.
Visual Kit 5 Verso 6.0.4.2
200
Imediatamente, a janela ser expandida para que se possa inserir configuraes adicionais para
a conexo com o SQL-Server.


Fig 200 Configurando a conexo com o SQL-Server.

Na entrada Base de Dados dever ser configurada com o nome do Database dado pelo
Administrador do SQL-Server que indica em qual instncia o Visual Kit 5 ir criar as tabelas.

A entrada Servidor ser configurada com o nome ou IP da mquina onde est localizado o
Banco de Dados, caso o banco de dados seja local, deve se botar o nome da mquina a qual
se est utilizando. Caso o banco de dados esteja remoto via internet, deve se obrigatoriamente
colocar o IP da mquina ao invs do nome dela.

No Porta do SQl tambm deve ser solicitada ao Administrador, porm j tem o valor default
com a porta padro que a 1433.

A WSID indica o nome da Estao de Trabalho (Workstation) e no necessrio solicitar ao
administrador, pode se inserir qualquer informao, at mesmo o seu nome.

Aps estes passos, a utilizao do Visual Kit 5 volta a ser como de usual. A nica diferena
que ao invs de criar arquivos em formatos .DBF ele criar tabelas no SQL-Server.

A modo de exemplo vamos criar, um sistema de um mdulo e uma entidade. Lembremos que,
o Visual Kit 5 enumeras as tabelas das entidades usando cinco dgitos -seguindo a ordem de
criao- cumprindo sempre o seguinte padro: Comea sempre com a letra B, seguido de
dois dgitos que indicam o numero do mdulo e trs dgitos que indicam o numero da entidade.
Ex. B01001 a primeira entidade do primeiro mdulo.

Visual Kit 5 Verso 6.0.4.2
201

Fig 201 Criando a entidade B01001

Salvemos nosso sistema e entremos no SQL-Server. Dever estar criada uma nova tabela: a
B01001. (veja na Fig 202)

Visual Kit 5 Verso 6.0.4.2
202

Fig 202 Tabela criada pelo Visual Kit 5 no MS SQL Server.

Criando sistemas com conexo remota via internet.

Esta seo s para ressaltar o dito anteriormente, quando a usamos Bases de Dados remotas
pela internet devemos na janela Dados do Sistema, na indicao Servidor colocar um IP vlido
( exemplo: 200.224.132.102 ) aberto para acesso na porta 1433 e suas bases estaro acessveis
via internet, no entanto o seu sistema estar rodando no sua estao de trabalho.

Rodando pelo navegador de internet

Voc pode rodar o sistema gerado pelo Visual Kit 5 usando o Internet Explorer Browser. Para
isto voc precisa fazer uma compilao usando o Visual FoxPro. Veja os procedimentos:

- Abra o projeto principal.pjx do sistema gerado pelo Visual FoxPro. Veja na Fig 203.

Visual Kit 5 Verso 6.0.4.2
203

Fig 203 Abrindo o projeto pelo Visual FoxPro.

- Na janela Project Manager aperte o boto Build
- Ser aberta a janela Build Options. Selecione em Build Action a opo
Application(.app). Confirme a seleo clicando o boto OK.


Fig 204 Selecionando opo Application (app).
Seguidamente aparecer a janela de Save as, para confirmar o nome do arquivo .app. (veja na
Fig 205).
Visual Kit 5 Verso 6.0.4.2
204


Fig 205 Confirmando nome do arquivo principal.app
O Visual FoxPro criar o arquivo principal.app dentro do diretrio do sistema gerado. Veja no
exemplo da Fig 206.


Fig 206 Arquivo principal.app criado
Visual Kit 5 Verso 6.0.4.2
205
Agora s abrir o Internet Explorer e localizar este arquivo no diretrio do sistema gerado.
Veja na seguinte figura.


Fig 207 Localizando arquivo principal.app no diretrio do sistema gerado.


Fig 208 O sistema rodando no Internet Explorer.
Visual Kit 5 Verso 6.0.4.2
206

XVII. Funcionalidades bsicas dos
Sistema Gerados

Quando voc cria sistemas usando o Visual Kit 5 ele coloca diversos recursos nos
sistemas gerados. Cada recurso tem suas finalidades e funcionalidades que descrevemos a
seguir.

Localizar entidades e campos do sistema

Utilize a janela Localizar para encontrar dados em todos os arquivos do sistema atravs de
palavras chave sem precisar abrir o arquivo.


Fig 209 Janela Localizar

Executando o recurso Localizar
Feche todos os arquivos abertos.
Visual Kit 5 Verso 6.0.4.2
207
Selecione a operao Consultas.
Na treeview do sistema gerado, abra "Ferramentas" selecione a opo Localizar.
Localizando uma entidade (arquivo) ou campo de arquivo
No campo Localizar digite a palavra chave inteira ou um trecho. Exemplo: Clientes ou Cli.
Pressione o boto Iniciar Pesquisa.
Na lista Entidades Encontradas clique sobre a entidade desejada.
Pressione o boto Ok.

Localizando uma informao dentro do arquivo
Clique com o mouse no campo Tipo de Pesquisa.
No campo Contendo Texto digite a palavra chave inteira ou um trecho. Exemplo: SILVA ou
LVA.
Pressione o boto Iniciar Pesquisa.
Na lista Entidades Encontradas clique sobre a entidade desejada.
Pressione o boto Ok.
Nos dois casos acima descritos, o sistema executar a operao Consultas e posicionar o
cursor sobre o primeiro registro encontrado.

Criando usurios (login e senha) para o
sistema

Utilizando a opo Propriedades no sistema gerado, voc pode cadastrar os usurios que
acessaro o sistema com nome (login) e senha. Voc poder definir os direitos de cada um,
indicando quais mdulos e entidades o usurio tem direito incluir, excluir, consultar, etc.

Visual Kit 5 Verso 6.0.4.2
208

Fig 210 Opo de Propriedades
Quando voc entra pela primeira vez na janela Propriedades o sistema cria um usurio de
nome administrador com senha igual a admini. O tamanho da senha de 6 (seis)
caracteres ou dgitos.



Fig 211 Criando usurio Administrador
Executando as Propriedades
Feche todos os arquivos abertos.
Selecione na treeview do sistema gerado o item "Ferramentas" e a opo Propriedades.

Criando usurios
Clique na lista Usurios.
Pressione o boto Inserir.
Digite o nome do usurio e pressione o boto Ok.
Se o sistema gerado vai rodar em rede obrigatrio criar todos os usurios do sistema.

Visual Kit 5 Verso 6.0.4.2
209
Incluindo / alterando a senha do usurio
Selecione o usurio na lista Usurios.
Pressione o boto Senha.
Digite a senha do usurio e pressione o boto Ok.

Exclundo usurios
Clique no nome do usurio na lista Usurios.
Pressione o boto Excluir.
Confirme a excluso.

Estabelecendo direitos de usurios, mdulos e/ou entidades
Selecione o usurio, mdulo e/ou entidade na lista correspondente.
Pressione o boto Direitos para Usurios, Mdulos e Entidades.
Clique uma vez sobre a operao que voc quer desabilitar na janela Direitos.
Pressione o boto Ok para confirmar os dados.

Desabilitando recursos e menus (configura tela e sistema)
Clique sobre o usurio na lista de Usurios.
Clique sobre o recurso/menu que voc deseja desabilitar para aquele usurio. A seta indica que
o recurso/menu est habilitado.

Criando um arquivo de log por usurio
Clique sobre o usurio na lista de Usurios.
Clique no campo Arquivo Log-Usurio e digite o path e nome do arquivo (TXT) onde sero
gravadas as informaes da utilizao do sistema.

Exemplo: \WINDOWS\RELLOG.TXT.
Criando um arquivo de recursos
Clique sobre o usurio na lista de Usurios.
Clique no campo Arquivo de Recursos e digite o path e nome do arquivo (*.DBF) onde sero
gravadas as informaes sobre os recursos do sistema.

Exemplo: \VDEMOS\FOX01.DBF.
Se a execuo do sistema gerado for em rede (multiusurio) obrigatrio criar um arquivo de
recursos para cada usurio do sistema.

Estabelecendo a execuo automtica de uma entidade
Clique no campo Mdulo da janela Executa Automaticamente e digite o nmero do
mdulo.
No campo Operao digite o nmero da operao 1 - para Incluso, 2 - para Alterao
etc.
No campo Entidade digite nmero da entidade que ser executada automaticamente.
Para sair aps a execuo do sistema, clique sobre o campo Executa e sai do sistema.
Sai da janela Propriedades clicando sempre no boto Ok.

Visual Kit 5 Verso 6.0.4.2
210
Incluso, alterao e excluso de registros

Utilize estas operaes para incluir, alterar ou excluir dados no sistema. Para selecionar estas
operaes clique primeiro na entidade desejada. Ser aberto um menu tipo TreeView com todas
as operaes registradas para a dada entidade.

Como exemplo, a Fig 212 mostra um sistema Controle de Estoque, com a entidade Clientes e a
operao Incluso selecionada. Clicando nesta operao ser aberto o formulrio desenhado
por voc. Por exemplo, veja na Fig 213.



Fig 212 Operao Incluso selecionada.

Visual Kit 5 Verso 6.0.4.2
211

Fig 213 Formulrio aberto para a Incluso.

Selecionada a operao utilize os botes criados pelo prprio Visual Kit 5 apresentados abaixo
para: gravar os dados, sair da operao, mudar de registro, consultar o arquivo atual etc.

Grava dados includos, alterados.
Na excluso apaga o registro exibido.
Exibe o primeiro registro do arquivo.
Exibe o registro anterior.
Exibe na tela o prximo registro.
Exibe o ltimo registro do arquivo.
Visual Kit 5 Verso 6.0.4.2
212
Vai para a tela anterior deste mesmo arquivo.
Vai para a prxima tela deste arquivo. O boto na cor cinza est desabilitado.
Executa a operao de consulta para o arquivo atual.
Cancela a operao.

Para as operaes Alterao e Excluso funcionam de maneira similar.

Dica
Voc pode utilizar o mouse ou a tecla <TAB> para movimentar o cursor pelos campos do
arquivo. Utilize o mouse tambm para navegar pelas telas do arquivo.


Consultas

A operao Consulta possui todos os recursos necessrios para a manipulao completa dos
dados de seus arquivos. Esta uma operao muito til e usada pelos usurios dos sistemas
gerados.

A operao Consulta pode ser acessada tambm atravs das operaes: Incluso,
Alterao, Excluso, Relatrios, Etiquetas e Transferncia.

Nas operaes de entrada de dados (Incluso, Alterao e Excluso) voc pode acessar
os dados de arquivos relacionados pressionando a tecla F10 sobre o campo de
relacionamento.

Voc pode criar ainda macro entidades de alterao e excluso, afim de fazer uma manuteno
simplificada de seus arquivos.
Exemplo de consulta ao arquivo (entidade) Clientes.
Visual Kit 5 Verso 6.0.4.2
213

Fig 214 Janela da Operao Consulta
Ao selecionar:
Executa a ordenao do arquivo por campos. Descendente ou ascendente.

Pesquisa por qualquer campo, inclusive campo Memo.

Permite alterar um ou mais registros e salvar macro entidades de alterao.

Permite excluir registros e criar macro entidade de excluso.

Possibilita o acesso aos arquivos relacionados com o arquivo atual.

Pesquisa indexada. Busca uma determinada informao mais rpido que o
Filtro.

Calcula o desvio padro, mdia aritmtica etc, baseado em formula pr-
estabelecida.

Cria colunas com o resultado de operaes matemticas.
Visual Kit 5 Verso 6.0.4.2
214

Salva como Entidade Macro de consulta, para automatizar as consultas
futuras.

Edita o registro atual atravs da operao Alterao abrindo o formulrio
da entidade.

Localiza prximo registro que satisfaz a condio estabelecida na janela
Localizar do menu Arquivo. Boto na cor cinza no pode ser utilizado.

Permite alterar os campos que sero exibidos na consulta e sua ordem.

Encerra a operao.


Relatrios rpidos, etiquetas e transferncia

O sistema gerado pelo Visual Kit 5 possui todos os recursos para criar relatrios, etiquetas
(mala-direta), importar arquivos ou exportar arquivos para outros softwares.

As trs operaes possuem a mesma interface ou tela. Dependendo da operao selecionada o
sistema habilitar alguns botes e desabilitar outros.

Visual Kit 5 Verso 6.0.4.2
215

Fig 215 Janela para as operaes Relatrios, Etiquetas e transferncia de arquivos.

Veja abaixo a descrio das listas e botes desta janela:

Campos do Arquivo:
Lista de campos do arquivo atual e arquivos relacionados. Clique com o mouse no campo que
ser selecionado.


Fig 216 Mostra os campos da entidade selecionada.

Campos Selecionados:
Lista de campos que foram selecionados para impresso ou exportao.
Visual Kit 5 Verso 6.0.4.2
216
Clique com o mouse no campo para: remover, efetuar quebra, totalizao ou criar coluna
matemtica.

Fig 217 Mostra os campos selecionados.
Seleciona / Remove
Botes para selecionar ou remover campos para impresso ou exportao. Na lista Campos do
Arquivo clique sobre o campo desejado. Utilize os botes abaixo para selecionar ou remover
um ou mais campos.


Fig 218 Botes para seleo dos campos

Filtro...
Executa a funo Filtro. Permite selecionar um grupo de registros para impresso ou
exportao.

Ordenao...
Executa a funo Ordenao. Permite ordenar os registros que sero impressos ou
exportados.

Quebra
Divide a impresso por grupos.
Na lista Campos Selecionados clique sobre o campo que formar a diviso. Exemplo:
diviso da impresso por Estado.
Pressione o boto Quebra

Totalizao
Totaliza campo numrico. Se existir quebra, sub-totaliza a cada novo grupo.
Visual Kit 5 Verso 6.0.4.2
217
Na lista Campos Selecionados clique sobre o campo que ser totalizado. Exemplo: imprimir
o total de salrios ao final do relatrio.
Pressione o boto Totalizao

Matemtica...
Executa a funo Matemtica. Cria colunas matemticas com o resultado da expresso
matemtica estabelecida.
Na lista Campos Selecionados clique sobre o campo que ser calculado. Exemplo: imprimir
coluna, calculando 10% de desconto no preo de venda.
Pressione o boto Matemtica

Lay-Out...
Opo desabilitada.
Ateno A quebra no tem efeito sobre a impresso do Lay-Out. O filtro e a ordenao sim.

Consulta
Exibe os dados do arquivo atual, atravs da operao Consulta.

Mixer Opo desabilitada.

Salvar Entidade...
Salva macro entidade. Monta um relatrio, etiqueta, importao ou exportao de dados.
Pressione o boto Salvar Entidades para criar uma nova entidade no menu de entidades.
Sempre que selecionada esta entidade, o sistema ir executar a impresso do relatrio ou
etiqueta, importar ou exportar os dados automaticamente.

Imprimir / Processar
Executa a impresso do relatrio ou etiqueta, importa ou exporta os dados.

Visualizar...
Exibe na tela arquivos textos criados no disco (winchester).

Fechar
Encerra a operao.

Expresso de Filtro
Exibe e permite a alterao do filtro (condio de pesquisa) ativo.


Visual Kit 5 Verso 6.0.4.2
218
Indexador Ativo (Expresso)

Exibe e permite a alterao do ordenador ativo.


1o. Cabealho
Primeiro cabealho do relatrio.

2o. Cabealho
Segundo cabealho do relatrio.


Relatrio? Impressora / Disco
Envia o arquivo para impresso ou exportao para disco ou impressora ativa.


Salta pgina na quebra? No / Sim
Salta pgina a cada mudana de grupo quando existir quebra.


Relatrio 80/132 col? 80 col / 132 col
Impresso em formulrio de 80 ou 132 colunas.






Visual Kit 5 Verso 6.0.4.2
219
Printa total de registros? No / Sim
Imprime o total de registros impressos ao final do relatrio.


Arquivo LBL/LBX (label)
Nome do arquivo de etiqueta que ser utilizado. Arquivo com terminao LBL
(Clipper/dBase) ou LBX (FoxPro).


Formato Arq. Transferncia
Seleciona o tipo de arquivo que ser importado ou exportado.


Arquivo Descrio
FOXPLUS Arquivo de dados FoxBase+, dBase, Clipper, Foxpro.
DELIMITED Arquivo ASCII (tipo texto).
Excel - XLS Planilha Excel verso 2.x ou superior.
DIF Planilha VisiCalc 1.0.
MOD Multiplan.
SDF Arquivo ASCII (tipo texto).
SYLK Formato de intercmbio de ligao SYMBOLIC usado pelo Microsoft Multiplan.
WK1 Lotus 1-2-3 verso 2.x.
WKS Lotus 1-2-3 verso 1A.
WR1 Planilha Symphony verso 1.1.
WRK Planilha Symphony verso 1.01.

Exporta / Importa
Ativa importao ou exportao na transferncia.


Visual Kit 5 Verso 6.0.4.2
220
Senhas dentro da entidade

Esta funo permite a incluso de senhas de acesso s entidades por operao bsica. Voc
pode criar uma senha para cada operao por entidade.
Se a entidade possuir senha de acesso, sempre que selecionada, o sistema exigir a entrada do
nome do usurio e senha.

Voc tem trs chances para acertar a senha, caso contrrio no ser possvel acessar a entidade.

Procedimentos para criar senhas por entidade

- Utilizando o mouse selecione a operao Senhas no menu treeview do sistema.
- Selecione com o mouse a operao que receber a senha, digite a senhas (de 1 at 6
caracteres ou dgitos) utilizando o mouse pressione o boto Salvar para gravar as
senhas ou Cancela para abandonar.


Dica:
Se voc deseja evitar o acesso a operao Senhas.
- Desabilite a operao Senhas para cada entidade do sistema.
- Ou crie uma senha para a operao Senhas por entidade.



Fig 219 Colocando senhas nas operaes das entidades

Visual Kit 5 Verso 6.0.4.2
221
Indexao

Quando voc gera sistemas em formato .DBF, e voc exclui regularmente informaes dos
seus arquivos, execute esta operao para apagar fisicamente todos os registros excludos.
Dessa forma, os arquivos se mantero sempre com o nmero real de registros.

Ateno!
Se voc alterar a estrutura de uma entidade, ou seja, incluiu ou excluiu novos campos no
formulrio, mudar o tipo de dados de um campo, etc. indexe a entidade antes de us-la. Usar
uma entidade que teve sua estrutura alterada antes de index-lo causar problemas.


Procedimentos para indexar uma entidade.

- Utilizando o mouse selecione a operao Indexao na treeview do sistema.
- O sistema inicialmente far a excluso fsica dos registros excludos, em seguida
indexar o arquivo.
- O path (caminho) e nome dos arquivos de dados, de ndice e a chave de indexao
tambm sero exibidos nesta tela.


Ateno! No interrompa esta operao



Fig 220 Indexando as tabelas das entidades


Em ambiente de rede local, certifique-se de que o arquivo a ser indexado no est sendo
utilizado por nenhum usurio da rede. Se voc tentar indexar um arquivo que est sendo
utilizado, o sistema exibir uma mensagem de erro, no indexar o arquivo selecionado e
poder perder os dados do arquivo.


Visual Kit 5 Verso 6.0.4.2
222
Outras opes teis

Filtro e ordenao

Filtro
Seleciona em um arquivo com (n) registros somente um grupo de registros.
Por exemplo: em um arquivo com mil estabelecimentos de ensino, utilizando o filtro voc pode
selecionar somente os estabelecimentos do bairro igual a Catete ou os nomes que comeam
pela letra A.

Esta funo permite relacionar mais de um campo para filtro atravs dos operadores lgicos
E e OU.


Fig 221 Janela de Filtro
Para estabelecer uma condio de filtro (pesquisa)
Voc pode estabelecer condies de filtro para destacar de um universo "X" qualquer uma
determinada poro de registros.
Como por exemplo:
Campo NOME que comea pela letra A (ana, alberto...);
Campo DATA com dia igual ou maior de 10 (10, 12,20...);
Campo ENDEREO que contm a string Senhora (Av. Nossa Senhora...);
Campo VALOR_PAGO igual a vazio (0);
Campo NOME contm Silva (Ernesto da Silva...);
Visual Kit 5 Verso 6.0.4.2
223
Campo CEP menor igual a 20000 (19000,18000...);
Campo NASCIMENTO com ano igual a 1966.

Filtrando um nico campo (caractere ou numrico)
O filtro pode ser utilizado nas operaes consulta, relatrio, etiqueta e transferncia e sua
manipulao sempre idntica.
O exemplo abaixo genrico e pode ser utilizado em qualquer uma das operaes citadas.
Utilizando o mouse pressione o boto Filtro.
Selecione, na caixa de texto, o campo que ser filtrado, pressione o boto do mouse duas vezes
sobre o campo ou tecle ENTER.
Selecione o operador relacional.
Digite o contedo que ser filtrado.
Utilizando o mouse pressione o boto Ok.

Filtrando um campo data
Utilizando o mouse pressione o boto Filtro ou selecione Filtro no menu Funes.
Selecione, na caixa de texto, o campo do tipo DATA que ser filtrado, pressione o boto do
mouse duas vezes sobre o campo ou tecle ENTER.
Selecione a opo de data a filtrar.
Selecione o operador relacional.
Digite o contedo que ser filtrado.
Utilizando o mouse pressione o boto Ok.

Filtrando mais de um campo
Execute os passos acima para selecionar cada campo.
Aps digitar o contedo do campo tecle ENTER;
Em seguida o cursor cair automaticamente na caixa de operadores Lgicos E e OU,
selecione o boto de rdio desejado e repita a operao descrita na opo filtrando um campo.
Para finalizar pressione o boto Ok.

Ordenao
Seleciona os campos, que faro parte da nova chave de ordenao do arquivo, permitindo a
visualizao do arquivo ordenado ascendente ou descendente por outros campos alm dos
campos que fazem parte da chave primria do arquivo.
Visual Kit 5 Verso 6.0.4.2
224
Por exemplo: em um arquivo que possui os campos cdigo, nome e endereo, voc pode
ordenar a sua visualizao na tela ou na impressora por endereo em ordem ascendente, isto ,
da letra A para a letra Z ou descendente (de Z para A).


Fig 222
Para ordenar o arquivo
Ordenar o arquivo pelo campo NOME do cliente(de A at Z ou Z at A);
Ordenar o arquivo pelo campo DATA de nascimento (da menor para a maior data);
Ordenar o arquivo pelo campo SALRIO (do maior para o menor).

Ordenando um nico campo do arquivo
Utilizando o mouse pressione o boto Ordenao.
Selecione, na caixa de texto, o campo que ser ordenado, pressione o boto do mouse duas
vezes sobre o campo ou tecle ENTER.
Selecione o indexador ascendente ou descendente.
Utilizando o mouse pressione o boto Ok.

Ordenando mais de um campo
Execute todos os passos descritos acima.
Aps selecionar o primeiro campo selecione o prximo campo que ser ordenado e repita a
operao descrita na opo Ordenando um nico campo.
Para finalizar pressione o boto Ok.


Quebra.

Divide a impresso das informaes por grupos (quebra), para facilitar a visualizao dos
relatrios.
Visual Kit 5 Verso 6.0.4.2
225
Por exemplo: em um arquivo que possui os campos Nmero da RA (Regio Administrativa),
Cdigo do bairro, Nome da Empresa e Endereo completo, voc pode imprimir as empresas
agrupadas por RA, quebrando por RA.
O sistema far a impresso de cada RA uma nica vez e ir saltar uma linha ou pgina a
cada mudana de RA.

Para dividir a informao impressa por grupos
Voc pode dividir a informao impressa por grupos, como por exemplo:
Quebrar a impresso pelo campo DATA de inscrio (imprime por grupo os dados dos
registros que tem campo DATA de inscrio igual);
Quebrar a impresso pelo campo CEP (imprime grupos de informao com o CEP idntico);
Quebrar por Cidade (imprime cidades iguais agrupadas).

Quebrando por um nico campo
Utilizando o mouse selecione (pressione) o campo que ser quebrado na caixa de Campos
Selecionados.
Pressione o boto Quebra.

Quebrando por mais de um campo
Repita a operao acima para todos os campos que voc deseja quebrar.
Continue repetindo os passos descritos acima para a escolha de todos os campos da quebra.
Importante Os campos selecionados na quebra devem ser os primeiros campos escolhidos na
caixa de texto Campos Selecionados e no pode haver nenhum campo entre eles que no
faa parte da quebra.
O indexador ativo deve ser formado pelos campos que fazem parte da quebra


Operaes Matemticas

Cria colunas (virtuais) com o resultado de expresses matemticas pr-estabelecidas.
Esta funo permite somar, subtrair, multiplicar, dividir, tirar o percentual ou totalizar
campos numricos, criando colunas virtuais.
Visual Kit 5 Verso 6.0.4.2
226

Fig 223

Para totalizar uma coluna numrica na consulta
Para totalizar um campo numrico, selecione a opo Totalizao.
Digite o nome do cabealho de totalizao;
Escolha o campo (numrico) que voc deseja totalizar;
Selecione o operador matemtico;
Digite um valor numrico ou tecle ENTER e selecione outro campo;
Ao final pressione o boto Ok.
O sistema fornecer automaticamente os seguintes resultados:
Total de registros (total de registros calculados);
Soma dos valores (soma da expresso matemtica registro a registro);
Mdia (mdia aritmtica);
Valor mnimo (menor valor calculado encontrado no arquivo);
Valor mximo (maior valor calculado encontrado no arquivo);
Varincia da Populao;
Desvio Padro.
Para retornar a tela da consulta pressione qualquer tecla.
Importante A multiplicao da coluna por "1" tem por objetivo efetuar a totalizao direta de
uma coluna numrica.

Para totalizar uma coluna numrica no relatrio
O total geral da soma dos campos ser impresso ao final do relatrio.
Se existir uma quebra o subtotal ser impresso a cada mudana de grupo (quebra) e o total
geral ao final do relatrio.
Para totalizar um campo numrico selecione o campo que ser totalizado na caixa de texto
Campos Selecionados e utilizando o mouse pressione o boto Totalizao.
Visual Kit 5 Verso 6.0.4.2
227
Para retirar um campo da totalizao remova o campo da caixa de texto Campos
Selecionados.
Observao A totalizao s tem efeito sobre a coluna. No possvel totalizar as linhas de
um relatrio.
No possvel totalizar o resultado das totalizaes.

Para criar colunas numricas calculadas
Utilizando o mouse pressione o boto Matemtica.
Digite o nome do cabealho da coluna matemtica;
Escolha o campo (numrico) que voc deseja utilizar no clculo;
Selecione o operador matemtico;
Digite um valor numrico ou tecle ENTER e selecione outro campo;
Ao final pressione o boto Ok.
O sistema criar novas colunas, com o resultado da expresso matemtica que voc montou.
Alerta A diviso por ZERO causar um erro de execuo. Filtre os valores diferentes de zero
antes de executar uma diviso.



Visual Kit 5 Verso 6.0.4.2
228
XVIII. Consultas, Relatrios e
Etiquetas Avanadas

A operao Consultas, Relatrios e Etiquetas Avanadas uma magnfica ferramenta que
permite a criao de inmeras consultas e relatrios a partir das entidades atual, incluindo
tambm dados das entidades relacionadas.

Quando voc usa esta operao, aberta a janela Gerador de Consultas Avanadas, como
mostra a Fig 224. Esta janela contm diversas pginas que descrevemos a seguir.

Origem dos Dados : preparando os dados

Na pgina Origem de Dados, voc pode escolher os campos que deseja consultar, filtr-os,
selecionar as quantidades de registros, etc., ou seja, prepara todo um ambiente de dados que
depois ser usado para gerar as consultas, relatrios, etiquetas e exportao de dados.


Fig 224 Janela do Gerador de Consultas Avanadas

Visual Kit 5 Verso 6.0.4.2
229

Fig 225 Escolhendo a Tabela



Na parte superior da pgina "Origem dos Dados" voc identifica as entidades ou tabelas, que
sero usadas na criao da sua consulta. Voc pode usar os botes no meio das duas listas para
passar campos de uma lista para outra.

Na parte inferior da janela esto disponveis 5(cinco) sub pginas: Campos-selecionar
campos, Filtro-filtra os registros, Ordenao-ordenar registros, Join(Juno)-relacionar
tabelas entre si e Seleo- seleciona registros.


Ateno A opo Join no est disponvel nesta verso.


Na sub-pgina Campos so listados todos os campos disponveis para a criao da sua
consulta avanada. Selecione aqui os campos que voc deseja apresentar da seguinte forma.

- Faa um clique sobre algum campo da lista Campos
- Clique no boto que indica a direo [>]. O campo agora aparece na lista da esquerda.
Veja nesta figura:

Visual Kit 5 Verso 6.0.4.2
230

Fig 226 Escolhendo os Campos

Clicando no boto voc abre o Construtor de Expresses mostrado na Fig 227 pora a
criao de expresses de diversos tipos, exemplo expreses matemticas, de caractere, etc.


Fig 227 Construtor de Expresses.

A sub-pgina Filtro permite especificar vrias condies para selecionar os registros das
tabelas. Cada condio pode ser separada pelos operadores lgicos OU e E que so definidos
na coluna Lgico.
Visual Kit 5 Verso 6.0.4.2
231


Fig 228 Janela que define o filtro

Ao criar filtros, voc estar realmente montando atraves dos operadores uma equao entre a
coluna Campos ou Expresses e o Valor. Os operadores relacionais disponveis para
criar filtros so os seguintes:

Operador Descrio
= (Igual): Determina que o valor do Campo seja igual ao Valor. Ex: Campo Fsico-
Jurdico seja igual a J (Jurdico). Veja na figura acima.
>(maior que): Especifica que o valor do campo deve ser maior do que o Valor.
>=(maior
igual que):
Especifica que o valor do campo deve ser maior ou igual do que o Valor.
<(menor que): Especifica que o valor do campo deve ser menor do que o Valor.
<=(menor
igual que):
Especifica que o valor do campo deve ser menor ou igual do que o Valor.
<>(diferente): Especifica que o valor do campo deve ser diferente do que o Valor.
Like
(contm):
Especifica uma comparao parcial. Por exemplo Campo.Nome like MAR,
retornar: MARIA, MAURICIO, MARTA, MARCOS, etc.

A sub-pgina Ordenao permite a definio de ordenao dos dados que aparecero na
consulta.

Visual Kit 5 Verso 6.0.4.2
232

Fig 229 Janela que define o tipo de ordenao

Clicando na coluna Ordenar Por: voc define a ordem em que os registros sero exibidos na
consulta ou relatrio. Selecione ASC para ascendente e DESC para descendente.





Ateno
A ordem de cliques na coluna Ordenar Por: indica a seqncia da Ordenao.


A sub-pgina Seleo permite definir a quantidade de registros que sero apresentados na
consulta, alm de disponibilizar o cdigo de seleo para edio.

A opo Definir a quantidade de registros que sero Visualizados: habilita o campo de
quantidade de registros que sero apresentados no resultado da consulta. O Valor inicial de
10 registros.

Visual Kit 5 Verso 6.0.4.2
233

Fig 230 Janela Seleo: Selecionando a quantidade de registros


Ateno
Antes de executar um Relatrio ou um Etiqueta preciso primeiramente executar a Consulta.




Visual Kit 5 Verso 6.0.4.2
234

Fig 231 Resultado da Consulta


Em qualquer momento, durante a montagem da consulta, voc pode examinar a declarao
SQL que corresponde as suas definies at aquele ponto. uma maneira bastante rpida de
aprender sobre a sintaxe e poder do comando SQL. Para habilitar a declarao SQL, use a
opo Escrever comando SQL habilita a edio do cdigo do select-SQL.

Depois de selecionados os campos, filtrados, ordenados, etc. chegou o momento de selecionar
a sada dos resultados. Para especificar a sada use os seguintes botes.

Funcionalidade dos botes:


Armazenar uma consulta. Digite o nome da consulta que voc deseja gravar e clique no boto
Voc pode salvar at 999 consultas por entidade. As consultas armazenadas podero ser
alteradas sempre que desejado.


Exclui uma consulta armazenada. Selecione na Combobox das consultas gravadas a consulta
que voc deseja excluir e clique no boto excluir.


Executa a consulta. Uma vez que voc tenha definido uma consulta, voc poder executar a
consulta e os resultados sero exibidos na pgina Consulta.

Visual Kit 5 Verso 6.0.4.2
235

Manda a seleo para um Relatrio. As consultas criadas so a base para a criao de
sofisticados relatrios. Clique neste boto aps a confeco, na seleo de uma consulta
armazenada e modele diferentes tipos de relatrios. Esta opo ser aprofundada na seguinte
seo (Report Designer)


Manda a seleo para o recurso de Etiquetas. As consultas criadas so a base para a criao de
etiquetas. Voc pode modelar diferentes tipos de etiquetas usando Label Designer.


Guarda a seleo numa Tabela. Existem vrios tipos de formatos que voc pode usar, exemplo
Excel, texto, DBF, etc. O resultado das consultas poder ser exportado ao clicar o boto
exportar, definindo primeiramente o tipo do arquivo e o nome.

Atravs desta rotina voc poder enviar o resultado da sua pesquisa para o Excel e criar
sofisticados grficos usando as opes desta ferramenta.


Fig 232 Formatos de exportao da consulta.

Ateno ! Esta opo no est disponvel nesta verso.


Criando e personalizando Relatrios
Report Designer

O relatrio um meio simples e fcil de apresentar informaes da Base de Dados em
documentos impressos. Nesta seo mostramos como elaborar e emitir relatrios utilizando o
Report Designer.

Os relatrios tm dois componentes bsicos: a fonte de dados e o layout. A fonte de dados,
como foi vista na seo anterior, normalmente uma ou mais tabelas, podendo ser filtradas,
Visual Kit 5 Verso 6.0.4.2
236
ordenadas e selecionadas. O layout que descreveremos nesta seo - a forma em que os
elementos que compe o relatrio so dispostos na pgina.

As bandas de um relatrio
Um relatrio se constitui pelo menos em trs bandas: Encabeamento, Detalhes e Rodap, que
aparecem como bandas default em um relatrio vazio. Voc pode definir, alm disso, um
Ttulo e criar vrias bandas aninhadas, definindo grupos um dentro de outro.

A banda Detalhes onde, tipicamente, so includos, em uma linha ou mais, os campos para
cada registro da tabela que est sendo impressa.

Depois de definir os dados sega os seguintes procedimentos:

- Clicar no boto executar consulta.
- Clicar no boto Relatrio (indicado por um cone impressora).
- Aparecer a janela de Layout. Veja na Fig 233.



Fig 233 Janela Layout do Criador de Relatrios

Ttulo:
Voc usa a opo Ttulo na janela Layout para criar a banda Ttulo que encabea o relatrio.

Agrupamento:
Voc usa as opes Agrupar/NovoGrupo/Totalizao para agrupar em bandas os registros a
serem impressos no relatrio.

Aqui voc cria ou modifica os grupos aninhados que separam os dados do relatrio em bandas.
Cada banda constituda de um cabealho e de um rodap, e ela funcionalmente definida por
um campo ou expresso que muda de valor quando relatrio est sendo impresso
Visual Kit 5 Verso 6.0.4.2
237

Os campos ou expresses selecionados para agrupamento definiram as quebras, cuja mudana
de valor, durante a impresso do relatrio, determina o incio de uma nova banda. A ordem dos
grupos nessa lista muito importante, os grupos devem ir de pai para filho.

Por exemplo, num relatrio sobre faturamento, voc tem as tabelas relacionadas Clientes,
Faturas e Itens da Fatura. A primeira banda se repete toda vez que um novo Cliente comea ser
impresso; a Segunda, quando uma nova Fatura do Cliente (ordem) comea ser impressa; e os
itens da Fatura so os Detalhes sendo impressos.

Visualizando e Imprimindo

Clicando sobre este boto com o mouse, voc - em qualquer momento- pode visualizar
como est ficando o relatrio antes da impresso. Aparecer a visualizao acompanhada com
os seguintes botes de opes padro Windows:



Fig 234 Botes de Visualizao e Impresso.


Personalizando o Relatrio

Clicando neste boto, voc personalizar o relatrio incluindo rtulos, logos, ajustando
a posio, etc. Esta opo chamara uma tela com as bandas definidas na opo do
agrupamento. Veja na Fig 235 as trs bandas default de um relatrio vazio. Aparece tambm
uma Caixa de Ferramentas e uma janela de Propriedades, muito similar a descrita quando
desenhamos os formulrios das entidades (veja no Captulo V).


Visual Kit 5 Verso 6.0.4.2
238


Fig 235 Personalizando Relatrio.

A caixa de ferramentas permitir inserir ou desenhar rtulos e imagens nos relatrios. Para
adicionar:
- Selecione primeiro o objeto desejado na caixa de ferramentas fazendo um clique no
cone correspondente
- Leve o ponteiro do mouse para o local desejado dentro da banda especfica do relatrio.
- D um clique no mouse e o objeto ser desenhado no lugar indicado.

Exemplo: Vamos inserir um logo no cabealho do relatrio. Para incluir uma imagem basta:
- clicar no objeto imagem e selecionar a banda no relatrio. Veja na seguinte figura.

Visual Kit 5 Verso 6.0.4.2
239


Fig 236 Inserindo uma imagem

- Clicar na propriedade Figura para definir o arquivo que contm a imagem.


Fig 237 Selecionando o arquivo com a imagem.

Visual Kit 5 Verso 6.0.4.2
240

Fig 238 Imagem inserida no cabealho.


Visual Kit 5 Verso 6.0.4.2
241

Fig 239 Relatrio Personalizado



Voc pode tambm, ajustar visualmente a altura de qualquer banda, clique no layout em cima
da seta prefixado o nome da banda, e arraste verticalmente.

Criando e personalizando Etiquetas Label
Designer

A Etiqueta um relatrio multicolunas que coincide com algum papel de etiquetas particular.
No Visual Kit 5, voc pode criar etiquetas de uma maneira simples usando diferentes formatos
ou configuraes de etiquetas.

Depois de selecionada a origem de dados -explicada acima- voc poder acessar o Label
Designer clicando no boto com o cone de envelope.

Visual Kit 5 Verso 6.0.4.2
242



Na seguinte figura mostrada a janela da interfase do criador de etiquetas. Na parte superior da
janela mostrada uma lista com as diferentes configuraes de etiquetas. As etiquetas so
cadastradas para o dado fabricante selecionado na entrada de dados Fabricante. Selecione a
etiqueta clicando encima de sua configurao. Automaticamente ser mostrado a forma na rea
inferior direita.


Fig 240 O Label Designer

Visual Kit 5 Verso 6.0.4.2
243

Fig 241 Personalizando a Etiqueta


Fig 242 Resultado final da gerao das etiquetas.

Na lista esquerda so mostrados os campos selecionados no passo Origem de Dados. Voc
poder inserir estes campos na ordem desejada, assim como rtulos usando os botes.
Visual Kit 5 Verso 6.0.4.2
244

Visual Kit 5 Verso 6.0.4.2
245
Criando Cdigos de Barras

Uma opo muito usada em varias aplicaes a gerao dos cdigos de barras,
principalmente em relatrios ou etiquetas. Criar cdigos de barras nos sistemas gerados pelo
Visual Kit 5 muito fcil. Vejamos os procedimentos.

Instalar Fonte

O primeiro passo a realizar a incluso de uma fonte tipo cdigo de barra caso no exista -
no computador onde o sistema gerado vai rodar. Este passo realizado uma nica vez. Para
isso:

- D um clique no boto Iniciar (Start) na barra de tarefas (Task Bar) do seu Windows
(ou pressione <CTRL>+<ESC>).
- No menu apresentado, selecione Configuraes (Settings).
- Na janela aberta clique no Painel de Controle (Control Panel)



Fig 243 Selecionando o Painel de Controle


- Ser aberta a janela da Fig 244 com todas as pastas do Painel de Controle.
- Selecione a pasta Fontes (Fonts), indicada na figura com o circulo em vermelho.
- Automaticamente ser aberta uma janela com todas as fontes usadas no computador
(Veja na Fig 245).
- Clique em Arquivo (File) e selecione Instalar Nova Fonte... (Install New Font...).
Visual Kit 5 Verso 6.0.4.2
246

Fig 244 Pastas do Controle de Painel


Fig 245 Inserindo uma nova fonte
Visual Kit 5 Verso 6.0.4.2
247


- Indique o caminho da nova fonte Barcode39 que se encontra na pasta do sistema
gerado, (ex. Kit_clientes), dentro do parameters, na pasta font. Ou seja
c:\Kt_clientes\parameters\font
- Selecione a fonte Barcode39 e clique no boto OK.
- Automaticamente ser instalada a fonte. Veja na Fig 247 a fonte j instalada.




Fig 246 Selecionando a nova fonte




Fig 247 Barcode instalado.




Visual Kit 5 Verso 6.0.4.2
248

Criando o Cdigo de Barra

Vamos a mostrar o uso desta opo, gerando etiquetas com cdigo de barras. Veja os
procedimentos:

- Selecione a operao Consulta, Relatrio e Etiquetas Avanadas como vimos na
seo anterior.
- Escolha a entidade ou arquivo com o campo que deseje converter em cdigo de barras.
- Clicando no boto abra o Construtor de Expresses mostrado na Fig 249 para
criar uma nova expresso que converter o campo em cdigo de barras.


Fig 248 Escolhendo a Origem de Dados

- Dentro do Construtor de Expresses, clique encima do campo que voc deseja
converter para cdigo de barras (ex ISBN) e selecione a funo preestabelecida Cdigo
de Barra campo caractere dando um duplo-clique.
- Automaticamente ser preenchida a expresso mostrada na Fig 250 que realizar a
converso. Digite um nome para esta expresso (ex. Barras) e clique no boto OK.


Visual Kit 5 Verso 6.0.4.2
249

Fig 249 Construtor de expresses





Fig 250 Expresso para cdigo de barras.

Visual Kit 5 Verso 6.0.4.2
250
- Veja nesta figura como ficou a origem de dados depois da criao da expresso. Voc
pode inserir ou no outros campos (ex. TITULO).
- Clique no boto para executar Consulta.




Fig 251 Origem de dados com expresso de converso do cdigo de barras.



Ateno! Antes de executar um Relatrio ou uma Etiqueta preciso primeiramente
executar a Consulta.

Visual Kit 5 Verso 6.0.4.2
251

Fig 252 Consulta executada.

- Clique no boto de criar etiquetas como descrito na seo anterior.
- Selecione os campos e personalize a etiqueta
- Clique encima do campo com o cdigo de barra (ex. Barras) e clique no boto Fonte.
- Aparecer a janela da Fig 254 onde selecionaremos a fonte cadastrada no passo
anterior, ou uma outra fonte de tipo de cdigo de barras.
- Por ltimo clique no boto visualizar para ver o resultado das etiquetas com cdigo de
barras. Veja na Fig 255.


Visual Kit 5 Verso 6.0.4.2
252

Fig 253 Personalizando o formulrio



Fig 254 Selecionando a fonte.



Visual Kit 5 Verso 6.0.4.2
253

Fig 255 Resultado final



Visual Kit 5 Verso 6.0.4.2
254
XIX. OLAP e Data Mining

OLAP- Processamento Analtico Online

O recurso On-Line Analytic Processing ou processamento analtico on-line proporciona as
condies de anlise de dados para responder perguntas com enfoque mais estratgico e de
maneira simples e rpida.

O que OLAP?
O OLAP uma maneira especial de colocar ou modelar os dados das tabelas do sistema. De
um ponto de vista prtico, usando o OLAP, o prprio usurio realiza consultas interativas aos
dados, seguindo um caminho de anlise atravs de mltiplos passos, como, por exemplo:
aprofundar-se sucessivamente por nveis mais baixos de detalhe de um quesito de informao
especfico.

No OLAP os dados so processados em um formato chamado de Cubos-OLAP ou
simplesmente de Cubos. Este modelo permite realizar anlises multidimensionais (cruzamento
de varias informaes) de uma maneira rpida. Vejamos na Fig 256 um modelo esquemtico
de um Cubo-OLAP. Neste exemplo, o cubo est formado por trs dimenses: Geogrfica,
Produtos e Tempo. (o nmero de dimenses pode maior ou menor colocamos trs para dar
uma explicao melhor do conceito). Cada clula do cubo guarda uma informao que podem
ser totalizadas em nveis superiores ou desmembradas em nveis inferiores. Exemplo os niveis
Estado->Ciudade->Bairro.

Navegar e manipular as clulas do cubo pode ser feita atravs de uma tabela dinmica (Pivot
Table), onde as linhas e colunas so conformadas e mudadas de acordo as necessidades do
usurio com simples cliques do mouse.


Fig 256 Modelo esquemtico dos Cubos OLAP
Visual Kit 5 Verso 6.0.4.2
255

Procedimentos para usar o OLAP

Na janela OLAP voc encontrar trs pginas: Origem de Dados, Criao de Cubo e OLAP.
Vejamos a seguir a finalidade de cada uma.

Origem de Dados

Na janela Origem de Dados voc identifica primeiramente as entidades (tabelas), que sero
usadas para processar ou criar o cubo. Os campos das entidades so logo carregados na lista
Campos, para a seleo. Selecionados os campos que sero usados, voc pode clicar na
prxima pgina: Criao do Cubo.



Fig 257 Janela de seleo dos Dados para gerar os cubos OLAP

Criando o Cubo

Na pgina Criao de Cubo voc escolher quais campos sero as dimenses (campos para o
cruzamento) e quais sero totalizaes. Totalizao o parmetro que ser analisado e as
dimenses, as variveis para fazer os cruzamentos de dados na pesquisa OLAP. Por exemplo:
Visual Kit 5 Verso 6.0.4.2
256

Fig 258 Escolhendo as Totalizaes e as Dimenses.

Voc poderia indicar - selecionando e arrastando com o mouse- uma totalizao igual a
quantidade de clientes (Count), e as dimenses Sexo, Profisso, Casa Prpria, Carro e
Carto.

Na entrada de dados Nome do Cubo, coloque um nome para o cubo que vai ser criado.

Clique no boto Criar Cubo e o cubo ser processado e gerado. Voc pode apagar cubos
anteriores que no estejam sendo usados, selecionando-o e clicando no boto Apaga Cubo.


Nota
Voc pode criar dimenses com nveis hierrquicos - exemplo Estado->Cidade->Bairro
mantendo sempre a ordem da hierarquia. Para isso, basta com o mouse arrastar o campo de
nvel inferior para embaixo do campo de nvel superior de forma que crie uma estrutura em
rvore.


Em dependncia da quantidade de dados e do nmero de dimenses e totalizaes o
processamento do cubo pode demorar. Ser apresentada uma mensagem indicando que o cubo
est sendo processado.

Visual Kit 5 Verso 6.0.4.2
257
Bom, depois do processamento, chegou a hora de navegar pelo cubo e fazer as pesquisas
desejadas. Clique para na pgina de Olap.

Navegando pelo Cubo

Na pgina OLAP (Fig 259) voc poder realizar as pesquisas usando como interface uma
tabela dinmica. Os procedimentos so os seguintes.


Fig 259 Pagina de analise e navegao pelo cubo
- Na entrada de dados Nome do Cubo selecione o nome do cubo processado.
- Para carregar o cubo, clique no boto com a imagem de um cubo azul.
- Ser apresentada uma tabela dinmica. Esta tabela possui um menu com varias opes.
- Selecione a opo indiada na Fig 260, para aparecer aberta a lista das dimenses e
totalizaes do cubo.
- Selecionando e arrastando com o mouse, coloque os items da lista aberta na tabela
dinmica da forma desejada. Veja na Fig 261

Voc pode utilizar as ferramentas apresentadas na tabela dinmica como por exemplo carregar
o cubo no programa Excel para a gerao de grficos. Para maiores informaes pressione o
boto Help da janela.

Visual Kit 5 Verso 6.0.4.2
258

Fig 260 Selecionando a lista das dimenses.


Fig 261 Navegando pelo Cubo

Principais Definies
Dentro do navegador do cubo existe uma opo de ajuda (Help) com uma explicao bastante
detalhada do manuseio da tabela dinmica. Esta ajuda pode aparecer em idioma ingls, por
isso, colocamos aqui algumas definies importantes.

Drill Across: O Drill Across ocorre quando o usurio pula um nvel intermedirio dentro de
uma mesma dimenso. Por exemplo: a dimenso tempo composta por ano, semestre,
Visual Kit 5 Verso 6.0.4.2
259
trimestre, ms e dia. O usurio estar executando um Drill Across quando ele passar de ano
direto para semestre ou ms.
Drill Down: O Drill Down ocorre quando o usurio aumenta o nvel de detalhe da informao,
diminuindo o grau de granularidade.
Drill Up: O Drill Up o contrrio do Drill Down, ele ocorre quando o usurio aumenta o grau
de granularidade, diminuindo o nvel de detalhamento da informao.
Slice And Dice: O Slice and Dice uma das principais caractersticas de uma ferramenta
OLAP. Ele serve para modificar a posio de uma informao, alterar linhas por colunas de
maneira a facilitar a compreenso dos usurios e girar o cubo sempre que tiver necessidade.
Alertas: Os Alertas so utilizados para indicar situaes de destaque em elementos dos
relatrios, baseados em condies envolvendo objetos e variveis. Servem para indicar valores
mediante condies, mas no para isolar dados pelas mesmas.
Ranking: A opo de ranking permite agrupar resultados por ordem de maiores / menores,
baseado em objetos numricos (Measures).Esta opo impacta somente uma tabela direcionada
(relatrio) no afetando a pesquisa (Query).
Filtros: Os dados selecionados por uma Query podem ser submetidos a condies para a
leitura na fonte de dados. Os dados j recuperados pelo Usurio podem ser novamente
filtrados para facilitar anlises diretamente no documento.
Sorts: -Os sorts servem para ordenar uma informao. Esta ordenao pode ser customizada,
crescente ou decrescente.

Data Mining Inteligncia Artificial

Data Mining ou Explorao de Dados um ramo da informtica que utiliza tcnicas de
estatsticas e inteligncia artificial para construir modelos matemticos.

Data Mining o processo de extrair informao vlida, previamente desconhecida e de
mxima abrangncia a partir de grandes bases de dados, usando-as para efetuar decises
cruciais. O Data Mining vai muito alm da simples consulta a um banco de dados, no sentido
de que permite aos usurios explorar e inferir informao til a partir dos dados, descobrindo
relacionamentos escondidos no banco de dados. Pode ser considerada uma forma de
descobrimento de conhecimento em bancos de dados.

Definio
Data Mining difere de tcnicas estatsticas porque, ao invs de verificar padres hipotticos,
utiliza os prprios dados para descobrir tais padres. Por exemplo, supondo que o analista que
queria identificar os fatores de risco, utilizasse uma ferramenta de Data Mining. A ferramenta
poderia descobrir que mulheres adultas so clientes de risco, mas a ferramenta pode ir alm e
descobrir um padro que o analista no pensou inicialmente. Por exemplo, que o tipo de estado
civil e nmero de filhos em combinao com a idade da mulher tambm so determinantes do
risco.

Onde utilizar o Data Mining.
O Data Mining pode ser utilizado com os seguintes objetivos:
Visual Kit 5 Verso 6.0.4.2
260

-Explanatrio: explicar algum evento ou medida observada. Ex: Por que a aberturas de novas
contas subiram no Rio de Janeiro?;
-Confirmatrio: confirmar uma hiptese. Ex: pode-se querer examinar os registros dos clientes
para determinar se famlias de duas rendas tem mais probabilidade de adquirir um seguro de
vida do que famlias de uma nica renda;
-Exploratrio: analisar os dados buscando relacionamento novos e no previstos. Ex: analisar
registros histricos para determinar que fatores esto associados a clientes que devolvem um
produto.

Entre as aplicaes tpicas do uso das tecnologias de Data Mining se destacam: Predio do
lucro, gastos, etc; Aquisio de novos clientes; Reteno de clientes; Deteco de Fraudes; etc.

Recursos de Data Mining no Visual Kit 5.

O recurso de Data Mining implementado na verso Standard do Visual Kit 5 um recurso
muito usado na criao de modelo preditivos. Ele composto de um nico algoritmo chamado
de Microsoft DecisionTrees (Arvores de Deciso). Este algoritmo determina as regras para
predizer o contedo de um determinado campo chamado tambm de campo de predio ou
de sada do modelo- em dependncia dos valores de outros campos - (chamados de campos de
entrada do modelo).


Nota
Sai do marco deste livro a explicao do modelo de Microsoft DecisionTrees. Informaes
detalhadas deste algoritmo podero ser encontradas na pgina da Microsoft.
Em prximas atualizaes do produto sero includos novos algoritmos de Data Mining.


No recurso de Data Mining voc encontrar trs pginas: Origem de Dados, Criao do
Modelo e Treina Modelo. De maneira geral voc realizar:

- Passo 1: Voc seleciona primeiramente uma tabela contendo os casos, de onde o
algoritmo de Data Mining vai extrair as informaes;
- Passo 2: Voc define os campos de entrada do modelo e o campo que vai ser predito;
- Passo 3: A tabela de casos dividida em duas partes: uma parte dos registros so
utilizados para criar o modelo, ou seja achar as regras de predio; a outra parte ser
utilizada para testar as regras. No teria poder de generalizao testar o modelo com os
mesmos dados que o modelo foi criado;

Na fase de teste, calculado um valor de erro que, quanto menor seja este valor, melhor fica o
modelo;

- Passo 4: Escolha do melhor modelo na prtica voc criar vrios modelos, e escolhe o
que menor valor de erro possua;
Visual Kit 5 Verso 6.0.4.2
261

Selecionado o melhor modelo, voc o embute dentro do formulrio para predizer novos
contedos do campo. Por exemplo:

Imagine que voc tem um negcio que outorga aos clientes um carto que o identifica como
cliente VIP, Executivo ou Standard. Agora, suponha que voc queira que quando seja
preenchido o formulrio de cadastro de um novo cliente, o sistema prediga automaticamente -
segundo as caractersticas do cliente - qual o melhor carto para ele, e mostre este resultado
para que ajude a voc tomar uma deciso. A regra de predio seria achada usando a base
acumulada de clientes do sistema.

Selecionando a Origem dos Dados
A janela Origem de Dados similar janela apresentada do OLAP vista anteriormente. Aqui
voc pode realizar as seguintes tarefas preparativas:

- Identificar as entidades, que sero usados para criar o modelo de predio;
- Os campos destas entidades sero carregados na lista Campos;
- Selecionar os campos que sero usados no modelo


Nota Voc precisa sempre selecionar um campo que seja chave (primria) e que
identifique os registros da tabela de casos que voc vai pesquisar.


Visual Kit 5 Verso 6.0.4.2
262

Fig 262 Seleo dos dados.

Criando o Modelo
Nesta pgina (veja na Fig 263) voc indicar qual dos campos selecionado no passo anterior,
vai ser o predito, ou seja, a sada do modelo, e quais sero usados para fazer a predio as
entrada do modelo. Os procedimentos a seguir so:

- Arraste primeiro o campo chave (que identificar cada caso) para o quadro Chave;
- Arraste o campo que ser predito para o quadro Predio;
- Arraste os campos que faro parte da entrada do modelo, isto , os campos a partir dos
quais voc ir predizer o modelo para o quadro Dados de Entrada;
- Na entrada de dados Nome do Modelo, preencha um nome para o modelo que voc
deseja criar e pressione o boto Criar Modelo
- Ser criada a estrutura do modelo;

O modelo criado nesta fase realmente est vazio, ele precisa ser treinado com os dados da
tabela de casos para poder predizer depois os eventos.

Campos de tipo hierrquicos (como por exemplo: carto Platinum, Gold, Normal), tem que
receber um peso, para poder avaliar bem a predio feita. Normalmente voc dever atribuir
pesos para campos caracteres Fig 264. O peso tem que ser um nmero inteiro que indique a
hierarquia.

Visual Kit 5 Verso 6.0.4.2
263

Fig 263 Criando o modelo.

Fig 264 Colocando valores a campos hierrquicos.
Visual Kit 5 Verso 6.0.4.2
264

Treinando e testando o modelo
Nesta fase (veja a janela na Fig 265) voc faz o treinamento do modelo. O treinamento consiste
em clculos matemticos sofisticados que so realizados para achar as regras de predio, mas
que so totalmente transparentes para voc. Os procedimento so:

- Selecione o modelo na entrada de dados.
- Na entrada de dados Percentual de Treinamento, selecione o percentual de registros
(casos) que sero utilizados para o treinamento do modelo. Os registros que no forem
utilizados no treinamento, sero utilizados para validar o modelo.

No caso da Fig 265, 80% da tabela de casos sero utilizados no treinamento do modelo e 20%
sero utilizados para validar o modelo preceptivo.


Fig 265 Treinando e Testando o modelo.
- Clique o boto Treina Modelo para treinar o modelo.

O modelo comear a ser treinado, s vezes pode levar um tempo, em dependncia dos dados
do modelo e o desempenho de seu computador. Depois de finalizado o treinamento hora de
avaliar o modelo.

A avaliao feita clicando o boto Testa Modelo. Para o teste sero usados os casos que
no participaram da criao das regras. Aqui sero comparando o valor real com o predito.
Visual Kit 5 Verso 6.0.4.2
265

Ao final do teste o quadro ser preenchido com: o campo chave da tabela de casos, o contedo
real do campo, o valor predito e a probabilidade de predio de cada registro ou seja, a
probabilidade que o valor predito certo.

Tambm calculado o valor do Erro Mdio Quadrtico que um parmetro que mede de
maneira geral o desempenho do modelo e que podemos usar para fazer comparaes na
escolha do melhor modelo. Quanto menor for o Erro Mdio Quadrtico, melhor ser o modelo.

Usando o modelo
A ltima fase embutir o modelo dentro do formulrio para us-lo. Clique no boto Executa
na Incluso para atribuir a predio ao campo predito automaticamente aps a incluso de
registros.

Visual Kit 5 Verso 6.0.4.2
266
XX. Apndices

A. Convertendo sistemas da verso 4.6
para a verso 6.0 do Visual Kit 5

A Ebendinger disponibiliza em seu site, um programa para converter sistemas gerados com a
verso 4.6 do Visual Kit 5 para a nova verso do Visual Kit 5.

O programa conversor cria um novo diretrio, converte o sistema para a nova verso e copia os
arquivos para os novos sub-diretrios do sistema gerado.

Na cpia dos arquivos o conversor organiza o diretrio do sistema da seguinte forma:
sub-diretrios no sistema convertido:

\SOURCE programas fontes (funes especficas)
\PARAMETERS\FORM formulrios (scx)
\PARAMETERS\REPORT relatrios (frm)
\PARAMETERS\LABEL etiquetas (lbx)

os demais arquivos so organizados por tipo do dado armazenado.

Visual Kit 5 Verso 6.0.4.2
267
B. Atualizando o Visual Kit 5 e sistemas
gerados

A Ebendinger criou e disponibiliza em seu site, um programa para atualizar o Visual Kit 5 e os
sistemas gerados.

Sempre que a Ebendinger concluir um ajuste ou incluir novidades no Visual Kit 5 ou nos
sistemas gerados, os arquivos alterados sero disponibilizados em nosso servidor de FTP (File
Protocol Transfer).

Faa o download free do programa de atualizao, e execute o programa periodicamente
para verificar se existem novidades em nosso servidor de FTP.

O download dos ajustes permitido somente aos usurios cadastrados do Visual Kit 5. Veja na
figura abaixo o funcionamento do programa de update (atualizao).



Fig 266 Programa de atualizao do Visual Kit 5.

Pressione o boto "Seleo para Kit 5", para selecionar o diretrio do Visual Kit 5 em seu
micro, como no exemplo abaixo.

Visual Kit 5 Verso 6.0.4.2
268

Fig 267 Selecione o diretrio do Visual Kit 5

Pressione o boto "Seleo para sistemas gerados", para selecionar os diretrios dos sistemas
gerados que voc deseja atualizar.

Ao final da seleo de diretrios, pressione o boto "Atualizar", para iniciar o download e
cpia dos arquivos para os diretrios selecionados.


Fig 268 Fim da atualizao.
Visual Kit 5 Verso 6.0.4.2
269
C. Denominao das Tabelas, Mdulos,
Entidades no Visual Kit 5

No Visual Kit 5, as tabelas so enumeradas internamente com a letra B seguida com cinco
dgitos cumprindo sempre o seguinte padro:

B*****
Fig 269 Denominao das tabelas no Visual Kit 5
em que:
- Os primeiros dois dgitos indicam o nmero do mdulo a que pertence.
- Os restantes trs dgitos indicam o nmero da entidade.

tendo em conta que os nmeros dos mdulos atribudo pela ordem de criao dos mesmos. O
primeiro mdulo criado ser o 01, o segundo 02 e assim por diante. O mesmo acontece
com a enumerao das entidades.

Exemplo . B01001 tabela da primeira entidade do primeiro mdulo.
B03002 tabela da segunda entidade do terceiro mdulo

Visual Kit 5 Verso 6.0.4.2
270
D. Propriedade Formatos e Mscara de
Edio

Usando o controle TextBox, que sem duvida a forma mais usada de inserir dados, o usurio
pode inserir qualquer texto. Mas as vezes preciso gerenciar essa entrada de dados para que o
texto seja inserido de uma formatao ou apresentao especial, coisas como permitir a entrada
somente de caracteres maisculos ou somente nmeros ou at mesmo formatao especfica de
telefone ou CPF. Colocar estas regras muito fcil de fazer usando as propriedades de Formato
do Campo e Mscara de Edio.

Os formatos de dados so utilizados no s para exibir o contedo dos dados no monitor, mas
tambm na us-lo na impresso, por exemplo, voc poderia imprimir somente uma parte dos
dados. Veja na Fig 270 onde localizada estas propriedades.



Fig 270 Localizao das propriedades Formato do Campo e Mascara de Edio


O propriedade Formato do Campo possui vrios valores que descrevemos na tabela:

Visual Kit 5 Verso 6.0.4.2
271
Definio Descrio
! Converte para maisculas caracteres. Utiliza apenas para campos caractere.
$ Exibe o smbolo monetrio. O campo deve ser numrico.
^ Exibe valores numricos com notao cientfica.
A Permite apenas caracteres alfabticos (sem espaos ou marcas de pontuao).
D Usa o formato de Data especificado.
E Edita campo Data como data Britnicas.
K Seleciona todo o texto quando o controle recebe o foco.
L Exibe zeros esquerda no lugar de espaos. O campo deve ser numrico.
R Exibe a mascara do formato para o TextBox especificada na propriedade
Mscara de Edio que veremos a continuao. Exemplo: se a mscara for 99-
999, o nmero 12345 ser exibido assim 12-345, mais o hifem no ser
gravado. Este somente para campo caractere ou numrico.
T Retira os espaos para o campo digitado.
YS Exibe campo data no formato resumido.
YL Exibe campo data no formato longo, com hora.

A propriedade Mascara de Edio permite mascarar a entrada de dados realizada pelo
usurio. Os caracteres definidos para a definio da mscara esto descritos na tabela XX

Mscara Descrio
X Permite a entrada de qualquer caractere.
9 Permite a digitao de dgitos e sinais, como o de subtrao ( ).
# Dgitos, espao em branco e sinais podem ser digitados.
$ Exibe o smbolo monetrio numa posio fixa.
$$ Exibe o smbolo monetrio em uma posio flutuante, prximo a qualquer digito
num Spinner ou TextBox.
* Asteriscos sero exibidos esquerda do valor.
. Um ponto especifica a posio do ponto decimal.
, Virgulas podem ser includas para separar os dgitos a esquerda do ponto
decimal.
Visual Kit 5 Verso 6.0.4.2
272


Nota
Os sistemas gerados pelo Visual Kit 5 suportam os mesmos formatos (InputMask e Format) da
linguagem Visual FoxPro v.6.0.

Exemplos:

Mscara para campo Data: ##/##/####.
Campo do tipo DATA.
Exemplo: 16/12/1964.

Tipo de Campo: Numrico
Tamanho do Campo: 10
Decimais: 2
Formato: $
Mascara: 9,999,999.99
Exemplo: Salrio, Valor, Preo.

Tipo de Campo: Numrico
Tamanho do Campo: 11
Decimais: 0
Formato: K
Mascara: 999-9999-9999
Exemplo: Telefone, Fax.

Visual Kit 5 Verso 6.0.4.2
273

E. Operadores
Os Operadorespermitem que voc manipule dados do mesmo tipo. Os operadores so
agrupados da seguinte forma.

- Operadores de caracteres
- Operadores de data
- Operadores Lgicos
- Operadores Relacionais
- Operadores Numricos

Operadores de Caracteres
Voc pode juntar e comparar dados usando os operadores +, -, e $.

Operador Ao Exemplo
+ Concatenao. Junta duas seqncias de caracteres
(strings).
'Bom ' + 'dia'
- Concatenao. Elimina espaos em branco do
elemento que precede ao operador,
posteriormente junta os dois elementos
client.Nom - client.SobreNom
$ Comparao. Procura uma expresso caractere em
outra
'father' $ 'grandfather'

Operadores de Datas

Operador Ao Exemplo
+ Adio dNewDate = dDate1 + nDays
- Subtrao dNewDate = dDate1 - nDays

Operadores Lgicos
Os operadores lgicos trabalham com qualquer tipo de dados e retorna um valor Lgico.

Operador Ao Exemplo
( ) Expresso de grupo Var1 AND (Var2 AND Var3)
NOT, ! Negativo Lgico IF NOT VarA = VarB
IF ! nVar1 = nVar2
AND Lgico E Campo0 AND Campo9
OR Lgico OU CampoX OR CampoY

Operadores Numricos
A seguinte tabela mostra os operadores numricos em ordem de precedncia.
Visual Kit 5 Verso 6.0.4.2
274

Operador Ao Exemplo
( ) Agrupa sub-expresso (4-3) * (12/nVar2)
**, ^ Exponencial 3 ** 2
3 ^ 2
*, / Multiplicao e diviso 2 * 7
14 / 7
% Mdulo (resto) 15 % 4
+, - Adio e subtrao 4 + 15

Operadores Relacionais
Os operadores relacionais trabalham com todos os tipos de dados e retorna um valor Lgico

Operador Ao Exemplo
< Menos que 23 < 54
> Maior que 1 > 2
= Igual a Var1 = Var2
<>, #, != No igual a .T. <> .F.
<= Menor que ou igual a 1998/02/16 <= 1998/02/16
>= Maior que ou igual a 32 >= 31
== Comparao de caracteres
string
status == "Aberto"

















Visual Kit 5 Verso 6.0.4.2
275
F. Regras de nomenclaturas Ebendinger

1. Funes Especficas
2. Sub-funes
3. Funes de uso geral
4. Variveis
5. Formulrios
6. Etiquetas
7. Imagens
8. Help
9. cones
10. Documentos Word e outros
11. DataBase
12. Table (arquivo)
13. ndice
14. Query
15. View
16. Classe
17. Arquivo Texto
18. Menu
19. Report


Funes Especficas:
So nomeadas pelo Visual Kit 5.

Exemplo: E0301526

Colunas Descrio
E Especfica (funo)
03 Terceiro Mdulo
015 Dcima quinta Entidade
2 Com abertura de arquivo pela APP
6 Etiqueta

Tipo de Funo Descrio
1 Funo Bsica da APP
2 Func. Especfica com abertura de arquivos pela APP (bearq)
3 Sem abertura de arquivo. O programador pode abrir dentro da funo
se necessrio.
4 Reservada
5 Chamada a executvel externo


Visual Kit 5 Verso 6.0.4.2
276

Tipo de Operao Descrio
1 Incluso
2 Alterao
3 Excluso
4 Consulta
5 Relatrio
6 Etiqueta
7 Reservada
8 Reservada
9 Transferncia

Sub-funes:
Funes chamadas e criadas dentro de uma funo especfica. Nomeadas pelo programador da
funo especfica. Usar o nome da funo especfica onde a sub-funo foi originalmente
criada, acrescido de um nmero seqencial ascendente, iniciado em 001 at 999.

Exemplo: S0301526020()

Colunas Descrio
S Sub-funo
03 Criada originalmente no mdulo 03
015 Criada originalmente para a entidade 015
2 Com abertura de arquivo. Repete o byte usado nesta coluna no nome da
funo especfica Primitiva (original)
6 Etiqueta. Repete o byte usado nesta coluna no nome da funo especfica
Primitiva.
020 Sub-funo de nmero 020, na funo especfica E0301526. Nmero
seqencial ascendente.


Diretrio: Todas as funes especficas e sub-funes devem ser gravadas no sub-diretrio
SOURCE\D01...D02.. D99 de acordo com o mdulo ao qual pertence a entidade, no diretrio
do sistema gerado.

Exemplo: H:\CREMERJ\SOURCE\d03

Funes de uso geral:
Criadas para utilizao por mais de uma funo especfica ou sub-funo. Nomeadas pelo
programador da funo. Usar um nome que permita uma fcil identificao.

Os dois primeiros bytes do nome da funo indicam o valor de retorno da funo.


Visual Kit 5 Verso 6.0.4.2
277
Exemplo: lgMontaFiltro()

Tipos de Funo (por retorno) Descrio do valor de Retorno
Ct Caracter
Dt Data
Nm Numrico
Cn Currency (moeda)
Fl Float
Dm DateTime
Db Double
In Inteiro
Lg Lgico
Mm Memo
Gn General (imagem, ole...)

Diretrio: Todas as funes de uso geral devem ser gravadas no sub-diretrio
SOURCE\general, no diretrio do sistema gerado.

Exemplo: H:\CREMERJ\SOURCE\general


Variveis:
Criadas nas funes especficas, sub-funes e funes de uso geral. Nomeadas pelo
programador da funo. Usar um nome que permita uma fcil identificao.

Os dois primeiros bytes do nome da varivel indicam o tipo de dado da varivel.

Usar sempre que possvel palavras completas, iniciadas por letra maiscula.

Vide tabela acima (funes de uso geral).

Exemplo: ctNomeCliente


Formulrios:
Formulrios criados no Visual FoxPro. Arquivos SCX. Usar o nome da funo especfica onde
o formulrio foi originalmente criado, acrescido de um nmero sequencial ascendente, iniciado
em 01 at 99.

Exemplo: F030152501.SCX

Colunas Descrio
F Formulrio
03 Criado originalmente no mdulo 03. Repete os bytes usados nesta coluna no
Visual Kit 5 Verso 6.0.4.2
278
nome da funo especfica Primitiva.
015 Criado originalmente para a entidade 015. Repete os bytes usados nesta coluna
no nome da funo especfica Primitiva.
2 Com abertura de arquivo. Repete o byte usado nesta coluna no nome da
funo especfica Primitiva.
5 Relatrio. Repete o byte usado nesta coluna no nome da funo especfica
Primitiva.
01 Formulrio de nmero 01.


Diretrio: Todos os formulrios devem ser gravados no sub-diretrio
PARAMETERS\FORM\D01, D02... D99 de acordo com o mdulo ao qual pertence a entidade,
no diretrio do sistema gerado.

Exemplo: H:\CREMERJ\parameters\form\d03

Etiquetas:
Etiquetas (label) criadas no Visual FoxPro. Arquivos LBX. Usar o nome da funo especfica
onde a etiqueta foi originalmente criada, acrescido de um nmero seqencial ascendente,
iniciado em 01 at 99.

Exemplo: L030152602.LBX

Colunas Descrio
L Label (etiqueta)
03 Criado originalmente no mdulo 03. Repete os bytes usados nesta coluna no
nome da funo especfica Primitiva.
015 Criado originalmente para a entidade 015. Repete os bytes usados nesta coluna
no nome da funo especfica Primitiva.
2 Com abertura de arquivo. Repete o byte usado nesta coluna no nome da
funo especfica Primitiva.
6 Etiqueta. Repete o byte usado nesta coluna no nome da funo especfica
Primitiva.
02 Etiqueta de nmero 02.


Diretrio: Todas as etiquetas devem ser gravadas no sub-diretrio
PARAMETERS\LABEL\D01, D02... D99 de acordo com o mdulo ao qual pertence a entidade,
no diretrio do sistema gerado.

Exemplo: H:\CREMERJ\parameters\label\d03


Imagens:
Visual Kit 5 Verso 6.0.4.2
279
Imagens usadas no sistema. Arquivos BMP, GIF, JPG. Usar o nome da funo especfica para
a qual a imagem foi originalmente criada, acrescido de um nmero sequencial ascendente,
iniciado em 001 at 999.

Exemplo: I0301525002.GIF

Colunas Descrio
I Imagem
03 Criada originalmente no mdulo 03. Repete os bytes usados nesta coluna no
nome da funo especfica Primitiva.
015 Criada originalmente para a entidade 015. Repete os bytes usados nesta coluna
no nome da funo especfica Primitiva.
2 Repete o byte usado nesta coluna no nome da funo especfica Primitiva.
5 Relatrio. Repete o byte usado nesta coluna no nome da funo especfica
Primitiva.
002 Imagem de nmero 002.


Diretrio: Todas as imagens devem ser gravadas no sub-diretrio
PARAMETERS\IMAGE\D01, D02.. D99 de acordo com o mdulo ao qual pertence a entidade,
no diretrio do sistema gerado.

Exemplo: H:\CREMERJ\parameters\image\d03


Help:
Arquivos de ajuda do sistema gerado, criados no Word, compilados no Visual FoxPro.
Arquivos HLP.

Diretrio: Todos os arquivos de help devem ser gravados no sub-diretrio
PARAMETERS\HELP, no diretrio do sistema gerado.


cones:
Arquivos criados usando programas grficos. Arquivos ICO.

Diretrio: Todos os arquivos de cone devem ser gravados no sub-diretrio
PARAMETERS\ICO, no diretrio do sistema gerado.


Documentos Word e outros:
Os arquivos so nomeados pelo funcionrio que os criar.

Exemplo: D990518011.DOC

Visual Kit 5 Verso 6.0.4.2
280
Colunas Descrio
D Letra padro.
99 Ano de criao do documento. (98, 99...)
05 Ms de criao do documento. (01,02..12)
18 Dia de criao do documento (01,02...31)
011 Nmero sequencial de 001 999, diarios. Por cliente.


Diretrio: Todos os arquivos Word ou de outros softwares (excel, powerpoint...) devem ser
gravados no sub-diretrio Editor/[nome do cliente], no driver de rede designado.

No permitido manter documentos nos drivers das Estaes.

Dentro do arquivo deve ser gravado o nome do arquivo, para facilitar a busca.


DataBase:
DataBase (Base de Dados) criadas no Visual FoxPro, Access etc. Usar o nome do sistema para
nomear o DataBase.

Exemplo: CREMERJ.DBC

Diretrio: Todos os DataBase devem ser gravados no sub-diretrio DATABASE, no diretrio
do sistema gerado.

Exemplo: H:\CREMERJ\database


Table (arquivo):
Tabelas (arquivos) criadas no Visual FoxPro. Arquivos DBF. Sequir as convenes do Visual
Kit 5 para nomear tabelas.

As tabelas para uso geral devem ser nomeadas de traz pra frente.

Exemplo: B04999.DBF

Colunas Descrio
B Padro interno.
04 Criada originalmente no mdulo 04.
999 Criada originalmente para a entidade 999. As tabelas de uso geral devem ser
criadas com a numerao descendente.


Diretrio: Todas as tabelas devem ser gravadas no sub-diretrio do mdulo correspondente
D04\DBF, no diretrio do sistema gerado.
Visual Kit 5 Verso 6.0.4.2
281

Exemplo: H:\CREMERJ\D04\DBF

ndice (indexador):
Arquivos de ndice criados no sistema gerado ou Visual Kit 5. Arquivos IDX. Sequir as
convenes do Visual Kit 5 para nomear ndices.

Os arquivos de ndice devem ser idnticos ao arquivo de dados (dbf), acrescidos de um nmero
sequencial de 1 a 14.

Exemplo: B020013.IDX

Colunas Descrio
B Padro interno.
02 Criado originalmente no mdulo 02.
001 Criado originalmente para a entidade 001. As tabelas de uso geral devem ser
criadas com a numerao descendente.
3 Terceiro arquivo de ndice fixo.

O limite de arquivos de ndice fixos 14.

Os arquivos de ndices fixos devem ser especificados na tabela de parmetros (bearq)
Abertura de Arquivos do Visual Kit 5.

IMPORTANTE: Todas as funes especficas que atualizam dados em tabelas do sistema
gerado (incluso, alterao ou excluso de dados), devem abrir no (bearq) Abertura de
Arquivos do Visual Kit 5, todos os ndices fixos da tabela atualizada.

Exemplo: arquivo B02001.DBF
ndices fixos: BO20011.IDX
B020012.IDX
B020013.IDX

Se uma funo especfica atualiza dados no B02001.DBF, ento voc dever cadastrar no
Abertura de Arquivos do Visual Kit 5, todos estes ndices para esta funo especfica com
abertura de arquivo.

Diretrio: Todos os arquivos de ndice devem ser gravadas no sub-diretrio do mdulo
correspondente D04\IDX, no diretrio do sistema gerado.

Exemplo: H:\CREMERJ\D04\IDX

Query:
Pesquisa pr-programada (query) criadas no Visual FoxPro. Arquivos QPR. Usar o nome da
funo especfica para a qual a query foi originalmente criada, acrescido de um nmero
seqencial ascendente, iniciado em 01 at 99.
Visual Kit 5 Verso 6.0.4.2
282






Exemplo: Q030152601.QPR

Colunas Descrio
Q Query (pesquisa)
03 Criada originalmente no mdulo 03. Repete os bytes usados nesta coluna no
nome da funo especfica Primitiva.
015 Criada originalmente para a entidade 015. Repete os bytes usados nesta coluna
no nome da funo especfica Primitiva.
2 Com abertura de arquivo. Repete o byte usado nesta coluna no nome da
funo especfica Primitiva.
6 Etiqueta. Repete o byte usado nesta coluna no nome da funo especfica
Primitiva.
01 Query de nmero 01.


Diretrio: Todas as querys devem ser gravadas no sub-diretrio PARAMETERS\QUERY\D01,
D02... D99 de acordo com o mdulo ao qual pertence a entidade, no diretrio do sistema
gerado.

Exemplo: H:\CREMERJ\parameters\query\d03


View:
Vises do arquivo (view) criadas no Visual FoxPro. Arquivos VUE. Usar o nome da funo
especfica onde a view foi originalmente criada, acrescido de um nmero seqencial
ascendente, iniciado em 01 at 99.

Exemplo: V030152602.VUE

Colunas Descrio
V View (viso do arquivo)
03 Criada originalmente no mdulo 03. Repete os bytes usados nesta coluna no
nome da funo especfica Primitiva.
015 Criada originalmente para a entidade 015. Repete os bytes usados nesta coluna
no nome da funo especfica Primitiva.
2 Com abertura de arquivo. Repete o byte usado nesta coluna no nome da
funo especfica Primitiva.
6 Etiqueta. Repete o byte usado nesta coluna no nome da funo especfica
Primitiva.
Visual Kit 5 Verso 6.0.4.2
283
02 View de nmero 02.


Diretrio: Todas as vises do arquivo devem ser gravadas no sub-diretrio
PARAMETERS\VIEW\D01, D02... D99 de acordo com o mdulo ao qual pertence a entidade,
no diretrio do sistema gerado.

Exemplo: H:\CREMERJ\parameters\view\d03


Classe:
Classes criadas no Visual FoxPro. Arquivos VCX. Usar o nome da funo especfica onde a
classe foi originalmente criada, acrescido de um nmero sequencial ascendente, iniciado em 01
at 99.

Exemplo: C030152603.VCX

Colunas Descrio
C Classe
03 Criada originalmente no mdulo 03. Repete os bytes usados nesta coluna no
nome da funo especfica Primitiva.
015 Criada originalmente para a entidade 015. Repete os bytes usados nesta coluna
no nome da funo especfica Primitiva.
2 Com abertura de arquivo. Repete o byte usado nesta coluna no nome da
funo especfica Primitiva.
6 Etiqueta. Repete o byte usado nesta coluna no nome da funo especfica
Primitiva.
03 Classe de nmero 03.


Diretrio: Todas as classes devem ser gravadas no sub-diretrio PARAMETERS\CLASS\D01,
D02... D99 de acordo com o mdulo ao qual pertence a entidade, no diretrio do sistema
gerado.

Exemplo: H:\CREMERJ\parameters\class\d03


Arquivo Texto:
Criados no Visual FoxPro, Sistema gerado ou Visual Kit 5. Arquivos TXT. Usar o nome da
funo especfica onde o arquivo texto foi originalmente criado, acrescido de um nmero
seqencial ascendente, iniciado em 001 at 999.

Exemplo: T0301526002.TXT

Colunas Descrio
Visual Kit 5 Verso 6.0.4.2
284
T Texto
03 Criado originalmente no mdulo 03. Repete os bytes usados nesta coluna no
nome da funo especfica Primitiva.
015 Criado originalmente para a entidade 015. Repete os bytes usados nesta coluna
no nome da funo especfica Primitiva.
2 Com abertura de arquivo. Repete o byte usado nesta coluna no nome da
funo especfica Primitiva.
6 Etiqueta. Repete o byte usado nesta coluna no nome da funo especfica
Primitiva.
002 Arquivo Texto de nmero 002.


Diretrio: Todos os arquivos de texto devem ser gravados no sub-diretrio
PARAMETERS\TEXTFILE\D01, D02... D99 de acordo com o mdulo ao qual pertence a
entidade, no diretrio do sistema gerado.

Exemplo: H:\CREMERJ\parameters\textfile\d03


Menu:
Menus criados no Visual FoxPro. Arquivos MNX. Usar o nome da funo especfica onde o
menu foi originalmente criado, acrescido de um nmero seqencial ascendente, iniciado em 01
at 99.

Exemplo: M030152602.MNX

Colunas Descrio
M Menu
03 Criado originalmente no mdulo 03. Repete os bytes usados nesta coluna no
nome da funo especfica Primitiva.
015 Criado originalmente para a entidade 015. Repete os bytes usados nesta coluna
no nome da funo especfica Primitiva.
2 Com abertura de arquivo. Repete o byte usado nesta coluna no nome da
funo especfica Primitiva.
6 Etiqueta. Repete o byte usado nesta coluna no nome da funo especfica
Primitiva.
02 Menu de nmero 02.


Diretrio: Todos os menus devem ser gravados no sub-diretrio PARAMETERS\MENU\D01,
D02... D99 de acordo com o mdulo ao qual pertence a entidade, no diretrio do sistema
gerado.

Exemplo: H:\CREMERJ\parameters\menu\d03

Visual Kit 5 Verso 6.0.4.2
285
Report:
Relatrios criados no Visual FoxPro. Arquivos FRX. Usar o nome da funo especfica onde o
relatrio foi originalmente criado, acrescido de um nmero seqencial ascendente, iniciado em
01 at 99.

Exemplo: R030152501.FRX

Colunas Descrio
R Relatrio (Report)
03 Criado originalmente no mdulo 03. Repete os bytes usados nesta coluna no
nome da funo especfica Primitiva.
015 Criado originalmente para a entidade 015. Repete os bytes usados nesta coluna
no nome da funo especfica Primitiva.
2 Com abertura de arquivo. Repete o byte usado nesta coluna no nome da
funo especfica Primitiva.
5 Relatrio. Repete o byte usado nesta coluna no nome da funo especfica
Primitiva.
01 Relatrio de nmero 01.


Diretrio: Todos os relatrios devem ser gravados no sub-diretrio
PARAMETERS\REPORT\D01, D02... D99 de acordo com o mdulo ao qual pertence a
entidade, no diretrio do sistema gerado.

Exemplo: H:\CREMERJ\parameters\report\d03