Anda di halaman 1dari 261

51

CLARION 5

52 CLARION 5 CLARION
Aprendiendo

aprendizage
m Clarion
Copyright 1994, 1995, 1996; 1997 por TopSpeed Corporao
Copyright 1998, Unisoft SRL
Todos os direitos reservados
Este trabalho protegido por copyright e todos os direitos reservados. no pode ser copiado,
fotocopiado, reproduzido, traduzido ou passado para mdia eletrnica ou computador sem o
consentimento escrito dos detentores de direitos.
Esta publicao acompanha Clarion 5. Pode conter erros tcnicos ou tipogrficos. TopSpeed e
Unisoft o entregue "como est" sem garantia, expressa ou implcita.

TopSpeed Corporao
150 East Road Amostra
Pompano Beach, Florida 33064
(+ 1-954) 785-4555

Unisoft SRL
Uruguai 263, piso 5
1015 - Buenos Aires
Tel./Fax: (54-11) 4372-7243 / 9850; 4374-2298 / 9469

Traduo: Hctor Daniel Calabia, Belca


Armado Lilia GB Calabia, Belca. Tel. 4774-6845. Fax: 4777-6683
sistemas RC: reviso e atualizao. Salta - Argentina. 1.999.

Mark Reconhecimento:
EuCONTEDO 53

TopSpeed marca registrada da TopSpeed Corporation.


Clarion5 marca registrada da TopSpeed Corporation.
Btrieve Btrieve Technologies uma marca registrada.
Microsoft, Windows , e Visual Basic so marcas registradas da Microsoft Corporation.
Todos os outros nomes de produtos e empresas so marcas comerciais ou marcas registradas de
seus respectivos proprietrios.

impresso em a Argentina - Impresso na Argentina.

CONTEDO

EuNTRODUO
59
Bem-vindo de volta! 59
O que h nesta Seo ............................................. .................................................. ...... 59
convenes da documentao 60
Convenes tipogrficas ................................................ ................................................. 60
convenes de teclado ............................................... .................................................. .. 60
Anatomia de um banco de dados
61
sistemas de arquivos e drivers de ............................................. ............................................ 62
Tipos de Dados ............................................... .................................................. ........... .................
62
Classificao de dados: chaves .......................................... e ndices ..................................... 64
subindo e descendo ordens .............................................. ................................. 65
Usando as teclas como limitando ............................................ ................................................ 66
As relaes entre arquivos ............................................... .................................................. .......... 66

53
54 CLARION 5 CLARION
Aprendiendo

Base de dados: ............................................. Resumo .................................................. .............. 67

1 - PLANEAMIENTO DE A APLICAO 69
Definio de tarefas do aplicativo 69
banco de dados de projeto 70
............................................... arquivo do cliente .................................................. ........... 71
arquivo telefones ............................................... .................................................. ....... 71
............................................... arquivo de ordem .................................................. ........... 72
Arquivo Detalhe .............................................. .................................................. ......... 72
Arquivo produto .............................................. .................................................. .... 72
Integridade Referencial ................................................ .................................................. .......
72
esquema completo a base Dados ................................................ ............................. 73
Interface do aplicativo 74

2 - CA RIANDO DICCIONARIO DE DATOS 75


arquivos Cursilho ............................................... .................................................. ........ 75
criao Dicionrio 76
Copiar arquivos de um para outro dicionrio 78
Cpia dos Clientes definio arquivo ........................................... ............................ 78
Cpia dos telefones definio arquivo .......................................... .................... 79
Vincular arquivos e opes de configurao integridade
referencial 80
Configurando restries de integridade referencial ........................................... ... 81
controle de janela formatos pr-definio 82

3 - INCORPORATION ARQUIVOS E CAMPOS 85


Definio de novos arquivos de dados 85
Ordens arquivo criao ............................................. ........................................... 85
arquivos e produtos Detalhe Naming 86
Definio de campos .............................................. .................................................. .... 88
Definio de campos de arquivo .......................................... ordens ..................... 88
Definindo campos de arquivo .......................................... Detalhe ...................... 91
Definio de campos de arquivo .......................................... produtos ................. 93

4 - INCORPORATION chave e relaes 95


ordens de arquivo definio de chave 95
EuCONTEDO 55

criando chave Primria .................................................. .......................................... 96


Designar uma chave estrangeira .............................................. ..................................................
. 97
Key Detalhe Definition File 99
Definio da primeira chave estrangeira ............................................ ...................................
99
Definio da segunda chave estrangeira ............................................ .................................
100
Principais produtos de arquivo de definio 101

Criar a chave primria .............................................. .................................................. ......


101

Definio de uma chave alfabtica ............................................. .......................................


102

Definir relaes entre os arquivos 103


Definindo relaes "Pedidos" .......................................... .............................. 103
Definindo relacionamentos ........................................... Detalhe Arquivo ................... 105

Definio de verificaes de validade depende da relao 107


Definindo os registros de pedidos de verificao de validade ............................ 107
Definio de verificaes de validade para
............................................... registos de detalhe .................................................. ......... 108

5 - IDados pr-existentes MPORTACIN 109


Convertendo arquivos de dados 109
A importao de uma definio de arquivo. CSV ................................................. ............ 109
Converter um arquivo de dados ............................................ ...................................... 111

6 - EMPEZANDO PROGRAMAO 115


Usando o Gerador de Aplicativos 115
criao de arquivo .app ............................................. .................................................. . 115
Criao do processo principal (Main) ........................................... ........................ 116
Menu Editar ............................................... .................................................. ............. 118
SplashScreen criao procedimento .............................................. .......................... 121
Adicionando uma barra de ferramentas a aplicao .................................................. . 122
Testar um aplicativo em desenvolvimento ............................................ .................................
127

55
56 CLARION 5 CLARION
Aprendiendo

Estudar o cdigo fonte gerado ............................................. ..................................... 128

7 - CA RIANDO BROWSE 131


Criando uma janela Procurar 131
Criando lista de clientes de exibio .......................................... ................ 131
Enchimento e concepo de uma caixa de listagem ..........................................
.................................. 132
Escolha o arquivo e campos para colocar na lista ....................................... ............ 133
Adicionando abas .............................................. .................................................. ... 137
Ocultar botes ............................................... .................................................. ....... 138
Os clientes navegar testes ............................................. .............................................. 139
sistemas de visualizao ............................................... ........................................ 140
Procurar fechando Cliente ............................................. ............................................. 142

8 - CRIANDO um registro ou FORM 143


Criao de um procedimento de atualizao 143
Incorporando um procedimento de "todo" ........................................... ......................... 143
Criando folha de procedimento ou formulrio ........................................... .............. 144
Preencha as caixas .............................................. .................................................. ..... 145
Mover e alinhar campos ............................................. ................................................. 147
A adio de um modelo de controlo BrowseBox ........................................... ....................
151
Adicionando o modelo de BrowseUpdateButtons Controlo ............................................ ......
154

9 - CPROCEDIMENTOS opiceos 157


Procedimentos "Produtos" 157
Cpia dos procedimentos .............................................. .............................................. 157
Trabalhando pontos de insero ............................................ ................................. 158
Procurar modificao ............................................... .................................................. 162
criao procedimento Folha .............................................. ...................................... 165

10 - UMODELOS DE MODO DE CONTROLO 167


criao procedimento 167
Selecionando o tipo de processo de ............................................. ................................... 167
Colocar caixa de listagens (Control Template BrowseBox) ................................. 168
Adicionando modelo de atualizao botes .......................................... .............. 169
EuCONTEDO 57

Colocar a segunda caixa ........................................... listagens ............................ 170


Adicionar o boto template "Close" .......................................... ............................... 172
Especificando estratgias de ajustamento ............................................ .......................... 173

11 - TEMAS AVANZADOS 175


atualizao do arquivo de ordens 175
Criando o formulrio de Entrada de Pedidos ........................................... ..................... 175
controle colocando Detalhe modelos Arquivo ......................................... ..... 179
faz-lo funcionar 184
Usando o Editor de Frmula ............................................. ................................................. 184
Configurando o "modificao in situ" .......................................... ............................ 185

12 - CRELATRIOS RIANDO 197


Uma simples lista de clientes 197
Atualizar menu principal .............................................. ....................................... 197
criao de relatrios ............................................... .................................................. ....... 198
detalhe ............................................... .................................................. ........... 200
relatrio de encomendas 203
criao de relatrios ............................................... .................................................. .. .... 203
Encher o baseband ........................................... pgina ...................................... 205
Povoando a faixa de detalhes ............................................. ............................................... 206
Adicionando quebras grupo ............................................. .................................................. 207
Encher a banda cabealho grupo ........................................... ................................ 209
Encher a banda rodap de grupo ................. ......................... ..................................... 212
Encher a banda de p gurpo "Clientes" ....................................... ...................... 214
Adicionando uma frmula .............................................. .................................................. ...
217
Adicionando um filtro de registro ............................................ ..........................................
217
Relatrio de alcance limitado
(Relatrio limitada Range) 219
............................................... criao de relatrios .................................................. ....... 219
Relatrio ordem individual 221
criao de relatrios ............................................... .................................................. ....... 221
Que segue? .................................................. .................................................. ................... 225

57
58 CLARION 5 CLARION
Aprendiendo

13 - CUrsillo na linguagem CLarion 227


linguagem de programao Clarion 227
-Evento com base programao ............................................. .......................................... 227
Ol do Windows ................................................ .................................................. ................
228
Ol Windows com controles .............................................. ............................................. 233
"Ol Windows" com manipulao de eventos .......................................... ...............................
235
Adicionando um procedimento .............................................. .................................... 236
Adicionando um procedimento .............................................. ...............................................
238
Para o mundo real: Adicionando um ......................................... de menu ...............................
239
Mais para o mundo real: a adio de uma lista e uma forma ..................................... 241
modelos de cdigo OOP gerado pela ABC 256
Iniciar uma aplicao com Quick Start ............................................ .............................. 256
O Mdulo de Programa ............................................... .................................................. ..........
257
O que se segue ao lado ............................................... .................................................. ..... .......
262

VOCABULARY 265

INTRODUO
EuCONTEDO 59

Bem-vindo de volta!

A seo anterior apresentou o ambiente Clarion e Assistente. Agora vamos estudar como usar as
outras ferramentas que Clarion oferece para criar aplicaes eficazes. Esta seo contm dois
cursos, em muitos nveis diferentes.
Workshop sobre Gerador de aplicaes que familiariza-lo com todo o ambiente de
desenvolvimento ferramentas Clarion.
Workshop sobre Clarion Idioma apresentado por esta linguagem e contatos com o tipo de
cdigo que gera o ambiente de desenvolvimento.

O que h nesta Seo

Workshop sobre Gerador de Aplicao


Os captulos 1 a 12: Apresentao de todas as principais ferramentas de desenvolvimento
Clarion. Comea na fase de planeamento de implementao, levando ao dicionrio de dados
CreAccin com o Editor de dicionrio, e leva a criar um aplicativo completo com o Gerador de
Aplicao. Aps a concluso do curso, voc ter criado uma completa aplicao para entrada e
relatrios ordem.
Voc vai usar o Gerador de Aplicativos e trabalhar com modelos de Procedimento de Controle
de Cdigo e para produzir essa aplicao. Ele vai trabalhar com o Windows Designer e
relatrios. Voc vai usar o editor de texto para incorporar cdigo fonte Clarion nos modelos de
cdigo-fonte gerados.

oficina Clarion na linguagem


Captulo 13: Apresenta manual de programao linguagem de nvel. Ele comea com o
simples, e, em seguida, leva criao de exemplos simples dos procedimentos mais comuns de
aplicaes Clarion "Ol, mundo!"; tudo ao mesmo tempo a funcionalidade do cdigo que voc
escreve, e sua ligao com o cdigo que produz o Gerador de Aplicativos explicou.

convenes da documentao

Convenes tipogrficas:

itlico Indicar o que deve ser digitado no teclado, tais


como: escrever este. Alm disso,
ocasionalmente, eles utilizado para enfatizar

59
60 CLARION 5 CLARION
Aprendiendo

certas palavras ou frases ou expresses indicam


lngua estrangeira.

Small Caps Indicam teclas, como ENTER ou fuga, ou clique com


o mouse.

negritas Indicam ordens ou opes de um menu ou


texto em uma caixa de dilogo. Nota: Este
estilo tambm pode usar uma famlia de fontes
diferentes, para coincidir com a Helvetica
negrito usando o Windows como sistema de
origem.

LetterGothic Ele usado para diagramas, listas de cdigo-


fonte, para discutir exemplos e exemplos de
uso de instrues de cdigo.

convenes de teclado

Fl Indica pressione e solte uma chave; neste caso,


por exemplo Fl.

ALT + X combinao de teclas, neste caso, pressione a


tecla ALT e ao faz-lo, pressione X, em seguida, solte
ambas as teclas.

Anatomia de um banco de dados


Descrever brevemente aqui os elementos bsicos de bancos de dados de projeto. S temos a
inteno de fornecer uma viso geral do tpico para aqueles que no esto completamente
familiarizados com bancos de dados de conceitos de design comum. desenvolvedores experientes
podem pular esta seo e passar directamente para o prximo captulo.
EuCONTEDO 61

definies
Um banco de dados (banco de dados) um conjunto de informaes (dados) organizado em um
sistema de arquivos, registros e campos. O banco de dados mantido por um ou mais programas
ou aplicaes.

A unidade bsica de armazenamento de dados um campo (campo). Um campo um lugar onde a


informao armazenada mesmo tipo. Por exemplo, um campo pode armazenar um nome e outro
campo pode salvar um nmero de telefone.

Um grupo de diferentes campos que esto ligados logicamente fazer um registro (registro). Um
registro contm todas as informaes relacionadas a um tpico. por exemplo, todos os campos
com informaes sobre um estudante (nome, endereo, nmero de telefone, nmero de estudante,
etc.) esto reunidos no registro do estudante. Isto semelhante ao arquivo ou registro que a escola
tem cada aluno.

Um conjunto de registros logicamente ligados constituem um arquivo (arquivo). Seguindo a


analogia, um colecion de todos os registros dos alunos produzir os registros gerais de estudantes.
Isto assemelha-se os armrios onde os registros de estudantes so mantidos.
Outra maneira de visualizar isso usando uma planilha:

Neste formato, a tabela inteira um arquivo, cada linha um registro, e as colunas representam
campos.
Um banco de dados uma coleo de arquivos vinculados, tambm chamados tabelas (tabelas).
Isto assemelha-se a um grupo de arquivos que todos os registros escolares so mantidos. Um
arquivo salva arquivos com dados pessoais dos alunos; outros dados sobre cursos; e um terceiro,
com informaes sobre a equipe.
Um banco de dados um conjunto de tabelas que mantm relaes juntos definidos bom banco de
dados projeto separa informaes relacionadas que so ligados por arquivos campos de link. Mais
sobre isso em breve.

resumo:

61
62 CLARION 5 CLARION
Aprendiendo

Um ou mais campos so combinados para formar um log.


Um ou mais registros so combinados para formar um arquivo.
Um conjunto de arquivos vinculados um banco de dados.

sistemas de arquivos e drivers

Existem inmeros formatos de arquivo usados em PCs. Este o armazenamento fsico formata o
disco usando os programas que mantm arquivos de dados. Clarion suporta muitos formatos,
graas aos drivers de tecnologia (drivers) de TopSpeed. Esses drivers permitem Clarion a ler e
escrever programas para estes formatos diferentes.
Standard Edition traz drivers para TopSpeed, Clarion, ASCII, BASIC e formatos DOS. edies
Professional e Enterprise incluem Btrieve, ODBC, Clipper, dBase III e IV, e FoxPro. Se voc
precisa usar dados de outro sistema de arquivos, voc pode comprar os drivers apropriados e
adicion-los para as questes profissionais e de negcios. Contacte o seu revendedor para ver se o
driver que voc precisa est disponvel.
Cada sistema de arquivos tem suas peculiaridades e limitaes. Para mais informaes, consulte o
Apndice Drivers de banco de dados emdo Usurio'Guia S.

Tipos de dados

Campos pode armazenar muitos tipos diferentes de dados, mas cada campo individual s pode
salvar um tipo. Quando o campo definido, o tipo de dados especificado. Por exemplo, para salvar
um nmero de0 a 100, um definido como um nico campo de byte ocupa menos espao definido
como um nmero decimal (um byte pode armazenar qualquer nmero inteiro, sem sinal, entre 0 e
225).
Clarion suporta os seguintes tipos de dados (totalmente documentados no Captulo 3 referncia
Language):
alfanumrico (Alfanumrico)
STRING Campo que armazena um nmero especfico de caracteres
alfanumricos e outros caracteres ASCII.
pString Campo que armazena uma cadeia de caracteres com um byte
comprimento inicial indicando o nmero de bytes na cadeia. Este
o tipo de dados utilizados no Pascal idioma e tipo de dados
"lstring" Btrieve Registro Manager.
cstring Campo que armazena uma cadeia de caracteres e que encerra em
um carrer null; ASCII zero (0). Este tipo de dados usado na
linguagem "C" e tipo de dados "ZSTRING 'Btrieve Registro
Manager.
Inteiro (inteiros)
EuCONTEDO 63

BYTE Um byte campo que contm um inteiro sem sinal de 0 a 225


positivo).
SHORT Two-byte campo que contm um inteiro assinado, de -32.768
32.767.
USHORT Two-byte campo que contm um inteiro sem sinal de 0 a 65.535
(positivo).
LONGO Quatro bytes campo que contm um inteiro assinado de
2147483648 de 2,147,483,647.
ULONG Quatro bytes campo que contm um inteiro sem sinal de 0 a
4,294,967,295.

Nmeros de ponto flutuante (real) (os nmeros de fraces)

REAIS O campo que mantm um total de oito bytes ponto assinado com
15 dgitos significativos flutuantes.
SREAL Campo que armazena um nmero de quatro bytes, com sinal,
ponto flutuante seis dgitos significativos. O formato usa SREAL
curta Real (preciso simples) do processador Intel 8087.
BFLOAT8 Variation REAL, este tipo armazena um nmero oito bytes com
sinal, ponto flutuante oito bytes como o formato de preciso dupla
Microsoft BASIC.
BFLOAT4 SREAL dados variao da taxa, um campo BFLOAT4 economiza
um nmero de quatro bytes, com sinal-clon flutuante, que usa o
formato preciso simples Microsoft BASIC.

nmeros decimais embalado (decimais) embalado

DECIMAL O campo que mantm um valor decimal embalado, com sinal,


variando de -9.999.999.999.999.999.999.999.999.999.999 para
9.999.999.999.999.999.999.999.999.999.999.
PDECIMAL Campo que armazena um nmero decimal em formato decimal
Btrieve embalagem e IBM / EBCDIC. A nica diferena entre
decimais e PDECIMAL o lugar onde voc guarda o sinal.
Outros tipos de dados

DATA campo de quatro bytes que armazena uma varivel de data no


formato de Btrieve Registro Manager.
TEMPO campo de quatro bytes que armazena um tempo varivel no
formato Btrieve Registro Manager.
GROUP campo lgico que contm vrios campos de dados. Por exemplo,
um grupo de campos chamadoNumTelfono pode conter dois

63
64 CLARION 5 CLARION
Aprendiendo

campos: DDN e telefone. Um grupo de campos (Grupo) pode ser


utilizado em conjunto ou cada um dos seus componentes
individuais.
PICTURE Apesar da imagem no um tipo de dados, quando selecionado,
voc declarar um tipo string de dados com um formato de exibio
ou mscara (como @P ### P), que define o nmero de caracteres na
cadeia. O formato de exibio usado para declarao de campo inserido
no campo "Record Picture". Isso til para campos cujos formatos de
armazenamento e exibio so diferentes.

Classificao de dados: chave e ndices

Um dos aspectos mais poderosos de uma base de dados informatizada a capacidade de classificar
os dados em muitas maneiras diferentes. Fazer isso requer manualmente vrias cpias dos
arquivos, muitas pastas e vrios armrios de arquivo. Tambm preciso um longo tempo para
arquivar cada cpia em lugares diferentes, dependendo de sua ordem.

Pelo contrrio, em uma base de dados informatizada, o sistema exige apenas definir um nmero de
"chave" ou "ndices". Estas ordens adicionais declarar a ordem fsica de registros no arquivo de
dados. Em alguns sistemas de arquivos chaves so mantidos em arquivos separados, em outros
compartilham o mesmo arquivo de dados. motoristas Tecnologia Topspeed arquivos de forma
transparente lida com essas diferenas.

Chaves e ndices so funcionalmente equivalentes. Eles diferem apenas na forma como eles so
mantidos em cada aplicao:
A chave mantida de forma dinmica. Cada vez que voc adicionar, alterar ou excluir um
registro, o sistema atualizado. As teclas so usadas para utilizar tipo frequentemente.
Um ndice no mantida de forma dinmica, uma vez que constri (compilao) apenas
QUAD necessrio. Os ndices so teis para a criao de sistemas para uso ocasional, como
por processos que so executados no final do ms ou no final do ano.
Seguindo o nosso exemplo de um registro de escola, suponha que queremos classificar os registros
de estudantes de duas maneiras: em ordem alfabtica pelo nome e pelo nome dentro de cada
assunto. Isso produz dois sistemas alternados.
Este exemplo usa um componente-chave em nome dos estudantes.
EuCONTEDO 65

O exemplo a seguir tem duas componentes principais: curso eo nome do aluno. Uma chave pode
conter mais do que um campo, permitindo que outros sistemas dentro de sistemas.

ascendentes e descendentes ordens

Alguns sistemas de arquivos permitem que ambos os tipos de sistema de chaves ou componentes
(por exemplo, arquivos de sistema Topspeed). Outros sistemas suportam apenas a ordem
ascendente, o que significa que os dados s podem ser encomendados menor para o maior (por
exemplo, os arquivos do sistema Clarion).
O exemplo a seguir tem duas componentes principais: Ano da formatura (descendente), e nome do
aluno).

65
66 CLARION 5 CLARION
Aprendiendo

Usando chaves como limitadores

Suponha que voc queira criar um relatrio de cursos de matrcula um banco de dados contendo
informaes dos ltimos quinze anos. Para este relatrio, que s se preocupam com os ltimos trs
anos. Voc pode reduzir drasticamente o tempo de processamento se uma parte do arquivo de
dados contendo apenas registra os ltimos trs anos usado. Isso feito em duas etapas:
Primeiro, voc deve definir uma chave para classificar os dados por data de cada curso.
Ento voc tem que definir os limites de interesse. faixa de limite (faixa limite), tambm
chamado de "busca limite" especifica um subconjunto (subconjunto) para ser processado,
tirada de todo o arquivo. Apenas os registros que se enquadram dentro do limite considerado.

Neste exemplo, apenas um quinto dos registros sero processados (assumindo que a cada ano tem
caractersticas semelhantes). Ao reduzir o nmero de registos de 80 por cento, o tempo de
processamento diminui em proporo.

As relaes entre arquivos

Um dos propsitos de criao de bancos de dados relacionais reduzir dados redundantes. A regra
bsica que os dados s devem estar localizados em um s lugar. Este fraudada dois tipos de
benefcios: primeiro, reduz os requisitos de espao de armazenamento. Em segundo lugar, facilita
a manuteno do banco de dados. Para atingir este objectivo, as bases so divididos em arquivos
separados, mas relacionados, atravs de um processo chamado de normalizao de dados.

O primeiro passo mover os dados a serem repetidas atravs de arquivos. Por exemplo, se um
estudante poderia tomar um dede mximo seis indivduos, voc tem que projetar o arquivo de
estudantes para conter seis campos de materiais (Matl, mat2, mat3, etc). Mas todos esses
campos no so utilizados em cada registro. Se um estudante leva seis temas, o registo completa;
mas se um outro estudante leva apenas um, haver seis campos vazios em seu registro. Por esta
razo, os campos de materiais so movidos para um arquivo separado, eliminando a necessidade
de reservar espao para os campos vazios. Isto cria um relacionamento um-para-muitos. (Um
estudante pode assumir muitas classes) entre os registros dos alunos e materiais de arquivo.

O prximo passo mover os dados redundantes para arquivos separados. Cada campo nos alunos
de arquivos devem depender da chave primria (Student Number). O nome, endereo e telefone
permanecem no arquivo do aluno. Mas a descrio do curso de cada aluno pudesse se mover para
um arquivo separado. Isso elimina a necessidade de repetir a descrio do curso para cada aluno
naquele curso. Para fazer isso, adicione um campo de golfe com o nmero de arquivo de
estudantes e cursos de arquivo. Isso cria uma relao muitos-para-um (Muitos estudantes seguem
um curso) entre os registros dos alunos e cursos de arquivamento.

Uma vez que voc tem "normalizado" o armazenamento de dados de informaes relacionadas
esto ligados de modo que cada arquivo tem um campo idntico ao campo no arquivo relacionado.
EuCONTEDO 67

Um campo de ligao poderia ser o nmero de aluno, nmero do curso, ou uma srie de sala de
aula. Qualquer campo (ou grupo de campos) que identifica univocamente um registro no arquivo
primrio, pode ser usado como link.
Voc pode encontrar exemplos destas relaes no arquivo de dados.
um professor ensina muitas (vrios) materiais (um-para-muitos).

muitosOs alunos iro compartilhar um curso (muitos-para-um).

Bases de dados: Viso geral

Um banco de dados uma coleo de informaes (dados organizados em um conjunto de


campos, registros e arquivos.
Campos pode armazenar muitos tipos diferentes de dados, mas cada indivduo campo
armazena apenas uma classe.
Cada pedao de informao deve ser armazenado em um lugar.
Um ou mais campos compem um registro. Um ou mais registros compor um arquivo. Um
grupo de arquivos relacionados compem um banco de dados.
Clarion Que programas pode acessar muitos sistemas de arquivos usando manipuladores de
arquivos.
Chaves e ndices declarar outros do que a ordem fsica dos registos dentro do ficheiro de
sistemas, e podem conter mais do que um campo, permitindo que os sistemas secundrios
dentro de um sistema.
limites de busca (limites de alcance) permitem que voc processar um subconjunto de
registros, reduzindo o tempo de processamento.
Os arquivos so relacionados atravs de campos comuns, que contm dados idnticos, o que
ajuda a eliminar informaes redundantes.

67
68 CLARION 5 CLARION
Aprendiendo

- PLANEAMIENTO DE THE APLICAO

Como regra geral, cada minuto gasto na aplicao de planejamento poupa dez minutos depois.
Este captulo descreve o processo informalmente planejando aplicativo que ir criar nos captulos
subsequentes. No mundo real, ele provavelmente teria de criar uma especificao funcional prvia,
aplicaes escritas para executar. Esta descrio informal define:

As tarefas executadas pelo aplicativo.


O aplicativo mantm dados, e como mant-los.

Como ponto de partida, a implementao do Builder claro aplicativo usa o aplicativo de dicionrio
de dados que voc criou e usando os assistentes na seo anterior deste manual. Estende o conceito
de um sistema de pedidos simples, usando o dicionrio de dados para rastrear os clientes.

Definio de tarefas do aplicativo

O aplicativo ir manter arquivos do cliente e ordens de uma empresa industrial. A primeira tarefa
de planejar o que a aplicao vai fazer avaliar o que a empresa espera fazer.

Para os fins deste tutorial, vamos criar o aplicativo um sistema de entrada de pedidos simples.
comum que os clientes para fazer pedidos por telefone para um ou mais produtos de uma s vez.
noite, o servio administrativo imprime a ordem para o depsito.

Portanto, o aplicativo deve fornecer:


As caixas de dilogo de entrada de dados, para tomar a ordem, ou modific-lo mais tarde.
Acesso lista de clientes de dentro dos formulrios de ordem. A lista de clientes j est criado
com o Assistente para um incio rpido, armazenado no arquivo do cliente.
Acessar a lista de nmeros de pea (itens) produzidos pela empresa a partir de formas de
entrada de pedidos.
Mostrar transaes de vendas do Windows.
Procedimentos para manter a lista de produtos e informaes do cliente.
relatrios impressos.
EuCONTEDO 69

banco de dados de projeto


A primeira tarefa ao planejar a estrutura do arquivo avaliar quais dados a necessidades de
aplicao, e como armazenar com duplicao mnima.
Uma boa gesto de bases de dados necessrios para manter arquivos separados para cada
"entidade" ou grupo de dados. As "entidades de dados" que ir manter esta aplicao so:

cliente Nome e endereo do cliente (o nico ltima mudana,


se o cliente se move). Criado no "Cursilho para um
incio rpido", juntamente com os telefones de arquivos.

ordem informaes bsicas necessrias para montar os dados necessrios para imprimir um
formulrio de pedido. "consultas" feitas a informaes
de outros arquivos, como nome e endereo de clientes.
Quando uma pessoa faz uma nova ordem, adicionado
um registro para este arquivo.

detalhe Produto, preo e quantidade de um determinado item


em um pedido: informaes variveis para cada ordem
Embora isso produz uma duplicata de informaes
sobre preos no arquivo do produto, voc deve ficar
aqui o preo do momento da venda. Caso contrrio, o
montante variar quando os preos mudam em produtos
de arquivo.

produzir Informaes sobre os produtos vendidos pela empresa,


incluindo o seu nmero, descrio e preo. Estes dados
so alterados apenas quando h uma mudana de preo
ou um produto adicionado. *

* Nota do tradutor: Na verso original, o arquivo de produto chamado "Produtos" e, por


exemplo, o telefone, "Telefones". Como mostrado, ambos os nomes de arquivos
no excedam oito letras tradicionalmente permitidas pelo DOS. Em castelhano,
ambos os "Produtos" e "Telefone" tem mais de oito letras. Se voc usa o
Windows 3.x voc deve chamar esses arquivos "Produto" e "Telephone".
Aqueles que utilizam o Windows 95 e acima pode usar qualquer nome. Da em
diante, para facilitar a leitura nestes casos e semelhantes, vamos usar o nome
de arquivo longo.
Nota 2: O dicionrio de dados permite que voc digite o nome do arquivo e campos com
acentos como "Telefone", e estes so processados corretamente pelo Gerador
de Aplicativos. Ao verificar a traduo deste manual descobriu, no entanto, que
algumas partes do Clarion no funcionou bem com acentos; e causar problemas
difceis de diagnosticar. Aconselhamos a no usar acentos em nomes de
arquivos, campos ou chaves. Eles podem ser (e aconselhvel faz-lo) na
interface do usurio: rtulos de campo, ttulos de coluna, legendas explicativas,

69
70 CLARION 5 CLARION
Aprendiendo

etc. Esses elementos podem ser predefinidos sem problemas no Dicionrio de


Dados (HDC).

arquivo do cliente

Clientes salvar arquivos de dados "constante", como nomes e endereos. Eficiente para armazenar
essas informaes em um nico lugar, tornando mais fcil para realizar uma nica atualizao
quando h uma mudana. Ele tambm economiza espao, evitando informaes duplicadas no
arquivo de ordem. Caso contrrio, se houver mil encomendas para a empresa XYZ, o endereo
repetido 1000 vezes. Reduzindo as necessidades de armazenamento, recorrendo para salvar os
dados apenas uma vez chamado de normalizao.
Os dados do cliente requer um campo que identifica o cliente. O nome da empresa no funciona,
porque pode haver duplicatas. Por exemplo, pode haver vrios registros para um cliente chamado
"Hardware <<A mangueira>> "se voc tiver vrios ramos. A aplicao j fizemos especificado
cusno que o campo seria uma chave autonumbered, que voc criar e salvar nmeros exclusivos
para cada cliente.
Cusno campo serve como uma "chave primria" (chave primria) para o arquivo de dados.
Quaisquer outros arquivos que esto ligados ao arquivo do cliente deve declarar o campo cusno
como "chave estrangeira" (FOREIGN KEY). Uma chave primria um campo ou combinao de
campos que distingue exclusivamente cada registro em um arquivo. A tecla "estrangeiro" um
campo ou uma combinao dos mesmos, em um arquivo (ou mesa) cuja chave deve ser igual a
uma chave primria em outro arquivo vinculado.
Porque h muitas ordens para cada nmero de cliente, a relao entre o arquivo de clientes e
pedidos de arquivos ser um-para-muitos (1: Many). Dizemos que o arquivo do cliente o arquivo
principal e as solicitaes de arquivo filho.

Telefones Arquivo

arquivo Telefonos armazena os nmeros de cada cliente e pode haver muitos nmeros para cada
cliente.
arquivo telefones tambm inclui um campo de texto em que indicam se o nmero de telefone
pertence ao escritrio, fax, celular ou endereo de casa. Usando o dicionrio de dados, especificar
o controle de entrada de dados uma lista drop-down com opes pr-carregados.

arquivo de ordens
EuCONTEDO 71

O arquivo de ordem leva informaes de cada transaco de todos os outros arquivos (como dados
de clientes). Porque grande parte da informao bsica neste arquivo est impresso na "header"a
nota Ordem, normalmente llamrselo "Order Header".

Cada transao de vendas exige registro no arquivo de ordem. Registro da empresa est ligada
informao do cliente atravs do nmero de clientes. Porque algumas ordens podem ter um nico
artigo, e mais de dez, tem que criar um arquivo "Detail" separado para ser ligada com o nmero de
ordem nico. Isso cria uma relao de um-para-muitos, com ordens de arquivo como um pai e de
arquivo "detalhe" como um filho. produtos pedidos so identificados pelos respectivos cdigos de
produto no "detalhe" arquivo.

Assim, a entrada de pedidos tem um nmero de cliente para vincul-lo aos dados dos clientes
(chave estrangeira) e um nmero exclusivo para ligar o "detalhe". Multicomponente criar uma
chave primria em ambos os campos para criar facilmente um procedimento de visualizao
(browse) ordenados por cliente e nmero de ordem.

Detalhe Arquivo

Este arquivo armazena os itens ordenados pelos respectivos cdigos de produto (chave Produtos de
arquivo de referncia estrangeiros), preos, quantidades e taxa de imposto. Um campo adicional
armazena o nmero de ordem, que vinculado ao arquivo fim em uma relao de muitos-para-um.
arquivos duplicados Detalhe precificao informaes j armazenadas no arquivo do produto. Isto
porque os preos podem variar. importante para manter o preo dentro do arquivo em detalhes,
porque, caso contrrio, se o preo for alterado, o mdulo de faturamento levar diferente do que as
acordadas com o cliente no tempo dos preos de encomenda.

arquivo do produto

Este arquivo armazena os nmeros exclusivos para cada produto, descries e preos. Quando o
vendedor procura de um produto pelo nome, o aplicativo insere o nmero do produto no registro
de detalhe. O cdigo do produto a chave primria: Nenhum nmero item pode ser repetido, e
cada produto deve ter um nmero. Um campo adicional contm a taxa de imposto para esse
produto.

integridade referencial

A integridade referencial refere-se ao processo de controlar todas as alteraes para o campo de


chave de um determinado ficheiro, para assegurar a validade da relao pais e filhos mantida.
Significa, tambm, verificar todos os registros "crianas" tem "pais" vlido; de modo que no h
registros de "rfo" no banco de dados.

71
72 CLARION 5 CLARION
Aprendiendo

Como os dados para uma determinada transao residem em vrios arquivos, este pedido deve
manter a integridade referencial. Isto crtico, no entanto, muitos outros bancos de dados
ferramentas de desenvolvimento exigem a escrever procedimentos manuais para prend-lo.
Generator aplicativo implementado automaticamente no cdigo-fonte gerado, quando voc escolhe
algumas opes Dicionrio de Dados.

essencial que a aplicao no permite modificar um registro de modo a deixar um vazio ou


duplicados em um valor campo de chave primria. Por exemplo, necessrio limitar a capacidade
dos usurios finais para criar um nmero de cliente dobrou. Se duas empresas diferentes que
partilhavam o seu nmero de cliente, corremos o risco de registrar uma ordem para a empresa
errada.

esquema completo a base dados

O grfico a seguir fornece uma viso geral da base de dados completa.Si olhar para ele do ponto de
vista de um vendedor que tem uma ordem de telefone, os registros do arquivo ordem que a ordem,
detalhe mantm os artigos encomendados, e arquivos de clientes e produtos manter a informao
constante em ambos os temas.

O artigo referem-se a descrio e preo. O cdigo do cliente procura o nome e endereo do cliente.
Outros dados, tais como a data da operao, so preenchidos automaticamente (na data do sistema,
por exemplo).

Finalmente, o workshop ir criar um novo dicionrio de dados, que voc copie os arquivos
definidos acima, o novo dicionrio.

Como para a aplicao criado, porque o curso uma ferramenta educacional que tenta mostrar o
que Clarion pode ajudar voc no criar um sistema de encomendas em grande escala. No entanto,
certas partes da aplicao ser muito revelador, para aprender como aplicar procedimentos
semelhantes em suas prprias aplicaes.
EuCONTEDO 73

Interface do aplicativo

A maior tarefa ainda antes de comear a codificar planejar a interface do usurio. Em uma
aplicao de negcio como este, importante que o vendedor localizar rapidamente os dados que
voc precisa para que voc pode gravar a venda e atender a prxima chamada. Portanto, o
aplicativo deve colocar todos os dados importantes para olhar, desde o incio, de modo que
nenhuma renda ou modificao de dados mais do que um boto ou comando de menu de
distncia.
Alm disso, a empresa j usa outros aplicativos do Windows; por isso importante que o
aplicativo tem uma aparncia comum e comportamento com os outros. Os usurios finais aprender
mais rapidamente uma interface familiar.
Para o exerccio das funes, o pedido deve ser implementado de forma consistente com as
orientaes indicadas abaixo. Embora o seguinte no substitui uma especificao real do programa
devem servir o objectivo dos Cursilhos.

Desde a aplicao ir lidar com a manuteno de ficheiros dos clientes, itens e ordens em
vrias formas, necessrio interface para vrios documentos (MDI).
A aplicao deve ter uma barra de ferramentas com botes para carregar e formas de vdeo do
Windows (Procurar) para controlar seu funcionamento.
Para manter a consistncia na interface, as opes do menu principal so Arquivo, Editar,
Exibir, Janela e Ajuda. menu Arquivo acessa os procedimentos de impresso e sair. Os botes
nas caixas de dilogo chamada barra de ferramentas para modificar um registro existente (se
selecionado em um Procurar) ou para adicionar / excluir registros, e para percorrer os arquivos.
O menu View chama os procedimentos de exame dos arquivos de dados. Ajudar a janela e
executar as aes habituais.
Quando novas encomendas so adicionados, os vendedores e os clientes devem ser capazes de
escolher os produtos listas de correr. Muitos dados de pedidos (endereos, descries e preos)
deve ir "enchendo", conforme necessrio.

Agora que temos descrito no modo de aplicao bastante completa, estamos prontos para comear
a trabalhar. O primeiro passo criar o dicionrio de dados.

- CA RIANDO DICCIONARIO DE DATOS

73
74 CLARION 5 CLARION
Aprendiendo

Este captulo mostra como:


Criar um novo dicionrio de dados.
Copiar e adaptar as definies tomadas a partir do dicionrio criado por Quick Start.
Vincular arquivos e especificar restries de integridade referencial.
Pr-formatado controles de janela para os campos.
Este tutorial assume que voc tiver concludo o Cursilho para o incio rpido da primeira
parte deste livro.

arquivos Cursilho

Recomendamos fazer o curso completo, especialmente se o ambiente de desenvolvimento


totalmente novo Clarion vai (e mesmo se voc j usou verses anteriores do Clarion). Como voc
deve ter visto no curso anterior, a abordagem com Gerador de Aplicativos Clarion orientada por
modelos muito diferente de outros ambientes de desenvolvimento lnguas terceira e quarta
gerao. Se voc fazer o curso completo, voc vai obter os melhores resultados com esta nova
ferramenta.

Os arquivos curso completo residem no diretrio


\ \ CLARION5 EXEMPLOS \ Guardian. A oferta para que voc possa ver o resultado final do
curso e compar-lo com o seu aplicativo. Deve ocorrer diferenas apenas superficiais.

Se voc j um Clarion programador especialista, voc pode examinar os arquivos acabados, ao


invs de fazer o curso em si. No entanto, recomendamos que voc pelo menos ler atravs deste
curso, uma vez que existem mtodos de trabalhar no ambiente que no podem ser adquiridas
simplesmente "jogar a pia" e trabalhar com ferramentas. Este tutorial demonstra algumas
caractersticas do ambiente de desenvolvimento que no parecem primeira vista.

Nota: Quando existem vrias maneiras de fazer a mesma tarefa, este workshop ir
mostrar vrios, para demonstrar a flexibilidade do ambiente de
desenvolvimento Clarion.

criao Dicionrio

Sempre que um novo aplicativo criado, voc deve primeiro definir o dicionrio de dados
(arquivo .dct). Generator aplicao leva todas as suas informaes no dicionrio: os arquivos de
dados usados pelo aplicativo, suas relaes mtuas, bem como informaes adicionais, como os
controles de formatao predefinidos.
EuCONTEDO 75

Como regra geral, quanto mais viso e trabalho posto em projetar o dicionrio de dados, mais voc
pode fazer o Gerador de Aplicativos. E quanto mais trabalho feito Gerador de Aplicativos para
voc, menos voc ter que fazer a si mesmo!
Quando o curso anterior, execute o Assistente para um incio rpido, simplesmente definir o
arquivo de dados. Agora, apresentamos o editor do dicionrio.

Ponto inicial:
Ele deve ter aberto o ambiente de desenvolvimento Clarion, e Pick caixa
fechada dilogo (escolha).

Indique o nome do novo dicionrio


1. Escolha menu Arquivo New.
2. Clique na opo Dictionary.

A caixa de dilogo Novo aparece.

Nomeie o novo arquivo de dicionrio


1. Selecione o diretrio ou pasta \ CLARION5 \ TUTORIAL
2. tipo tutorial no campo Nome do arquivo.
Clarion acrescenta a extenso: o arquivo de dicionrio tem o nome TUTORIAL.DCT
completo. Voc pode usar nomes de arquivos longos, se voc usar um sistema operacional de
32 bits (Windows 95 ou NT). A verso em Ingls deste curso no usa nomes longos, para
torn-lo vlido para todos os usurios, incluindo Windows 3.x. Como explicamos, esta verso
em espanhol, ocasionalmente, permitir que o comprimento excede oito caracteres para facilitar
a leitura. Usurios de sistemas operacionais que no suportam esta j deve truncar os nomes.

nota: Dicionrio de Dados permite que voc insira nomes de arquivos e campos com
acentos como "Telefone", e estes so processados corretamente pelo Gerador
de Aplicativos. Ao verificar a traduo deste manual descobriu, no entanto, que

75
76 CLARION 5 CLARION
Aprendiendo

algumas partes do Clarion no funcionam bem com acentos; e causar


problemas difceis de diagnosticar. Por favor, no use acentos em nomes de
arquivos, campos ou chaves. Elas podem ser usadas (e aconselhvel faz-lo)
na interface do usurio: rtulos de campo, ttulos de coluna, legendas
explicativas, etc. Estes elementos podem ser predefinidas sem dificuldades no
dicionrio de dados (HDC).
3. Pressione o boto Salvar para criar o arquivo.
Isso cria um arquivo de dados dicionrio vazio. A barra de ttulo mostra o nome do ficheiro.

Especifique uma descrio dicionrio


1. Clique no boto Dicionrio Properties (Propriedades Dictionary).
respectiva caixa de dilogo caixa aparece.
2. Selecione a guia Comentrios e digite o Cursilho dicionrio.
O guia Comentrios permite que voc escreva notas de texto livre no dicionrio. opcional,
mas extremamente til para programadores que podem precisar de rever um projeto depois de
vrios meses de intervalo.
Esta janela tambm oferece uma senha boto (Password), o que impede que outras pessoas
usem este dicionrio. No h necessidade de preencher o Cursilho, mas um recurso til para
considerar.

3. Feche a caixa de dilogo Propriedades dicionrio pressionando o boto OK.

Copiar arquivos de um para outro dicionrio

Voc pode usar comandos normais de copiar e colar no Windows para copiar o arquivo de
definies de outro dicionrio (ou para copiar campos de um arquivo para outro). Em outras
palavras, uma vez que voc definiu ... Para redefinir a preocupao se voc acabou de copiar o que
j foi feito!
EuCONTEDO 77

Cpia dos Clientes definio de arquivo

Abra o outro dicionrio de dados, escolha um arquivo e copie


1. Escolha Arquivo menu de Pick, em seguida, selecione a guia Dicionrio.
2. Selecione a lista de ficheiros de arquivo QWTUTOR.DCT e pressione o boto Select.
outro dicionrio caixa de dilogo, que contm definies de ficheiro de aplicao feitos com
Quick Start abre. Mov-lo, e voc vai ver que ambos os arquivos .dct esto abertas.

3. Os clientes escolhem o arquivo da lista Arquivos.


4. Escolha Editar Copy (ou pressione CTRL + C)
5. Clique no dicionrio caixa TUTORIAL.DCT dilogo.
Isso torna o Tutorial dicionrio ativo.
6. Escolha Editar Paste (ou pressione CTRL + V).
caixa de dilogo Editar aparece propriedades do arquivo.
Esta operao no s copiar o arquivo de definio, tambm copiar os campos e chaves.
7. Pressione o boto OK para fechar a caixa de dilogo Propriedades de editar o arquivo.

77
78 CLARION 5 CLARION
Aprendiendo

Cpia dos telefones definio de arquivo

Vamos agora usar os comandos de copiar e colar para copiar os outros arquivos de definio.
Escolha o arquivo e copiar
1. Clique no dicionrio caixa QWKTUTOR.DCT dilogo.
2. Telefone Escolha lista de arquivos Files.
3. Escolha Editar Copy (ou pressione CTRL + C).
4. Pressione CTRL + F6 ou clique na caixa de dilogo do dicionrio TUTORIAL.DCT.
5. Escolha Editar Paste (ou pressione CTRL + V).
caixa de dilogo Editar aparece propriedades do arquivo.
6. Pressione o boto OK para fechar a caixa de dilogo Propriedades de editar o arquivo.

Feche o arquivo de dicionrio criado por Quick Start


1. Clique na caixa de dilogo QWKTUTOR.DCT diante.
2. Pressione o boto Fechar, ou escolha Arquivo Close.

Vincular arquivos e opes de configurao de


integridade referencial

Voc pode copiar as definies (incluindo a respectiva chave), mas no pode copiar relaes de
arquivo Clarion outros dicionrios. Portanto, voc deve redefinir a relao entre esses dois
arquivos.
EuCONTEDO 79

Definir o primeiro lado do relacionamento

Ns definimos a relao de forma diferente do que fizemos no ano anterior. Desta vez, vamos a
partir do lado de muitos ( "filho") em vez do prximo ( "Pai"), s para provar que pode ser feito.
1. Telefones realce o arquivo e adicione o boto Add Relation.
caixa de dilogo Propriedades nova relao aparece. Como o arquivo foi ltimos telefones
selecionados, estabelecemos a relao de sua perspectiva.
Cada cliente pode ter mais de um telefone. "Cliente" o Pai, em uma relao pai-filho.
Portanto, um muitos para um (muitos: 1) Vista para o cliente a partir de telefones.
2. Escolha muitos: 1 a partir da lista suspensa Tipo na relacao telefones Grupo.
3. . Escolha KeyClienteNum de Estrangeira lista suspensa Key.

Esta a chave que est ligada a uma chave primria no arquivo do cliente; portanto, uma
chave estrangeira.
Definio do outro lado do relacionamento

1. Clientes relacionadas escolher a lista suspensa Arquivo do grupo pai.


2. KeyClienteNum escolher da lista drop-down de chave primria.
A relao entre pai e filho, a chave estrangeira da criana deve estar relacionado com uma
chave primria no pai. Veja Anatomia de um banco de dados, no captulo 4 desta seo e seo
Databasabe Design, emo programador'S GuiaPara mais informaes sobre a teoria de bancos
de dados.
3. Pressione o Mapa pelo boto Nome para ligar os campos.
Voc pode usar esse boto, porque ele deu o mesmo nome para os campos que esto ligados a
ambos os arquivos. Esta uma prtica muito boa para adotar porque, no longo prazo torna
muito mais fcil de manter a aplicao. Quando voc voltar para fazer alteraes em um
projeto que acabou h muito tempo, muito mais fcil de reconhecer as reas ligadas, se eles
tm o mesmo nome em ambos os lados da relao.

Configurando restries de integridade referencial

Para indicar tais restries, voc pode especificar como o cdigo-fonte de gravao Generator
aplicativo que controla o que acontece se um usurio final tenta modificar um valor em uma chave
primria, ou se voc tentar excluir um registro de "pai" com "crianas". Se as restries no esto
definidas, o usurio poderia comprometer a integridade dos registros do banco de dados criando
"rfo" de duas maneiras: pela excluso de um registro "pai" ou alterar o valor do campo
relacional. Em aplicaes geradas com molde Clarion Application Builder Classe, a necessidade
de manter este cdigo de integridade incorporada nas aplicaes de construo de bibliotecas
(ABC).

79
80 CLARION 5 CLARION
Aprendiendo

Para este tutorial, especificar que a aplicao deve atualizar a chave estrangeira, se o valor da
chave primria alterado. Alm disso, ns especificar que voc no pode permitir que o usurio
exclua um pai com filhos.
1. Escolha Cascade ( "Cascade") da atualizao da lista ( "Quando modificada") no grupo de
integridade referencial constrangimentos.
Faa uma cascata mudana significa que a aplicao se estende a mudana e atualiza a chave
estrangeira (filho de arquivos), as crianas em todos os registros relacionados ao registro pai.
2. Escolha Restringir ( "Restringir") Em Excluir da lista ( "Quando voc excluir")
restringir excluso significa que o aplicativo no elimina um pai com filhos (o usurio deve
eliminar primeiro as crianas).
3. Pressione OK para fechar a caixa de dilogo Novo propriedades de relacionamento.

Neste ponto, o dicionrio se parece com isso:

Observe a pequena seta direita do nome do arquivo vinculado na lista de arquivos relacionados.
Ele indica a natureza da relao entre os dois arquivos.
Dois sinais (>> ou <<) prximo ponto "muitos" do lado "um". Um sinal (> ou <) prximo ponto
"um" do lado "muitos". Portanto, Celulares << -> Clientes indica que muitos registros de telefone
pode ser ligado a um registro de cliente.
Salve o seu trabalho
um bom hbito de salvar seu trabalho com freqncia enquanto as aplicaes em
desenvolvimento (falhas e interrupes vm sem aviso prvio). Para isso, escolha Save
arquivo, ou pressione o boto Salvar na barra de ferramentas. Este escreve o arquivo de
dicionrio no disco.

controle de janela formatos definition - Pr


Dentro do dicionrio de dados, voc pode especificar as propriedades padro de controles de
janelas usadas para modificar os campos que definem. Voc tambm pode especificar certas regras
de integridade de dados, definio de verificaes de validade (validade de cheques) e o valor
inicial do campo. Estas opes so a chave para ajudar o Gerador de Aplicativos para fazer a
maioria do trabalho para voc fatores.

caixa de dilogo de acesso Propriedades do campo


1. Clientes Realce o arquivo na lista Arquivos.
2. Pressione o boto Campos / Keys.
EuCONTEDO 81

A caixa de dilogo Campo / Definio Key permite modificar as propriedades de qualquer


campo ou chave no arquivo.

3. Escolha o campo Provncia, e clique no boto Propriedades.


caixa de dilogo Editar propriedades do campo aparece com a opo de Incio Rpido finalistas
neste campo.
Definir verificaes de validade
1. Selecione os cheques guia de validade.
Essa guia permite que voc defina limites para campos numricos, especificar que o valor de
um campo deve ser igual para o mesmo campo em outro arquivo relacionado, que deve ser
verdadeira ou falsa, ou, como neste caso, o valor do campo deve ser uma lista que especificar
na caixa de dilogo.
2. Escolha o boto de opo deve estar em List ( "deve aparecer na lista")
3. Digite o seguinte na caixa de opes (escolhas):
BA | SF | ER | CBA | MZA
Cada opo deve ser separados por uma barra vertical (|).
Assim, a lista de opes admissveis definidos. Neste caso, o dicionrio especifica que apenas
as abreviaturas destes cinco provncias so aceitveis. Voc especificar que padro de controle
para este campo uma lista drop-down.
Em espanhol no teclado, a barra vertical obtida pressionando ALT (boto direito) + 1 (o
teclado normal, no numrico).

81
82 CLARION 5 CLARION
Aprendiendo

Definir um valor padro


1. Selecione a guia Atributos.
2. Tipo 'BA' campo Valor Inicial ( "Valor Inicial"), incluindo aspas simples (no teclado espanhol
Windows a chave para a direita do nmero 0)
Este especifica que sempre que aparece controle, o padro "BA". Os valores iniciais pode
salvar um monte de tempo para o usurio final; Neste caso, se a maioria dos clientes esto
localizados em "BA" impede deve olhar para a lista cada vez que um novo cliente
adicionado. As aspas simples so necessrias porque tambm possvel nomear uma varivel
ou funo como um valor inicial de um campo, o que no cotados (note que h algo regras
diferentes para os valores iniciais de variveis na memria). Como neste caso, o valor inicial
uma cadeia de caracteres, as aspas simples identificados como tal.

Especifique um controle de janela padro


1. Escolha a guia Janela.
Voc deve ser especificado quando em List, o campo de opo de janela padro uma
estrutura com botes de rdio. Estes aparecem como padro na lista de controles do Windows.
EuCONTEDO 83

2. Escolha Lista Drop ( "lista drop-down") na caixa Tipo de controle.


lista de controles de janela agora mostra apenas um prompt ( 'indicador') e uma lista de
controle ( "list") com a queda ( "drop") atributo.

3. Pressione o boto OK para fechar a caixa de dilogo Editar propriedades do campo.


4. Pressione o boto Fechar para fechar o dilogo Definio caixa Campo / Key.
5. Escolha Save arquivo, ou pressione o boto Salvar nas ferramentas da barra de ferramentas.
No prximo captulo, voc vai aprender como adicionar um arquivo para o dicionrio de dados,
completamente comear "do zero", sem o uso de Quick Start e carga rpida. Veja como fcil e
rpido , mesmo sem usar os assistentes.

- EuNCORPORATION DE Ae rchives Campos

83
84 CLARION 5 CLARION
Aprendiendo

Definio de novos arquivos de dados


Depois de copiar e modificar dois arquivos definidos na aplicao Quick Start, voc est pronto
para adicionar um novo arquivo a partir do zero.

Ponto de partida:
O arquivo TUTORIAL.DCT (dicionrio) deve estar aberta.

Arquivo Criao de Ordem

especificao de etiqueta, o prefixo e descrio


1. Clique no boto Add File na caixa de dilogo dicionrio.
2. Quando a caixa de dilogo Adicionar arquivo aparece com a questo de saber se a utilizao de
carga rpida, pressione o boto No
nova caixa de dilogo aparece propriedades do arquivo. Clarion utiliza a informao que aqui
incorporada para declarar a estrutura de ficheiro (file).
3. Digite ordens no campo Nome e pressione TAB.
Este campo s aceita um rtulo vlido para Clarion, que identifica exclusivamente a estrutura
de dados. Uma etiqueta s pode conter letras, nmeros e o sublinhado (_) ou clon e deve
comear com uma letra ou sublinhado. Os acrdos do cdigo executvel usar este rtulo para
se referir ao arquivo.
Aps pressionar TAB, "PED" aparece automaticamente no campo Prefixo. O prefixo uma
maneira para identificar exclusivamente os campos que tm o mesmo nome em diferentes
arquivos de dados. Por exemplo, PED: cusno cusno o campo no arquivo de ordens enquanto
CLI: cusno o campo de mesmo nome nos clientes de arquivo. Voc tambm pode identificar
exclusivamente os campos usando o Avaliao sintaxe Campos (discutido em referncia
Language).
4. Digite ordens de cabealho no campo Descrio.
Esta descrio aparece ao lado do arquivo de dados de etiqueta na lista Dictionary. Se voc
escolher o guia Comentrios, voc pode escrever uma descrio mais longa. Essa descrio
pode ser muito til quando ele retorna para o arquivo para a manuteno do programa.
arquivo de driver eleio
1. Escolha Arquivo Topspeed da lista drop-down driver.
Esta ao declara o formato de arquivo para dados como TopSpeed. Este o mais novo dos
dois prprios formatoso TopSpeed Corporao Tem desenvolvido (o outro Clarion).
A seo Driver Handbook Database Application fornece informaes sobre que tipo de dados
cada controlador suporta, bem como outras informaes teis, tais como extenses de arquivo
padro para arquivos de dados e / ou ndices. Ele tambm oferece dicas e truques para escolher
o driver correto para a tarefa, que os condutores so melhores quando o aplicativo deve lidar
EuCONTEDO 85

com um grande banco de dados que atualizado com freqncia, ou que os condutores so
melhores quando o que mais importa a busca curto espao de tempo.
2. Pressione o boto OK.
Voc pode aceitar os padres para todas as outras opes. a caixa de dilogo fechada ea caixa
dicionrio mostra o arquivo de ordens, com o esclarecimento "ordens de cabealho" ao seu
lado.

Detalhe nomear os arquivos e Produtos

Criando o detalhe de arquivo


1. Clique no boto Add File na caixa de dilogo dicionrio.
Escolha No quando perguntado se deseja usar Quik Carga ( "Quick Charge").
2. Tipo de detalhe no campo Nome.
3. Tipo Detail (linhas) de ordens no campo de descrio.
4. Escrever varejo no campo Prefixo.
Essa personalizao do prefixo padro (mudana de "DET" a "RETAIL") torna o cdigo mais
legvel. Embora convencional para prefixos so trs caracteres, ele tambm pode ser mais,
como vemos aqui.
5. Escolha Topspeed a lista drop-down FileDriver.
Aceite todas as outras configuraes pr-configuradas.
6. Pressione o boto OK.

Arquivo produtos Criao


1. Pressione o boto AddFile (no use Quick Load).
2. Produtos Tipee no campo Nome.
3. produtos Tipee para venda no campo de descrio.
4. Tipo PROD no campo Prefixo.
5. Escolha Topspeed arquivo da lista drop-down driver.
6. Pressione o boto OK.

Salve o seu trabalho


1. Escolha Salvar arquivo, ou pressione o boto Salvar na barra de ferramentas.
Neste ponto, a caixa Dicionrio parece com isso:

85
86 CLARION 5 CLARION
Aprendiendo

Definio de campos

Definio de um campo Piscina

Neste momento vrios campos que iro definir campos de ligao entre os arquivos no banco de
dados. Vamos usar um mecanismo chamado Piscina Dicionrio de Dados Campo (Pool Field) para
garantir que eles so definidos exatamente como nos ficheiros que necessitam dele.
1. Clique no boto Add File.
Um pool de Campos tratada no Dicionrio de dados como um arquivo, mesmo que no seja
normalmente qualquer cdigo em aplicaes. Voc pode definir no Dicionrio de dados como
muitos campos como voc como piscinas, no entanto, no geralmente necessrio usar mais de
um.
2. Escolha a opo Pool.
3. CamposPool Tipee no campo Nome.
4. Escrever POOL no campo Prefixo.
5. Pressione o boto OK.
Abrir venda Campo Definio e Chaves
1. Iluminar arquivo CamposPool na lista Arquivos.
2. Pressione o boto Campo / Chaves ...
Esta janela mostra todos os campos definidos e chaves em um arquivo. Uma vez que um novo
arquivo est em branco. Poderamos comear a adicionar campos, mas em vez disso vai comear a
copiar os clientes de um campo de arquivo.
3. Clique na barra de ttulo da janela / do campo Key Definio e arraste para ver a caixa de dilogo
dicionrio est abaixo.
4. Clientes Realce o arquivo na lista Arquivos de dicionrio. Note-se que o foco se move esta janela
5. Pressione o boto Campos / Chaves ...
Agora uma outra venda Campo / Definio Key aparece com os campos definidos nos clientes de
arquivo.
Escolha e copiar um campo
EuCONTEDO 87

1. Escolha o campo cusno lista Campos.


2. Escolha Editar> Copiar (ou pressione CTRL + C).
3. Escolha Janela> Campo / Definio Key - Campos Pool (ou clique na janela aberta para traz-lo
em foco).
4. Escolha Editar> Colar (ou pressione CTRL + V).
aparece Caixa De dilogo Editar propriedades do campo.
5. Pressione OK para fechar Caixa De dilogo Editar propriedades do campo.
Este o campo que ir oficiar link para o relacionamento entre clientes e arquivos de Pedidos.
Campos ligao entre diferentes arquivos so sempre definidas a mesma, de modo que copiar a
definio uma maneira de introduzir a definio existente no Pool de Campos.
Derivando um campo existente
1. Selecione Janela> Campo / Definio Key - Clientes (ou clique na janela aberta para traz-lo em
foco).
2. Destaque o campo cusno lista Campos e clique no boto Propriedades.
Propriedades do campo da caixa de dilogo de edio aparece.
3. Escrever POOL: Cliente derivada de campo.
Isto significa que o campo CLI: cusno agora derivada de POOL campo: cusno. O termo
"derivado" significa que a definio do pool de campo: cusno o "pai" e todos os "filhos" que so
derivados a partir dele, campos compartilhar automaticamente todos os seus atributos.
Acumulando definio de campos campos existentes, d-lhe a capacidade de fazer alteraes em
um s lugar e aplicar em cascata todos os campos derivados. Por exemplo, se preciso mudar a
definio de cusno campo em todos os registros que o utilizam, ns simplesmente muda a
definio de POOL: cusno e cascata seria aplicvel a todos os campos derivados. Isso pode ser
feito, escolhendo Editar> Distribuir campo depois de fazer alteraes POOL: cusno.
4. Pressione OK na caixa de dilogo Editar propriedades do campo.
Adicione o resto dos campos para Piscina de Campos
1. Selecione Janela> Campo / Definio Key - Campos Pool (ou simplesmente clique na janela
aberta para dar foco).
2. Pressione Insert para abrir caixa de dilogo Propriedades novo campo.
Depois de ter comeado a definir novos campos aparecem automaticamente a caixa de dilogo
Propriedades Novas aps a adio de cada campo. Isso acelera o processo de adio de vrios
campos. Depois de adicionar o ltimo, basta apertar o boto Cancelar no espao em branco
caixa de dilogo para retornar caixa Campo / Key Definio.
3. Digite ordno no campo FieldName.
Este campo ser o elo entre as encomendas e arquivos detalhe.
4. SHORT Escolha caixa Tipo de dados.
Este especifica um inteiro curto (32.769 para 32767).
5. Pressione o boto OK.
6. Digite partNum no campo Nome do campo.

87
88 CLARION 5 CLARION
Aprendiendo

Isto ir ligar o detalhe arquivo com o produto.


7. SHORT selecionar a partir da lista suspensa para o campo Tipo de dados.
8. Pressione o boto OK.
9. Pressione o boto Cancelar.
Reaparec Box Campo / dilogo Chave Definio.
10. Pressione o boto Fechar.

Definindo campos de arquivo ordens

Neste ponto, voltar a apresentar ordens e se preparar para definir os campos.


abrindo janelas Campo / Definio Key.
1. Realce o arquivo da lista de ordens arquivos.
2. Pressione as teclas / ... boto Fields.
3. Pressione o boto Insert para abrir caixa de dilogo Propriedades novo campo.
4. Digite cusno no campo Nome do campo.
5. Pressione o boto reticncias (...) para a direita do campo derivada.
um listas de seleo janela, como uma rvore, com todos os campos j definidos no dicionrio
aparece. Voc pode derivar um novo campo de outra j existente, ou em um arquivo, o campo
de dados abrangente ou piscina.
6. Iluminar cusno campo CamposPool e pressione o boto Select.
O novo campo ser uma cpia perfeita do campo que foi derivado automaticamente. O boto
com o cone de uma seta circular para a direita da reticncias (...) boto permite atualizar o
campo derivado como definido pelo campo "pai" se necessrio (mas muito mais simples para
escolher Editar> Distribuir Campo aps modificar o campo "pai").
7. Pressione o boto OK para fechar as Propriedades novo campo da caixa de dilogo.
Este campo ir oficiar ligao entre as Ordens de arquivo e cliente.
Derivar o ordno campo
Isto proporciona uma identificao nica para cada ordem.
1. Digite ordno no campo Nome do campo.
2. Pressione o boto reticncias (...) para a direita do campo derivada.
3. Destaque ordno campo CamposPool e pressione o boto Select ..
4. Boto pressione OK para fechar a caixa de dilogo Propriedades do novo campo.
Definir campo Valor da Fatura
Este campo armazena o valor total do pedido.
EuCONTEDO 89

1. Digite MontoFactura no campo Nome do campo.


2. Select decimais a partir da lista drop-down Tipo de Dados.
3. Introduza 7 no campo de caracteres.
Este especifica o nmero total de dgitos do nmero (em ambos os lados do decimal).
4. Tipo 2 no campo Places ( "casas decimais").

5. Pressione o boto OK.


definio campo de data
O campo armazena a data em que o pedido foi feito.
1. Digite OrderDate no campo FieldName.
2. LONGO escolher da lista drop-down Tipo de dados.
LONGO o preferido para armazenar datas tipo de controlador TopSpeed. H um valor de
data ESTANDART Clarion (ver Referncia de idioma para mais informaes sobre datas e
horrios Clarion padro) est contido.
3. Tipee @ D5 no campo imagem do ecr ( "padro de exibio").
Este padro de exibio especifica a formatao padro do campo "caracteres". Neste caso @
D5 significa formato de data DD / MM / AA. A caixa de dilogo mostra uma representao de
texto formatado ao lado do campo.
4. Selecione os atributos de tabulao (atributos) e digite TODAY () no campo Valor inicial.
O cdigo gerado coloca a data de hoje, a qualquer controle, quando o registro adicionado

89
90 CLARION 5 CLARION
Aprendiendo

usando a funo built-TODAY ().


5. Pressione o boto OK.
definio de campo nota
Isso permite que voc inclua uma nota curta para instrues especiais de ordem.
1. Nota tipee no campo FieldName.
2. STRING escolher a lista drop-down Tipo de Dados.
3. Digite 80 no campo de caracteres.
Este especifica 80 caracteres.
4. Pressione o boto OK.
Fechar as Propriedades novo campo da caixa de dilogo
Todos os campos so definidos, e que agora abrir uma nova caixa de dilogo Propriedades do
campo.
1. Pressione o boto Cancelar para fechar as Propriedades novo campo da caixa de dilogo.
2. Pressione o boto Fechar para fechar o dilogo Definio caixa Campo / Key.

arquivo de definio de campos Detalhe

Neste ponto, vamos definir arquivo Detalhe campos.


Derivar a definio do campo de ligao
1. Detalhe realce o arquivo na lista Arquivos e pressione o boto Insert para abrir caixa de dilogo
Propriedades novo campo.
2. Digite ordno no campo FieldName.
3. Pressione o boto reticncias (...) para a direita do campo derivada.
4. Destaque ordno campo CamposPool e pressione o boto Select.
5. Pressione o boto OK para fechar as Propriedades novo campo da caixa de dilogo.
Este campo ser o elo entre as encomendas e arquivos detalhe.
Derivando a partNum campo
Este campo permite que arquivos e ligar este produto.
1. Tipee partNum no campo Nome do campo.
2. Pressione o boto reticncias (...) para a direita do campo derivada.
3. Destaque campo partNum CamposPool e pressione o boto Select.
4. Pressione o boto OK para fechar as Propriedades novo campo da caixa de dilogo.
definio de campo quantidade
Este campo armazena a quantidade encomendada.
EuCONTEDO 91

1. Entrar no campo Quantidade Nome do campo.


2. Escolha curto quanto o tipo de dados (tipo de dados)
3. Pressione o boto OK.
Definio de campo ProdPrecio
Isso mantm o preo unitrio do produto no momento da encomenda.
1. Tipee ProdPrecio no campo Nome do campo.
2. Escolha decimal como o tipo de dados.
3. Tipo 5 no campo de caracteres.
4. Tipo 2 no campo Places.
5. Pressione o boto OK.
Definindo o TasaImponible campo
6. Tipee TasaImponible no campo Nome do campo.
7. Escolha decimal como o tipo de dados.
8. Tipo 4 no campo caracteres.
9. Tipo 2 no campo Places.
10. Pressione o boto OK.
Fechar as Propriedades novo campo da caixa de dilogo
Todos os campos so definidos, e que agora abrir uma nova caixa de dilogo Propriedades do
campo.
1. Pressione o boto Cancelar para fechar as Propriedades novo campo da caixa de dilogo.
2. Pressione o boto Fechar para fechar o dilogo Definio caixa Campo / Key.

Definindo campos de arquivo Produtos

Neste ponto, vamos definir campos de arquivo do produto. Este o ltimo arquivo.
Derivar a definio do campo de ligao
1. Produtos realce o arquivo na caixa de dilogo Dicionrio caixa de listagem Files.
Pode ser necessrio para mover algumas janelas para faz-lo. O foco se move para a caixa de
dilogo dicionrio.
2. Pressione as teclas / ... boto de campo.
Agora, uma nova janela aberta Campo / definio da chave com os campos definidos para
produtos de arquivamento.
3. Pressione o boto Insert para abrir caixa de dilogo Propriedades novo campo.
4. Digite partNum no campo Nome do campo.

91
92 CLARION 5 CLARION
Aprendiendo

5. Pressione o boto reticncias (...) para a direita do campo derivada.


6. Destaque campo partNum CamposPool e pressione o boto Select.
7. Pressione o boto OK para fechar as Propriedades novo campo da caixa de dilogo.
Este campo detalhe vontade a ligao entre arquivos e produtos.
Definio Campo Descrio
Este campo carrega a descrio do produto.
1. descrio do tipo no campo FieldName.
2. STRING escolher a lista drop-down Tipo de Dados.
3. Digite 25 nos caracteres de campo (caracteres).
4. Pressione o boto OK.
definio de campo Preo
1. Tipee preo no campo Nome do campo.
2. Escolha decimal como o tipo de dados.
3. Tipo 5 no campo de caracteres.
4. Tipo 2 no campo Places.
5. Pressione o boto OK.
Definindo o TasaImponible campo
1. Tipee TasaImponible no campo Nome do campo.
2. Escolha decimal como o tipo de dados.
3. Tipo 4 no campo caracteres.
4. Tipo 2 no campo Places.

5. Pressione o boto OK.


EuCONTEDO 93

Fechar a caixa de dilogo Propriedades do novo campo e salvar o


trabalho
Todos os campos foram definidos, e deve ser uma nova caixa de dilogo Propriedades ativos novo
campo.
1. Pressione o boto Cancelar para fechar a caixa de dilogo.
2. Pressione o boto Fechar em cada dilogo aberto caixa Campo / KeyDefinition.
3. Escolha Arquivo Salvar ou clique no boto Salvar na barra de ferramentas.

- EuNCORPORATION DE Ce Laves RELAES

Agora que ns definimos todos os arquivos, podemos adicionar chaves e especifique as relaes
entre os arquivos. O Assistente de Incio Rpido e definiu as chaves dos dois arquivos criados para
a implementao do primeiro curso. Neste captulo, vamos definir as chaves para outros arquivos

Ponto de partida:
O arquivo TUTORIAL.DCT (dicionrio) deve estar aberta.

Ordens chave definio de arquivo


Os campos no arquivo de ordens que esto ligados a outros arquivos no banco de dados so ordno
e cusno campos.

Clientes Pedidos
NumCliente NumCliente Detalle
Nombres NumPedido NumPedido
Apellidos MontoFactura NumProducto
Empresa Fecha Cantidad
Direccin Nota ProdPrecio
Ciudad TasaImponible
Provincia
CP

O campo ordno est ligada ao detalhe arquivo.


no devem ser duplicados ou valores nulos (vazia) da ordem nesse arquivo: esta a chave
primria.

93
94 CLARION 5 CLARION
Aprendiendo

H muitos registros de detalhes de um nmero de pedido nico. Portanto, esta uma relao de
um-para-muitos: o arquivo de ordem o "pai" file Detalhe.
campo NumClente est vinculado ao arquivo do cliente.
No ser duplicada nos valores cusno campo. A chave que definimos no arquivo de ordem
estrangeira. O arquivo de chave fim no permite duplicatas e nulos, e foi definida como a
chave primria para esse arquivo.
Pode haver vrios pedidos para cada cliente, tornando-se uma relao muitos-para-um: o
arquivo de ordem o "filho" do arquivo do cliente.

criando chave Primria

Nomeie a chave
1. Ordens Realce o arquivo na lista Arquivos.
2. Pressione o boto Campo / Key ...
3. Selecione a guia Chaves.
4. Pressione o boto Inserir.
nova caixa de dilogo aparece Propriedades chave.
5. Tipo KeyNumPedido no campo Nome da chave.
Como conveno mnemnico, sugerimos incorporando a "chave" a palavra e o nome do campo
no nome da chave (como faz o Assistente para um comeo rpido).
6. Selecione a guia Atributos, marque a caixa Exigir Valor nico ( "um valor nico
necessria"), e marque a caixa de chave primria.
Isto especifica que a chave primrio. O cdigo de fonte gerado automaticamente impede o
utilizador para introduzir valores duplicados ou nulo.
7. Marque a caixa Nmero Auto.
O cdigo gerado pelos modelos aumentar a tecla numrica para cada novo registro.

8. Selecione a guia Campos.


EuCONTEDO 95

Designar o campo de chave


1. Pressione o boto Inserir.
Caixa de dilogo Inserir componente chave ( "Enter componente chave") aparece para voc
especificar o campo ou campos que compem a chave.
2. Clique duas vezes no ordno.
Isso adiciona o campo para a lista de componentes para estes campos de chave.

3. Pressione o boto OK.


Uma nova caixa de dilogo aparece Propriedades New Key para digitar uma nova senha.

Designar uma chave estrangeira

Agora podemos definir a cusno chave. Duplicatas so permitidas neste arquivo. Ela est ligada
chave primria nos clientes de arquivo, por isso uma chave estrangeira.
1. Tipo KeyNumCliente no campo Nome da chave.
2. Selecione a guia Atributos.
A chave permite duplicatas, assim tambm as configuraes predefinidas.

3. Selecione a guia Campos.


4. Pressione o boto Inserir.
caixa de dilogo Inserir aparece componente chave, para especificar um campo ou campos para
a chave.

95
96 CLARION 5 CLARION
Aprendiendo

5. Selecione cusno e pressione o boto Select.


6. Pressione o boto OK.
Cada vez que voc terminar de definir uma chave, uma caixa de dilogo Propriedades nova
chave, a incorporar a seguinte.
7. Pressione o boto Cancelar para fechar as Propriedades nova chave de caixa de dilogo.
O arquivo de caixa de dilogo ordens agora aparece da seguinte forma:

8. Pressione o boto Fechar para fechar o dilogo Definio caixa Campo / Key.
9. Escolha Salvar arquivo, ou pressione o boto Salvar na barra de ferramentas.
EuCONTEDO 97

Key Detalhe Definition File

Os campos no arquivo detalhes que esto ligados a outros arquivos no banco de dados so
NumProductos e ordno.

Pedidos Detalle Producto


NumCliente NumPedido NumProducto
NumPedido NumProducto Descripcion
MontoFactura Cantidad Precio
Fecha ProdPrecio TasaImponible
Nota TasaImponible

O campo ordno est vinculado ao arquivo Orders.


No ser duplicada no ordno campo com links para registros nos valores de arquivo ordem.
Ns definimos a chave no arquivo detalhe outra chave estrangeira. Ordens do arquivo de
chave no permite valores duplicados ou nulos, e foi definida como a chave primria.
Pode haver mais de um registro de detalhe para um nmero de ordem particular. Portanto, um
detalhe muitos-para-um, sendo arquivo o "filho" do arquivo Orders.
O campo partNum est ligada aos produtos de arquivo.
No ser duplicado no campo partNum registra valores de detalhe de arquivo. Pode haver mais
do que uma ficha detalhe (linha ordem) referenciado a um nmero nico produto. Portanto,
temos aqui um outro relacionamento de muitos-para-um, com o arquivo detalhe "Filho"
Arquivo "Produtos".

Definio da primeira chave estrangeira

KeyNumProducto definido de modo que pode haver valor partNum duplicado neste arquivo.
1. Detalhe realce o arquivo na lista Arquivos.
2. Pressione o boto Fiel / Chaves ...
3. Selecione a guia Chaves.
4. Pressione o boto Inserir.
5. Tipee KeyNumProducto no campo Nome da chave.
6. Selecione a guia Atributos.

97
98 CLARION 5 CLARION
Aprendiendo

Esta chave permite duplicatas, portanto, deixe todas as predefinies.


7. Selecione a guia Campos.

8. Pressione o boto Inserir.


9. Escolha partNum e clique duplo.
10. Pressione o boto OK.
Principais Propriedades caixa de dilogo aparece em branco, esperando que voc especificar
outra chave.

Definio da segunda chave estrangeira

1. Tipee KeyNumPedido no campo KeyName.


2. Selecione a guia Campos.
3. Pressione o boto Inserir.
4. Selecione ordno e clique duas vezes.
5. Pressione o boto OK.
6. Pressione o boto Cancelar para fechar a caixa de dilogo Propriedades de Nova chave em
branco.

Box Campo / dilogo Detalhe Definition File Key agora se parece com isso:
EuCONTEDO 99

7. Pressione o boto Fechar para fechar o dilogo Definio caixa Campo / Key.
8. Escolha Salvar arquivo, ou pressione o boto Salvar na barra de ferramentas.

Definio dos produtos-chave para arquivamento


Apenas um campo no arquivo do produto est ligado a outro arquivo no banco de dados: o campo
partNum.
PartNum est ligada ao detalhe arquivo.

Detalle Producto
NumPedido NumProducto
NumProducto Descripcion
Cantidad Precio
ProdPrecio TasaImponible
TasaImponible

No deve haver nmeros duplicados ou arquivo do produto ordem zero, porque uma chave
primria.
Para cada partNum no registro pode haver muitos registros de detalhes. Este um, onde o
arquivo do produto "Pai" file detalhe de um-para-muitos.

Criar chave primria

Nomeie a chave
1. Realce o arquivo na lista de produtos Files.
2. Pressione o boto Campo / Chaves ...
3. Selecione a guia Chaves.
4. Pressione o boto Inserir.
5. Digite KeyNumProducto no campo KeyName.
6. Escolha a guia Atributos.

99
100 CLARION 5 CLARION
Aprendiendo

7. marEla exige a caixa Valor nico e armrio chave primria.

8. Marque a caixa Nmero Auto.


9. Escolha a guia Campos.
10. Pressione o boto Inserir.
11. Escolha partNum e clique duplo.
12. Pressione o boto OK.
Principais Propriedades caixa de dilogo aparece em branco, pronto para outra definio de chave.

Definio de uma chave alfabtica

Os usurios provavelmente vo querer ver a lista de produtos em ordem alfabtica, por isso,
adicionar a chave apropriada.

1. Tipo KeyDescripcion no campo Nome da chave.


2. Escolha a guia Campos.
3. Pressione o boto Inserir.
4. Escolha Descrio, e clique duas vezes.
5. Pressione o boto OK.
6. Pressione o boto Cancelar para fechar a caixa de dilogo Propriedades Key em branco.
Box Campo / dilogo Key produtos definio de arquivo parecido com este:
EuCONTEDO 101

7. Pressione o boto Fechar para fechar o dilogo Definio caixa Campo / Key.
8. Escolha Salvar arquivo, ou pressione o boto Salvar na barra de ferramentas.

Definir relaes entre os arquivos

Que definem as relaes "Pedidos"

Agora que ns definimos todas as chaves, podemos adicionar relacionamentos. Uma vez definidas
essas verificaes de validade podem ser adicionados dos campos devem conter apenas os valores
existentes em outro arquivo. Estes so os estgios finais para completar o dicionrio de dados.
KeyNumPedido vincula o arquivo para arquivar Detalhe em uma proporo de um-para-muitos
..
arquivo KeyNumCliente links de arquivos Pedidos de clientes em um de muitos para.

Definio da primeira relao

1. Realce o arquivo da lista de ordens arquivos.


2. Adicionar Relao pressione o boto.
O tipo predefinido 1: Muitos, o que certo neste caso.
3. KeyNumPedido escolher da lista drop-down de chave primria.
4. Escolha lista Detalhe deaplegable arquivo relacionado.

101
102 CLARION 5 CLARION
Aprendiendo

5. Escolha KeyNumPedido da lista drop-down chave estrangeira.


6. Pressione o Mapa pelo boto Nome ( "Correlacionando nome").
Isto estabelece a relao que liga todos os campos nas duas chaves que compartilham o mesmo
nome.

Configurando restries de integridade referencial


1. Cascade escolher a atualizao na lista.
Isso indica que os modelos devem gerar cdigo para atualizar automaticamente todos os
registros "crianas" ligados, quando o valor das principais mudanas do pai.
2. Em Restringir escolha Excluir da lista.
Isso impede que o usurio exclui um arquivo de arquivos "pai" ter "filhos" ligada.
3. Pressione o boto OK.

Definindo o segundo rcio


1. Realce o arquivo da lista de ordens arquivos.
2. Adicionar Relao pressione o boto.

3. Escolha muitos: 1 a partir da lista drop-down Tipo.


Observe que quando voc escolher muitos: 1, indicadores de chave primria e campos de chave
externos de cmbio lugares. Isto porque estamos definindo as relaes do ponto de vista do
EuCONTEDO 103

arquivo "filho"; o lado oposto do relacionamento que j fez. Uma chave primria sempre
no arquivo de "pai", enquanto um arquivo de chave estrangeira sempre pertence criana.
4. Escolha KeyNumCliente da lista drop-down chave estrangeira.
5. Clientes relacionadas escolher a lista de arquivos.
Isto estabelece o arquivo do cliente como o "pai" nesta relao
6. KeyNumCliente escolher da lista drop-down de chave primria.
7. Pressione o Mapa pelo boto Name.

Configurar resticiones integridade referencial


1. Cascade escolher a atualizao na lista.
Embora estamos definindo essa relao do lado do arquivo de "criana", restries de
integridade referencial permanecem em compartilhamentos de arquivos "pai".
2. Em Restringir escolha Excluir da lista.
3. Pressione o boto OK.
A caixa de dilogo Dicionrio deve ficar assim:

escolher arquivo save, ou pressione o boto Salvar na barra de ferramentas.

Definindo Relacionamentos de detalhes do arquivo

103
104 CLARION 5 CLARION
Aprendiendo

Cada vez que um relacionamento definido no Editor de dicionrio vlido para ambos os
arquivos de uma vez. Portanto, uma vez que voc j definiu todas as relaes arquivar ordens,
apenas uma relao definida.
Este ltimo pertence relao detalhe arquivo.
O arquivo de chave KeyNumPedido liga ordens Detalhe em uma proporo de um-para-
muitos. Isso j foi definido.
O KeyNumProducto ligaes-chave do ficheiro Detalhes do produto em um de muitos para.

Definir o relacionamento
1. Destacar os detalhes do arquivo lista Arquivos.
2. Adicionar Relao pressione o boto.
3. Escolha muitos: 1 a partir da lista drop-down Tipo.
4. Escolha KeyNumProducto da lista drop-down chave estrangeira.
5. Escolha produtos da lista deaplegable arquivo relacionado.
6. KeyNumProducto escolher da lista drop-down de chave primria.
7. Pressione o Mapa pelo boto Nome ( "Correlacionando nome").
Configurando restries de integridade referencial
1. Escolha Restringir a lista suspensa Em Update.
Isso vai evitar que os nmeros de produto forem alterados.
2. Em Restringir escolha Excluir da lista drop-down.
3. Pressione o boto OK.
A caixa de dilogo Dicionrio agora deve ter esta aparncia:
EuCONTEDO 105

4. escolher arquivo save, ou pressione o boto Salvar na barra de ferramentas.

Definio de verificaes de validade depende da relao

Agora que ns definimos todas as relaes entre os arquivos, voc pode definir verificaes dos
dois campos que esperamos fichas ou formulrios de validade.
Quando uma nova entrada de pedidos for inserido, voc pode especificar que o cusno
corresponde a um registro existente no arquivo do cliente.

105
106 CLARION 5 CLARION
Aprendiendo

Quando um novo registro detalhe digitado, voc pode especificar que o partNum deve
corresponder a um registro existente no arquivo de produtos.

Definindo os registros de pedidos de verificao de validade

1. Realce as Ordens lista de arquivos ficheiros recebidos.


2. Pressione o boto Campos / Chaves ...
3. Ilumine cusno (destaque) e clique no boto Propriedades.
4. Selecione os cheques guia de validade.
5. Selecione o boto de rdio deve estar no arquivo ( "deve existir no arquivo ...)
6. Os clientes escolhem a etiqueta a partir da lista drop-down Arquivo.
Esta ao requer que o campo contm apenas valores verificados, consultando o registro
adequado nos clientes de arquivo.
Como este validado utilizando a informao sobre relaes de arquivo, voc no pode
configurar esta verificao de validade at que tenham sido relaes definidas.

7. Pressione o boto OK.


8. Pressione o boto Fechar para fechar o dilogo Definio caixa Campo / Key.

Definio de validade verifica se h registros de detalhes

1. Destacar os detalhes do arquivo lista Arquivos.


2. Pressione as teclas / ... boto de campo.
3. PartNum destaque e pressione o boto Propriedades.
4. Selecione os cheques guia de validade.
5. Escolha o boto de opo deve estar no arquivo.
EuCONTEDO 107

6. Selecione a lista Etiqueta Arquivo produtos.

7. Pressione o boto OK.


8. Pressione o boto Fechar para fechar o dilogo Definio caixa Campo / Key.
O dicionrio de dados j est cheio. No prximo captulo, vamos importar dados existentes de
outro aplicativo, para mostrar como fcil de alcanar.

- EuDados pr-existentes MPORTACION

Convertendo arquivos de dados


Voc pode ter dados de aplicaes legadas que deseja manter e usar em aplicaes Clarion. Para
este fim, este captulo vai ensinar voc a:
Importar uma definio de arquivo de dados pr-existentes.
Procurar e modificar um arquivo usando o administrador de banco de dados ( "Gerenciador de
Banco de Dados")
Como converter dados de um formato de arquivo para outro.

Ponto de partida:
O arquivo TUTORIAL.DCT deve estar aberta.

107
108 CLARION 5 CLARION
Aprendiendo

A importao de uma definio de arquivo CSV

Uma maneira simples para converter arquivos de dados exportar os dados existentes a partir dos
arquivos de aplicativos anteriores Valores separados por vrgulas (.csv). Este o formato de
arquivo usado originalmente pela linguagem Basic, os dados contidos entre aspas, os campos so
separados por vrgulas e os registros so separados por um retorno de carro e alimentao de linha.
Clarion BASIC arquivo de driver l e escreve esses arquivos .csv.
Ir importar a definio de um arquivo CSV existente que contm os dados do cliente, em seguida,
gerar um programa de converso de dados simples (para mostrar como fcil), que TopSpeed
colocada em um arquivo.

arquivo de definio de importao


1. Escolha Arquivo Importar arquivo.

2. Selecione Bsico da lista suspensa e, em seguida, pressione o boto OK.


caixa de dilogo Abrir Arquivo BASIC.
3. No campo Nome do arquivo, tipo c: \ clarion5 \ exemplos \ tutor \ import1.csv e pressione OK.

caixa de dilogo Editar aparece propriedades do arquivo.


4. Pressione o boto OK.
EuCONTEDO 109

Voc tem agora a IMPORT1.CSV definio arquivo. O prximo passo olhar para os dados
do administrador de banco de dados.

Alterar os dados
Clique direito sobre o arquivo IMPORT1.CSV, iluminar Navegar Import1 e clique para chamar o
administrador de banco de dados.

O administrador de banco de dados Clarion permite modificar diretamente os arquivos de dados.


uma ferramenta para o programador, projetado para permitir que voc faa todas as alteraes
necessrias para os arquivos. Isso significa que nenhuma salvaguarda contra as violaes de
integridade referencial ou a integridade dos dados. Portanto, essa ferramenta deve ser usada com
muito cuidado.

Observe que o primeiro registro contm nomes de campo, no dados. Esta a maneira padro de
construir arquivos .csv. Alm disso, esses nomes de campo so exatamente o mesmo que o arquivo
de definies de nomes de campos clientes (o que ir facilitar a converso muito)

Converter um arquivo de dados

Neste ponto, voc tomou no arquivo de dados CSV no Gerenciador de Banco de Dados Clarion.Lo
seguinte informao trazer esses dados para um TopSpeed arquivo para que programas Clarion
pode cham-los.

109
110 CLARION 5 CLARION
Aprendiendo

Gerando um programa conversor de arquivo


1. Escolha Arquivo Converter ficheiro (ou pressione Ctrl + V)
caixa de dilogo Converter caixa de arquivo ser exibida.
2. No campo Destino Nome do arquivo, digite Clientes.TPS como um novo nome de arquivo
(removendo todo o texto pr-configurado que estava no campo).
3. Pressione as reticncias (...) junto Estrutura Target Field.
4. Clientes Realce, pressione o boto Select.
caixa de dilogo agora deve aparecer Converter o seguinte arquivo:
Quando voc pressiona o boto OK, isso vai gerar todo Clarion precisa tomar arquivo de fonte
de dados (Fonte Matrcula), e copi-los para um novo arquivo de destino (Target File) de
cdigo, usando o formato de arquivo especificado na estrutura de destino ( Estrutura Target).
A melhor razo para gerar cdigo-fonte para converso de dados Clarion dada a oportunidade
de modificar o cdigo antes da compilao e execuo, o que d a oportunidade de lidar com
quaisquer necessidades especiais que voc pode ter a respeito de converso. Isso faz com que o
processo de converso completamente flexvel para lidar com qualquer situao que possa
surgir.
5. Pressione o boto OK.
aparece uma mensagem anunciando a gerao de cdigo fonte.
6. Pressione o boto OK para retornar para o administrador de banco de dados.
7. Pressione o boto Exit para sair do administrador de banco de dados.
Excluindo o Import1 definio de arquivo
O nico propsito desta definio foi permitir que o administrador de banco de dados ir gerar
o cdigo de converso. Portanto, podemos remov-lo agora Dicionrio de Dados.
1. Import1 sendo aceso, pressione o boto Excluir.
2. Pressione o boto Sim quando for solicitado para confirmar a excluso.
3. Pressione o boto Fechar para sair do dicionrio Editor de dados, e pressione o boto Sim para
salvar as alteraes quando sair.
Compilar e executar o programa de conversor
1. Escolha Arquivo Abrir (ou pressione CTRL + O).
EuCONTEDO 111

2. Seleccione a fonte Clarion (* .clw) do arquivo da lista drop-down Tipo.


3. Selecione C: \ CLARION5 \ TUTORIAL.
4. CONVERT.CLW realce o arquivo e pressione o boto Abrir.

Editor de Texto Clarion parece modificar o arquivo carregado.


O administrador de banco de dados criado o cdigo fonte de converso neste arquivo, que
contm tudo o que voc precisa ler dados do arquivo BASIC e copiar o TopSpeed arquivo.
5. Escolher projeto Set ....

caixa de dilogo Selecionar caixa proyect aparece.


6. Escolher arquivo Project (* .prj) do arquivo da lista drop-down Tipo.
7. Selecione C: \ CLARION5 \ TUTORIAL.

111
112 CLARION 5 CLARION
Aprendiendo

8. CONVERT.PRJ realce o arquivo e clique no boto Abrir.


O ADMINISTRADOR CONVERT.PRJ arquivo de banco de dados tambm gerado enquanto o
CONVERT.CLW arquivo de origem.
Clarion Cada programa tem um projeto ( "Projeto") que controla as opes para compilar o
cdigo fonte e linkeado para produzir o arquivo .EXE resultante. No caso de (converses e
arquivo gerado pelo administrador de banco de dados) mo codificado programas, essas
configuraes esto contidas em um arquivo .prj. No h necessidade de um .PRJ quando o
Gerador de Aplicativos usado, uma vez que o mesmo arquivo .APP contm todas as
configuraes do projeto.
Neste ponto, poderamos modificar o cdigo fonte para qualquer converso de dados
necessria (ver tpicos na ajuda on-line: Como converter um arquivo-Gerar Fonte e como fazer
uma atribuio de campo para mais informaes sobre como se adaptar a converso de dados
de cdigo). No entanto, no h nada que devemos fazer neste projeto, ento apenas compilar e
executar o programa.
9. Escolher projeto Executar (ou pressione CTRL + R)
Isso compila o programa, linkea para um .exe e executar o arquivo executvel para converter
arquivos resultantes. Durante a execuo do programa, aparece uma janela de status indicando
o status da converso. Uma vez que existem apenas alguns registros que tornam este caso
desaparecer muito em breve e provavelmente no pode v-lo.
10. Escolha Arquivo Fechar para fechar o arquivo e saia do editor de texto.

teste
Agora voc pode verificar os dados no novo arquivo, abri-lo com o administrador de banco de
dados e rolagem atravs de registros.
1. Escolha Arquivo Abrir (ou pressione CTRL + O)
2. arquivo de banco de escolher o arquivo da lista drop-down Tipo, selecione o arquivo
CLIENTES.TPS, e pressione o boto Abrir.
uma caixa de dilogo pedindo o arquivo de driver (driver), password (senha), e as opes
necessrias para abrir o arquivo aberto.

3. Topspeed selecionar a lista drop-down Driver e pressione o boto OK.


Isso demonstra uma outra maneira de abrir o administrador de banco de dados diferente
daquele a partir do Editor do dicionrio.
Observe que o primeiro registro contm nomes de campo em vez de dados, bem como no
arquivo na IMPORT1.CSV arquivo. tais nomes no so necessrias neste arquivo, de modo
que voc pode excluir este registro intil.
EuCONTEDO 113

4. Com o controle deslizante localizado no primeiro registro, pressione a tecla DELETE e


pressione o boto Sim quando for solicitado para confirmar a excluso.
5. Pressione o boto Sim quando for solicitado para fazer um arquivo de backup (cpia de
segurana).
O administrador de banco de dados sempre pergunta se voc quiser fazer um backup antes de
fazer quaisquer alteraes aos dados. premitir sempre boa idia para faz-lo (no caso!).
6. Pressione o boto Exit.
uma mensagem perguntando se voc deseja salvar as alteraes feitas para o arquivo aparece
CLIENTES.TPS. Este dilogo oferece uma oportunidade adicional para desfazer as alteraes
feitas, se ele percebe que foi um erro para fazer alteraes. Sim salva as alteraes e sadas;
no reverte o arquivo para o estado em que estava quando voc entrou o administrador de
banco de dados e para fora, e Anular retorna para o administrador.
7. Pressione o boto Sim para salvar as alteraes.
Agora que voc fez alguns dados existentes importantes para o formato TopSpeed para que os
aplicativos podem usar Clarion. No prximo captulo, vamos comear a construir uma
aplicao "do zero" usando o Gerador de Aplicativos.

- EMPEZANDO THE PROGRAMAO

Usando Gerador de Aplicao

Tendo completado o Dicionrio de Dados agora Gerador de Aplicativos pode ser usado para criar
o aplicativo. Este captulo mostra como:
Criando o arquivo .app, que armazena todo o trabalho do projeto.
Definir o primeiro procedimento (Principal) para criar uma estrutura de aplicativo MDI, e
como chamar procedimentos no menu do aplicativo.

Ponto inicial:
Deve ser aberto somente ambiente de desenvolvimento Clarion.

criao de arquivo .app

1. Escolha Arquivo novo aplicao.

113
114 CLARION 5 CLARION
Aprendiendo

2. Escolha um aplicativo (.app) do Salvar lista drop-down tipo.


3. Selecione C: \ CLARION5 \ TUTORIAL.
4. tipo tutorial no campo Nome do arquivo.
5. Desmarque a caixa de Uso Quick Start, e clique no boto Salvar.
a caixa de dilogo Propriedades do aplicativo aparece.
6. TUTORIAL.DCT Tipee no campo dicionrio.
7. Desmarque a caixa de Assistente de aplicao.
Este curso Gerador de Aplicativos no usar o Wizards, para demonstrar como usar as
ferramentas fornecidas pelo Clarion

8. Pressione OK para fechar a caixa de dilogo Aplicao Propriedades.

Criao do processo principal (Principal)

Aparce caixa de dilogo com a aplicao (aplicao Tree) rvore. Isto apresenta uma lista de todos
os procedimentos de aplicao em uma rvore lgica que fornece um guia visual para mostrar a
ordem em que um procedimento chama outro. Vimo-lo pela primeira vez no Cursilho Quick Start.
O procedimento principal o ponto de partida. A implementao do workshop ser um programa
com Multiple Document Interface (MDI). Portanto, o lugar natural para comear definir o
procedimento usando o modelo do quadro principal para criar um quadro para a aplicao.

Selecionando o tipo de procedimento a principal


1. Ter um principal destaque na caixa de dilogo rvore de aplicativos, clique no boto
Propriedades.
2. Quadro ficar na caixa de dilogo Selecionar Procedimento, desmarque a caixa Use Assistente
de Procedimento e pressione Select.
EuCONTEDO 115

caixa de dilogo Propriedades da caixa de procedimento aparece. Define a funcionalidade e


estruturas de dados do processo.
3. Digite no campo respingo Procedimento SplashScreen.
Isto d o nome do procedimento contm uma tela de abertura que aparece rapidamente como o
usurio abre o aplicativo.

Normalmente, a primeira tarefa criada quando um procedimento projetar a janela principal.


Voc pode colocar controles, ou se o modelo j controla, voc pode personaliz-los.
O mbito da execuo nunca toma-se controla. Windows no. No entanto, vamos personalizar
o ttulo da janela (o texto que aparece na barra de ttulo). Em seguida, adicionar itens ao menu
padro, que tambm pr-configurado processo Quadro modelo, e criar uma barra de
ferramentas para a aplicao (a barra de ferramentas se voc pode incluir controles).

Modificando a janela principal


1. Pressione o boto Window.
Designer janela aparece. Aqui eles so todos necessrios para projetar visualmente as
ferramentas e controles de janela.
2. selecione Exibir show de Propertybox para exibir a propriedade barra de ferramentas
flutuante (se j no estiver presente).

115
116 CLARION 5 CLARION
Aprendiendo

3. Um clique na janela de ttulo para dar-lhe concentrar-se, que lida aparecer ( "manijitas" ou
pegas) coloradas nas bordas da janela.
4. Tipo "Implementao do curso" no campo de texto na barra de ferramentas flutuante
propriedade, em seguida, pressione TAB.

Isso muda o texto do ttulo na janela de amostra. Certifique-se as alas so no mbito da


aplicao de exemplo para executar esta etapa.
Menu Editar

Desde o designer de menu do Windows, voc pode chamar o Editor de Menu, que lhe permite
adicionar ou modificar os itens de menu da janela do quadro da aplicao. Quando voc adicionar
cada item, voc pode selecionar a guia TAB para nomear o procedimento a ser executado quando
o usurio escolhe esse item.
Para cada novo procedimento adicionado ao menu, o Gerador de Aplicativos adiciona um
procedimento de "todo" ( "fazer") a rvore da aplicao. Pode ser definido aps a funcionalidade
deste processo, da mesma maneira que agora est a definir a funcionalidade da estrutura de
aplicao.
Quando o Gerador de Aplicativos gera o cdigo-fonte do aplicativo, ele abre automaticamente
uma nova "thread de execuo" para cada procedimento chamado a partir do menu principal (que
necessrio em qualquer aplicao MDI).
EuCONTEDO 117

Adicionar itens ao menu


1. A partir do Menu Designer Janela, selecione Menu menu Editar (Ou simplesmente
clique duas vezes na barra do menu projeto da janela de ao).
Editor de menu aparece. Apresenta o menu hierarquicamente em uma lista esquerda. Os
campos direita permitem que voc nomear e personalizar os menus e itens.
Este modelo j fornecido com o menu "standard". Contm comandos bsicos como Sair no
menu Arquivo, comandos comuns cortar, copiar e colar, e gesto janela bsica ordens
comumente encontrados em um aplicativo MDI.

2. Ilumine a segunda extremidade sentena (ver ilustrao).


Editor insere novo item de menu imediatamente abaixo da seleo destacada. O menu para
adicionar formulrios ser chamado. Ele contm trs itens: produtos, clientes e encomendas.
aparece na barra de menu apenas antes do menu Window.
3. Pressione o boto Menu Nova superior esquerdo (ou pressione SHIFT + INSERT).
Isso insere um novo menu frase, e sua declarao END correspondente.
4. Escrever Fo & rmularios no campo Menu de texto e pressione TAB.

117
118 CLARION 5 CLARION
Aprendiendo

Isso define o texto que aparece no menu. O comercial (&) indica que o caractere seguinte (r)
sublinhado e fornecer um "atalho de teclado" (o usurio pode pressionar ALT + R para ativar
este menu).

Adicionar o primeiro item de menu


1. NewItem pressione o boto (ou pressione INSERT).
Isso atualiza a lista do lado esquerdo da caixa de dilogo, alterar o texto do menu que voc
acabou de adicionar ao "Fo & rmularios". Adiciona um item de um novo menu de comando
destacvel no menu em Fo & rmularios, e antes da instruo END que vai com o & menu de
Forms.
2. Escreva e Clientes no campo Texto Menu e pressione TAB.
FormulariosClientes aparece? No campo Uso. Esta uma "equivalncia" (EQUATE) do item
de menu para que as frases se referem ao cdigo fonte. marca sinal prefixo (?) Indica um
campo equivalente label (campo equiparar rtulo) (ver o livro de referncia Language).
3. Selecione a guia Aes.
Os indicadores permitem um nome de procedimento a ser executado quando o usurio
seleciona o item de menu formulrios clientes.
4. Escolha chamar um procedimento a partir da lista drop-down Quando pressionado ( "Quando
voc pressiona").
novos indicadores aparecem para o nome do procedimento de chamada e outras opes.
5. VerClientes tipo no campo Nome do Procedimento.
Este processo cria um "todo" (feito) na rvore da aplicao.
6. Verifique a rosca caixa Iniciar ( "Abrir um segmento de execuo").
O procedimento VerClientes ir mostrar uma janela MDI "filha" deve sempre comear um
novo segmento de execuo para cada janela MDI chamado diretamente de dentro do
aplicativo. Tpico campo Stack ( "a execuo da pilha thread") mostra o valor mnimo
recomendado.
EuCONTEDO 119

Adicionando o segundo item de menu


1. Pressione o boto newItem.
Isso atualiza a lista esquerda, mudando o texto do texto que voc acabou de adicionar "e
Clientes".
2. Escreva e produtos na rea de menu de texto e pressione a tecla TAB.
FormulariosProductos aparece? No campo Uso.
Normalmente, o prximo passo definir a ao que este item do menu (que ser executado
quando o usurio final escolhe esta opo). Desta vez, pule esta ao somente neste item. Mais
tarde, voc vai criar um procedimento de cpia e, em seguida, anex-lo para o menu, apenas
para demonstrar esse ambiente Clarion capacidade.

Adicionando o item terceiro menu


1. Pressione o boto newItem.
2. Escreva e ordens no campo menu do campo e pressione TAB.
FormulariosPedidos aparece? No campo Uso.
3. Selecione a guia Aes.
4. Escolha chamar um procedimento a partir da lista drop-down quando pressionado.
5. VerPedidos digitar no campo Nome do Procedimento.
6. Marque a caixa Iniciar Thread.

Fechando o Editor de Menu e Janela Designer


1. Pressione o boto Fechar para fechar o Editor de Menu.
Isso retorna a janela Designer.
2. Escolha a opo Exit! e responda Sim quando perguntado se deseja salvar as alteraes para a
janela.

119
120 CLARION 5 CLARION
Aprendiendo

Isso retorna para a caixa de dilogo Procedure Propriedades.


3. Pressione o boto OK para fechar a caixa de dilogo Propriedades Procedimento.
Isso retorna para a caixa de dilogo rvore Application ( "rvore a aplicao"). Existem hoje
trs novos procedimentos de marcadores como "todo" VerCliente, VerPedidos e SplashScreen.
Estes foram os procedimentos que voc nomeados no Editor de Menu.

4. Escolha Arquivo GuardarOu pressione o boto Salvar na barra de ferramentas.

Tela de abertura de criao de procedimento

Procediemiento nomeou um Splash ( "splash screen"), e agora vamos criar.


1. Destaque procedimento Tela de abertura (ToDo) e pressione o boto Propriedades.
2. Selecione respingo na caixa de dilogo Select Procedimento, limpar o Usar assistente
procedimento de caixa, e pressione o boto Select.
caixa de dilogo Propriedades da caixa de procedimento aparece. No h nada que temos que
fazer este procedimento no workshop, mas para aceitar todas as configuraes predefinidas.

3. Pressione o boto OK.


EuCONTEDO 121

Adicionando uma barra de ferramentas a aplicao

Chamada Designer janela e criar a barra de ferramentas


1. Realce o procedimento principal.
2. Boto direito do mouse para ativar o menu contextual.
Note-se que este menu contextual tem um conjunto de opes igual ao da coluna de botes
localizados direita de cada janela Propriedades procedimento. Este menu contextual d
acesso directo a todas as ferramentas Clarion usados para modificar os procedimentos
existentes, para que voc no tem que ir atravs da janela de Propriedades do Procedimento de
cada vez.

3. Escolha Janela.
4. Menu Designer Janela, escolha Toolbar NewToolbar ("Barra de ferramentas Novo
").
Isso adiciona barra de ferramentas, que sempre aparece logo abaixo do menu na janela do
display. Voc pode adicionar qualquer controle para a barra de ferramentas clicando em um
cone de ferramenta na Controles caixa de ferramentas flutuante, e em seguida, clicando na
barra de ferramentas.

121
122 CLARION 5 CLARION
Aprendiendo

Coloque o primeiro boto


1. Clique na ferramenta boto (que se parece com o boto "OK").
2. Clique na rea da barra de ferramentas da janela, logo abaixo do canto superior esquerdo.
3. Clique direito no boto que voc acabou de colocar, em seguida, escolha Propriedades no menu
de contexto.
caixa de dilogo Propriedades da caixa de boto aparece.

4. Excluir o contedo do campo de texto.


Estes botes permitem colocar imagens em vez de texto para dar uma aparncia de design mais
contemporneo.
5. Escrever? BotonCliente no campo Uso.
Este o rtulo do campo equivalente a referenciar o boto de cdigo. Ns incluem a palavra
"boto" para facilitar a leitura do cdigo.
EuCONTEDO 123

6. Escolha a aba Extra.


7. Marque a caixa Flat.
8. Mostrar a caixa de dilogo Arquivo de Imagem Selecione a lista cone, v at o final e clique
em Selecionar arquivo ... exibida.

9. Escolha o arquivo C: \ CLARION5 \ exemplos \ TUTOR \ CUSTOMER.GIF, e pressione o


boto Abrir.
10. Selecione a guia Ajuda.
11. Escrever Ver lista de clientes no campo Dica.
Isso adiciona uma dimenso que vai aparecer sempre que o cursor do mouse sobre o boto
pra.
12. Escolha a guia Posio.
13. Botes de seleo raio fixo (Fixo), tanto para o longo (largura) e altura (altura).
14. Ajustar o comprimento (Largura) 16 e a altura (altura) a 14.
15. Selecione a guia Aes.
16. Escolha chamar um procedimento na caixa suspensa quando pressionado.
17. Escolha VerClientes caixa drop-down Nome do Procedimento de.
Este o procedimento que voc nomeou na rubrica Forms clientes. Pressione o mesmo
procedimento ir chamar boto. Muitas vezes um boto de comando em um atalho da barra de
ferramentas usadas para executar uma opo de menu.
18. Marque a caixa Iniciar Thread.
19. Pressione o boto OK.

Colocando o segundo boto


1. Clique na ferramenta "boto".
2. Clique sobre a rea da barra de ferramentas da janela em que estamos a trabalhar, apenas para a
direita do primeiro boto. outro boto, denominado "Button2" aparece.

123
124 CLARION 5 CLARION
Aprendiendo

3. Clique direito sobre este boto e escolha Propriedades no menu de contexto.


4. Limpar o campo de texto.
5. Escrever? BotonProductos no campo Uso.
6. Escolha a aba Extra.
7. Marque a caixa Flat.
8. Expanda a lista de cones (cone), v at o final e clique em Select File ...
9. Selecione o arquivo de exemplo C: \ CLARION5 \ exemplos \ TUTOR \ PRODUCTS.GIF, em
seguida, pressione o boto Abrir.
10. Selecione a guia Ajuda.
11. Escrever Ver lista de produtos no campo Dica.
12. Pressione o boto OK para fechar a caixa de dilogo Propriedades do boto.
Normalmente, neste momento uma ao anexado ao boto. Por agora, vamos pular essa ao.
Mais tarde, para demonstrar o uso dos pontos de insero de cdigo, ir copiar um
procedimento, e chamar no ponto de cdigo-fonte que lida com o que fazer quando o usurio
final pressionar o boto.

colocao terceiro boto


1. Clique na ferramenta "boto".
2. Clique na rea da barra de ferramentas, ao lado do segundo boto.
3. Clique direito sobre o boto que voc acabou de colocar, em seguida, escolha Propriedades no
menu de contexto.
4. Excluir o contedo do campo de texto.
5. Tipee? BotonPedidos no campo Uso.
6. Selecione a guia Extra.
7. Marque a caixa Flat.
8. cone exibir a lista, v at o final e clique em Selecionar Arquivo ....
9. Escolha o arquivo C: \ CLARION5 \ exemplos \ TUTOR \ ORDERS.GIF, e pressione o boto
Abrir.
10. Escolha a guia Ajuda.
11. Tipee Veja a lista de ordens no campo Dica.
12. Selecione a guia Aes.
13. Escolha chamar um procedimento a partir da lista drop-down quando pressionado.
14. VerPedidos escolher a lista drop-down Nome do Procedimento.
Este o nome do procedimento que voc entrou no item de menu formulrios Pedidos.
15. Coloque uma marca de verificao da caixa Initiate Thread.
16. Pressione o boto OK.
EuCONTEDO 125

Redimensionar e botes alinhar

Janelas de designer traz um conjunto de ferramentas de alinhamento para fcil ajuste e


alinhamento de controles.
1. Encomendas no boto ainda selecionado, CTRL + clique no boto clientes.

Isso coloca "manijitas" ou "pegas" em torno de ambos os botes, eo boto de Clientes tem
punhos vermelhos, indicando que tem o foco.
D CTRL + clique a ao de "mltipla escolha" para executar aes em vrios controles ao
mesmo tempo. Uma vez que vrios controlos foram seleccionados, pode tambm mover-se
arrastando qualquer um dos controlos transeccionados, ou pode ser utilizado quer alinhamento
ferramenta (Alinhamento), agindo sobre todo o grupo seleccionado.
2. Com os dois botes ainda selecionado, CTRL + clique no boto produtos.

Agora, os trs botes tm alas eo ltimo boto selecionado, produtos, tem vermelho,
indicando que possui o foco, e o "controle mestre" para o alinhamento.
3. Direito do mouse e escolha a opo "Alinhamento Top" (Align Top) menu de contexto.

Quando voc tiver selecionado vrios controles, um clique mostra um alinhamento direita do
menu de contexto, em vez do menu de contexto do controle isolado. Esta ao alinha os trs
botes na altura de produtos.
4. Clique direito e escolha "espaamento horizontal" (Espalhe horizontalmente) menu de
contexto.
Esta distncia proporcionalmente os trs botes. Isso no esto muito distantes, livre para
deixar espao para o que est vindo!

Adicionar os botes de controle Browse

1. Escolha Populate Modelo de controle ... (Ou clique sobre as ferramentas de


modelo de controle que est localizado na parte inferior direita do ngulo flutuante
Controles caixa de ferramentas).
caixa de dilogo Select aparece modelo de controle.
2. Iluminar modelo FrameBrowseControl, e pressione o boto Select.

3. Clique na barra de ferramentas da janela, direita do boto Orders.

Na barra de ferramentas aparecem treze botes de controle de navegao. Sabe aqueles botes,
o aplicativo que voc criou na seo anterior. Estes botes controlam o movimento da lista e
chamar o procedimento de atualizao que ir criar mais tarde.
O layout da tela agora deve ser muito parecido com este:

125
126 CLARION 5 CLARION
Aprendiendo

Feche a janela Designer e salvar seu trabalho


1. Escolha seleo de menu Exit! e responder Sim quando for solicitado para salvar as alteraes
na janela.
Isso retorna diretamente para a rvore de aplicao que contm os mesmos dois procedimentos,
marcados como "fazer" (ToDo): VerClientes e VerPedidos.
2. Escolha Arquivo GuardarOu pressione o boto Salvar na barra de ferramentas.

Testar um desenvolvimento de aplicativos

1. Com a rvore aplicativo aberto, escolha Project corridaOu pressione o boto Executar na
barra de tarefas.
Generator aplicao gera o cdigo-fonte, mostrando o andamento do processo em uma janela
de mensagem, o procedimento por procedimento.
Em seguida, a janela de Marca aparece, mostrando o andamento dos trabalhos e compilador
linkeador.
EuCONTEDO 127

Depois da janela inicial aparece a aplicaoQue deve ser algo como isto:

2. Pressionar um dos botes na barra de ferramentas ou escolha um dos itens no menu


formulrios.
Aparece a seguinte mensagem:
Esta capacidade permite que voc testar seu aplicativo no modo progressivo, se voc tiver
criado todos os procedimentos ou no.
No prximo captulo vamos completar.

3. Pressione o boto OK para fechar a caixa de mensagem.


4. Escolha Arquivo sada para fechar o novo aplicativo.
Durante todo o restante deste curso, no tenha medo de construir e executar (Adicione and
Run) desenvolver a aplicao em qualquer ponto no curso solicitado para salvar o arquivo.

Estudar o cdigo fonte gerado

Agora vamos ver o que o Gerador de Aplicativos tem. O objetivo do Gerador de Aplicativos (e
modelos) escrever o Clarion cdigo fonte para voc. No h "mgica em fazer este conjunto
de ferramentas para criar aplicativos: tudo se resume em linguagem de programao Clarion.

127
128 CLARION 5 CLARION
Aprendiendo

1. rvore de ter aberto o aplicativo, clique na guia Module.


Isso muda a sua viso da aplicao da rvore que mostra a lgica a ser chamar procedimentos
em relao fonte mdulos de cdigo criado para a aplicao.
2. Iluminar mdulo TUTORIAL.CLW, clique direito para exibir o menu de contexto e, em
seguida, clique em Mdulo.
Isso leva voc diretamente para o editor de texto para ver o cdigo fonte mais recente que
gerou (a ltima vez que voc apertou o boto Run). Quaisquer alteraes feitas desde a ltima
vez que o cdigo gerado no ser visvel aqui.

O arquivo TUTORIAL.CLW o principal mdulo do programa desta aplicao, onde todo o


cdigo e declaraes de dados global est contido. No tenha medo por todo este cdigo.
Depois de ter terminado o curso, voc pode consultar a "Introduo linguagem Clarion" no
final deste livro e se tornar mais familiarizado com a linguagem Clarion (que, na verdade,
muito simples).
EuCONTEDO 129

3. Quando tiver terminado de observar o cdigo, escolha Arquivo perto para fechar o editor
de texto e retornar para o Gerador de Aplicativos.
Mas no vai escolher Arquivo sadaOu ser completamente Clarion para Windows.
4. Agora clique sobre o Procedimento de guia.
No, mudar seu ponto de vista da aplicao dos procedimentos de rvores.
5. Realce o DIREITO procedimento Main (Frame) CLIC para ativar o menu de contexto e clique
em Mdulo.
Isso leva voc de volta para o editor de texto para ver o cdigo fonte mais recente gerado para
o procedimento principal. Mais uma vez, as alteraes feitas na Application Builder a partir do
ltimo cdigo de tempo gerado no aparecer neste cdigo.
Voc pode notar que logo abaixo da seleo tinha outra chamada Mdulo Fonte. No confundi-
los, porque eles fazem coisas muito diferentes. Mais tarde, vamos demonstrar a seleco da
fonte.

Se voc fizer alteraes no cdigo, voc pode compilar e executar o programa para ver os
efeitos que as alteraes. No entanto, as alteraes feitas aqui sero perdidas na prxima vez
que voc gerar o cdigo-fonte. Portanto, no uma boa prtica para fazer alteraes aqui.
Esta capacidade de visualizar o cdigo-fonte muito til para estudar o cdigo gerado para
determinar o contexto em que o cdigo que voc deseja adicionar sobre os pontos de insero
(mais tarde tentar isso) aparecer.
6. Quando tiver terminado de observar o cdigo, escolha Arquivo Fechar para fechar o editor
de texto e retornar para o Gerador de Aplicativos.

129
130 CLARION 5 CLARION
Aprendiendo

- CA RIANDO BROWSE

Criao e uma janela Pesquisar


Neste captulo, vamos criar uma lista vitrine (browse) semelhante ao criado para voc o Assistente
de Incio Rpido. Gerador de aplicao utiliza os mesmos modelos que geram o mesmo cdigo fonte
bsica; mas isso vai ter a oportunidade de "torn-lo a partir do zero." Isso mostra que os
participantes podem fazer por voc, e como voc pode fazer to bem. Comeamos a janela de
procura do cliente.

Ponto de partida:
O arquivo TUTORIAL.APP deve estar aberta.

Criando lista de clientes de exibio

Voc deve se lembrar que o Assistente de Incio Rpido criado uma janela para o procedimento de
procura Clientes que ficou assim:

Agora, vamos criar um procedimento semelhante usando o modelo Procurar.

Selecionar o tipo de procedimento para VerClientes


1. Clique duas vezes no VerClientes na rvore da aplicao.
2. Destaque (luzes) modelo na caixa de dilogo Tipo Navegar caixa Selecionar Processo, verificar
se a caixa Usar Assistente de Procedimento no est marcada e pressione o boto Select.
EuCONTEDO 131

caixa de dilogo Propriedades caixa de procedimento abre.


Faa o tamanho da janela ajustvel
1. Na caixa de dilogo Procedure Properties, clique no boto Extenses.
2. Nas Extenses de caixa e de dilogo Modelos de controle, pressione o boto Inserir.
3. a caixa de dilogo Select Extenso iluminar WindowResize, e pressione o boto Select.
Este modelo de extenso gera automaticamente o cdigo para lidar com o redimensionamento e
reposicionamento de todos os controles de janela quando o usurio redimensiona a janela, ou
quando voc pressiona os botes Maximizar ou Restaurar.
4. Pressione o boto OK para fechar a caixa de dilogo e modelo de extenso de controle.

Procurar Procedimento modificao


1. Na caixa de dilogo Procedure Properties, pressione o boto Window.
2. Clique direito sobre o ttulo da janela da janela e escolha Propriedades no menu de contexto.
3. Procurar Os clientes tipee no campo Texto.
4. Redimensionvel Escolha da lista drop-down Tipo de quadro.
5. Selecione a guia extra e marque a caixa Maximizar Box.
Estas duas ltimas etapas permitem que o usurio redimensionar a janela durante a execuo.
6. Pressione o boto OK para fechar a caixa de dilogo Propriedades janela.

Enchimento e concepo de uma caixa de listagem

Usando a lista Caixas Designer, voc pode preencher e formatar os campos de dicionrio de dados
que aparecem nas colunas da lista.
Prepare-se para formatar a janela da lista
Clique direito sobre a caixa listados na janela e escolha caixa de listagem Formato ... no menu de
contexto.

131
132 CLARION 5 CLARION
Aprendiendo

Marque a caixa de dilogo Campo, que fornece acesso a arquivos definidos no dicionrio aparece.
lista de arquivos mostra todos selecionado para uso neste processo em uma hierarquia, ou rvore de
arquivos (Esquema de arquivos), incluindo arquivos de lista caixas de controle.

Escolha o arquivo e campos para colocar na lista

1. Destaque o item "todo" sob FilemBrowsing caixa de lista e pressione o boto Inserir.

2. Clientes Realce o arquivo na caixa de dilogo Inserir arquivo, e pressione o boto Select.
Isso adiciona o arquivo rvore na caixa de dilogo Selecionar campo, que agora exibe o
arquivo e seus campos.
3. Pressione o boto Edit.
4. KeyNumCliente ficar na caixa de dilogo Acesso Mudana chave e pressione o boto Select.
Isto importante, pois indica a ordem de visulaizacin de registros. Se a chave no for
especificado, os registros aparecem na ordem em que foram incorporados ao arquivo (tambm
chamado de "ordem dos registros")

5. Ilumine CLI: Empresa na lista Campos e pressione o boto Select. Isso retorna as caixas de
listagem Designer, com o campo selecionado adicionado lista. A guia direita permitem que
voc crie a aparncia do campo.
EuCONTEDO 133

Aplicando um formato especial para o primeiro campo


1. Selecione a guia Geral marque as caixas para "Right Edge" (margem direita) e "Permitir
redimensionamento" (redimensionvel). Em tempo de execuo, isto ir adicionar uma aresta
vertical reconfigurvel para a direita do campo.
2. Um clique sobre as setas para cima caixas "Sangria" (recuo) para dar um ligeiro recuo do texto
do cabealho e contedo do campo.

Encher o segundo campo

133
134 CLARION 5 CLARION
Aprendiendo

Nova coluna (Insert)

1. Pressione o boto Coluna Nova (Inserir nova coluna).


2. Destaque CLI: Nomes na lista de campos e pressione o boto Select.
3. armrios de apuramento "Right Edge" (margem direita) e "Permitir redimensionamento"
(redimensionvel).
Caixas de listagem Designer automaticamente "arrastar" estas opes ltimo campo adicionados
para continuar a adicionar campos, o que torna muito fcil de incorporar vrios campos com
opes de formatao semelhantes. Neste caso, apagar as marcas das caixas de excluir o divisor
de coluna entre esta coluna e no prximo, que ser o campo Sobrenome.

Encher o terceiro campo


1. Pressione a nova coluna.
2. Ilumine CLI: Sobrenomes na lista de campos (Campos), e pressione o boto Select.
3. Marque as caixas borda direita e redimensionvel.
Este novamente adiciona colunas divisor ajustvel entre esta coluna e o prximo.
EuCONTEDO 135

Agrupamento de alguns campos

New Group (Shift + Insert)

Isto fornece o texto para o cabealho do grupo. Cada campo que adicionado direita sero
includas no grupo at que um novo grupo definido.

Note-se que os efeitos produzidos pela adio de campos e as mudanas realizadas so refletidas
na amostra caixa de lista que aparece no topo do Designer Lista Boxes. Alm disso, voc pode
usar trs botes localizados no lado direito da nova coluna para remover correspondente coluna

Excluir coluna (Apagar) Mover Coluna Esquerda (Ctrl +


Up)

Mover Coluna Direita (Ctrl +


Down)
do campo iluminado (Excluir coluna), mover a coluna para a esquerda (Mover coluna da
esquerda) ou mover a coluna para a direita (Mover Coluna rigtht) respectivamente.

1. Pressione o boto New Group (Adicionar um grupo).


2. Pressione a SETA PARA CIMA para ilumninar o novo grupo.
Isso permitir que voc adicione um ttulo de grupo para a informao relacionada com o
endereo. O ltimo parece "em" campos de cabealho, e liga visualmente os dados nas colunas
cobrindo.
3. dados de endereos Tipee no (texto do ttulo) cabealho campo.

4. Ilumine CLI: Endereo na lista de caixas de Designer.

135
136 CLARION 5 CLARION
Aprendiendo

Encher o quinto campo


1. Pressione o boto New Column.
2. Ilumine CLI: Cidade na lista Campos e pressione o boto Select.

Encher o sexto campo


1. Pressione o boto New Column.
2. Destaque CLI: Provncia na lista Campos e pressione o boto Select.

Preenchendo o campo e sair stimo Designer


1. Pressione o Populate.
2. CLI esto: CP na lista Campos e pressione o boto Select.
3. Pressione o boto OK para fechar a lista Designer Boxes.
adicionando abas

Quando o Assistente de Incio Rpido criado este procedimento, ele controla guias mudando a
ordem de exibio da lista de acordo com a guia selecionada. Portanto, vamos adicionar esta
funcionalidade para mostrar como fcil de fazer.

adicionar a folha Propriedades e primeira guia


1. Clique no ttulo da janela para exibir as alas vermelhas nas bordas da janela.
2. Coloque o cursor do mouse diretamente sobre a ala central no topo, e arraste para aumentar o
espao na parte superior.

3. Clique nas propriedades da folha de controle (folha de propriedades) sobre os flutuantes


controles de caixa de ferramenta (que aparece vrias pastas de arquivo e, direita do crculo).
4. Um clique sobre e direita da caixa de listagem para colocar a folha de propriedades e controle
guia.
5. Arraste o "punho vermelho" no canto inferior esquerdo para que ele aparece logo abaixo e
esquerda do boto Inserir.
EuCONTEDO 137

6. Arraste o "punho vermelho" no canto inferior direito para que ele aparece logo abaixo e
esquerda do boto Fechar.
Isto altera o tamanho da folha de propriedades de modo que parece que a caixa de lista e os
botes esto na lngua. Na verdade, eles no so, e no quer que eles sejam, porque queremos
que esses controles so visveis, independentemente da guia o usurio tenha selecionado. A
janela ser agora algo parecido com isto:

7. Clique no texto "Tab 1", no campo Texto de caixa flutuante propriedade.


8. Tipo KeyNumCliente no campo de texto no Property ferramentas caixa e pressione Tab
flutuante.
Isso muda o texto da guia. O texto livre, mas se o nome dos conjuntos de chaves, tambm
indica a ordem de exibio.

Adicionando outros separadores

1. Clique no controle Tab nos controles de caixa de ferramenta (que como uma nica pasta)
flutuantes.

2. CLIC imediatamente direita KeyNumCliente para colocar a nova guia.


3. Tipo KeyEmpresa no campo Texto das ferramentas propriedade de caixa flutuantes e pressione
TAB.
4. Voc clica no controle guia nos controles caixa de ferramentas flutuantes.

137
138 CLARION 5 CLARION
Aprendiendo

5. Clique imediatamente direita da guia KeyEmpresa para colocar a prxima guia.


6. Tipo KeyCP no campo Texto das ferramentas propriedade de caixa flutuantes e pressione TAB.

Ocultar botes

Quando o Assistente de Incio Rpido criado este procedimento no tinha botes Adicionar, Alterar,
Apagar e Fechar; ou pelo menos Voc no pode v-los quando voc executar o programa! Na
verdade, os botes esto l, mas so escondidos do usurio para usar apenas os botes na barra de
ferramentas para modificar o arquivo.
O "segredo" que os botes na barra de ferramentas apenas arrumado os botes ocultos Procurar o
procedimento para fazer o que sempre fizeram. Portanto, quando voc cria um procedimento
Navegar sem utilizar os assistentes, voc precisa da atualizao de botes na tela; mas no
necessrio que o usurio para ver a execuo do programa.
1. Clique direito sobre o boto Fechar na janela de amostra, em seguida, clique em Propriedades ...
no menu de contexto.
2. Marque a caixa "Ocultar" (Hide), e pressione o boto OK.
Isso adiciona o controle de atributo esconder, de modo que no visvel na tela durante a
execuo. Claro que voc sempre pode v-lo na janela Designer.
3. Clique direito sobre o boto Select, em seguida, clique em Propriedades ....
4. Esconder marque a caixa e pressione o boto OK.
5. Clique direito sobre o boto Excluir e clique em Propriedades ....
6. Esconder marque a caixa e pressione o boto OK.
7. Clique direito sobre o boto Alterar.
8. Esconder marque a caixa e pressione o boto OK.
9. Clique direito sobre o boto Inserir e clique em Propriedades ....
10. Esconder marque a caixa e pressione o boto OK.

Mover botes e redimensionar a lista

No h necessidade de desperdiar o espao ocupado por estes botes (o usurio no pode ver), de
modo que vai chamar no meio.
1. Clique no boto Fechar e, em seguida, pressione SHIFT + clique e arraste o boto para cima
dentro da lista.
Arrastando um boto com a tecla SHIFT (SHIFT) pressionado move o controle em linha reta: se
voc comear a se mover para baixo somente ir para cima e para baixo; Se voc comear a
mov-lo para um lado, apenas rolar horizontalmente.
2. NO Pressione o boto quando for solicitado para mover dentro da guia (Tab).
EuCONTEDO 139

3. Clique no boto Select e, em seguida, CRTL + clique sobre a inserir, alterar e excluir botes para
selecionar todos eles, e, em seguida, clique e arraste os botes para a caixa de lista.
Arrastar vrios controlos permite mover simultaneamente manter as suas posies relativas
dentro do grupo.
4. NO Pressione o boto quando for solicitado para mover dentro da guia (Tab).
5. Agora, vamos usar o espao ganho para estender a lista.
6. Clique na caixa de lista, e arraste a ala central inferior para baixo para aumentar a lista.

teste cliente Browse

Designer Windows tem um modo de teste, oferecendo uma prvia de como a janela no desktop.
Uma vez que uma janela MDI aparece no quadro da janela Designer.

1. Escolha Pr-Visualizao! na barra de menus do Windows Designer.

2. Pressione a tecla Esc (ou o boto X) para retornar ao Windows Designer.

sistemas de visualizao

Agora que as guias foram colocadas, devemos dizer caixa de listagem que sistemas de usar.
1. Clique direito na caixa de lista e escolha Aes ... do menu de contexto.
A caixa de lista realmente um BrowseBox modelo de controle que foi colocado no
procedimento de janela de modelo pr-configurado em Procurar, no modelo Record (Template
Registry) (ver do Usurio'S Guia para obter mais informaes sobre o Registro modelo). Isso
significa que ele tem associado indicadores que informam sobre como preencher a lista e as
aes a serem tomadas.

139
140 CLARION 5 CLARION
Aprendiendo

Os indicadores que aparecem na guia Aes vm diretamente dos modelos (neste caso, o modelo
BrowseBox). Dessa forma, voc pode se comunicar exatamente o que modelos de cdigo deve
gerar para produzir exatamente a funcionalidade que voc precisa. Estes indicadores, seus usos e
significados, so abordados ema guia usurio ea ajuda online para cada janela em que eles
aparecem.
2. Selecione a operao condicional guia (Comportamento Condicional).
3. Pressione o boto Inserir.
4. Tipo de escolha (? Folha1) = 2 no campo Condio.
Isto indica a condio em que a ordem de apresentao alternativa ser usado. Esta expresso usa
a funo escolha da lngua Clarion (ver referncia Language) para detectar quando o usurio
escolheu a segunda folha do separador. O cdigo gerado ir usar essa expresso em uma
instruo condicional que vai mudar a ordem de exibio quando o programa executado.
5. Pressione o boto com trs pontos (...) ao lado da tecla de campo para usar.
6. Destaque CLI: KeyEmpresa e pressione o boto Select na caixa de dilogo Select Key.

Agora, quando o usurio escolhe a segunda lngua template Controle BrowseBox ir gerar o
cdigo para selecionar a empresa chave campo. No h necessidade de saber o que fazer com a
primeira guia, como sempre usa a senha que estabelecemos na rvore de arquivos (esquema de
arquivo).
7. Pressione o boto OK.
8. Pressione o boto Inserir.
9. Tipo de escolha (? Folha1) = 3 no campo Condio.
10. Pressione o boto com trs pontos (...) ao lado da tecla de campo para usar.
11. Destaque CLI: KeyCP e pressione o boto Select na caixa de dilogo Select Key.
12. Pressione o boto OK.
EuCONTEDO 141

13. Pressione o boto OK para fechar a caixa de dilogo Propriedades da lista.


Feche a Navegar Cliente

Escolha Exit! na barra de menu Janela Designer e salvar as alteraes na janela quando solicitado.
Pressione o boto OK na caixa de dilogo para fechar Propriedades do Procedimento.
Escolha Salvar Arquivo ou pressione o boto Save para salvar seu trabalho.

- CA RIANDO FICHA O FORM

Criao de um procedimento de atualizao

No captulo anterior, ns projetamos o procedimento clientes listagens caixa Procurar e adicionar


guias para alterar a ordem de exibio. Para terminar o procedimento bsico, vamos nomear o
procedimento de atualizao (procedimento de atualizao). Este o procedimento que lida com
os botes de ao Adicionar, alterar e excluir (inserir, alterar e excluir).

141
142 CLARION 5 CLARION
Aprendiendo

Ponto de partida:
O arquivo TUTORIAL.APP deve estar aberta.

Incorporando um procedimento de "todo"

1. VerClientes se na aplicao de rvore caixa de dilogo e clique no boto Propriedades.


o procedimento caixa de dilogo Propriedades (Propriedades Processo) aparece. H trs
maneiras de chegar a esta caixa de dilogo para que voc use o que mais lhe convier:
Destacar o processo e, em seguida, clique no boto Propriedades.
D um duplo clique sobre a aplicao caixa da rvore de dilogo.
SoBe direito do mouse o procedimento e escolha Propriedades no menu de contexto.
2. Digite FichaCliente na caixa de entrada de dados localizado na caixa de dilogo Propriedades
Procedimento caixa Procedimento p Update.
Este nomes o procedimento para adicionar e modificar (atualizar) os regitros mostrando
navegar. O novo procedimento aparece na rvore da aplicao como "fazer" (Todo ").
3. Pressione o boto OK para fechar a caixa de dilogo Procedure Propriedades.

Note que no tinha para iniciar uma nova thread de execuo para este procedimento. Voc
deve executar no mesmo segmento que navegar para que o usurio no pode abrir uma guia de
janela ou formulrio para alterar um registro, em seguida, selecione a janela de procura de
novo e abrir outra aba no mesmo registro. Em outras palavras, seria bom deixar as tentativas do
usurio para alterar o mesmo registro duas vezes de uma vez!

Criando folha de procedimento ou formulrio

O procedimento de atualizao deve usar o procedimento de modelo de formulrio para criar um


procedimento que o usurio final pode usar para manter registros.
EuCONTEDO 143

Selecione o tipo de procedimento para FichaCliente


1. Clique duas vezes no FichaCliente na rvore da aplicao.
2. Iluminar modelo de procedimentos Form, limpar o Usar assistente procedimento de caixa, e
pressione o boto Select.
a janela Propriedades do Procedimento aparecer. Note-se que esta caixa de dilogo parece
diferente de quaisquer outros procedimentos que tm trabalhado, porque os indicadores do lado
esquerdo variam consoante o tipo de modelo Procedimento. O Manual de Aplicao e ajuda
on-line descrevem as opes de personalizao disponveis em cada caixa de dilogo
Procedure Propriedades.

3. Pressione o boto Arquivos para nomear o arquivo que ir trabalhar no formulrio.


caixa de dilogo arquivo aparece Definio esquemtica.
4. Destaque o item "todo" sob a expresso "Atualizando o arquivo no disco" (atualizao de
registros no disco) e pressione o boto Inserir.
5. Clientes Realce o arquivo na caixa de dilogo Selecionar arquivo, e pressione o boto Select.

143
144 CLARION 5 CLARION
Aprendiendo

6. Pressione o boto OK para retornar janela do procedimento Propriedades.

Faa o tamanho da janela ajustvel


1. Na caixa de dilogo Procedure Properties, clique no boto Extenses.
2. Nas Extenses de caixa e de dilogo Modelos de controle, pressione o boto Inserir.
3. a caixa de dilogo Select Extenso iluminar WindowResize, e pressione o boto Select.
Este modelo de extenso gera automaticamente o cdigo para lidar com o redimensionamento
e reposicionamento de todos os controles de janela quando o usurio redimensiona a janela, ou
quando voc pressiona os botes Maximizar ou Restaurar.
4. Pressione o boto OK para fechar as extenses de caixa de dilogo e modelos de controle.

Modificando a janela Propriedades


1. Na caixa de dilogo Procedure Properties, pressione o boto Window.
2. Clique direito sobre a janela de ttulo, e escolha Propriedades no menu de contexto.
3. Escolha Resizable ( "redimensionvel") a partir da lista drop-down Tipo de quadro.
4. Selecione a guia extra e marque a caixa Maximizar Box.
Estes dois ltimos itens permitem que o usurio redimensionar a janela durante a execuo.
5. Pressione o boto OK para fechar a caixa de dilogo Propriedades janela.

Preencha as caixas

O projeto da janela proconfigurado e contm trs campos. O boto OK fecha a caixa de dilogo,
aceitando a entrada do usurio e as informaes gravadas no disco. O boto Cancelar fecha o
formulrio sem salvar as alteraes. E o campo de texto fornece uma mensagem informativa para
o usurio sobre a ao que est sendo executada no registro. Esta ao chamada em Ingls para
preencher, cuja traduo literal que as pessoas (a janela).
EuCONTEDO 145

1. Selecione Opes Show Fieldbox

Isso mostra uma caixa de ferramentas flutuante contendo todos os campos especificados na
rvore de arquivo do aplicativo.
2. Cusno clique na caixa de ferramentas flutuante Preencher campo, e mova o cursor sobre o
projeto da janela.
O cursor muda para uma cruz e um "booklet", indicando que o campo vem do dicionrio de
dados.
3. Clique perto do canto superior esquerdo da janela.
Isso coloca o campo e seu rtulo associado. Esses controles trazer todos acima especificado nas
definies de dicionrio.
4. D um duplo clique Empresa na caixa de ferramentas flutuante Preencher campo.
DUPLO CLIC imediatamente colocado tanto no campo e com a etiqueta logo abaixo dos
primeiros campos que voc acabou de colocar. Voc poderia selecionar e colocar cada campo
como fizemos com o primeiro, mas muito mais rpido, clicando duas vezes.
5. D um duplo clique sobre a caixa de ferramentas flutuantes preencher os nomes de campo.
6. Clique duas vezes no Sobrenomes na caixa de ferramentas de campo Preencher flutuantes.
7. D um duplo clique sobre Gesto na caixa flutuante ferramentas campo Preencher.
8. Clique duas vezes sobre a flutuao ferramentas caixa Cidade Preencher campo.
9. D um duplo clique provncia na caixa de ferramentas flutuante Preencher campo.

145
146 CLARION 5 CLARION
Aprendiendo

Isso coloca o rtulo e na lista drop-down. No dicionrio de dados que predefinir este campo
como um controle de lista com o atributo DROP. Uma vez que os valores vlidos (BA | SF |
ER | CBA | MZA) contendo so pr-definidos, no h necessidade de mudar seu formato.
10. Clique duas vezes no CP na caixa de ferramentas de campo Preencher flutuantes.
guia de janela ou formulrio agora se parece com isso:

Mover e alinhar campos

Para uma aparncia mais profissional, temos de mover os campos e alinhar as bordas de todos os
controles.

Localizao dos campos em suas posies aproximadas


1. Clique na Regio lista.
2. DRAG, mantendo pressionada a tecla Shift (SHIFT + DRAG) a lista Provncia para a direita,
mais perto de seu rtulo.
Shift + arrastar limites de controlo do movimento, quando o avio comearam a mover-se (vertical ou horizontal).

3. CTRL + clique no rtulo da provncia.


Quando dada CTRL + clique em um controle, as alas de controle previamente selecionados
ficar azul, enquanto o controle recm-selecionada aparecem em vermelho. Agora, existem dois
controles selecionados.
EuCONTEDO 147

4. Mova a provncia de lista drop-down e etiqueta (clique e arraste em qualquer um dos controles
selecionados), canto superior direito dos controles cidade.
Quando vrios controlos so seleccionados, eles podem ser movidos em grupos, tal como
controle individual mudaria.
5. Clique na entrada de dados de controle CP.
6. Pressione SHIFT + arrastar na caixa de CP para a esquerda, mais perto de seu rtulo.
7. CTRL + clique no rtulo CP.
8. Mova a entrada de dados caixa de CP e rotular canto superior direito dos controles da cidade e
da provncia.
Voc pode ter que ampliar a janela um pouco para alcan-lo.
9. Clique sobre os dados caixa de entrada Nome, para a direita, mais perto de seu rtulo.
10. SHIFT + DRAG ltimo nome na caixa esquerda, mais perto de seu rtulo.
11. CTRL + clique no rtulo Nome.
12. Mova a caixa Nome de entrada de dados acima e direita dos nomes.
Agora, a janela deve ser algo como isto:

147
148 CLARION 5 CLARION
Aprendiendo

O alinhamento final de controlos

1. Escolha a opo Show Alignbox ( "Show alinhamento box")


Janelas designer tem uma caixa de ferramentas flutuante que contm o
mesmo conjunto de ferramentas de alinhamento que esto disponveis
atravs do menu Alinhamento. Alignbox caixa de ferramentas flutuante
no pode ser exatamente como o show aqui, porque possvel alterar a
forma de qualquer bar flutuante arrastando suas bordas. Experiment-lo e
verificar a sua flexibilidade. Com esta tcnica possvel configurar o
espao de trabalho como desejado.

2. Clique na primeira etiqueta no canto superior esquerdo.


Este deve ser o rtulo cusno. Quando voc d CLIC deve aparecer em torno das alas.

3. Ctrl + clique nos quatro etiquetas localizadas imediatamente abaixo da primeira.


Como da CTRL + clique em cada controle, as alas de que foi previamente selecionado
passagem azul, eo controle recm-selecionada aparecem em vermelho. As alas de controlo
vermelho o "ponto de referncia" ou "ancoragem" para a operao de alinhamento. Todos os
outros controles esto alinhados em relao a ter as alas vermelhas.

Com os cinco rtulos selecionados deve ficar assim:


EuCONTEDO 149

4. Pressione o boto esquerdo Align (boto superior esquerdo) na caixa flutuante ferramentas
Alinhar.

Os controles esto alinhados no lado esquerdo, em relao ao ltimo item selecionado (com
punhos vermelhos).

Para identificar os controles na caixa de ferramentas Align, basta colocar o cursor do mouse
sobre o controle e esperar meio segundo at que a dimenso identificar aparece.

5. imprensa Espalhe o boto na caixa de ferramentas a alinhar verticalmente flutuante.

Os controles so distribudos uniformemente entre o primeiro eo ltimo boto selecionado.

6. Clique na entrada de dados primeiro controle (cusno)

7. Ctrl + clique entrada controles imediatamente abaixo, para selecionar todos eles.

8. Clique direito e escolha "alinhamento esquerda" (Alinhar esquerda) menu de contexto que
aparece.

Esta outra maneira de ativar as ferramentas de alinhamento. O menu de contexto de


alinhamento aparece apenas quando voc tiver selecionado vrios controles.

9. Clique direito e escolha Espalhe menu de contexto verticalmente.

Isto deve alinhar todos os controlos de entrada de dados com as respectivas etiquetas, que j
tenham sido submetidos a este alinhamento.

10. Clique nos nomes de entrada de dados caixa.

11. CTRL + clique sobre os trs controles do lado esquerdo (o rtulo, os nomes de campo e
rtulo).

12. Escolha alinhamento horizontal (Alinhar horizontalmente) flutuante caixa de ferramentas


Alinhar ou o menu de contexto (boto direito).

No h outra maneira para selecionar vrios controles na janela Designer: Use o loop.

13. Colocar o cursor do rato ligeiramente acima e para a direita do primeiro controlo na linha
inferior (que seria Cidade).

14. CTRL + clique e arraste um pouco para baixo e para a direita at o desenho da caixa em torno
dos cinco controles direita (os rtulos e campos City, Provncia e CP), e solte o boto do
mouse.

alas vermelhas aparecem no campo CP e azul nos outros controles.

Esta a tcnica de "lao".

15. Selecione o alinhamento horizontal (Alinhar horizontalmente) a caixa de ferramentas


flutuante, ou o alinhamento menu de contexto (boto direito).

16. Use a mesma ferramenta para alinhar os campos cusno, Negcios e Gesto com etiquetas.

A janela agora deve aparecer da seguinte maneira:

149
150 CLARION 5 CLARION
Aprendiendo

A janela est quase pronto. Agora adicionar uma listagem caixa de registros telefnicos
ligados.

A adio de um modelo de controlo BrowseBox

Modelos (templates) gerar controle de todo o cdigo fonte necessrio para criar e manter um
controle ou conjunto de controles, especfico na janela. Todos os controles de entrada de dados
simplesmente no so simplesmente colocados controles ou modelos de controle, porque eles
precisam de cdigo extra para executar suas funes normais. modelos de controle so usados
somente quando um controle especfico precisa funcionalidade extra no fornecida pelo prprio
controle. Por exemplo, o OK e Cancelar botes so ambos controle de modelo: o boto OK salva o
arquivo no disco, enquanto o Anular controle de modelo executa toda a "limpeza" necessria para
cancelar a operao atual.
Agora vamos colocar um modelo de controle BrowseBox que exibe todos os registros no arquivo
do telefone ligado ao registo de cliente atual.

template colocao de controle


1. Escolher modelo de controle Preencher, ou clique no modelo de controle sobre os flutuantes
Controls toolbox (ltimo cone da ferramenta direita na linha inferior).
EuCONTEDO 151

2. Na caixa de dilogo Selecione destaques Control Template BrowseBox e pressione o boto


Select.
O cursor muda para uma cruz e um livreto.
3. Clique logo abaixo da Cidade caixa de entrada de dados para colocar o controle.
a caixa de seleo de campo aparece para voc escolher o arquivo a ser exibido neste
BrowseBox.
4. Escolha o item "todo" sob a caixa de File-Navegao da caixa de lista e pressione o boto
Inserir.
5. Telefones realce o arquivo na caixa de dilogo Inserir arquivo, e pressione o boto Select.
6. Telefones realce o arquivo na lista de arquivos e clique no boto Editar.
7. KeyNumCliente ficar na caixa de dilogo Acesso Alterar chave, e pressione o boto Select.

Colocar os campos de arquivo Telefonos


1. Destaque Tel: cusno na lista Campos e pressione o boto Select.
Designer Lista Caixas aparece para adicionar o resto dos campos que deseja exibir.

151
152 CLARION 5 CLARION
Aprendiendo

2. Selecione justificao esquerda (esquerda) a partir da lista drop-down Justificao.


Isso muda a justificativa padro (valores numricos direita).
3. Pressione o boto New Column.
4. Ilumine TEL (destaque): DDN na lista Campos e pressione o boto Select.
5. Seleco Esquerda lista de Justificao.
6. Pressione o boto New Column.
7. Destaque TEL: Telefone na lista Campos, e ento pressione o boto Select.
8. Seleco Esquerda lista de Justificao.
9. Pressione o boto New Column.
10. Destaque TEL: Descrio na lista Campos, e ento pressione o boto Select.
Como etapa opcional, modificar as colunas da janela para torn-lo grande o suficiente para os
respectivos ttulos. Basta arrast-los com o mouse.

11. Pressione o boto OK para fechar a lista de Designer.


Isto coloca a caixa listados na janela, na posio que voc especificou. Isso pode expandir a
janela. Se assim for, voc pode redimensionar a janela arrastando as alas, e movendo-se OK,
Cancel e mensagem de controles para a nova parte inferior da janela.

Estabelecer limites mbito do modelo


1. Clique direito sobre a caixa que voc acabou de colocar, e escolha Aes no menu de contexto.
2. Pressione a reticncias (...) localizado junto zona limite campo.
3. Realce o TEL campo: cusno na lista de componentes da chave (componentes-chave), e
pressione o boto Select.
EuCONTEDO 153

4. Escolha "relao entre arquivos" (Relao Arquivo) na lista suspensa de limite de pesquisa
(limite de alcance Type).
5. Pressione a reticncias (...) ao lado do campo de arquivo e caixa de dilogo Cliente caixa
relacionadas Selecione Arquivo escolher.
Isso identifica o arquivo do cliente eo arquivo relacionado. Estes estgios limitar os registros
exibidos na caixa listados somente os registros relacionados ao registro do cliente que est
sendo exibido no momento da consulta.

6. Pressione o boto OK na caixa de dilogo Propriedades da lista.

Adicionando os BrowseUpdateButtons modelo de controle

Em seguida, adicione o Insert padro, Alterar e os botes para controlar o caixa listados em
Excluir.
Colocar outro modelo de controle
1. Preencher escolha Modelo de controle, ou clique na ferramenta de modelo na ferramenta de
controles de caixa de controle (o ltimo cone da lista na linha inferior).
2. Realce o modelo de controle BrowseUpdateButton e pressione o boto Select.
O cursor muda para uma cruz e um livreto.
3. Clique abaixo da parte inferior caixa de lista esquerda.
Inserir, parecem alterar e excluir botes. Lembre-se: estes so os botes que permitem o
funcionamento dos botes na barra de tarefas, e, portanto, deve estar presente na janela de

153
154 CLARION 5 CLARION
Aprendiendo

design. No h necessidade de ser visvel para o usurio, para que possa escond-los, se
desejar. No entanto, uma vez que esta caixa de listagens (BrowseBox) est localizado em um
procedimento de atualizao (Form), nesta aplicao, vamos sair desse grupo de botes
visveis. Isso permitir que voc use qualquer um dos dois grupos de botes. Os botes da
barra de ferramentas s ir funcionar nesta lista quando a caixa listados tem o foco (no quando
o usurio insere dados em qualquer outro controle), de modo que deixar visvel para aqueles
botes ir garantir que o usurio pode facilmente manter registros telefone.
Neste ponto, a janela deve ser algo como isto:

Especificar "local Editar" para atualizar Phones


1. Clique direito sobre o boto "Delete" (Apagar) e selecione Aes no menu de contexto.
2. Dial "Modificao in situ" (Use Editar no local) caixa.
Configurar aes (aes) de um boto serve trs botes para o grupo, uma vez que os trs
pertencem ao mesmo modelo de controle. Como o arquivo Phones tem apenas alguns campos,
no h necessidade de um procedimento de atualizao separado.
3. Pressione o boto OK.
4. Escolha Exit! Designer para fechar as janelas.
5. Pressione o boto OK para fechar a caixa de dilogo Procedure Propriedades.
6. Escolha Salvar arquivo, ou pressione o boto Salvar na barra de ferramentas.
EuCONTEDO 155

- CPROCEDIMENTOS opiceos

Procedimentos "Produtos"
Agora que voc j criou a navegao do cliente, podemos reutilizar esse trabalho para o prximo
procedimento, copiando e em seguida, alterando campos. Neste captulo, copiar o procedimento
VerClientes para criar VerProductos.
Tambm usaremos os "pontos de insero" (pontos incorpora) para escrever "cdigo fonte
inserida" VerProductos chamar o procedimento da aplicao de menu e barra de ferramentas.
Ento, ns apresentamos os muitos pontos que voc pode adicionar alguns (ou muitos) linhas de
cdigo prpria fonte para adicionar funcionalidade a qualquer procedimento.

Ponto de partida:
O arquivo TUTORIAL.APP deve estar aberta.

Cpia dos procedimentos

Recorde-se quando o item de menu Ver produtos foi criado, e o boto na barra de ferramentas
intitulada "Produtos", no especifique um procedimento para chamar quando o usurio final ir
executar. Comeamos a criar a chamada de procedimento.
1. Destaque procedimento VerClientes na rvore da aplicao.
Este o procedimento que ir copiar.
2. Escolha Copiar Procedimento ...
caixa de dilogo caixa Novo Procedimento aparece.
3. Tipo VerProductos na caixa de entrada e pressione o boto OK.

Porque o procedimento est ligada a VerClientes FichaCliente (que est copiando), uma caixa
de dilogo alertando sobre o conflito de nome (nome do procedimento confronto) com opes
para lidar com a situao parece. A traduo da mensagem : "O procedimento de cpia chama
outros procedimentos Voc quer dar-lhes novo nome automaticamente para os procedimentos

155
156 CLARION 5 CLARION
Aprendiendo

chamados, usando os mesmos nomes, ou indicar nomes alternativos em cada caso.?". H trs
botes na parte inferior: "Auto Rename" (dar um novo nome automaticamente), "Same"
(deix-lo), e "Prompt" (perguntar).

4. Pressione o boto Prompt.


Ao pressionar este boto, voc pergunta o Gerador de Aplicativos para perguntar antes de
tomar o novo nome de procedimentos conflitantes.
outra caixa de mensagem que informa um determinado nome duplicado aparece:

5. Pressione o boto Renomear.


Alternate procedimento de caixa de dilogo (procedimento alternativo) aparece.
6. Tipo FichaProducto na caixa de login, e pressione o boto OK.

FichaProducto aparecem os VerProductos e procedimentos na rvore da aplicao. Eles so


"dissociado" do resto do processo, porque eles no so chamados por qualquer outro processo
(ainda). Agora vamos cuidar disso.

Trabalhando pontos de insero


EuCONTEDO 157

modelos Clarion permitem que voc adicione seu prprio cdigo fonte de muitos pontos pr-
definidos dentro do cdigo gerado. uma maneira muito eficiente para alcanar o mximo de
flexibilidade e reutilizao de cdigo. O ponto em que o cdigo digitado chamado de "ponto de
insero" (Embed Point). Estes pontos esto disponveis para todos os eventos comuns e cada
janela de controle e em muitas outras posies lgicas dentro o cdigo gerado.
Neste exemplo, adicionar cdigo introduzido fonte (usando um modelo de cdigo que ir escrever
a fonte de cdigo) nos pontos onde o usurio final escolhe os itens do menu Ver opo , eo ponto
onde o usurio pressiona o boto produtos na barra de ferramentas do aplicativo.

A nomeao de um procedimento
1. Clique direito o procedimento rvore da aplicao principal.
Existem vrias maneiras de inserir os pontos de insero dentro de um procedimento. Dois
aparecer no menu de contexto que acaba de aparecer ..
A primeira opo Incorpora, que chama a caixa de dilogo Fonte incorporado, que exibe uma
lista de todos os pontos de insero dentro do procedimento.
A segunda maneira que realmente gera fonte para o cdigo do procedimento e chama a (o
editor de texto no cdigo modo de insero) "Embeditor" para que voc possa modificar todos
os pontos de insero no contexto opo de fonte de cdigo-fonte do gerado . Este ltimo
parece "cinza" para indicar que no possvel modific-lo, e cada ponto possvel de
procedimento de insero identificado por comentrios, aps o qual voc pode inserir seu
prprio cdigo.
H vantagens em cada mtodo de trabalho com os pontos de insero, de modo cobrir tanto
durante este curso. Primeiro, use a caixa de dilogo Fonte incorporado.
2. No menu de contexto, escolha Incorpora.
a caixa de dilogo Fonte incorporado, que lhe d acesso a todos os pontos de insero
procedimento aparece. Voc tambm pode chegar aqui com o boto Procedimento Incorpora
na janela Propriedades, mas mais rpido usando o menu de contexto. A lista ordenada
alfabeticamente ou na ordem em que os itens aparecem no cdigo-fonte gerado, dependendo da
configurao Incorpora Ordenar por ordem alfabtica no ambiente de opes (Opes de
configurao Aplicao).
3. Pressione o contrato All boto.
Isto ir facilitar a localizao a necessidade especfica ponto de insero.
4. Controle de Manipulao de Eventos Localize a pasta, clique no sinal + para expandir o
contedo.
O menu seleco um controle, como uma caixa de entrada de dados, ou a prpria janela.
No lado direito da janela, voc ver os botes de seta caixa de rotao que lhe permitem definir
uma prioridade (prioridade) para cima e para baixo e; estes so importantes. s vezes voc
quer escrever cdigo para ser executado antes do cdigo gerado pelo modelo, e s vezes a
correr atrs e s vezes deve executar algum lugar no meio dentro do cdigo gerado. A
prioridade determina a localizao exata de seu cdigo incorporado. Isto ir fornecer muita
flexibilidade para localizar o cdigo incorporado possvel. O prprio valor de prioridade no
importante, mas a sua posio lgica dentro do cdigo gerado. Em breve vamos esclarecer
mais sobre esse assunto.

157
158 CLARION 5 CLARION
Aprendiendo

5. Localize a pasta? FormulariosProducto e clique nela para expandi-lo.


6. Aceito destaque e pressione o boto Inserir.
O evento "aceito" para seleo de menu marca o ponto do cdigo gerado executando como o
usurio escolhe o comando de menu.

caixa de dilogo Selecionar parece incorporar tipo com uma lista de todas as opes incorporar
cdigo. Voc pode simplesmente chamar um procedimento (Chamar um procedimento),
escreva seu prprio cdigo fonte (Source) linguagem Clarion ou usar um cdigo de modelo
(modelo Cdigo) para escrever o cdigo necessrio. Esta uma vantagem para editar os pontos
de insero dentro da caixa de dilogo Fonte incorporado: Voc pode usar modelos de cdigo
para voc escrever cdigo, em vez de ter que faz-lo sozinho.

7. Selecione o Tpico cdigo do modelo Iniciar e pressione o boto Select.


Um modelo de cdigo geralmente vem com algumas orientaes e instrues de utilizao.
Voc comea a informao que voc precisa escrever cdigo executvel, que por sua vez
inserido no cdigo padro gerado produzida pelo modelo Procedimento diretamente neste
ponto de insero. Este modelo de cdigo em particular projetado para iniciar um novo
EuCONTEDO 159

segmento da chamada execuo por ele INICIAR procedimento, o procedimento que voc
especificar.
8. VerProductos escolher a lista drop-down Nome do Procedimento.
Isso indica o procedimento para chamar quando o usurio seleciona o item de menu. Este o
procedimento que tenha copiado anteriormente.

9. Pressione o boto OK.

Nomeie o procedimento para chamar usando o boto de produtos na barra

de ferramentas
Neste ponto, voc pode fazer o mesmo para chamar o procedimento VerProductos a partir do
boto produtos. No entanto, existe uma maneira mais fcil para reescrever este cdigo: basta
copiar e col-lo a partir de um ponto de insero para o outro!
1. Clique no boto Copiar (o grupo boto do meio no boto contrato certo Todos).
O modelo de cdigo que voc acabou de adicionar ainda deve ser destacado, assim que esta
ao ir copi-lo a partir da rea de transferncia do Windows.
2. Localize a pasta? BotonProductos (na mesma pasta no controle, mesmo que voc j
manipulao localizado) e clique nela para abri-la.
3. Ilumine aceitado ( "Accepted") e colar (o boto com o grupo de extrema direita de botes
direita do boto contrato Todos) ( "Colar").
caixa de dilogo procedimento parece nome novamente classe para avisar que voc j tenha
chamado uma vez este procedimento.
4. Pressione o "mesmo" (Same).
Agora, este ponto de insero ir gerar o mesmo cdigo acima.
5. Pressione o boto Fechar.

159
160 CLARION 5 CLARION
Aprendiendo

Os VerProductos procedimento agora "conectado" procedimento sob Principal. Agora voc


pode personalizar os procedimentos copiados para referenciar os produtos de arquivo.

modificao Browse

arquivo de controle de mudanas novos anncios


1. Clique direito sobre o procedimento VerProductos e escolha Janela no menu de contexto.
2. Clique direito sobre o controle List Box Escolha Formatar ... no menu de contexto.
3. Listados na imprensa desenhador o boto delete (Excluir) repetidamente at ter removido todos
os campos.
Quando voc ter removido o ltimo campo, a caixa de dilogo aparece automaticamente
Seleo campo.
4. Clientes Realce os arquivos de lista de arquivo (arquivos) e clique no boto Excluir.
5. Destaque "To Do", que substitui o arquivo do cliente e pressione o boto Inserir.
6. Produtos realce o arquivo e pressione o boto Select.
7. Pressione o boto Editar e selecione KeyDescripcion da caixa de dilogo Acesso Mudana
Key.
A caixa de dilogo Selecionar campo agora exibe o arquivo e os campos corretos.

campos repovoada
1. Ilumine PROD: partNum na lista Campos e pressione o boto Select.
2. Marque as caixas borda direita e redimensionveis, e aumentar Ident uma caixa (1).
3. Pressione o boto New Column.
4. Mark PROD: Viso geral sobre a lista de campos (Field), e pressione o boto Select.
5. Selecione Esquerda para justifficacin os dados.
6. Pressione o boto New Column.
7. Ilumine PROD: Preo na lista Campos e pressione o boto Select.
8. Aumentar recuo no grupo de dados 12. Como justificao necessria decimal este passo para
garantir que colocamos a visualizar a parte fraccionada
9. Pressione o boto New Column.
10. Ilumine PROD: TasaImponible na lista Campos e pressione o boto Select.
Note-se que padro justificao decimal, e que o spin indicando o recuo de dados grupo
mantido em 12 (doze) como observamos no campo anterior.
11. Pressione o boto OK para fechar a lista de Designer.
No se preocupe com os botes que aparecem na caixa de listagem. Lembre-se que estes so
escondidos e so chamados pelos botes na barra de ferramentas.
EuCONTEDO 161

renomear janela
1. Clique na barra de ttulo da janela.
2. Tipo VerProductos no campo de texto (Text) caixa de ferramentas flutuante Propriedade e
pressione TAB.

Remover todas as guias


1. Clique direita da guia KeyCP para selecionar toda a folha de propriedades.
Para ter a certeza de ter dado clicar no lugar certo, observe as ferramentas de propriedade de
caixa flutuantes e ver se os shows uso em campo? Sheet1. Se no, tente novamente at que
voc faa.

2. Pressione a tecla DELETE.


Todas as guias desaparecer.

Adicionando um localizador
Se a lista de produtos a ser exibido muito longo, voc vai precisar fazer uma extensa pesquisa
antes de encontrar o produto desejado. Inicialmente todas as listas exibir caixas de trazer um
localizador de "passos" (STEP) que vai para o primeiro registro que comea com a letra do
operador para digitar no teclado.
Mas, com grandes bases de dados, o usurio precisa digitar vrias letras iniciais para alcanar o
registo pedido. entrada Locator (Localizador de entrada) um campo no qual o usurio pode
escrever. Pressionando TAB, a lista desloca-se para o primeiro registro que coincide com o
digitado. Este recurso funciona apenas com cdigos alfanumricos (string).

161
162 CLARION 5 CLARION
Aprendiendo

1. Se voc ainda no estiver presente, selecione Opes Mostrar Fielbox para exibir a caixa
flutuante ferramentas campo Preencher.
Se a caixa de ferramentas Preencher campo ainda mostra os campos de arquivo Os clientes
simplesmente fechar a caixa de ferramentas (com duplo clique na barra de ttulo) e reabri-lo
para atualizar a caixa de ferramentas com campos de arquivo produtos.
2. Clique duas vezes em Descrio das ferramentas de preencher a caixa campo.
Isso coloca tanto o rtulo e caixa de login para o campo localizado perto do canto superior
esquerdo da janela. Este o campo localizador.
3. Escolha Exit! Designer de menu para fechar as janelas, e salvar as alteraes.

sistemas de limpeza alternativos


1. Clique direito sobre o procedimento VerProductos e escolha Extenses no menu de contexto.
caixa de dilogo Extenso aparece e modelo de controle. Esta caixa lista todos os modelos de
controle que esto em processo de ao e tags (Aces).
Esta caixa de dilogo tambm permite que voc adicione e manter modelos ou modelos de
extenso no procedimento. modelos de extenso so muito semelhantes aos do controle, que
adicionar funcionalidade especifica o procedimento, mas a funcionalidade de uma extenso de
modelo no est directamente ligado a qualquer controle que aparece na janela. Em outras
palavras, se trata de modelos que agregam funcionalidade "nos bastidores", sem afetar
diretamente a interface do usurio.
Um bom exemplo de produto Extenso Templates Clarion vem em Internet Connect. Ele
contm (entre outras ferramentas) um grupo de modelos de extenso que automaticamente
"traduzir" Uma aplicao Clarion do Windows em pginas HTML dinmicos. Isso permite que
o aplicativo seja executado Internet Clarion. O usurio s precisa de um visualizador
habilitados para Java para acessar programa Clarion. Se voc est interessado, voc pode obter
mais informaes sobre TopSpeed ou Unisoft Internet Connect.
2. Ilumine Navegar em produtos e pressione o boto Comportamento Locator (Localizador de
Comportamento).
3. Entrada selecionar a partir da lista suspensa ou pressione OK.
Isto completa os requisitos para o localizador. A ordem de pesquisa campo-chave (neste caso
PROD: Descrio) o controle local padro.

4. Selecione o comportamento condicional guia.


EuCONTEDO 163

5. Pressione o boto Excluir duas vezes.


Isso elimina as duas expresses condicionais que entraram para o procedimento VerClientes.
6. Pressione o boto OK.
7. Escolha Salvar arquivo, ou pressione o boto Salvar na barra de ferramentas.

Folha criao Procedimento

Quando ele deu novo nome a referncia ao copiar VerClientes o procedimento de atualizao para
VerProductos, ele se virou em um procedimento FichaProducto "todo". Portanto, voc deve criar
um guia ou formulrio para atualizar o arquivo do produto.
Selecione o tipo de Procedimento para FichaProducto
1. FichaProducto ficar de p, e, em seguida, clique no boto Propriedades.
2. Ilumine Form, limpar o Usar assistente procedimento de caixa, e pressione o boto Select.
3. Pressione o boto Arquivos na caixa de dilogo Procedure Propriedades.
4. Realce o arquivo "todo" e pressione o boto Inserir.
5. Produtos Illuminate arquivo e pressione o boto Select.
6. Pressione o boto OK para retornar caixa de dilogo Procedure Propriedades.
7. Pressione o boto Janela para estruturar o formulrio.

campos povoam
1. Se voc ainda no estiver presente, selecione Opes Mostrar Fieldbox para mostrar
PopulateField caixa de ferramentas.
2. D um duplo clique sobre a caixa de ferramentas partNum campo Preencher.

163
164 CLARION 5 CLARION
Aprendiendo

Isso coloca automaticamente tanto o rtulo eo campo de caixa de login perto do canto superior
esquerdo da janela.
3. D um duplo clique sobre a caixa de Inscrio Ferramenta campo Preencher.
Isso coloca automaticamente tanto o rtulo e caixa de login localizado abaixo do campo acima.
4. D um duplo clique sobre a caixa de ferramentas Preo Campo preenchido.
5. D um duplo clique sobre a caixa de ferramentas TasaImponible campo Preencher.
A forma parecida com esta:

Alterar o ttulo da janela


1. Clique na barra de ttulo da janela do formulrio.
2. Fact Sheet produto Digite no campo de texto (texto) caixa de ferramentas flutuante e pressione
TAB propriedade.

Sada da janela Designer e trabalho de gravao


1. Escolha Exit! Menu, para fechar a janela Designer (salvar alteraes).
2. Pressione o boto OK na caixa de dilogo para fechar Propriedades do Procedimento.
3. Escolha Save arquivo, ou pressione o boto Salvar na barra de ferramentas para salvar seu
trabalho.
atualizao do produto formulrio est pronto.
EuCONTEDO 165

- UCONTROLE DE MODELOS SING


VerPedidos para o procedimento, voc cria uma janela com duas caixas que deslizam de forma
sncrona listagens. Um exibe o contedo do arquivo de ordem, e o outro vai exibir registros
relacionados no arquivo de detalhes. Janela ir utilizar um procedimento genrico, e "preencher"
com razo controle templates.La nico a faz-lo, em vez de comear com um modelo normal,
Navegar mostrar uma outra maneira de criar um procedimento: usando modelos de controle
colocados em uma janela genrica ( da mesma maneira que foi criado no mesmo modelo Browse).
modelos de controle gerar todo o cdigo fonte para criar e manter um nico controle ou um grupo
controla vinculados. Neste caso, a colocao de um modelo de controle BrowseBox permite que o
Gerador de Aplicativos produz o cdigo que abre os arquivos e faz com que as estruturas de dados
necessrios que mostrar.

Ponto de partida:
O arquivo TUTORIAL.APP deve estar aberta.

criao procedimento

Selecionando o tipo de procedimento

1. VerPedidos destaque e pressione o boto Propriedades.


2. Destaque Janela na caixa de dilogo Selecionar tipo de Procedimento e pressione o boto
Select.
Modificando a janela
1. Na caixa de dilogo Procedure Properties, pressione o boto Window.
caixa de dilogo Estrutura caixa Novo aparece. O procedimento de janela genrico como um
espao em branco onde uma janela desejos definido. Desde que no h nenhum tipo
predefinido da janela voc tem que escolher uno.En neste caso, o que precisamos uma janela
"filha" MDI.

165
166 CLARION 5 CLARION
Aprendiendo

2. MDI janela filho Destaque e pressione o boto OK.


Designer janela aparece.
3. Ampliar a janela, tornando-se cerca de duas vezes o tamanho original.
4. Clique direito sobre o ttulo, e escolha Propriedades no menu de contexto.
5. Digite ordens no campo de texto.
6. Redimensionvel Escolha da lista drop-down Tipo de quadro.
7. Selecione a guia extra e marque a caixa Maximizar Box.
8. Pressione o boto OK para fechar a caixa de dilogo Propriedades janela.

Colocar caixa de listagens (Control Template BrowseBox)

1. Escolha Populate Controle modelo ou Control-clique na ferramenta de modelo nos controles


da caixa de ferramentas flutuante (ltima ferramenta na direita, linha inferior).
caixa de dilogo Select aparece modelo de controle.
2. Realce o controle BrowseBox modelo e pressione o boto Select.
O cursor muda para uma cruz e um "livro".
3. Clique no canto superior esquerdo do ngulo vitrines.
Coloque os campos de arquivo Solicitao de lista de Designer
1. Destaque o item "todo" localizado sob File-Navegao da caixa de lista e pressione o boto
Inserir.
2. Realce o arquivo caixa de dilogo Campos de encomenda, e pressione o boto Select.
3. Pressione o boto Editar e selecione caixa de dilogo KeyNumPedido Mudana chave de
acesso.
4. Destaque PED: cusno na lista de campos (Campos) e pressione o boto Select.
5. Pressione o boto Preencher.
6. Destaque PED: Eu ordno na lista de campos (Campos) e pressione o boto Select.
7. Pressione o boto New Column.
8. Destaque PED: MontoFactura na lista de campos (Campos) e pressione o boto Select.
9. Aumentar a caixa de campo Recuo a doze (12).
10. Pressione o boto New Column.
11. Destaque PED: DataDoPedido na lista de campos (Campos) e pressione o boto Select.
12. Pressione o boto New Column.
13. Destaque PED: NotaPedido na lista de campos (Campos) e pressione o boto Select.
14. Esquerda, selecione na lista suspensa para a justificao do campo.
15. Ajustar o tamanho das colunas na caixa de lista de amostras.
16. Pressione o boto OK para fechar a lista de Designer.
EuCONTEDO 167

17. Ajuste o tamanho da caixa de lista, arrastando a ala central no lado direito para a direita,
fazendo a caixa quase to largo como a janela.
Melhoradas listagens caixa de aparncia
1. Clique direito sobre as listagens de caixa, e escolha Propriedades no menu de contexto.
2. Selecione a guia extra e marque as caixas verticais e horizontais na caixa de dilogo
Propriedades da lista.
Isso adiciona lista horizontal e verticalmente rolagem.
3. Pressione o boto source (fonte)
Porque um campo (descrio) longo, voc pode especificar que listou esta caixa uma fonte
menor, o que lhe permite exibir mais informaes sem que o usurio ter que mover o cursor.
4. Escolha uma fonte eo tamanho fixado em 8 pontos.
Consulte o Guia do Usurio para algumas dicas sobre temas como a escolha das fontes da
direita para controles. No geral, bom limitada para as fontes que vm com o Windows;
porque ele no pode garantir que o usurio tenha uma fonte diferente em seu sistema. A
ilustrao mostra a fonte definida para Arial, que comum no Windows.

5. Pressione o boto OK para fechar a caixa de dilogo Selecionar fonte.


6. Pressione o boto OK para fechar a caixa de dilogo Propriedades da lista.

Adicionando o modelo boto Atualizar


Em seguida, adicione a opo "Adicionar", "Change" e "Delete" (inserir, alterar e excluir) botes
de controle listados acima. Uma vez que existem duas listagens nesta janela, deixe aqueles visvel
para os botes do usurio. Em seguida, adicionar um procedimento de formulrio para adicionar
ou editar uma ordem.

167
168 CLARION 5 CLARION
Aprendiendo

1. Escolher modelo de controle Preencher, ou clique na ferramenta de modelo na ferramenta de


controles de caixa de controle (o ltimo cone direita, linha inferior).
2. Na caixa de dilogo Selecionar modelo de Controle, selecione o controle
BrowseUpdateButtons modelo e pressione o boto Select.
3. Clique abaixo da borda esquerda da caixa de listagem
Os trs botes aparecem juntos. Se desejar, voc pode clicar sobre eles, e mudar o texto da
superfcie de cada boto (somente) por expresses traduzidas como "Adicionar", "Change" e
"Delete".
Neste ponto, a janela deve ficar assim:

Designar o procedimento de atualizao


1. Clique direito sobre o boto Excluir, e escolha Aes no menu de contexto.
2. Tipo FichaPedido na caixa de Atualizao de Procedimento.
Isto d nome ao procedimento. Designar o procedimento de atualizao para este modelo de
boto de controle se aplica aos trs botes.
3. Pressione o boto OK.

Colocando o segundo listagens caixa

Em seguida, coloque uma caixa listada com o detalhe o contedo do arquivo. Isto ir atualizar
automaticamente quando o usurio altera a seleo no topo da lista.
EuCONTEDO 169

1. Escolher modelo de controle Preencher, ou clique na ferramenta de modelo na ferramenta de


controles de caixa de controle (o ltimo cone direita, linha inferior).
2. Realce o controle BrowseBox modelo e pressione o boto Select.
3. Clique no boto Inserir imediatamente abaixo do anteriormente colocado.

Coloque os detalhes arquivo lista de campos Designer


1. Destaque o item "todo" localizado sob File-Navegao da caixa de lista e pressione o boto
Inserir.
2. Realce o arquivo na caixa de dilogo Campos Detalhe, e pressione o boto Select.
3. Pressione o boto Edit.
4. Selecione a caixa KeyNumPedido Acces de dilogo Key Change, e pressione o boto Select.
5. Detal se: I ordno na lista de campos (Campos), e pressione o boto Select.
6. Pressione o boto New Column.
7. Destaque Preo de varejo: partNum na lista de campos (Campos) e pressione o boto Select.
8. Pressione o boto New Column.
9. Destaque Retail Price: Nmero na lista de campos (Campos) e pressione o boto Select.
10. Pressione o boto newc Coluna.
11. Destaque Preo de varejo: ProdPrecio na lista de campos (Campos) e pressione o boto Select.
12. Aumentar a caixa de campo Recuo a doze (12).
13. Ajuste o tamanho da caixa de colunas exibe listagens.
14. Pressione o boto OK para fechar a lista de Designer.
15. Ajuste o tamanho das listagens de caixa, arrastando as alas, e dando-lhe um tamanho
conveniente para visualizao (deixar algum espao na direita para um boto que ir adicionar
mais tarde).

Configurando limites de busca


1. Clique direito sobre a caixa que voc listagens apenas colocados e selecione Aes no menu
contextual.
2. Pressione o reticncias em "Pesquisar Limites" (faixa limite do campo).
3. Realce o RETAIL campo: ordno na lista de componentes (Componentes), e pressione o boto
Select.
4. Escolha "Relao entre File" (Arquivo de Relacionamento) Limitar a lista drop-down Tipo
Range.
5. Pressione o reticncias ao lado de "File relacionadas" (File relacionadas).
6. Realce o arquivo na lista Selecionar Ordens arquivo e pressione o boto Selecionar.
Estes ltimos quatro estgios limitar os registros que aparecem na segunda caixa listados
apenas os registros de detalhes que esto ligados ao registro atual listado na caixa da Ordem.
Assim, o segundo modelo de controlo por meio da relao definida entre ficheiros no
dicionrio de dados para sincronizar a lista de baixo para cima.

169
170 CLARION 5 CLARION
Aprendiendo

Melhoradas listagens caixa de aparncia


1. Clique direito sobre as listagens de caixa, e escolha Propriedades no menu de contexto.
2. Selecione a guia extra e marque as caixas verticais e horizontais na caixa de dilogo
Propriedades da lista.
Isso adiciona barras verticais e horizontais lista de deslocamento.
3. Pressione o boto source (fonte).
Embora no haja nenhum campo "longas" nesta lista, ele ficar melhor se a fonte igual
listagem acima.
4. Escolha uma fonte e definir tamanho 8 pontos.
5. Pressione o boto OK para fechar a caixa de dilogo Selecionar fonte.
6. Pressione o boto OK para fechar a caixa de dilogo Propriedades da lista.

Adicionar o boto template "Close"

Finalmente, voc pode adicionar um boto Fechar para fechar a janela.


1. Escolher modelo de controle Preencher ou clique na ferramenta modelo de controle nos
controles da caixa de ferramentas (ltimo cone na lista logo abaixo).
2. Selecione o modelo de controle CloseButton e pressione o boto Select.
3. Clique no canto inferior direito da janela.
Neste ponto, a janela deve ser semelhante ilustrao a seguir. Pode ser maior que a rea
mostrada no Designer do Windows, mas no deve ser to grande quanto o ambiente de
trabalho:
EuCONTEDO 171

4. Escolha Exit! Designer Janela para a fechar.

Faa o tamanho da janela ajustvel


1. Na caixa de dilogo Procedure Properties, clique no boto Extenses.
2. No caso de dilogo Extenso e modelos de controle, pressione o boto Inserir.
3. WindowResize ficar na caixa de dilogo Select Extenso e opima o boto Select.
Ns j usamos vrias vezes esta extenso de modelo, mas desta vez modificar o seu
comportamento, em vez de aceitar as configuraes padro.

Especificando estratgias de ajustamento

1. Verifique o tamanho mnimo da janela (Minimun Restringir o tamanho da janela) Caixa de


restrio.
Ao marcar esta caixa e deixando os campos de largura e altura mnima (largura mnima - altura
mnima) de zero, o modelo garante que os usurios no pode reduzir o tamanho da janela para
alm do qual ele foi projetado.
2. Pressione o boto de estratgias de controle (Substituir Estratgias de Controle) cancelar.
caixa de dilogo correspondente aparece. Aqui voc pode especificiar dimensionamento
estratgia para controles individuais.
3. Pressione o boto Inserir.
4. Escolha? Insira a lista suspensa Janela Controle.
5. Escolha o boto de opo "Definir a base" (Fix Botton) sobre as opes de configurao
Vertical estratgia posicional.
Isso determina o boto Inserir ajuste estratgia para manter a uma base fixa da janela de
distncia. Agora vamos fazer o mesmo para os outros dois botes e actualizar a lista de
detalhes.

171
172 CLARION 5 CLARION
Aprendiendo

6. Pressione o boto OK.


7. Pressione o boto Inserir e escolher? Mudana de lista suspensa Janela Controle.
8. Escolha o boto de opo "Definir a base" (Fix Inferior) no opes de configurao Vertical
estratgia posicional, e pressione o boto OK.
9. Pressione o boto Inserir e escolher? Excluir na lista suspensa Janela Controle.
10. Escolha o boto de opo "Definir a base" (Fix Inferior) no opes de configurao Vertical
estratgia posicional, e pressione o boto OK.
11. Pressione o boto Inserir e escolha Lista: 2 da lista suspensa Janela Controle.
12. Escolha o boto de opo "Definir a base" (Fix Inferior) no opes de configurao Vertical
estratgia posicional, e pressione o boto OK.
13. Pressione o boto Inserir e escolher? Lista de janela de controle lista suspensa.
14. Escolha o boto de opo "borda inferior Constant" (borda inferior Constant) nas opes de
configurao Redimensionar Estratgia Vertical
Isso define lista de ordem ajuste estratgia para a parte inferior da lista mantida a uma
distncia fixa a partir da borda da janela. Portanto, a lista ser estendido conforme necessrio
para preencher o espao como a janela ampliada.
15. Pressione o boto OK (trs vezes) boto para voltar caixa de dilogo Procedure Propriedades.

Definir um campo para atualizar (Reset Field)

1. Nas Extenses de caixa e de dilogo Modelos


de Controle, selecione Procurar na Detail.
2. Pressione o boto Redefine Campos e
pressione Inserir.
3. Tipo PED: MontoPedido campo Campo
Reset, em seguida, clique em OK.
4. Isto especifica que o detalhe caixa lista ser
atualizada sempre que o valor do campo
5. PED: mudana MontoPedido. Isso garante
que o retorno de modificao de um pedido
existente, as alteraes feitas vai ser
reflectida na caixa de lista.

Encerrar o procedimento caixa de dilogo Propriedades e aplicao de


poupana
1. Pressione o boto OK na caixa de dilogo para fechar Propriedades do Procedimento.
2. Escolha Salvar arquivo, ou pressione o boto Salvar na barra de ferramentas para preservar o
trabalho.
EuCONTEDO 173

- TEMAS AVANZADOS

atualizao do arquivo de ordens


Para o formulrio de pedido, colocar os campos em uma atualizao do arquivo de registro, vamos
fazer uma consulta automtica arquivar os clientes, adicionar um modelo de controle BrowseBox
para exibir e modificar todos os itens em detalhes, vamos calcular a quantidade de cada linha, e em
seguida o pedido total.

Ponto de partida:
O arquivo TUTORIAL.APP deve estar aberta.

Criando o formulrio de Entrada de Pedidos

1. Ilumine rvore FichaPedido na aplicao, e clique no boto Propriedades.


2. Destaque formulrio na caixa de dilogo Select Procedimento, desmarque a caixa que invoca o
Wizard (Assistente de Uso Interno), e pressione o boto Select.
3. Pressione o boto para abrir a Janela Designer.
4. Faa superior a janela arrastando a ala superior central (use a barra de rolagem vertical para
mover a rea de visualizao, se necessrio).

173
174 CLARION 5 CLARION
Aprendiendo

Colocar controles de entrada de dados


Em vez de usar a caixa flutuante ferramentas Fieldbox para carregar os controles, desta vez use a
caixa de dilogo Selecionar campo para colocar vrios controles.
1. Multiple escolher preencher os campos, ou selecione a ferramenta Campo dicionrio caixa
de ferramentas flutuante Controls.
2. Na caixa de dilogo Selecionar campo, realce o item "todo" Update baixo Record no disco, e
pressione o boto Inserir.
3. Realce as Ordens de arquivo da lista Inserir arquivo.
4. Destaque PED: Data e pressione o boto Select.
5. Cercca clique no canto superior esquerdo da janela.
Isso coloca o campo e seu rtulo. Marque a caixa de dilogo Campo reaparece imediatamente
pronto para o prximo campo, o que torna este mtodo de colocao de controles quase to
rpico como a caixa de ferramentas Fieldbox flutuantes.
6. Destaque PED: NotaPedido, e pressione o boto Select.
7. Clique direita da caixa de login usado para data.
8. Mark PED: cusno, e pressione o boto Select.
9. Clique abaixo do rtulo campo de data.
10. Pressione o boto Cancelar na caixa de dilogo Selecionar campo para sair deste modo.
A janela da guia agora algo como isto:

Adicionar uma chamada para um procedimento de consulta

1. Clique direito sobre o Controle PED: cusno e escolha Aes no menu de contexto.
EuCONTEDO 175

aes ordinrias de cada controle de entrada permitem que voc para validar a entrada de dados
contra um registro em outro arquivo, ou quando o controle selecionado (apenas antes que o
usurio insere dados) ou quando aceitou (imediatamente aps a admisso dados).
2. Quando no grupo de controle for aceite, pressione o boto reticncias (...) para a caixa de login
Lookup Key.
3. Ordens Realce o arquivo na caixa de dilogo Select Key, e clique no boto Inserir.
4. Clientes Realce o arquivo na lista de arquivos, e pressione o boto Select.
Essas aes mais recentes adicionar o arquivo para o procedimento de Clientes rvore de
arquivos como uma consulta automtica do arquivo Orders. Isso ir gerar uma "consulta" nos
Clientes arquivo vinculado, com base na relao dos arquivos configurados no dicionrio.
5. Destaque CLI: KeyNumCliente a caixa de dilogo Key Select, e pressione o boto Select.
Isto indica a chave que usado para tentar obter um arquivo de registro vlido vinculado no
cliente para o valor que o usurio digitar este controle.
6. Pressione o reticncias (...) aponta caixa campo de pesquisa.
7. Destaque CLI: cusno na caixa de dilogo Select Component, e pressione o boto Select.
Isso faz com CLI: cusno o campo deve conter o valor correpondiente que o usurio entra o
controle.
8. Escolha o procedimento VerClientes da lista drop-down Lookup Procedimento.
Isso chama o procedimento chamado quando o usurio digita um nmero de cliente invlido,
assim voc pode escolher a partir de uma lista de clientes.

9. Marque as caixas Execute Lookup Durante Non-Stop Select ( "Fazendo consulta durante a
reviso automtica do disco") e forar a janela de atualizao Quando aceitado ( "redesenhar a
tela para aceitar"), para garantir que os dados apresentados sempre vlido e atualizado .

175
176 CLARION 5 CLARION
Aprendiendo

10. Incorpora pressione o boto na guia Aes.


Isso exibe uma lista de pontos de insero ligados apenas a este controle. Esta a maneira mais
rpida de chegar aos pontos de insero de um controle particular, e a segunda maneira que
vimos at chegar a um ponto de insero. H ainda um terceiro mtodo, que j tratar.
11. Realce o evento selecionado sob Controle manipulao de eventos e pressione o boto Inserir.
O "evento selecionado" ocorre pouco antes de o foco de controle get. Isto permite que qualquer
ponto de insero para "configurao especfica" para este controlo.
12. Destaque Fonte e pressione o boto Select.
Isso invoca o editor de texto de modo que voc pode escrever cdigo Clarion. Note que a caixa
de ferramentas flutuante Preencher campo est presente. Sempre d um duplo clique sobre um
campo na caixa de ferramentas, coloque o nome do campo (incluindo o prefixo) em seu cdigo
no ponto de insero. Isso no s ajuda a produtividade (menos digitao), mas tambm
garante a ausncia de erros tipogrficos (o que causaria erros na compilao).
13. Digite o seguinte cdigo:
? PED: cusno {PROP: Tocado} = true
parte do "comportamento padro do Windows" que se o usurio no entra controle de dados
e simplesmente pressionar TAB (ou d um clique com o mouse) para mover para um outro
controle, gerada a aceitao de um evento ( este muito diferente do dOS programas de
trabalho). Assim, os clientes podem gastar com TAB no controle sem causar validao de
dados em cada controle. No entanto, s vezes necessrio para evitar esse comportamento
padro para garantir a integridade do banco de dados.
A sentena tem escrito usa a sintaxe Clarion mapeamento de propriedade (ver referncia
Apndice C Language). Ao configurar PROP: Tocou como TRUE (verdadeiro) em caso
selecionado este controle, aceitao sempre um evento gerado, se o usurio entrou dados ou
no. Isso fora a execuo do cdigo de consulta (que entrou na guia Aes na pgina
anterior). Isso garante que o usurio digite um cdigo de cliente vlido; Caso contrrio, a lista
aparece para permitir que os clientes a escolher um nmero vlido.
14. Escolha Exit! (E salvar) para retornar caixa de dilogo Fonte incorporado.
15. Pressione o boto Fechar para retornar caixa de dilogo Propriedades de entrada, e pressione
o boto OK para fech-la.
Adicione um controlo de "apenas para exibio"
1. Escolha string de controle, String ou pressione o boto nos controles de caixa de ferramentas
flutuante (o cone direita da "grande seta" na linha superior).
2. Clique direita do nmero do cliente caixa de entrada previamente colocado.
3. Clique direito de controlar a cadeia de texto que voc acabou de colocar, e escolha
Propriedades no menu de contexto.
4. Marque a caixa varivel string.
Isto especifica que o controle ir exibir dados de uma varivel, no apenas uma seqncia
alfanumrica. caixa de dilogo caixa Selecionar campo aparece.
5. Cliente realce o arquivo na lista de arquivos e escolha CLI: campos de lista Company
(Campos) e pressione o boto Select.
6. Pressione o boto OK e feche a caixa de dilogo Propriedades de Cordas.
EuCONTEDO 177

Colocando modelos de controle Detalhe Arquivo

O elemento chave prximo nesta janela uma listas de controle (Navegar), sincronizados com o
nmero de ordem dessa guia. Isto ir mostrar todos os registros no detalhe arquivo relacionado
ordem de entrada.
Adicionando uma lista Detalhe
1. Escolher modelo de controle Preencher ou clique no modelo de controle sobre os flutuantes
Controls toolbox (ltimo cone direita, linha inferior).
2. BrowseBox destaques e pressione o boto Select.
3. Clique abaixo os dados do cliente caixa de login.
4. Destaque o item "todo" localizado sob File-Navegao da caixa de lista e pressione o boto
Inserir.
5. Marque a caixa de dilogo Inserir arquivo detalhe arquivo e clique no boto Inserir.
6. Pressione o boto Edit.
7. KeyNumPedido ficar na caixa de Acesso Alterar chave da caixa e pressione o boto Select.
8. Destaque Preo de varejo: partNum na lista de campos (Campos), e pressione o boto Select.
9. Centro de selecionar a partir da lista suspensa para a justificao dos dados (grupo de Dados).
10. Pressione o boto New Column.
11. Destaque Retail Price: Quantidade na lista de campos (Campos), e pressione o boto Select.
12. Centro de selecionar a partir da lista suspensa para a justificao de dados.
13. Pressione o boto New Column.
14. Destaque Preo de varejo: ProdPrecio na lista de campos (Campos), e pressione o boto Select.
15. Centro de selecionar a partir da lista suspensa para a justificao de dados.
16. Pressione o boto New Column.
17. Destaque LOCAL ordem de tabulao de dados na lista de arquivos, e pressione o boto
"New" (Novo).
O boto Novo permite a adio de uma varivel local sem ter que ir at a janela Procedimento
Propriedades e pressione o boto de dados. Usaremos esta nova varivel para exibir o preo
total para cada item (quantidade multiplicada pelo preo unitrio).
18. Tipee ItemTotal no campo Nome.
19. Select decimais a partir da lista drop-down Tipo.
20. Tipo 7 como de comprimento de campo (caracteres).
21. Digite 2 para o nmero de casas decimais (Places) e pressione o boto OK.

177
178 CLARION 5 CLARION
Aprendiendo

22. Centro de selecionar a partir da lista suspensa para a justificao de dados.


23. Pressione o boto New Column.
24. Realce o arquivo detalhe arquivo localizado sub-Navegao da caixa de lista e pressione o
boto Inserir.
25. Marque a caixa de dilogo Inserir arquivo arquivo do produto, e pressione o boto Select.
Isso adiciona o arquivo do produto para o arquivo modelo de controle de rvore como um
arquivo de consulta. O registro vinculado est em busca automaticamente, assim voc pode ver
a descrio do produto na lista.

26. Destaque PROD: Descrio na lista Campos e pressione o boto Select.


27. Esquerda, selecione na lista suspensa para a justificao de dados.
28. Redimensionar colunas e ajustar o design geral (como tem feito antes).
29. Pressione o boto OK para fechar a lista de Designer.
30. Ajustar o tamanho da caixa para exibir todos os campos carregados.
Esta dever aparecer agora algo como isto:
EuCONTEDO 179

caixas de lista de sincronizao


Queremos que esta lista para mostrar apenas os registos que esto ligados ao registro do cliente
sobre o qual voc est trabalhando. Portanto, devemos especificar um limite de pesquisa (limite de
alcance).

1. Direito Clique na caixa de lista que voc


acabou de colocar, e selecione o menu
Actions.

2. Pressione o boto com reticncias (...) no


limite de alcance campo.

3. Realce o RETAIL campo: ordno na lista


Componentes, e pressione o boto Select.

4. Escolha "File List" (File Relacionamento)


Limitar a lista drop-down Tipo Range.

5. Digite ordens no campo de arquivo


relacionado.

A adio de um clculo da quantidade total da ordem


Agora queremos calcular a ordem total, em seguida, guard-lo no arquivo de ordem.

179
180 CLARION 5 CLARION
Aprendiendo

1. Pressione o boto pequena seta localizada direita da lngua move it Hot Campos para as abas,
e selecione a guia totalizando quando ela aparece.
2. Pressione o boto Inserir.
3. Pressione o reticncias total campo Target Field.
4. Ordens Realce o arquivo na lista de arquivos (Arquivos), selecione PED: MontoFactura, e
pressione o boto Select.
Este o campo que ir receber o resultado do clculo total.
5. Escolha "Sum" (Soma) a partir da lista drop-down Total Tipo.
6. Pressione a reticncias (...) o campo total (campo de Total).
7. FichaPedidos dados locais destacar a opo na lista de arquivos (Arquivos), selecione
ItemTotal lista Campos e pressione o boto Select.
Este o campo cujo contedo ser usado no clculo total. At agora s tm declarado neste
campo e ns no fizemos nada para introduzir qualquer valor, mas em breve vamos.
8. Escolha "Para cada leitura record" (Cada registro lido) a partir da base na lista total drop-down.

9. Pressione OK para fechar a caixa de dilogo Browse totalizando.

Adicionar barras de rolagem horizontal e vertical


1. Escolha a aba Extra.
2. Marcar caixas horizontais e verticais.
3. Pressione OK para fechar a lista caixa de dilogo Propriedades.

Adicionando botes arquivo de atualizao


1. Escolher modelo de controle Preencher ou clique na ferramenta Control Template nos
controles da caixa de ferramentas (ltimo cone direita, linha inferior).
2. Na caixa de dilogo Selecionar modelo de controle, escolha o controle BrowseUpdateButtons
modelo e pressione o boto Select.
O cursor muda para uma cruz e um "livro".
3. Clique abaixo na lista.
aparecem juntos botes inserir, alterar e excluir.
4. Clique direito sobre o boto Excluir, e escolha Aes no menu de contexto.
5. Marque a caixa de "Change in situ" (Use Editar no local).
Basta indicar esta opo em um boto para controlar o modelo que marcar todos os trs. Ns
usamos a tcnica de "modificado in situ" (edit-in-place) para atualizar registros de detalhes, em
EuCONTEDO 181

vez de um formulrio. Isto ir permitir-nos demonstrar algumas tcnicas de programao


bastante avanadas e veja como fcil realizar dentro do Gerador de Aplicativos.
6. Pressione o boto OK.

A adio de um nico monitor de controle


1. Escolha string de controle, ou clique em caixa de ferramentas Controles String ferramenta.
2. Clique abaixo no canto inferior direito das listas de caixa.
3. Clique direito sobre o controle que voc acabou de colocar, e escolha Propriedades no menu de
contexto.
4. Verifique a varivel string caixa.
Isto especifica que o controle ir exibir dados de uma varivel, no uma mera seqncia
alfanumrica fixa. Marque a caixa de dilogo Campo aparece automaticamente.
5. Ordens de verificar o arquivo na lista de arquivos e escolha PED: MontoFactura a partir da lista
de campos (Field) e pressione o boto Select.
6. Pressione o boto OK.

Alterar o ttulo da janela e sair Designer


1. Clique na barra de ttulo da janela na qual voc est trabalhando.
2. Fim tipo de formulrio no campo de texto (texto) na caixa de ferramentas flutuante Propriedade

e pressione TAB.
3. Escolha Exit! Designer para fechar as janelas.

181
182 CLARION 5 CLARION
Aprendiendo

faz-lo funcionar
H um par de coisas que devemos fazer para este procedimento para obter a funcionalidade
completa: adicionar uma frmula, e definir o "modificado in situ".

Usando o Editor de Frmula

Para fazer ItemTotal calcular a quantidade de cada registro de detalhe listado na caixa, voc
precisa adicionar uma frmula para o procedimento. Isso tambm ir fazer a soma total no PED:
MontoFactura.
1. Pressione o boto sobre as frmulas de caixa de dilogo Propriedades Procedimento de.
Frmulas caixa caixa de dilogo aparece. Aqui todas as frmulas do procedimento so listados.
2. Pressione o boto Novo para adicionar uma nova frmula.
caixa de dilogo Editor de Frmula aparece.
3. Total Tipo item Frmula no campo Nome.
4. Pressione a reticncias (...) no campo Classe.
5. Formato destaque Navegue na lista classes de modelo e pressione o boto OK.
O domnio de Classe simplesmente especificar a posio lgica dentro do cdigo de fonte
gerado em que a frmula calculada. Navegar na classe Format indica o modelo de controle
BrowseBox para realizar o clculo cada vez que um formato de gravao para exibio na
caixa de lista.
6. Pressione a reticncias (...) no campo Resultado.
7. FichaPedidos dados locais esto na lista de arquivos, selecione ItemTotal lista Campos e
pressione o boto Select.
Isto d nome ao campo que receber o resultado do clculo. Este o campo que definimos
anteriormente na Listagem Designer.
8. Pressione o boto de dados no operando grupo (Operandos).
9. Realce o arquivo na lista Detalhe arquivos, selecione Preo de varejo: Nmero de lista Campos
e pressione o boto Select.
Isto coloca-lo automaticamente no campo Declarao. Este campo contm as construes de
expresso. Se desejar, voc tambm pode escrever diretamente sobre ele para construir a
expresso.
10. * Pressione o boto no grupo de operadores (Operators).
Este o operador de multiplicao.
11. Pressione o boto de dados no grupo Operandos.
12. Realce o arquivo na lista Detalhe arquivos, selecione Preo de varejo: ProdPrecio lista Campos
e pressione o boto Select.
13. Pressione o boto de teste (Confira) para verificar a sintaxe de expresso.
EuCONTEDO 183

uma marca de verificao verde aparece esquerda da sentena, o que indica que a sintaxe
est correta. Se um "X" vermelho aparece, a sintaxe incorreta, e destacado parte da sentena
a ser alterado.

14. Pressione o boto OK para fechar o Editor de Frmula.


caixa de frmulas reaparece dilogo.
15. Pressione o boto OK para fech-la.

Configurando o "modificao in situ"

Agora vamos configurar as caractersticas do "modificado in situ" (Edit in Place). J usamos esse
recurso no arquivo de telefones, e simplesmente aceitar o comportamento padro, porque era um
arquivo muito simples. No entanto, estamos agora trabalhando em uma linha de log Detalhe de um
sistema de entrada de pedidos, o que significa que precisamos para validar os dados inseridos pelo
operador. Para fazer isso, precisamos estender a funcionalidade simples oferecidoa biblioteca
classe ABC.

Definir classes especficas para colunas


1. Pressione o boto Extenses na caixa de dilogo Procedure Propriedades.
2. Destaque Atualizao para formar Navegar Registro Box em detalhe e pressione o boto
Configurar Editar no lugar.
caixa de dilogo correspondente aparece. As opes nesta caixa permite que voc especifique o
comportamento do controle quando o usurio entra ou modifica dados e pressione ENTER ou
uma tecla de seta, junto com vrias opes "Salvar". Aceitamos todos os valores padro.
3. Coluna especfica Pressione o boto.
4. Pressione o boto Inserir.
5. Pressione a reticncias (...) no campo campo.
6. Destaque Preo de varejo: partNum, e pressione o boto Select.

183
184 CLARION 5 CLARION
Aprendiendo

biblioteca ABC contm uma classe de objetos chamados EditEntryClass que o Editar classe
padro no lugar. "Ns vamos ignorar" alguns dos mtodos da classe, para esta coluna, voc
pode modificar o comportamento padro. A adio deste campo lista de campos de coluna
especfica o que nos permite "colocar de lado" mtodos pr-configurados para este caso.
Vamos fazer a validao para realizar a entrada de dados: queremos garantir que os usurios s
podem inserir nmeros de produto vlida.
7. Pressione o boto OK.
8. Pressione o boto Inserir.
9. Pressione a reticncias (...) no campo campo.
10. Destaque Retail Price: Nmero e pressione o boto Select.
A classe EditEntryClass s proporciona a entrada de dados de controles (ENTRADA). Para
este campo, ns queremos usar um controle de rotao para que o usurio faz isso aumente a
quantidade que voc deseja. Portanto, precisamos ignorar alguns dos mtodos da classe
tambm pr-configurado para esta coluna para ter um controle de rotao em vez de um
controle de entrada.
11. ABC Use caixa padro limpo.
Isso permite que voc especificar a classe exata a partir do qual deriva.
12. Selecione na lista suspensa EditClass classe base.
o EditEntryClassEle faz muito mais do que precisamos e mesmo assim vamos ignorar mtodos.
Ento, vamos derivar e sobre-escrever a classe da qual todos Editar nas aulas lugar so
derivadas:o EditClass.

13. Pressione o boto OK.


14. Pressione o boto Inserir.
15. Pressione a reticncias (...) para o campo campo.
16. Destaque Preo de varejo: ProdPrecio, e pressione o boto Select.
17. Desmarque a caixa que permite a modificao in situ (Permitir Editar no local).
Isto evita que esta coluna pode ser modificado.
EuCONTEDO 185

Somente campos primrios Navegar arquivo pode ser modificado in situ e opo de pr-
configurado que todos os arquivos primrios so modificados. Neste caso, isso significa que
voc pode alterar os campos de detalhe, mas no o produto. No entanto, neste caso, no
queremos que o usurio modificar o preo, porque vamos obter o arquivo diretamente do
produto, e ns no queremos isso mudou. por isso que ir desativar a caixa Permitir Editar no
local.
18. Pressione o boto OK cinco vezes para retornar rvore da aplicao.
Usando o Editor do Ponto de Insero (Embeditor)
Clique direito sobre FichaPedido e escolha Fonte no menu de contexto.
Esta opo de menu abre a Incluso editor de ponto: o terceiro mtodo de acesso a esses pontos.
Este o mesmo editor de texto que j foi utilizado, mas aberto em um modo especial que lhe
permite no s editar os pontos de insero no procedimento, mas faz-lo no contexto dos modelos
de cdigo gerado.
O cdigo-fonte se parece com isso:

Note-se que a maior parte do cdigo est localizado sobre um fundo cinza, e os pontos que voc
escreveu cdigo tem fundo branco. H tambm comentrios identificatrios para cada ponto de
insero. Voc pode ver ou no tais comentrios como sua opo opes de configurao de
aplicativos. Quando estiver familiarizado com eles, voc pode querer remov-los para ver mais do
prprio cdigo.
Voc vai notar que apareceu brevemente uma mensagem: "tutorial Generating".

185
186 CLARION 5 CLARION
Aprendiendo

Este editor mostra todos os pontos de insero possveis que poderiam ser gerados para o
procedimento. Observe a distino: o editor no mostra o cdigo que ser gerado, mas todo o
cdigo que poderia ser gerada, se voc escolheu cada possvel cdigo de opo e coloque sobre
cada item disponvel. muito improvvel que voc nunca fazer isso. Portanto, muito mais cdigo
exibido no editor quando o aplicativo compilado. Assim que terminarmos aqui, vamos olhar
para o cdigo gerado para apreciar a diferena.
O lado direito da barra de ferramentas, existem quatro botes que so muito importantes para saber
quando se trabalha no editor. Eles so (da esquerda para a direita): ponto de insero anterior, o
prximo ponto, ponto utilizado acima, e ponto utilizado abaixo (se voc parar o ponteiro do mouse
sobre eles voc vai ver as direes de palco em Ingls para cada um dos botes). Deixar de ir
rapidamente de um ponto de insero para outro, especialmente quando voc j escreveu algum
cdigo.
Ordens de deteco modificado
Uma das coisas que queremos fazer este procedimento detectar alteraes nos pedidos existentes
e garantir que nenhum dado causar desequilbrios entre ordens e arquivos detalhe. Este sistema
mantm a quantidade total de uma ordem no PED campo: MontoFactura, de modo que quando o
usurio muda um item de detalhes em um pedido existente, voc deve ser o registro atualizado.
H uma maneira simples de fazer isso, o que nos permitir demonstrar a manipulao flexvel de
erros cometidos pela biblioteca ABC.
1. Clique no prximo ponto de insero boto (cinco vezes) at atingir o ponto de insero
imediatamente anterior a linha de cdigo em que ThisWindow CLASSE (gerenciador de
janelas), (este deve ser em [Prioridade 7500] lido.
Cada ponto de insero tem potencialmente 10000 nveis de prioridade dentro. Este sistema de
prioridade concebido para permitir que o cdigo para inserir antes ou depois do cdigo
gerado (quer pelo ABC Modelos Clarion ou terceiros). Isso faz com que o sistema de insero
completamente flexvel, permitindo que voc adicione o cdigo em qualquer ponto lgico
necessrio, antes ou depois de qualquer "pea" de cdigo gerado.
2. Digite o seguinte cdigo:

GRUPO LocalErrGroup Esta linha deve ser exatamente na column1


! (Exibido em vermelho), pois um
! Procedimento Label.
USHORT (1)
USHORT (99)
BYTE (Nvel: Notificar)
PString ( 'Salvar ordem')
PString ( 'foi alterado um item. Pressione o boto OK')
END
SaveTotal SIMILAR (PED: MontoFactura)

modelos Clarion ABC gerado cdigo orientado a objetos usando a biblioteca ABC. Esta
biblioteca contm uma classe chamada manipulao de erro ErrorClass. A poro de cdigo
que ns escrevemos declara um GRUPO LocalErrGroup (exatamente da forma exigidao
ErrorClass: Ver Manual de Aplicao) contendo um nmero de erro "custom" e uma
mensagem que estamos a definir para o uso de ErrorClass objeto de nossa aplicao. A
declarao SaveTotal uma varivel local que definido como (como, sempre com o mesmo
tipo de dados) o campo PED: MontoFactura. Vamos usar essa varivel para armazenar a ordem
total quando o usurio atualiza um pedido existente.
EuCONTEDO 187

3. Escolha de busca encontrar para trazer a caixa de dilogo Localizar.


4. ThisWindow.Init tipo no campo Localizar e pressione o boto Localizar seguinte.
Isto conduz directamente a ThisWindow.Init mtodo
5. Na on-line imediatamente aps os SELF.Errors & = GlobalErrors (deve ser [Prioridade 5600])
ponto incorporado, digite o seguinte cdigo:
GlobalErrors.AddErrors (LocalErrGroup) D a manipulao de erro personalizada
SE = self.request ChangeRecord ! Se voc estiver alterando um registro
SaveTotal = PED: MontoFactura ! Salve a quantidade original da
ordem
END

Este cdigo chama o mtodo addErrors GlobalErrors LocalErrGroup objeto para adicionar
lista de erros disponveis que gerencia o objeto. O objecto GlobalErrors um exemplo deo
ErrorClassmodelos ABC que declaram a nvel mundial para lidar com todas as condies de
erro na aplicao. A adio do nosso LocalErrGroup permite que os GlobalErrors objeto para
lidar com a nossa condio de erro "custom". Isso demonstra a flexibilidade da biblioteca ABC
Clarion. A declarao IF detecta quando o usurio est modificando um pedido existente e
manter o original total.

Este ponto de insero est localizado na ThisWindow.Init PROCEDIMENTO executa


algumas tarefas de inicializao necessrio. Este um mtodo virtual ThisWindow objeto. Este
o objeto que executa todo o gerenciamento de janelas de cdigo e controles.

187
188 CLARION 5 CLARION
Aprendiendo

Talvez voc no tenha notado, mas os modelos ABC gerar exatamente uma linha de cdigo
fonte executvel dentro do prprio FichaPedido PROCEDIMENTO (GlobalResponse =
ThisWindow.Run) para que todas as funcionalidades do PROCEDIMENTO FichaPedido
realizada em mtodos de objeto; mtodos virtuais especficos so os mesmos ou FichaPedido
mtodos padro PROCEDIMENTO da biblioteca ABC. Isso se aplica a cada procedimento
gerada por modelos ABC. gerao de cdigo completamente orientado a objeto torna este
muito compacto e eficiente: apenas o cdigo deve ser necessariamente diferente em um
procedimento individual tratado de forma diferente. Tudo o resto cdigo padro que reside
em um s lugar, e que foi testado e refinado para garantir um desempenho consistente e
confivel.

Programao orientadaObjeto (POO) Clarion comea com a estrutura de classe. Veja CLASS
na referncia da linguagem para o tratamento de sintaxe OOP. Guia do desenvolvedor (Guia do
Programador) contm vrios artigos que tratamOOP em profundidade, e h uma documentao
completa Biblioteca ABC Clarion.

6. Digite ThisWindow.Kill no "Encontrar o qu?" (Encontrar o que), e pressione o boto


"Localizar prxima" (Localizar prximo).

7. No rescaldo da linha de ponto de cdigo incorporado (deve ser em [Prioridade 2500], insira o
seguinte cdigo:

GlobalErrors.RemoveErrors (LocalErrGroup) ! Retirar erro personalizada

Este mtodo chama Biblioteca ABCpara remover o nosso erro "personalizado". O mtodo
ThisWindow.Kill um "limpa" (realiza tarefas na sada) que executado quando o usurio
EuCONTEDO 189

terminar de trabalhar sobre o procedimento FichaPedido, para que o tratamento de erros no


mais necessrio.

8. Escrever EVENTO: CloseWindow campo Localizar e pressione o boto Localizar seguinte.


9. Na imediatamente seguinte FATO incorporado ponto: CloseWindow (deve ser em [Prioridade
2500], digite:
IF Self.request = ChangeRecord E | ! Se um registro alterado
Self.response <> RequestCompleted E | ! E boto OK no est pressionado
SaveTotal <> PED: MontoFactura ! E mudar os registros de detalhes
GlobalErrors.Throw (99) ! Show "erro
personalizada"
SELECIONAR (? OK) ! E ento selecione o
boto OK
CICLO
END

189
190 CLARION 5 CLARION
Aprendiendo

Este cdigo ir detectar qualquer tentativa por parte do usurio para sair do procedimento sem
guardar a entrada de pedidos depois de fazer alteraes a um pedido existente. Note-se a barra
vertical (|) no final das primeiras linhas de cdigo. Eles so absolutamente necessrias. A barra
vertical o caractere de continuao de linguagem Clarion. Isto significa que as trs primeiras
linhas de cdigo, em seguida, formar uma nica instruo lgico que avalia trs condies
distintas e s executar GlobalErrors.Throw instruo (99), se todas as trs condies.

Ignorando classes "A modificao in situ"


Bem, acabamos de ver um exemplo de como voc pode usar a biblioteca ABC em seu prprio
cdigo incorporado. Agora vamos mostrar-lhe como perder uma classe para fornecer
funcionalidade especial no fornecido pela biblioteca ABC. As demonstraes de classe para
objetos que tiverem designado atravs da caixa Configurar Editar dilogo no lugar so geradas
para voc por modelos ABC. Essas classes so derivadas da biblioteca de classes EditClass ABC.
1. Digite EditInPlace :: Preo de varejo: Cantidad.CreateControl campo Localizar e pressione o
boto Localizar seguinte.
2. No seguinte inmediatamiente incorporado para apontar o cdigo de linha (este deve ser
[Prioridade 2500], insira o seguinte cdigo:
CRIAR SELF.Feq = (0, CRIAR: Rotao) ! Cria um Spin Control
ASSERT (~ ERRORCODE ()) ! Ele assume que no h erro
RETURN ! Devolve pai antes de chamar o mtodo

Esse cdigo cria um controle de rotao e assume que no haver erros. A instruo de retorno
necessria porque precisamos ter certeza de que a chamada para o mtodo pai no ocorre.
3. V at o EditInPlace :: mtodo de retalho: Cantidad.Init (este deve ser imediatamente abaixo da
EditInPlace method :: Preo de varejo: Cantidad.CreateControl).
EuCONTEDO 191

4. No ponto imediatamente a seguir ao PARENT.Init incorporado (FieldNumber, listagem,


UseVar) linha (que deve ser [Prioridade 7500], introduzir o cdigo que se segue:

SELF.Feq {PROP: Texto} = {PROPLIST ListBox: Imagem, FieldNumber}


! Entrada de dados Mscara
SELF.Feq {SUPORTE: RangeLow} = 1 ! Configure o intervalo de
valores
SELF.Feq {PROP: RangeHigh} = 9999 ! SPIN

Este cdigo define a entrada de dados mscara e o intervalo de valores vlidos para o controle
de rotao.

5. Role para o mtodo EditInPlace :: VAREJO: Cantidad.SetAlerts (este deve ser imediatamente
abaixo da EditInPlace method :: Preo de varejo: Cantidad.Kill).

6. No seguinte inmediatamiente incorporado para apontar as PARENT.SetAlerts linha () (isto


deve ser [Prioridade 7500], introduzir o cdigo que se segue:

SELF.Feq {PROP: alrt, 5} = ''


SELF.Feq {PROP: alrt, 6} = ''

Este cdigo "-alerting" duas das teclas padro que alerta os SetAlerts mtodo o EditClassQue
so as setas para cima e para baixo. Precisamos fazer isso porque o SPIN usado para operar o
monitoramento, aumentando e diminuindo o valor do campo, respectivamente, quando
pressionado.

Para ver o cdigo que iremos excesso de escrever, pesquisa o EditClass no \ CLARION5 \
LIBSRC \ ABEIP.CLW.

191
192 CLARION 5 CLARION
Aprendiendo

7. Digite EditInPlace :: Preo de Varejo: NumProducto.TakeEvent Encontrar o campo e


pressionar o boto Localizar seguinte.

8. No seguinte inmediatamiente incorporado para apontar a linha de cdigo que diz ReturnValue
= Parent.TakeEvent () (esta deve ser [Prioridade 7500], digite o seguinte:

UPDATE (SELF.Feq) ! Atualize o campo Q


IF ReturnValue e ReturnValue <> editAction: Anular! Se a ao Pai devueve
! e diferente de Anular
PRO: partNum = BRW5.Q.DETAL: partNum ! configurar consulta
Se o acesso: Productos.Fetch (PRO: KeyNumProducto) ! Se no h nenhum produto
entrou
GlobalRequest = SelectRecord ! consultar registros de produtos
VerProductos
IF GlobalResponse <> RequestCompleted ! Se voc no selecionar produto
CLEAR (PRO: Record) ! limpar o tampo
ReturnValue = editAction: Nenhum ! ao deve continuar
END ! no mesmo campo
END
BRW5.Q.DETAL: partNum = PRO: partNum ! Atribuir arquivo de valores
BRW5.Q.DETAL: ProdPrecio = PRO: Preo ! produtos campos
BRW5.Q.DETAL: Desciption = PRO: Descrio ! Browse Queue e exibio
EXIBIO
END
Este cdigo realmente interessante. Note-se que a primeira declarao executvel (gerado
para voc) uma chamada ao mtodo PARENT.TakeEvent. Este mtodo chama o
EditClass.TakeEvent estamos "ignorando" para que voc possa fazer o que voc faz
normalmente (cdigo muito semelhante ao TakeEvent voc j escreveu para o controle SPIN
Retail Price: Quantidade).
EuCONTEDO 193

Todo o resto do cdigo dar esta classe derivada funcionalidade extra no est presente na
classe pai. Este o verdadeiro poder deOOP: Se voc quiser tudo o que faz o pai, mas algo
mais, no precisa duplicar todo o cdigo do pai, mas simplesmente cham-lo. Neste caso, todo
o cdigo extra para executar algumas tarefas de validao de dados padro. Este cdigo ir
verificar se o usurio digitou um produto vlido e, se no o fizesse, ele ir chamar os
VerProductos procedimento para escolher a partir de uma lista.

mtodos "negligencia"
H uma coisa muito importante para entender sobre como trabalhar no Editor de ponto pontos de
insero quando "esquecido" mtodos: basta escrever algo em um ponto de insero de um mtodo
que pode ser negligenciado J fez !. Mesmo uma linha de comentrio simples (!) Pode fazer isso
porque o Gerador de Aplicao adverte que voc tenha escrito algum cdigo, e gera o prottipo
correspondente do mtodo dentro da instruo class local. Para evitar que voc acidentalmente
digitar um comentrio que causam "ignorar" mtodo e destruir sua funcionalidade, os modelos
ABC gerar automaticamente chamadas para o mtodo PADRE (pai) e retornar decises (regresso)
por voc, conforme necessrio.

Voc vai notar que todos os nossos mtodos "esquecido" contido chamadas geradas seu mtodo
pai, e os mtodos TakeEvent tambm tiveram instrues de retorno gerados. s vezes voc quer
executar esses julgamentos; embora s vezes no. Nestes ltimos casos, basta digitar o cdigo no
ponto de insero antes a chamada de mtodo pai e inserir sua prpria instruo RETURN no
final do cdigo (como fizemos no final do cdigo que escrevemos para mtodos EditinPlace ::
VAREJO : Cantidad.CreateControl). Isto significa que o mtodo pai gerado ea declarao
RETURN nunca ser executado. compilador Clarion suficientemente inteligente para reconhecer
que estas declaraes nunca ser executado, e otimizado cdigo objeto, remov-los a partir dele.

Escolha Exit! para fechar os pontos de insero Editor.

193
194 CLARION 5 CLARION
Aprendiendo

procedimentos de atualizao rvore

O mtodo EditInPlace :: varejo: NumProducto.TakeEvent VerProductos procedimento chama dentro


de seu cdigo.
Uma vez que este est inserido o cdigo, o Gerador
de Aplicao ignora de ter chamado este processo, e
precisa de ser informado (ou erros de compilao
ser gerado), para que possa gerar a estrutura de
MAP correto para o mdulo que contm o
procedimento.
1. Clique direito sobre Procedimentos FichaPedido
e escolha no menu de contexto.
2. VerProductos destaque e pressione o boto OK.
3. Escolha Salvar Arquivo ou pressione o boto
Save para salvar seu trabalho.

Gerao de cdigo
1. Escolher projeto Gerar para gerar o cdigo-fonte de sua aplicao.

2. Clique direito sobre FichaPedido e selecione mdulo a partir do menu de contexto. Editor de
texto contendo o cdigo fonte gerado para o procedimento FichaPedido aparece. Note-se que
h muito menos cdigo aqui do que tinha nos pontos de insero Editor. H todo o cdigo
estava presente para que voc possa apreciar o contexto, e para fornecer pontos de insero
pelo qual "ignorar" os mtodos, se houver necessidade. No entanto, o Gerador de Aplicao e
Template ABC Clarion tem inteligncia suficiente para gerar o cdigo necessrio somente
quando necessrio.
3. Escolha Exit! para fechar o editor de texto.
EuCONTEDO 195

Agora um bom momento para testar o aplicativo. Eles so todas as partes de entrada de
dados, e a nica coisa que resta a fazer declaradamente a ser discutido nas listas de aula
prximos.

- CRIANDO EuELATRIOS

Uma simples lista de clientes


O ltimo ponto abordado neste curso so os relatrios. Primeiro, criamos uma simples lista de
clientes para apresentar o relatrio designer.
Ento vamos criar um ordens relatrio para mostrar como fcil para criar relatrios relacionais,
segmentos multi-nvel, totais de grupo e layout de pgina. Em seguida, copie as Ordens de
relatrios e pedidos de clientes de impresso limite e, finalmente, a uma nica ordem.

Ponto de partida:
TUTORIAL deve ser arquivo aberto. APP

Atualizar menu principal

Em primeiro lugar, precisamos adicionar selees para o menu, para que o usurio pode chamar
relatrios, e assim o Gerador de Aplicativos pode chamar procedimentos "todo" que se aplicam.
item de menu Novo
1. Clique direito sobre o procedimento principal na rvore de aplicao e escolha Janela no menu
de contexto.
2. Escolha menu Editar Menu Designer Window.
3. Destaque item de P & Setup rint no Editor de lista de menus. Se desejar, voc pode editar o
campo de texto Menu e traduzi-lo para: Configuraes e impressora.
4. Pressione o boto Item.
5. Digite Imprimir List & Clientes no campo de texto Menu, e pressione TAB.
Especifique a ao do novo item
1. Selecione a guia Aes.
2. Escolha chamar um procedimento a partir da lista drop-down quando pressionado.
3. Tipo InformeClientes.
4. Marque a caixa Tpico Iniciado.

195
196 CLARION 5 CLARION
Aprendiendo

Adicionando um segundo menu


1. Pressione o boto Item.
2. Digite Print & ordens no campo de texto de menu.
3. Selecione a guia Aes.
4. Escolha chamar um procedimento a partir da lista drop-down quando pressionado.
5. InformePedidos digitar no campo Nome do Procedimento.
6. Marque a caixa Iniciar Treadwell.

Adicionando um terceiro item para o menu


1. Pressione o boto Item.
2. Digite Impresso e cliente encomenda pelo campo de texto de menu.
3. Selecione a guia Aes.
4. Escolha chamar um procedimento a partir da lista drop-down quando pressionado.
5. Digite InformePedidosCliente no campo Nome do Procedimento.
6. Marque a caixa Iniciar Thread.
7. Pressione o boto Fechar para fechar o Editor de Menu.
8. Escolha Exit! para fechar o Designer do Windows (e salvar seu trabalho).

criao de relatrios

Podemos agora criar o primeiro relatrio usando o Report Designer.


1. Destaque procedimento InformeClientes na rvore da aplicao.
2. Pressione o boto Propriedades.
3. Destaque Relatrio na caixa de dilogo Select Procedimento, desmarque a Use Assistente de
Procedimento (usando os procedimentos do Assistente) caixa, e pressione o boto Select.
EuCONTEDO 197

4. Pressione o boto Relatrio sobre a caixa de dilogo Procedure Propriedades.


Report Designer aparece. Aqui voc pode visualmente editar o relatrio e seus controles.
Relatrio desenhador representa os quatro elementos bsicos da estrutura de dados que mostra
quatro bandas relatrio: Page Header (cabealho da pgina), Detail (detalhe), rodap da pgina
(rodap) e Form (Formulrio). Cada banda uma unidade funcional, que imprime todos juntos.
Veja o captulodo Usurio'Guia de S intitulado Usando o Formatter relatrio para obter mais
informaes sobre as partes do relatrio e como que gera o mecanismo de impresso.

Para este relatrio, voc colocar controles nmero da pgina no topo, e colocar os campos do
arquivo de clientes na banda de detalhes.

197
198 CLARION 5 CLARION
Aprendiendo

Colocar uma cadeia


1. Escolha Controls String, String ou tomar a caixa de ferramentas Controles de ferramentas.
2. Clique na banda Page Header.
3. Clique direito sobre o controle e escolha Propriedades no menu de contexto.
caixa de dilogo Propriedades da caixa seqncia aparece.
4. Digite nmero de pgina :. No campo de texto e pressione o boto OK.

Colocar um modelo de controle para imprimir o nmero de pgina


1. Escolha Preencher Control Template , ou "pique" na caixa de controle Ferramenta modelo
controla ferramentas.
2. destaques ReportPageNumber e pressione o boto Select.
3. Clique direita da cadeia anteriormente localizado.

detalhe

uma banda de detalhe (detalhe) para cada registro do relatrio impresso. Para este procedimento,
voc vai colocar os campos em um bloco de matriz, que produz um relatrio de etiqueta de
endereamento.
1. Multiple escolher preencher os campos, ou clique na caixa de controle do dicionrio campo
controla ferramentas.
2. Na caixa de dilogo Selecionar campo, realce a pasta "todo" e pressione o boto Inserir.
3. Os clientes selecionam a caixa de dilogo Inserir arquivo caixa de arquivo e pressione o boto
Select.
4. Pressione o boto Edit.
5. KeyNumCliente ficar na caixa de dilogo Acesso Alterar chave, e pressione o boto Select.
6. Destaque CLI: Empresa na lista Campos e pressione o boto Select.
7. Clique na faixa de detalhe perto do canto superior esquerdo.
8. Destaque CLI: Nomes na lista de campos e pressione o boto Select.
9. Clique na banda de detalhes, logo abaixo do primeiro controle.
10. Destaque CLI: Sobrenomes na lista Campos e pressione o boto Select.
11. Clique na faixa de detalhe, direita do controle que voc acabou de colocar.
12. Destaque CLI: Endereo na lista Campos e pressione o boto Select.
13. Clique dentro da banda de detalhes, abaixo do segundo controle apenas colocado.

Ajustando a faixa de detalhes


Neste ponto, provavelmente muito pequeno lugar na banda, e tm para ampliar.
1. Pressione o boto Cancelar para sair do enchimento mltipla.
EuCONTEDO 199

2. Clique na faixa de detalhe, mas no em um dos cadeia de controlo. lida com rea de detalhes
aparecem.
3. Redimensionar, arrastando a ala central inferior, deixar espao para uma ou mais linhas.

Coloque os campos restantes


1. Multiple escolher preencher os campos, ou clique na ferramenta dicionrio campo nos
controles de caixa de ferramentas.
2. CLI esto: CP no campo Fields, e pressione o boto Select.
3. Clique na banda de detalhes, sob o controle final que foi colocado.
4. Destaque CLI: Cidade no campo Fields, e pressione o boto Select.
5. Clique na faixa de detalhe, direita do ltimo controle que tenha sido colocado.
6. Destaque CLI: Provncia no campo Fields, e pressione o boto Select.
7. Clique na faixa de detalhe, direita do ltimo controle que tenha sido colocado.
8. Pressione o boto Cancelar para sair do enchimento mltipla.
Note-se que tem o mesmo conjunto de ferramentas de alinhamento no Report Designer no
Designer do Windows (escolha a opo Mostrar Alignbox, para mostrar que caixa de
ferramentas flutuante).

Selecionando uma fonte de base para o relatrio


1. Escolha Editar propriedades Report para definir os atributos padro.

199
200 CLARION 5 CLARION
Aprendiendo

2. Pressione o boto Fonte.


3. Selecione uma fonte, estilo e tamanho para usar como base o relatrio.
Se voc no escolher uma fonte, impressora padro fonte usada.
4. Pressione o boto OK para fechar a caixa de dilogo Selecionar fonte.
5. Pressione o boto OK para fechar a caixa de dilogo Propriedades do relatrio.

Visualize o relatrio
1. Escolha Pr-Visualizao! para visualizar como ser a pgina impressa.
2. Destaque Detalhe na lista de detalhes e pressione o boto Adicionar repetidamente.
Isto preenche a pr-visualizao com vrias bandas "impressas" para ver como eles se parecem.
Como cada relatrio pode conter vrias bandas de diferentes tipos, voc selecione o que voc
quer ver antes de visualizao. Assim, o Report Designer saber o que a compor na tela.

3. Pressione o boto OK.


EuCONTEDO 201

4. Quando tiver terminado "preview", escolha Exibir a faixa!

5. Escolha Exit! para retornar caixa de dilogo Procedure Properties (e salvar seu trabalho).
6. Pressione o boto OK para fechar a caixa de dilogo Procedure Propriedades.
7. Escolha Salvar arquivo, ou pressione o boto Salvar na barra de ferramentas para salvar seu
trabalho.

relatrio de encomendas
Ento vamos criar um dos tipos mais comuns de relatrio. Uma ordem usa a maioria dos arquivos
no dicionrio de dados, e demonstra como criar quebras e totais do grupo. Ele tambm ir mostrar
como controlar quebras de pgina grupo com sede.

criao de relatrios

1. Destaque procedimento InformePedidos.


2. Pressione o boto Propriedades.
3. Destaque Relatrio na caixa de dilogo Selecionar tipo de caixa de Processo, evitar o uso de
Procedimento Wizard (limpar o Usar assistente procedimento de caixa), e pressione o boto
Select.

201
202 CLARION 5 CLARION
Aprendiendo

caixa de dilogo Propriedades da caixa de procedimento aparece.

relatrio de arquivos
1. Pressione o boto Arquivos na caixa de dilogo Procedure Propriedades.
caixa de dilogo arquivo aparece Definio esquemtica.
2. Realce a pasta "todo" e pressione o boto Inserir.
3. Os clientes selecionam a caixa de dilogo Inserir arquivo caixa de arquivo e pressione o boto
Select.
4. Pressione o boto Edit.
5. Destaque CLI: caixa de dilogo KeyNumCliente Mudana na tecla de acesso, e pressione o
boto Select.
Este relatrio ir processar todos os registros do arquivo Clientes ordenados por cusno.
6. Clientes Realce o arquivo e pressione o boto Inserir.
7. Selecione Pedidos de arquivo Box Inserir arquivo de dilogo e pressione o boto Select.
Isto ir processar todos os pedidos para cada cliente.
8. Ordens de destacar o arquivo e pressione o boto Inserir.
9. Marque a caixa de dilogo Inserir arquivo detalhe arquivo e pressione o boto Select.
Cada ordem impresso com todas as linhas de detalhe que lhes correspondem.
10. Detalhe Realce o arquivo e pressione o boto Inserir.
11. Marque a caixa de dilogo Inserir arquivo arquivo do produto, e pressione o boto Select.
Cada registro de detalhe vai pesquisar os produtos de registro de arquivo vinculados. Neste
ponto, a rvore de arquivos ser parecido com este:
12. Pressione o boto OK para retornar caixa de dilogo Procedure Propriedades.
EuCONTEDO 203

Configurando os recursos padro


1. Pressione o boto Relatrio.
2. Escolha Editar Relatrio Propriedades para definir os recursos padro do relatrio.
3. Pressione o boto Fonte.
4. Escolha uma fonte, estilo e tamanho para usar como uma fonte bsica deste relatrio.

Se voc no escolher uma fonte para o relatrio, ele impresso usando a fonte padro da
impressora. Voc deve escolher uma fonte que voc sabe que o usurio tenha instalado (fontes
seguras normalmente ser considerado que vm com o Windows).
5. Pressione OK para fechar a caixa de dilogo Selecionar fonte.
6. Pressione OK para fechar a caixa de dilogo Propriedades do relatrio.

Enchendo a pgina baseband

A "pgina de base" BAND (pgina Form) impresso uma vez para cada pgina do relatrio; mas o
seu contedo feita apenas uma vez, quando voc abre o relatrio. Isto o torna til para a
informao constante, que estar presente em cada pgina.

Colocar uma cadeia de caracteres


1. Escolha Controls String, ou tomar a caixa de ferramentas String Controla ferramentas.

2. Clique no formulrio web pgina.

3. Clique duas vezes no controle.

caixa de dilogo Propriedades da caixa seqncia aparece.

4. Digite ordem de compra no campo Texto.

5. Pressione o boto Fonte.

203
204 CLARION 5 CLARION
Aprendiendo

6. Escolha uma fonte, estilo e tamanho do texto (aqui seria apropriado uma fonte grande, negrito).

7. Pressione o boto OK para fechar a caixa de dilogo Selecionar fonte.

8. Pressione o boto OK para fechar a seqncia caixa de dilogo Propriedades.

9. Redimensionar o controle para que ele possa conter texto, arrastando as alas.

Colocar a prxima corda


1. Escolha Controls String, String ou selecione a caixa de ferramentas Controles de
ferramentas.

2. Clique na parte superior do formulrio de banda pgina, logo abaixo da ltima cadeia que
colocou.

3. Clique direito sobre o controle e escolha Propriedades no menu de contexto.

4. Digite o nome da sua empresa no campo de texto.

5. Pressione o boto Font e escolha uma fonte, estilo e tamanho adequado (apenas ligeiramente
menor do que o campo anterior seria timo aqui).

6. Pressione o boto OK para fechar a caixa de dilogo Selecionar fonte.

7. Pressione o boto OK para fechar a seqncia caixa de dilogo Propriedades.

8. Redimensionar o controle para que ele possa conter texto, arrastando as alas.
EuCONTEDO 205

Povoando a faixa de detalhes

A faixa de detalhe (detalhe) impresso sempre que um novo arquivo de informaes, leia "Filho"
no nvel mais baixo da rvore de arquivos. Pedidos para este relatrio, o nvel mais baixo o
arquivo "Detail" (lembre-se os produtos um arquivo de "consulta" muitos-para-um a partir do
arquivo detalhe).
1. Multiple escolher preencher os campos, ou clique na ferramenta dicionrio campo nos
controles de caixa de ferramentas.
2. Destaque Detalhe na lista de arquivos e escolha Retail Price: Quantidade na lista Campos e
pressione o boto Select.
3. Clique na faixa de detalhe perto do canto superior esquerdo.
4. Destaque Preo de varejo: partNum na lista Campos e pressione o boto Select.
5. Clique na faixa de detalhe, direita do primeiro controle.
6. Produtos em destaque na lista Arquivos e escolha PROD: Viso geral sobre a lista Campos e
pressione o boto Select.
7. Clique na faixa de detalhe, direita do controle anterior.
8. Destaque Detalhe na lista Arquivos e escolha Preo de varejo: ProdPrecio na lista Campos e
pressione o boto Select.
9. Clique na faixa de detalhe, direita do controle anterior.

205
206 CLARION 5 CLARION
Aprendiendo

10. InformePedidos dados locais esto na lista de arquivos e clique no boto Novo.
Ento voc pode adicionar uma varivel local sem ter que ir janela Propriedades do
Regimento, e pressione o boto de dados. Esta varivel usada para exibir o preo total para
cada linha de pedido.
11. Digite ItemTotal no campo Nome do campo.
12. Select decimais a partir da lista drop-down Tipo de Dados.
13. Digite 7 nos caracteres de campo (caracteres).
14. Tipo 2 no campo de casas decimais (Places) e pressione o boto OK.
15. Clique na faixa de detalhe, direita do controle final colocado.
16. Pressione o boto Cancelar para sair deste modo de operao.
17. Mover todos os controlos para o topo da banda de detalhe, alinhados horizontalmente, e ajustar
o tamanho da banda, a ser mal maior do que os prprios controlos.

Adicionando quebras de grupo

Precisamos imprimir informaes diferentes em cada ordem. Portanto, precisamos criar estruturas
quebrar (INTERVALO) para imprimir algo cada vez que voc alterar as informaes no arquivo
de Pedidos e cada vez que mudar os clientes informaes sobre o arquivo.

1. Escolha Bandas redor Break, e depois clique na banda de detalhes.


caixa de dilogo Propriedades da caixa de quebrar aparece.
2. Pressione a reticncias (...) ao lado do campo Varivel.
3. Os clientes esto na lista de arquivos e escolha CLI: cusno na lista Campos e pressione o boto
Select.
4. Tipo de CLI: NumClienteBreak etiqueta no rtulo, e pressione o boto OK.

na banda de detalhes, recuado esquerda, que est dentro do Quebra estrutura: um salto de
banda (Pausa [cusno CLI]) aparece.
EuCONTEDO 207

5. Escolha Bandas Sorrouding Break, e clique na banda de detalhes.


6. caixa de dilogo Propriedades da caixa de quebrar aparece.
7. Pressione a reticncias (...) ao lado do campo Varivel.
8. Ordens destaque Recebidos lista de arquivos e escolha PED: ordno na lista Campos e pressione
o boto Select.
9. Digite PED: NumPedidoBreak no campo Rtulo e pressione o boto OK.
O relatrio agora se parece com isso:

Criao de grupo de cabealhos e rodaps


1. Escolha Bandas grupo cabealho e clique no Break (PED: ordno) banda.
Grupo banda Header (PED: ordno) aparece acima da banda de detalhes. Esta banda impresso
cada vez que o valor PED campo: ordno mudar no incio de cada novo grupo de registros.
Vamos us-lo para imprimir o nome e endereo da empresa, juntamente com o nmero de
ordem ea data.
2. Escolha Bandas Grupo rodap, e clique no Break (PED: ordno) banda.
Detalhe abaixo da banda: a banda Grupo rodap (ordno PED) aparecer. Esta banda impresso
cada vez que o valor da PED: ordno mudana, no final de cada grupo de inscrio. Vamos us-
lo para imprimir a ordem total.
3. Clique direito sobre a banda Grupo rodap (PED: ordno) e escolha Propriedades no menu de
contexto.
caixa de dilogo Propriedades de Rodap caixa de pgina / grupo aparece.

207
208 CLARION 5 CLARION
Aprendiendo

4. Marque a caixa Pgina aps.


Isso far com que o mecanismo de impresso para imprimir esta banda, em seguida, iniciar o
processo de pgina estouro (Overflow pgina). o rodap banda (rodap da pgina) ser
composto, uma ordem de "nova pgina" para a impressora, ele ser enviado e, em seguida, o
cabealho banda (cabealho da pgina) na pgina seguinte composto.
5. Pressione o boto OK.
6. Escolha Bandas Grupo rodap, e clique no Break (CLI: cusno) banda.
Esta banda aparece abaixo do Grupo rodap (Ped: ordno). Ele ser impresso cada vez que o
valor do campo CLI: cusno mudana no final de cada grupo de registros. Ns vamos usar isso
para imprimir as informaes de resumo sobre ordens para cada empresa cliente.
7. Clique direito sobre a banda Grupo rodap (CLI: cusno) e escolha Propriedades no menu de
contexto.
8. Marque a caixa Pgina aps.
9. Pressione o boto OK.

Encher a banda cabealho grupo

Colocar campos Clientes


1. Multiple escolher preencher os campos, ou clique na ferramenta dicionrio campo nos
controles de caixa de ferramentas.
EuCONTEDO 209

2. Os clientes esto na lista de arquivos e escolha CLI: Empresa na lista Campos e pressione o
boto Select.
3. CLIC dentro da banda Group Header (PED: ordno) perto do canto superior esquerdo.
4. Destaque CLI: Nomes na lista de campos e pressione o boto Select.
5. Clique dentro da banda Group Header (PED: ordno), abaixo do primeiro controle.
6. Destaque CLI: Sobrenomes na lista Campos e pressione o boto Select.
7. Clique no Grupo Header (PED: ordno), controle de direito j colocado.
8. Destaque CLI: Endereo na lista Campos e pressione o boto Select.
9. Clique no Grupo Header (PED: ordno), abaixo do segundo controle definiu.
10. CLI esto: CP na lista Campos e pressione o boto Select.
11. Clique no Grupo Header (PED: ordno), sob a direo.
12. Destaque CLI: Cidade na lista Campos e pressione o boto Select.
13. CLIC no grupo cabealho (PED: ordno), ao lado do ltimo controle que ele colocou.
14. Destaque CLI: Provncia na lista Campos e pressione o boto Select.
15. CLIC no grupo cabealho (PED: ordno), CLI direita: City.

Coloque os campos do arquivo ordens


1. Encomendas recebidas lista de verificao de arquivos e escolha PED: ordno na lista Campos e
pressione o boto Select.
2. CLIC no grupo cabealho (PED: ordno) perto do canto superior direito.
3. Destaque PED: DataDoPedido na lista Campos e pressione o boto Select.
4. Clique dentro da banda do cabealho de grupo (PED: ordno), colocado sob o controle final.
5. Pressione o boto Cancelar para fechar a caixa de dilogo Selecionar campo e sair deste modo.

colocao permanente de texto e coluna


1. Escolha Controls corda, ou um "pique" na caixa de ferramentas String Controla ferramentas.
2. CLIC dentro da banda Group Header (PED: ordno), deixou nmero de ordem de controle que
voc acabou de colocar.

3. Tipo de ordem Nmero: Campo de texto na caixa de ferramentas de propriedade e pressione


TAB.

4. Escolha Controls corda, ou um "pique" na caixa de ferramentas String Controla ferramentas.

5. CLIC dentro da banda Group Header (PED: ordno), deixou data de controle.

6. Data Tipo: Campo de texto na caixa de ferramentas de propriedade e pressione TAB.

209
210 CLARION 5 CLARION
Aprendiendo

7. Escolha Controls corda, ou um "pique" na caixa de ferramentas String Controla ferramentas.

8. CLIC dentro da banda Group Header (PED: ordno), esquerda sob Cliente.

9. Digite campo Quantidade na ferramenta Caixa de texto de propriedade e pressione TAB.

10. Escolha Controls corda, ou um "pique" na caixa de ferramentas String Controla ferramentas.

11. CLIC dentro da banda do cabealho de grupo (PED: ordno), para a direita de controle final
colocado.

12. Produto campo Tipo na ferramenta Caixa de texto de propriedade e pressione TAB.

13. Escolha Controls corda, ou um "pique" na caixa de ferramentas String Controla ferramentas.

14. Clique dentro da banda Group Header (PED: ordno), direita da ltima cadeia de caracteres
colocado acima do Controle DETAL: Detalhe Taxa em banda.

15. Tipo de campo Preo unitrio na ferramenta Caixa de texto de propriedade e pressione TAB.

16. Escolha Controls corda, ou um "pique" na caixa de ferramentas String Controla ferramentas.

17. CLIC dentro da banda Group Header (PED: ordno), direita da ltima seqncia de caracteres
situados diretamente acima do controle ItemTotal na banda de detalhes.

18. campo Total tipo de item na ferramenta Caixa de texto de propriedade e pressione TAB.

Colocar uma linha grossa sob os ttulos


1. Escolha Controls Line, ou cortar na caixa de ferramenta Line Controles ferramentas.

2. CLIC dentro da banda do cabealho de grupo (PED: ordno) com o nmero corrente.

3. Ajustar a linha arrastando as alas at que aparea largura de todos os ttulos das colunas.

4. Boto direito do mouse e escolha Propriedades no menu de contexto.


5. Digite 50 no campo de largura de linha (Linha de largura).
Assim, a linha engrossar.
6. Pressione o boto OK para fechar a linha de caixa de dilogo Propriedades.
O relatrio agora deve ser algo como isto:
EuCONTEDO 211

Encher a banda rodap de grupo

Colocar texto constante e campo total


1. Escolha Controls corda, ou um "pique" na caixa de ferramentas String Controla ferramentas.
2. CLIC dentro da banda Grupo rodap (PED: ordno), no meio da banda.
3. Classe Total Order: Campo de texto na ferramentas caixa de propriedades e pressione TAB.
4. Escolha Controls corda, ou um "pique" na caixa de ferramentas String Controla ferramentas.
5. Clique dentro da banda Grupo rodap (PED: ordno), direita da string apenas colocado.
6. Boto direito do mouse e escolha Propriedades no menu de contexto.
7. Verifique a varivel string caixa.
8. Pressione a reticncias (...) o uso no campo.
9. InformePedidos dados locais esto na lista de arquivos, escolha ItemTotal campo Fields, e
pressione o boto Select.
10. Digite @ n9.2 no campo do formato de exibio (Foto). Isto ir formar "em espanhol" total:
com pontos nas separaes de mil e uma vrgula como separador decimal.
11. Escolha Soma de lista drop-down Tipo total.

211
212 CLARION 5 CLARION
Aprendiendo

12. Escolha PED: NumPedidoBreak Na lista drop-down Reset.

13. Pressione o boto OK.


Ento, todo o contedo da ordem ItemTotal ser adicionado, e ir reiniciar quando voc alterar
o valor no PED: ordno.

Colocar uma linha do total


1. Escolha Controls Line, ou cortar na caixa de ferramenta Line Controles ferramentas.
2. CLIC dentro da banda Grupo rodap (PED: ordno) em cheques que voc acabou de colocar.
3. Ajustar a linha arrastando as alas at que a largura de todos os controles.
4. Boto direito do mouse e escolha Propriedades no menu de contexto.
5. Digite 20 no campo de largura de linha (Linha de largura).
Ento engrossa uma linha de bit.
6. Pressione o boto OK para fechar a linha de caixa de dilogo Propriedades.
EuCONTEDO 213

Enchendo a banda rodap de grupo "Clientes"

Colocar texto constante.


1. Escolha String Controla ou ferramentas "pique" na Cadeia Box Controles ferramentas.
2. CLIC dentro da banda Grupo rodap (CLI: cusno), metade da banda.
3. Escrever um Comentrio Order para: campo no PropertyBox ferramentas da caixa de texto.
4. Escolha Controls corda, ou um "pique" na caixa de ferramentas String Controla ferramentas.
5. CLIC dentro da banda Grupo rodap (CLI: cusno), abaixo do texto que voc acabou de
colocar.
6. Notas de ordem total Tipo: Campo de texto nas ferramentas caixa PropertyBox, e pressione
TAB.
Colocar todos os campos
1. Escolha Controls corda, ou um "pique" na caixa de ferramentas String Controla ferramentas.
2. CLIC dentro da banda Grupo rodap (CLI: cusno), direita do texto que voc acabou de
colocar.
3. Boto direito do mouse e escolha Propriedades no menu de contexto.
4. verifique varivel string a caixa.

213
214 CLARION 5 CLARION
Aprendiendo

5. Pressione a reticncias (...) o uso no campo.


6. InformePedidos dados locais esto na lista de arquivos e clique no boto Novo.
7. ContadorPedidos digitar no campo Nome.
Este campo ser impresso o nmero de pedidos impressos para cada cliente.
8. LONGO escolher a lista drop-down Tipo de Dados.
9. @ Tipo N3 no campo da imagem e pressione o boto OK.

10. Select Count (contagem) na lista suspensa Tipo total.


11. selees CLI: NumClienteBreak Na lista drop-down Reset.
Este o mesmo tipo de campo totalizador colocada no p do grupo PED: ordno, mas apenas
ser restaurada quando muda CLI: cusno.
12. Selecione a guia Extra.
13. PED Destaque: marcadores de lista NumPedidoBreak (contagens) e pressione o boto OK.
Este campo bolsas de contar o nmero de ordens que so impressos para cada cliente.
Bookmark lista (Tallies) permite que voc selecione os pontos onde o total aumentado. PED
selecionado: NumPedidoBreak da lista, a conta vai aumentar apenas no incio de cada nova
ordem.
14. Escolha Controls corda, ou um "pique" na caixa de ferramentas String Controla ferramentas.
15. Clique dentro da banda Grupo rodap (CLI cusno), direita da string apenas colocado.
16. Boto direito do mouse e escolha Propriedades no menu de contexto.
17. Verifique a varivel string caixa.
18. Pressione a reticncias (...) o uso no campo.
EuCONTEDO 215

19. InformePedidos dados locais esto na lista Arquivos e escolha ItemTotal na lista Campos e
pressione o boto Select.
20. Escolha Soma de lista drop-down Tipo total.
21. Selecione CLI: NumClienteBreak Na lista drop-down Reset.
Este o mesmo tipo de campo totalizador esto localizadas no sop do grupo PED: ordno, mas
apenas ser restaurado quando voc altera o CLI nmero: cusno.
22. Pressione o boto OK.
Field e sair
1. Escolha Populate Vrios campos, ou clique na ferramenta dicionrio campo nos controles
de caixa de ferramentas.
2. Os clientes esto na lista Arquivos e selecione CLI: Empresa na lista Campos e pressione o
boto Select.
3. CLIC dentro da banda Grupo rodap (CLI: cusno), direita do texto Resumo do Pedido para:
que foi colocado.
4. Pressione o boto Cancelar para sair deste modo de operao.
O layout do relatrio est completo.

5. Escolha Exit! para retornar para o procedimento caixa de dilogo Propriedades (certifique-se
de salvar o layout).

Adicionando uma frmula

215
216 CLARION 5 CLARION
Aprendiendo

Para tornar o campo ItemTotal contm a quantidade certa de cada registro de detalhes do pedido,
voc deve adicionar uma frmula para o procedimento.

1. Pressione o boto sobre as frmulas de caixa de dilogo Propriedades Procedimento de.


2. Pressione o boto Novo nas frmulas de caixa de dilogo.
O editor de Frmula aparece.
3. Tipo de Item Frmula Total (ou expresso similar) no campo Nome.
4. Pressionar os pontos de reticncias (...) no campo Classe.
5. Antes Detalhe Destaque Imprimir ( "Antes detalhes de impresso") na lista de classes de
modelo.
A classe indica Detalhe Imprimir Antes de relatar modelo para realizar o clculo sempre que
for imprimir um detalhe.
6. Pressione a reticncias (...) no campo Resultado.
7. InformePedidos dados locais esto na lista de arquivos, selecione ItemTotal lista Campos e
pressione o boto Select.
8. Pressione o boto de dados no grupo Operandos.
9. Realce o arquivo na lista Detalhe arquivos, selecione Preo de varejo: Nmero de lista Campos
e pressione o boto Select.
Isso coloca o campo selecionado dentro de Declarao. O ltimo contm a expresso que est a
ser construdo. Tambm possvel escrever diretamente neste campo, se desejado.
10. * Pressione o boto no grupo de operadores.
11. Pressione o boto de dados no grupo Operandos.
12. Realce o arquivo na listagem Arquivos Detalhe, selecione Preo de varejo: lista ProdPrecio
Fields, e clique no boto Select.
13. Pressione o boto de verificao para verificar a sintaxe da expresso.
14. Pressione o boto OK para fechar o Editor de Frmula.
15. Pressione o boto OK para fechar a caixa de dilogo e retornar para Propriedades do
Procedimento frmulas.

Adicionando registros de filtro


Para garantir que o relatrio s imprimir os formulrios de ordem para as empresas que tm
ordens, vamos incluir um registro de filtro (filtro de registro).
1. Pressione o boto Propriedades do relatrio na caixa de dilogo Procedure Propriedades.
a caixa de dilogo Propriedades do Relatrio aparece.
2. Tipo PED: ordno <> 0 no campo Filtro Record.
EuCONTEDO 217

Isto ir eliminar todos os clientes que no fizeram pedidos. Internamente, o modelo de relatrio
gera uma estrutura VISTA (vera referncia da linguagem). Esta estrutura faz VIEW "externo
Join" arquivos na rvore de arquivos. "Junte-se External" (associao externa) uma expresso
comum na teoria de bancos de dados relacionais: meiosVIEWEle vai apelo a todos os registros
no Pai arquivo, se eles tm crianas ou registros no vinculados. Se voc encontrar um registro
pai sem Filho, os campos de estas ltimas so consideradas em branco ou "zero", embora no
so vlidos nos dados de arquivo Pai. Portanto, esta a condio que ir verificar.
expresso PED: ordno <> 0 verifica se o campo de mesmo nome tem um valor diferente de
zero. Uma vez que este o campo de chave do arquivo para que cria o link para o registro de
cliente relacionado deve conter um valor, se houver pedidos para o cliente atual. Se PED:
ordno zero, o registro atual ignorada Cliente ( "vazou"). Isso elimina a impresso de Pai
registros ligados sem filhos (neste caso, os clientes sem ordens).
Nota: Se voc tem dificuldade em colocar os sinais <e> (ALT + ALT + 60 e 62),
voc pode usar a expresso equivalente "NO =". Leria: PED: NO ordno
= 0.
3. Pressione o boto OK.

Mudana de a janela indicador


1. Pressione o boto Janela na caixa de dilogo Procedure Propriedades.
2. Carregando ... escrever campo ordem na ferramenta Caixa de texto propriedade.
3. Escolha Exit! para retornar caixa de dilogo Procedure Propriedades.

Para fora e salva


1. Pressione o boto OK na caixa de dilogo para fechar Propriedades do Procedimento.
2. Escolha Salvar arquivo, ou pressione o boto Salvar na caixa de ferramentas.

Relatrio de alcance limitado

217
218 CLARION 5 CLARION
Aprendiendo

(Relatrio limitada Range)


Agora, vamos limitar o mbito de registros a serem impressas.

criao de relatrios
1. Destaque relatrio InformePedidos.
2. Copie o procedimento: Procedimento Escolha Copiar ...
caixa de dilogo caixa Novo Procedimento aparece.
3. Tipo InformePedidosCliente e pressione o boto OK.
O procedimento copiada aparece na rvore da aplicao, substituindo o procedimento de
"fazer" ( "todo") que estava no local.
Modificao do novo relatrio
1. Destaque procedimento InformePedidosCliente.
2. Boto direito do mouse e escolha Propriedades no menu de contexto.
3. Incorpora pressione o boto.
4. Toda a imprensa Contrato o boto.
Isto tornar mais fcil para localizar o ponto desejado incorporado.
5. Objetos locais Localize a pasta, e clique no sinal + para expandir seu contedo.
modelos ABC gerado cdigo orientado a objeto. Cada instncia do processo um conjunto de
objectos que so derivados a partir deBiblioteca ABC. Objetos de pastas locais (objetos locais)
exibe todos os objetos e mtodos que podem ser substitudos no processo, simplesmente
absorvendo prprio cdigo para aumentar a funcionalidade Biblioteca ABC, Para mais
informaes sobre esta tcnica poderosa, consulte os artigos e fcil em OOP Programao
Orientada a Objetos no Guia manual do Programer.
6. ThisWindow localize a pasta, clique para expandi-lo.
7. Coloque o Init PROCEDIMENTO (), BYTE, pasta virtual e clique para expandi-lo.
8. CDIGO localize a pasta e clique para expandi-lo.
9. Ilumine os arquivos abertos e pressione o boto Inserir.
Este ponto incorporado est no incio do procedimento, antes que o relatrio comeou a
processar a informao. importante que os arquivos para o relatrio j esto abertos, porque
chamar um outro procedimento para que o usurio selecione um registro de cliente. Se o
relatrio no arquivos j aberto, o procedimento para abrir o arquivo chamados clientes para
seu prprio uso, e depois desligar, que perderia as informaes que precisamos para o relatrio.
Isto tem a ver com multithreading einterfaceDocumento mltipla (MDI); Para mais
informaes, consulte segmento em referncia da linguagem.
10. Destaque Fonte ( "Fonte") e pressione o boto Select para ligar para o editor de texto.
11. Digite o seguinte cdigo:
EuCONTEDO 219

Pedido global = SelectRecord


Procurar nesta cdigo configura um procedimento para a seleo de um registro (boto Select
permite Browse procedimento).
12. Escolha SAIR! para retornar caixa de dilogo Fonte incorporado.
13. Realce o cdigo fonte (SOURCE) que voc acabou de digitar e pressione o boto Inserir.
14. Chamar um procedimento destaques e pressione o boto Select.
15. Escolha VerClientes de a lista suspenso e pressione o boto OK.
Assim, uma chamada para o procedimento VerClientes (browse) criado para permitir que o
usurio selecione o cliente cujas ordens esto sendo impressas

Note-se que duas entradas aparecem agora sob o ponto insero. Em cada ponto, voc pode
colocar como muitos itens como voc deseja, misturando modelos de cdigo (cdigo de
templates) com as suas prprias chamadas para o cdigo-fonte (Source) ou procedimentos
(procedimento). Voc tambm pode mover itens individuais em torno do ponto de insero,
alterao da ordem lgica de execuo (que o primeiro na primeira corrida). Note-se que
mudana vai alterar a prioridade opo (Prioridade) atribuda ao item movido se voc tentar
mover um item maior prioridade sobre um com uma prioridade mais baixa.
16. Pressione o boto Fechar para retornar caixa de dilogo Procedure Propriedades.
Configurao de gama
1. Pressione o boto Propriedades do Relatrio.
a caixa de dilogo Propriedades do Relatrio aparece. Esta caixa permite que voc defina
registros filtros ou limites de faixa (alm dos campos quentes e filtra detalhe): verdo Usurio'S
Guia.
registros de filtros (filtros registro) e ou do alcance da pesquisa (limites da faixa) so muito
semelhantes. Um filtro de registro uma expresso condicional para eliminar registros
indesejados no relatrio, enquanto um limite de alcance limitado impressa registros para
apenas aqueles que correspondam na sua chave. Ambos podem ser usados para criar relatrios
em um subconjunto dos arquivos. A diferena que o limite de alcance opera em uma chave,

219
220 CLARION 5 CLARION
Aprendiendo

enquanto os filtros, no. Assim, os ltimos so muito flexvel; Alcance e limites muito rpido.
Eles podem ser utilizados simultaneamente por seleco de um limite de intervalo e, em
seguida, filtrando registos desnecessrios dentro desse limite.
2. Selecione os limites de Alcance guia.
3. Pressionar os pontos de reticncias (...) Limite faixa de campo.
4. Destaque CLI: cusno, e pressione o boto Select.
5. Deixe a Faixa Limite Type (tipo de faixa de limite) como "valor presente" (valor atual), e
pressione o boto OK.
Isso indica que qualquer valor (valor atual) presente no campo no incio do relatrio atingir o
seu limite. Desde o usurio escolher um registro de cliente no procedimento VerClientes, o
valor correto ser no campo CLI: cusno para comear.
Exit Saving
1. Pressione o boto OK na caixa de dilogo para fechar Propriedades do Procedimento.
2. Escolha Salvar arquivo, ou pressione o boto Salvar na barra de ferramentas para salvar seu
trabalho.

Order relatrio individual


Em seguida, imprimir uma nica ordem escolhida a partir do visor ordem (browse) suave.

criao de relatrios

1. Destaque procedimento InformePedidosCliente.


2. Escolha Copiar Procedimento ...
caixa de dilogo caixa Novo Procedimento aparece.
3. Digite InformeUnPedido na caixa de entrada de dados e pressione o boto OK.
4. Mesmo pressione o boto (mesmo nome) na caixa de dilogo Nome do Procedimento
confronto.
O procedimento copiado na rvore aplicativo isolado. Aps a concluso do relatrio, "ns
conectar linhas".
Apagar o cdigo introduzido
1. Destaque procedimento InformeUnPedido.
2. Boto direito do mouse e escolha Propriedades no menu de contexto.
3. Incorpora pressione o boto.
4. Cheio pressione o boto Next (na extrema direita da barra de ferramentas).
5. Pressione o boto Excluir.
6. Responder Sim (ou "Sim") pergunta sobre se voc tem certeza (Tem certeza?)
7. Prima Apagar e responder Sim novamente (ou "Sim") pergunta sobre se voc tem certeza.
EuCONTEDO 221

8. Pressione o boto Fechar.


Alterar a rvore de arquivos
Em primeiro lugar, preciso mudar a ordem da rvore de arquivos. Acabar com os mesmos
arquivos, mas o arquivo em vez Clientes como arquivo primrio (a primeira rvore), precisamos
do arquivo ordens o arquivo principal para este procedimento, assim voc pode facilmente
limitar o escopo para um nico pedido.
1. Pressione o boto Files.
2. Clientes Realce o arquivo e pressione o boto Excluir.
Isso faz com que todos os arquivos desaparecem.
3. Iluminar pasta "todo" e pressione o boto Inserir.
4. Selecione Pedidos de arquivo Box Inserir arquivo de dilogo e pressione o boto Select.
5. Pressione o boto Edit.
6. Ilumine KeyNumPedido na caixa Acesso Alterar chave da caixa e pressione o boto Select.
7. Ordens de destacar o arquivo e pressione o boto Inserir.
8. Marque a caixa de dilogo Inserir arquivo detalhe arquivo e pressione o boto Select.
9. Detalhe Realce o arquivo e pressione o boto Inserir.
10. Marque a caixa de dilogo Inserir arquivo arquivo do produto, e pressione o boto Select.
11. Ilumine arquivo novamente solicitado e pressione o boto Inserir.
12. Os clientes selecionam a caixa de dilogo Inserir arquivo caixa de arquivo e pressione o boto
Select. Neste ponto, a rvore de arquivos deve ficar assim:

Ns selecionamos os mesmos arquivos, mas agora o arquivo principal ordens, e vai consultar
o registo de cliente ligado. Isto importante porque ns limitar este relatrio a uma nica
ordem e que seria muito mais difcil de fazer se o arquivo principal ser clientes.
13. Pressione o boto OK.

221
222 CLARION 5 CLARION
Aprendiendo

Esses valores podem variar limite


1. Pressione o boto Propriedades do Relatrio.
2. Selecione os limites de Alcance guia.
3. Pressione as reticncias (...) junto zona limite campo.
4. Destaque PED: ordno e pressione o boto Select.
5. Vamos "Valor Presente" (valor atual) como zona limite Tipo e pressione o boto OK.
Valor atual indica que o valor neste campo quando voc iniciar o relatrio o valor
pelo qual este ser limitado. Uma vez que o usurio executar a partir do procedimento
VerPedido, o valor correto ser no PED campo: ordno quando o relatrio comea.
Modificao do novo relatrio
Agora, temos de mudar o prprio relatrio, para imprimir uma nica ordem.
1. Pressione o boto Relatrio.
2. Right Click sobre o Break (CLI: cusno) banda e escolha Excluir no menu de contexto.
Isso remove no s o grupo de salto (Grupo Ruptura), mas tambm o correspondente Grupo

Pie, que nos deixa com um relatrio como este:


3. Escolha Exit! para retornar caixa de dilogo Procedure Propriedades.
Trabalhar fora e salva
1. Pressione o boto OK na caixa de dilogo para fechar Propriedades do Procedimento.
2. Escolha Salvar arquivo, ou pressione o boto Salvar na barra de ferramentas para salvar seu
trabalho.
EuCONTEDO 223

linhas de conexo
1. Destaque procedimento VerPedidos.
2. Right Click e escolha Janela no menu de contexto.
3. Escolha Preencher Control Template ou Control-clique sobre a ferramenta de modelo na
caixa de ferramentas de controle (inferior esquerdo).
4. Ilumine BrowsePrintButton e pressione o boto Selecionar.
5. Ilumine BrowsePedidos e pressione o boto Selecionar.
6. Boto direito do mouse no boto Excluir para localizar o novo controle de boto.
7. Right Click no boto Novo e escolha Propriedades no menu de contexto.
8. Digite Print & Order no campo campo.
9. Escrever? ImprimePedido no campo Uso.
10. Selecione a guia Aes.
11. Select InformeUnPedido Boto Imprimir a partir da lista drop-down.
Modelo Este controle projetado especificamente para chamar um escopo do relatrio
iluminado limitado ao registro na caixa de lista selecionada (Procurar em ordens). As Ordens
buffer de registro de arquivo contm o valor correto para operar o mbito limitado o valor atual
no relatrio relativo a uma ordem. Alm disso, a ao automaticamente adicionado ao menu
de contexto Browse.
12. Pressione o boto OK. O design da tela deve ser algo como isto:

13. Escolha Exit! para retornar rvorea aplicao.


14. Escolha Salvar arquivo, ou pressione o boto Salvar na barra de ferramentas para salvar seu
trabalho.

223
224 CLARION 5 CLARION
Aprendiendo

Que segue?

Parabns, voc chegou ao final do workshop sobre o Gerador de Aplicativos. Bem-vindo ou


acolher a crescente comunidade de desenvolvedores Clarion!.
Embora tenhamos feito a aplicao no tem a largura de um "programa comercial" tem servido
para demonstrar normal usar o Gerador de Aplicao e todas as suas ferramentas para criar um
aplicativo que executa algumas tarefas de processo bastante elaborado. Ao longo do caminho, voc
usou a maior parte do alto nvel conjunto de ferramentas de Clarion, e viu o quanto ele pode fazer
por voc, sem escrever cdigo. Ele tambm tem visto um pouco de cdigo fonte inserida pode
adicionar cdigo gerado funcionalidade modelos extra, e que pode ser facilmente esquecido
biblioteca de classes pr-configurado ABC.
Um breve passeio dos recursos disponveis
Voc tem muitos recursos disponveis para ajud-lo programar com Clarion. Aqui est uma breve
turn de dois dos mais importantes de que dispe:
1. Escolha Ajuda ndice.
Esta a pgina Contedo do extenso sistema de ajuda online.
2. ... Como eu pressionar o boto? ( "Como voc ...?).
Isso abre o arquivo de ajuda da Clarion, e leva a uma seo de perguntas frequentes com
respostas. Esta lista de temas o primeiro lugar para procurar quando voc tem dvidas sobre
programao em Clarion, comeando com "Como ...?" feita. Estas questes resolvidas
muitas das perguntas comuns que so recm-chegados ao Clarion. Muitas vezes as respostas
vai encontrar l.
3. Pressione o boto Voltar e, em seguida, o Guide to boto Exemplos.
Este tpico fornece hipertexto salta para o tratamento de todos os programas de exemplo que
vm com Clarion. L voc vai encontrar vrias dicas, truques e tcnicas demonstradas nos
exemplos, para atender seus prprios programas.
4. Pressione o boto Voltar e, em seguida, o boto Late Breaking News.
Esta edio oferece a mais recente e atualizada na ltima verso do Clarion de ter instalado
informaes. Voc deve sempre consultar esta seo quando uma atualizao de programa.
Normalmente existem detalhes de ltima hora que esto documentados apenas nesta seo.
Esta uma leitura altamente recomendada.
5. Fechar a ajuda on-line e, sem sair do programa, selecione o gerenciador de arquivos
(Explorador do Windows 95,98 ou NT) do sistema operacional.
6. Clarion Coloque o CD no dispositivo de CD e navegue at os docs \.
7. D um duplo clique no arquivo C5-UG.pdf (deve ter o Acrobat Reader instalado CD Clarion
para ler este arquivo).
esta chamada do Usurio`S Guiano Acrobat Reader. Este o completo, online e livro
disponvel a partir do CD (ou disco rgido, se voc copi-lo l). Isso significa que o tamanho eo
peso de um CD pode ter toda a documentao Clarion em qualquer lugar (usando o texto
procura Acrobat) disponvel. Note-se que a esquerda um grupo de "hops" disponvel a partir
deA tabelaContedo. Voc tambm pode ir diretamente a qualquer pgina individual que voc
escolher (e agora mostrar-lhe como).
EuCONTEDO 225

8. Pressione o controle VCR "fim do documento" (o tringulo apontando para a direita com uma
linha vertical no final), e pressione algumas vezes o boto de controle "pgina anterior" (ele se
parece com um tringulo apontando esquerda).
Ele agora est olhando para a posio de ndice do UsurioGuia `S.
9. Selecione o "zoom in" (uma lupa com sinal de mais) e clique em qualquer lugar da pgina (se o
cursor muda para um "apontar o dedo", em seguida, ir diretamente para o item aponta para, em
vez de fazer uma ferramenta de abordagem ).
Voc pode "zoom in" a qualquer texto que voc escolher usar esta ferramenta. Observe o
nmero da pgina de qualquer item que voc deseja.
10. CTRL + CLICK para retornar exibio anterior.
11. Pressione CTRL + 5 para ir para a caixa Ir caixa de dilogo pgina Para, digite o nmero da
pgina que voc escreveu para baixo, e pressione o boto OK.
Agora voc pode ver como fcil ir a qualquer lugar que voc deseja.
12. Feche o arquivo e sair do Acrobat Reader.
Onde aprender mais?
Onde devo ir daqui para aprender mais? Os melhores lugares (alm de criar um aplicativo em si)
so:
O Manual de Aplicao explica o Clarion ABC ABC Modelos de biblioteca; todas as
ferramentas oferecidas pelo Gerador de Aplicao.
O Workshop Clarion em Idioma no prximo captulo o melhor lugar para comear a aprender
a lngua.
Os utilizadores registados a Argentina e outros pases de lngua espanhola tm acesso ao
suporte tcnico atravs da Internet em http://www.unisoft.com.ar endereo (ou tambm
www.clarion.com.ar mail :. soporte@unisoft.com.ar ) por servios de grupos de discusso e
FTP. Uma equipe de tcnicos locais experientes (CST: Suporte Clarion Equipe Argentina) ir
responder s suas perguntas. Eles tambm podem ser dirigidas para o fax: (+541) 374-9469.
TopSpeed oferece seminrios educacionais em vrios locais. Chamada de Atendimento ao
Cliente (800)354-5444 ou (954)785-4555 nmeros para informaes.
CompuServe tipo GO Topspeed para entrar no frum de suporte tcnico TopSpeed, ou - na
Internet, para o grupo de notcias comp.lang.clarion por qualquer servidor Usenet (Altamente
recomendado!).
Boa sorte, e continuar a trabalhar: o poder da programao que coloca em suas mos Clarion
cresce medida que voc aprender mais sobre ele!

- CUrsillo ON LPERSONALIDADE CLarion

225
226 CLARION 5 CLARION
Aprendiendo

linguagem de programao Clarion

ambiente de desenvolvimento baseado em aplicaes Clarion a linguagem da Clarion


progamacin. uma linguagem de quarta gerao / 4GL), que voltado para aplicaes de
negcios e propsitos gerais. A primeira orientao meios contendo estruturas de dados e
altamente optimizado para as ordens de programao e manuteno da base de dados. tambm
de uso geral, porque uma linguagem compilada (uninterpreted) e tem um conjunto de
funcionalmente semelhante ao de outras linguagens de terceira gerao (tais como C / C ++,
Modula-2, Pascal, etc.) ordens. Tentamos mais amplamente essa distino nas primeiras pginas
deo Language Reference.

Neste ponto, voc deve ter concludo todos os cursos sobre o Gerador de Aplicativos em captulos
anteriores. O objetivo deste curso apresentar os fundamentos da linguagem Clarion,
particularmente na sua orientao para a programao de negcios usando o paradigma de
gerenciamento do Windows prprios eventos. Palavras-chave linguagem (idioma palavras-chave)
so mostrados em maisculas, e este workshop se concentra no uso de cada palavra-chave e sua
interao com outros elementos da linguagem nica no contexto especfico em que ele est sendo
usado. Deve ser sempre consultadoa referncia da linguagem Para uma explicao mais completa
de cada palavra-chave e capacidades individuais.

Ao concluir este curso de curta durao, voc vai estar familiarizado com:
A estrutura bsica de um programa Clarion.
A estrutura mais comum para o cdigo de manipulao de eventos.
Como compilar e programas de link manuscrita.

programao baseada em evento

Windows programas so geridos pelos acontecimentos. O usurio faz com que um evento clicando
com o mouse sobre a tela de controle ou pressionando uma tecla. Cada ao do usurio faz com
que o Windows para enviar um programa de mensagem (ou evento) para a janela proprietrio,
indicando que o usurio fez.
Assim que o Windows tenha enviado a mensagem indicando um evento, o programa tem a
oportunidade de lidar com isso de forma adequada. Isto significa que o paradigma de programao
do Windows exatamente o oposto do que acontece em DOS. No sistema operacional Windows,
ele diz ao programa que o usurio tenha feito, em vez do programa informa ao sistema operacional
o que fazer.

Este o conceito mais importante na programao do Windows: o usurio est sempre no controle
(ou deveria ser). Portanto, esses programas so reativa ao invs de pr-ativa; sempre lidar com o
que o operador tem, em vez de dizer-lhe o que fazer a seguir. O exemplo mais comum disso a
EuCONTEDO 227

entrada de dados caixa de dilogo. Na maioria dos programas DOS, o usurio deve seguir um
caminho de um campo para inserir dados. Voc sempre deve inserir dados em um campo antes de
prosseguir para a prxima. Isso faz com que a validao de dados simples: basta executar
somente o usurio deixar o campo.

Em programas do Windows, o operador pode usar o mouse ou um atalho de teclado para comear
a partir de um controle para outro, a qualquer momento, em nenhuma ordem particular, e omitindo
percorrer os controles que voc v o ajuste. Portanto, voc deve executar duas vezes a receita de
dados de validao, para ter certeza de que ele executado pelo menos uma vez: quando o usurio
acabou de entrar controle de dados, e novamente quando voc pressiona OK para sair caixa de
dilogo. Se no, ento executado, dados importantes podem ser omitidos. Isso faz com que os
programas do Windows so reativas ao invs de pr-ativa.

Ol do Windows

Tradicionalmente, todos os cursos em uma linguagem de programao que comea com a criao
de um programa tipo: "Ol, mundo", e este tambm.

Ponto de partida:
O ambiente Clarion deve ser aberto, e aplicao
TUTORIAL.APP fechado.

Criao Source File

1. Por instrumento adequado para o seu sistema operacional (Gerenciador de Arquivos, Explorer,
etc.), criar um novo diretrio sob o subdiretrio chamado Clarion5 Language. (No Windows
95, voc pode pressionar KEY-OF-JANELA + E para acessar o Explorer).
2. Voltar para Clarion
3. Escolha Arquivo novo fonte.
nova caixa de dilogo aparece. Este um padro do Windows caixa de dilogo Abrir arquivo,
que permite que voc altere o diretrio e digite o nome do arquivo.

227
228 CLARION 5 CLARION
Aprendiendo

4. Selecione o diretrio \ CLARION5 \ idioma.


5. Digite Ol no campo Nome do arquivo.
6. Pressione o boto Salvar.
Isso cria um HOLA.CLW arquivo vazio (.CLW a extenso padro para arquivos de origem), e
abre o Editor de Texto.

Arquivo de projeto Criao


1. escolha New Project.
nova caixa de dilogo New Project aparece. Quando totalmente codificado mo, um arquivo
de projeto (HOLA.PRJ) para controlar o processo de compilao e tambm necessrio
linkeado.
2. Escolha o projeto manuscrita boto de rdio (Project Coded mo).

3. Tipo C: \ CLARION5 \ idioma no diretrio caixa de trabalho (diretrio de trabalho) ou


pressione o boto reticncias para escolher o diretrio na caixa de dilogo Diretrio de
Trabalho Mudana.
Quando voc escreve um programa com a mo, o diretrio que contm o arquivo de projeto
(.PRJ) torna-se o diretrio de trabalho do projeto. Quando selecionada, Clarion mudar
automaticamente para o diretrio.
4. Pressione o boto OK.
a caixa de dilogo New Project aparece Arquivo.
EuCONTEDO 229

5. Digite caixa Ol do Windows Projeto Ttulo e pressione TAB.


6. Digite HOLA.CLW na caixa Arquivo Principal e pressione TAB.
Depois de ter chamado o mdulo de projeto de cdigo principal, os outros controles so
automaticamente preenchidos com os valores predefinidos.

7. Pressione o boto OK.


caixa de dilogo Box Project Editor aparece. Este controla os mdulos de fonte que o
compilador includos no projeto e bibliotecas que esto ligando para criar o programa
executvel. Quando voc escrever uma aplicao completa com a mo, voc tambm deve
atualizar o arquivo de projeto para incluir todos os mdulos de fonte, arquivo de motoristas,
cones e bibliotecas externas usadas pelo cdigo do programa. Veja o captulo Usando o
Sistema de projetos emdo Usurio'Guia de S Para mais informaes sobre como manter o
projeto.

8. Pressione o boto OK.


O foco agora pertence a HOLA.CLW arquivo
.Advierta a barra de ttulo do ambiente de programao agora diz:
Clarion5 (HOLA.PRJ) - (C: \ CLARION5 \ idioma \ HOLA.CLW).Esta linha indica sempre o
projeto e o diretrio de trabalho atual. importante abordar esta quando a codificao mo,

229
230 CLARION 5 CLARION
Aprendiendo

porque o simples fato de abrir um arquivo de origem no editor de texto no muda o projeto
atual para o compilador.
Escreva o programa
1. Digite o seguinte cdigo:
PROGRAMA
MAP
END
MyWin JANELA ( "Ol do Windows), SYSTEM
END
CDIGO
ABERTO (MyWin)
ACEITAR
END
Este cdigo comea com o PROGRAMA sentena. Esta deve ser a primeira instruo (excepto um
comentrio) durante todo programa Clarion. Note-se que a palavra-chave PROGRAMA recuado
em relao ao MyWin. Clarion, as nicas frases que comeam em um (1) coluna so cdigo-fonte
declaraes rtulo. Por definio, um rtulo deve comear em um (1) coluna. A declarao
programa comea com a seo de declarao de dados global (Global).

Temos agora uma estrutura de MAP vazio. A declarao final uma concluso necessria da
estrutura de dados MAP. Este tipo de estrutura contm os prottipos que definem tipos de
parmetros de dados, tipos de dados de resposta, e outras opes que dizem ao compilador como
lidar com chamadas de procedimento (tente isso mais tarde). uma estrutura de MAP necessria
quando o cigo de programa em mtodos (procedimentos) dividido. Ns no fizemos ainda, mas
precisamos tambm da seco que haja uma instruo OPEN no cdigo executvel.

Quando o compilador processa uma estrutura MAP, automaticamente inclui os prottipos no \


CLARION5 \ LIBSRC \ BUILTINS.CLW. Este arquivo contm prottipos de quase todos os
procedimentos incorporados a linguagem Clarion (incluindo o Open). Se a estrutura vazia MAP
no foi includo no cdigo, o compilador ir gerar um erro na instruo OPEN.

MyWin o rtulo da Janela de estrutura de dados (o "H" deve ser coluna 1). Clarion, as janelas
so declarados como estruturas de dados, e no so construdos dinamicamente, por acrdos de
cdigo executvel, como em outros idiomas. Este um dos aspectos que tornam a linguagem de
quarta gerao Clarion. Embora Clarion pode construir caixas de dilogo dinamicamente em
tempo de execuo, isso desnecessrio. Usando uma estrutura de dados, o compilador cria o
apelo do Windows para cada dilogo, permitindo um melhor desempenho durante a execuo.

O parmetro ( 'Ol do Windows) na janela governando define o texto da barra de ttulo da janela.
declarao sistema adiciona a janela do menu de sistema padro. A declarao END exigido
dados da estrutura janela de concluso. Cristalino, todas as estruturas complexas (ambos os dados
de cdigo como executveis) deve terminar com uma extremidade ou um ponto (.). Isto significa
que o seguinte cdigo funcionalmente equivalente ao anterior:

PROGRAMA
EuCONTEDO 231

MAP
END
MyWin JANELA ( "Ol do Windows), SYSTEM
END
CDIGO
ABERTO (MyWin)
ACEITAR.
Embora eles so funcionalmente equivalentes, este cdigo se torna muito mais difcil de ler, uma
vez que acrescenta algo ao estruturas MAP, janela, ou aceitar. Convencionalmente, usamos END
para concluir as frases complexas que abrangem vrias linhas, colocando a extremidade na mesma
coluna que a palavra-chave que est dando acabamento, e tudo o mais sangramento dentro da
estrutura. Ns usamos apenas ponto para completar um estruturas de linha, tais como instrues IF
com uma nica clusula ENTO. Esta conveno torna o cdigo mais fcil de ler, e tambm que
os "terminadores" falta muito mais fcil de localizar.
A declarao cdigo necessrio para identificar o incio da seo de cdigo executvel. Dados
(variveis de memria, arquivos de dados, estruturas de janelas, relatrios, etc.) so declaradas em
uma seo de dados (antes do cdigo de frase), e instrues executveis s pode vir aps o cdigo
dominante.
Uma vez que este programa no contm qualquer procedimento (todos discutidos abaixo), mas
tem uma seo Global Data seguido por trs linhas de cdigo executvel. Variveis declaradas
nesta seo so visveis e disponveis para uso em qualquer lugar do programa.
A instruo OPEN (MyWin) abre a janela, mas no a amostra. A janela s aparecer na tela
quando um display ou aceitar instruo executada. Este recurso permite alterar dinamicamente as
propriedades da janela, ou qualquer controle sobre ele, antes de aparecer na tela.
ACEITAR o processador de eventos. A maioria das mensagens (eventos) do Windows so
gerenciados internamente pelo ACEITAR. Estes so os eventos comuns manipulados pela
biblioteca de tempo de execuo (redesenhar a tela, etc.). Apenas os eventos que exigem programa
de aco so passados por aceitar o Cdigo Clarion. Isto simplifica a programao, permitindo que
o programador se concentrar apenas em questes de alto nvel.
A declarao ACCEPT tem um comando END como terminao, o que significa que um cdigo
de estrutura complexa. ACCEPT uma estrutura de reentrada ou loop (circular), que "passar por"
todos os eventos que o desenvolvedor pode querer gerenciar (nenhum neste caso, mas ento
veremos alguns), e depois de volta para lidar com o prximo evento .
um loop de aceitar para cada janela aberta em um programa Clarion necessrio. Uma janela
aberta "paus" para o prximo ciclo aceitar que no cdigo, e toma como seus eventos processador.
Para este programa, aceite tratado internamente tudo o que faz o menu do sistema (localizado no
atributo sistema Windows). Portanto, quando o usurio utiliza o menu do sistema para fechar a
janela, aceita automaticamente passa o controle para qualquer frase que se segue END
terminator. Desde que no h nenhum outro Clarion sentena para ser executado, o programa
termina. Quando qualquer programa Clarion atinge o final do cdigo executvel, ele executa um
retorno implcito que, por sua vez, retorna o usurio para o sistema operacional.
2. Clique no boto Executar (Run).
O programa compila e executa linkea. O ttulo da janela exibe a mensagem "Ol Windows" e deve
fechar a janela com o sistema de menu.

231
232 CLARION 5 CLARION
Aprendiendo

controles Ol do Windows

Este programa o mais pequeno que pode ser criado em Clarion. Agora vamos expandir um pouco
para mostrar como alguns controles so adicionados janela e como os eventos so tratados
gerada por esses controles.

Mudando a fonte
1. Modificar o cdigo para ler:
PROGRAMA
MAP
END
MyWin JANELA ( "Ol do Windows), AT (,, 100,100), SYSTEM ! mudado
String ( "Ol do Windows), AT (26.23), USE (? String1)
adicionado
BUTTON ( 'OK'), AT (34.60), USE (? Ok), PADRO adicionado
END
CDIGO
ABERTO (MyWin)
ACEITAR
Se for aceite () = Ok seguida, quebrar. adicionado
END

Nota: Vantanas Designer est disponvel no Editor de texto, como no


Gerador de Aplicativos. Para chamar o Designer Janela, coloque o
ponto de insero (cursor) em qualquer ponto dentro da estrutura de
janela e pressione CTRL + F. As nicas restries so de que as
ferramentas e modelos dicionrio Controle Field esto indisponveis
(porque eles so especficos para o Gerador de Aplicativos).

A mudana a adio de corda e boto controla a estrutura JANELA. "STRING" texto constante
colocado na janela, e Button adiciona um boto de comando.
A nica outra adio a instruo Se for aceite () = Ok seguida, quebrar. Esta declarao detecta
quando o usurio pressionou o boto OK e quebra (break) ACEITAR loop, terminando o
programa. O procedimento aceite devolve o nmero de campo de controlo para o qual o evento
recentemente expandido: aceites. (EVENTO: aceito uma equivalncia ou igualar, contido no
arquivo \ CLARION5 \ LIBSRC \ EQUATES.CLW, o compilador automaticamente includo em
todos os programas).
? Ok equivalncia (Rtulo de Campo Equate) do controle Button, definido pelo controle atributo
USE (ver rtulos de campo em Equate a referncia da linguagem). O compilador combina
automaticamente? Ok, o nmero atribudo ao campo de controle (usando o cdigo equivalncias
mais fcil de ler).
Quando o procedimento aceite retorna um valor igual ao nmero do campo atribudo pelo
compilador para o boto OK, a instruo break executada e o lao termina ACEITAR.
EuCONTEDO 233

2. Clique no boto Executar.


O programa compila e executa. O ttulo da janela exibe ainda a mensagem "Ol Windows" e agora
o mesmo acontece com o texto constante no meio da janela. Voc pode fechar a janela com o
menu do sistema ou o boto OK.

forma comum de cdigo fonte


H outras maneiras de escrever o cdigo no loop ACEITAR para fazer o mesmo. Iremos para a
maneira mais direta, porque a maioria se assemelha ao estilo de cdigo que produz o Gerador de
aplicao a partir do ABC Clarion Modelos.
1. Modificar o cdigo da seguinte forma:
PROGRAMA
MAP
END
MyWin JANELA ( "Ol do Windows), AT (,, 100,100), SYSTEM
String ( "Ol do Windows), AT (26.23), USE (? String1)
BUTTON ( 'OK'), AT (34.60), USE (? Ok), PADRO
END
CDIGO
ABERTO (MyWin)
ACEITAR
CAMPO DO CASO ()
adicionado
DE? Ok adicionado
CASO CASE () adicionado
DE EVENTO: Aceite adicionado
INTERVALO
adicionado
END adicionado
END adicionado
END
Este cdigo um caso aninhado em outra estrutura. Uma estrutura CASE procura uma
correspondncia exata entre a expresso imediatamente aps a palavra-chave CASE e outra
expresso que segue imediatamente a da clusula (embora neste caso apenas um dos clusula em
cada caso mostra, uma estrutura CASE pode ter como muitos como necessrio.)
A estrutura PROCESSO CAMPO () determina que controlam o evento corrente aplicvel. Quando
o mtodo de campo () retorna um valor igual ao nmero de campo boto OK (a equivalncia de
campo? Ok), ento voc corre o EVENTO estrutura CASE ().
Esta estrutura determina que evento foi gerado. Quando o procedimento retorna um valor igual
evento para evento: Aceites (um EQUATE que contm o arquivo \ CLARION \ LIBSRC \
EQUATES.CLW), em seguida, executa a instruo para quebrar o loop (break).
Nestle CASE EVENTO () de dentro caso de campo () permite que voc coloque todos ligados a
um cdigo de controle especial em um lugar. Tambm poderia ser aninhados estrutura
PROCESSO CAMPO (() dentro de uma estrutura EVENTO PROCESSO (), invertendo o cdigo,
mas esta desperdigara o cdigo de controlo associado para vrios locais.
2. Clique no boto Executar.

233
234 CLARION 5 CLARION
Aprendiendo

Novamente, voc pode fechar a janela tanto com o menu do sistema, ou o boto OK, como
acontece com o cdigo anterior, mas agora o cdigo estruturado de acordo com o estilo comum.

"Ol Windows" com o tratamento de eventos

Existem dois tipos de eventos passados ao programa de eventos Aceitar: O campo-especfica e


campo-independente.
Um evento especfico-Field (campo especfico) ocorre quando o usurio faz qualquer coisa que
requer o programa para tomar uma ao especfica em um controle particular. Aceitam-se: Por
exemplo, quando o operador pressiona TAB aps a introduo de dados de controlo, campo
especfico evento evento gerado.
A (campo independente) evento independente de campo no est ligada a qualquer controle
particular, mas pode exigir algum programa de aco (por exemplo, fechar uma janela, ou alterar
as threads).
CASE Nestl duas estruturas, como vimos, a forma mais comum de tratamento especfico para
os eventos de campo. O mtodo mais comum de lidar com o campo de eventos independentes
um evento de estrutura CASE () sem nidificao, geralmente localizado imediatamente antes do
campo estrutura CASE ().
Mudando a fonte
1. Modificar o cdigo fonte da seguinte forma:
PROGRAMA
MAP
END
MyWin JANELA ( "Ol do Windows), AT (,, 100,100), SYSTEM
String ( "Ol do Windows), AT (26.23), USE (? String1)
BUTTON ( 'OK'), AT (34.60), USE (? Ok), PADRO
END
CDIGO
ABERTO (MyWin)
ACEITAR
CASO CASE () adicionado
DE EVENTO: OpenWindow adicionado
MENSAGEM ( 'Janela Aberta') adicionado
DE EVENTO: GainFocus adicionado
MENSAGEM ( 'Foco Ganhou') adicionado
END adicionado
CAMPO DO CASO ()
DE? Ok
CASO CASE ()
DE EVENTO: Aceite
INTERVALO
END
END
END
EuCONTEDO 235

O novo evento estrutura CASE () lida com dois eventos de campo independentes: EVENTO:
openWindow e Evento: GainFocus. O procedimento utilizado neste cdigo mensagem apenas
para mostrar visualmente, durante a execuo do evento foi disparado. Mensagem em vez do
procedimento, pode ser adicionado aqui qualquer outro cdigo que o programa precisa ser
executado quando esses eventos so acionados usurio.
Isto mostra o fluxo lgico e a estrutura de cdigo para os procedimentos de janela: um circuito de
ACEITAR contendo um evento estrutura PROCESSO () que lida com todos os campos de eventos
independentes, seguido por um campo de estrutura PROCESSO () com estruturas aninhadas
PROCESSO DE EVENTOS ( ) para lidar com eventos especficos todos os campos.
2. Clique no boto Executar.
Note-se que os eventos so gerados EVENTO: GainFocus e EVENTO: OpenWindow quando a
janela aberta pela primeira vez (nessa ordem). EVENTO: GainFocus (entrar em foco) ser
atualizada quando o usurio clica ALT + TAB para outro aplicativo e depois volta novamente Ol
do Windows! utilizando a mesma combinao de teclas.

Adicionando um PROCEDIMENTO

Ol do Windows em um exemplo de um programa muito simples. A maioria dos programas de


negcios de hoje no tm essa simplicidade; requerem o uso de tcnicas de programao
estruturada. Isto significa que o cdigo dividido em sees funcionais que realizam cada uma
tarefa lgica. linguagem Clarion, estas sees funcionais so chamados Procedimentos
(procedimentos).
Primeiro, adicionamos um programa Ol do Windows procedimento.

Mudando a fonte
1. Modificar o cdigo fonte desta forma:

PROGRAMA
MAP
Ol PROCEDIMENTO
adicionado
END
CDIGO
adicionado
Ol adicionado

Ol PROCEDIMENTO adicionado
MyWin JANELA ( "Ol do Windows), AT (,, 100,100), SYSTEM
String ( "Ol do Windows), AT (26.23), USE (? String1)
BUTTON ( 'OK'), AT (34.60), USE (? Ok), PADRO
END
CDIGO

235
236 CLARION 5 CLARION
Aprendiendo

ABERTO (MyWin)
adicionado
ACEITAR
CASO CASE ()
DE EVENTO: OpenWindow
MENSAGEM ( 'Janela Aberta')
DE EVENTO: GainFocus
MENSAGEM ( 'Foco Ganhou')
END
CAMPO DO CASO ()
DE? Ok
CASO CASE ()
DE EVENTO: Aceite
INTERVALO
END
END
END

As nicas mudanas so aqui no incio do programa. Dentro da estrutura do MAP vemos agora o
julgamento Ol fazendo procedimento prottipo PROCEDIMENTO Ol. Um prottipo a
declarao do procedimento para o compilador para dizer o que esperar quando o cdigo chama o
procedimento. Este prottipo indica que o procedimento no tem parmetros e no retorna um
valor. Todos os procedimentos de seu programa deve ter seu prottipo em uma estrutura de MAP.
Ver procedimento Prottipos ema referncia da linguagem conhecer os outros prottipos.
O cdigo palavra-chave imediatamente aps a estrutura MAP termina seo Global Data (Dados
Global) e marca o incio da seo global de cdigo executvel, que contm apenas frase Oi, que
uma chamada para executar o procedimento Ol. Um procedimento que no retorna um valor
sempre chamado com uma nica frase com seu nome no cdigo executvel.
O segundo perodo termina seo de cdigo executvel Ol global PROCEDIMENTO e marca o
incio da definio do cdigo do procedimento Ol.
Uma declarao procedimento contm uma seo de dados da mesma maneira que voc faz um
programa (PROGRAM) e tambm requer a palavra-chave cdigo para definir a fronteira entre
declaraes de dados e cdigo executvel. por isso que o resto do cdigo no alterado no
exemplo anterior. Esta a declarao de dados locais (declarao de dados local) para o
procedimento.
A maior diferena entre as declaraes de dados global e local est dentro do escopo dos dados
comunicados. Qualquer dado indicado na seo local visvel apenas para o procedimento que
declara, enquanto qualquer declarada nos dados seo global visvel em todo o programa. Veja
declaraes de dados e alocao de memria noa referncia da linguagem Para um tratamento
mais completo de diferenas.

2. Clique no boto Executar.


O programa funciona exatamente como antes. A nica diferena que o Ol
PROCEDIMENTO agora pode ser chamado de qualquer lugar dentro do programa, mesmo
outro procedimento. Isto significa que, embora o programa execute o procedimento muitas
vezes, o cdigo necessrio escrito uma vez.
EuCONTEDO 237

Adicionando um Procedimento

UM PROCEDIMENTO Clarion que no retorna (RETURN) um valor s pode ser chamado em


uma instruo executvel separado; no pode usrselo em uma lista de parmetro expresso, ou
cesso. Um mtodo sim retorna um valor deve sempre conter uma declarao RETURN, e pode
ser usado em expresses, listas de parmetros e instrues de atribuio. Voc pode chamar um
sim procedimento retorna (regresso) como um valor separado, se voc no quer que o juzo de
valor de retorno, mas isso gera um aviso do compilador (a menos que o PROC prottipo
procedimento tem o atributo).
Estruturalmente, ambos os tipos so PROCESSO equivalente; ambos tm sees de dados locais,
seguidos por uma seo de cdigo executvel que comea com CDIGO palavra-chave.

Alterar o cdigo fonte


1. Modificar a estrutura do mapa da seguinte forma:

MAP
Ol PROCEDIMENTO
EventString PROCEDIMENTO (PassedEvent LONG), corda! agregado
END

Isso aumenta o PROCEDIMENTO prottipo EventString. EventString LONGO receber um


parmetro chamado PassedEvent que no pode ser omitido, e retorna uma string. Os tipos de dados
de todos os parmetros passados para um procedimento especificado entre parnteses seguinte
procedimento, cada, separadas por uma vrgula (se mltiplos parmetros). O tipo de dados do valor
de retorno de um procedimento especificado aps o parntese de fechamento da lista de
parmetros. Ambos os tipos de procedimentos podem receber parmetros, consulte a seo Lista
de Prototype Parmetroa referncia da linguagem para uma passagem de parmetros tratamento
mais completo.

2. Adicione a definio procedimento EventString o final do arquivo:

EventString PROCEDIMENTO (PassedEvent LONGO)


ReturnString Corda (255)
CDIGO
CASE PassedEvent
DE EVENTO: OpenWindow
ReturnString = 'janela aberta'
DE EVENTO: GainFocus
ReturnString = 'Foco Ganhou'
MAIS
ReturnString = 'Evento Desconhecido' & PassedEvent
END
RETURN (ReturnString)

237
238 CLARION 5 CLARION
Aprendiendo

O rtulo EventString (lembrar que ser um rtulo, deve ser a coluna 1) do procedimento de
julgamento d este procedimento enquanto a lista de parmetros anexado ao procedimento
palavra-chave nomes de parmetro tempo o PassedEvent nomeado.
um nmero igual de nomes parmetro listados na declarao PROCEDIMENTO como existem
tipos de dados listados no prottipo para esse procedimento deve sempre existir.
ReturnString uma varivel local declarado como um campo alfanumrico (STRING) 255
caracteres na pilha. declarao CDIGO encerra a seo de dados locais (dados locais) do
procedimento. A estrutura deve ser conhecido PROCESSO PassedEvent, uma vez que o mesmo
que um evento de estrutura PROCESSO (), mas condio PROCESSO PassedEvent , em vez do
procedimento de evento (). PROCESSO Esta estrutura simplesmente atribui o que corresponde a
ReturnString varivel para cada passada para o valor procedimento de evento.
O cdigo interessante aqui a declarao RETURN (ReturnString). Um procedimento sem valor
de retorno no requer um retorno especfico, como sempre executa um retorno implcito quando
no h mais cdigo para ser executado. No entanto, um prottipo indicado PROCEDIMENTO
para retornar um valor sempre contm uma instruo de retorno explcito que especifica o valor
para retornar. Neste caso, a declarao RETURN retorna qualquer valor que foi atribudo ao
ReturnString na estrutura PROCESSO.

3. Modificar o evento procedimento CASE () para ler:

CASO CASE ()
DE EVENTO: OpenWindow
MENSAGEM (EventString (EVENTO: OpenWindow))! mudado
DE EVENTO: GainFocus
MENSAGEM (EventString (EVENTO: GainFocus))! mudado
END

Isso muda procedimentos mensagem para exibir o valor de retorno do procedimento EventString.
O nmero do evento passado EventString como o evento equivalente (EQUATE Event) para
torn-lo mais compreensvel para leitura.
4. Clique no boto Executar.
O programa ainda funciona exatamente como antes.

Para o mundo real: Adicionando um menu

Ol do Windows um pouco agradvel de demonstrao do programa, mas realmente no te


ensinar muito sobre como fazer programao comercial real. Portanto, ele vai se expandir para
incluir algumas funcionalidades teis, comeando com um menu.

Alterar o cdigo fonte

1. Modificar o incio do arquivo como este:


EuCONTEDO 239

PROGRAMA
MAP
principal PROCEDIMENTO ! agregado
Ol PROCEDIMENTO
EventString PROCEDIMENTO (PassedEvent LONGO), STRING
END
CDIGO
principal ! mudado
Isso adiciona o prottipo do procedimento MAP estrutura principal e substitui a chamada para Ol
com um procedimento chamar principal.
2. Adicionar definio do procedimento ao final do arquivo:

principal PROCEDIMENTO
AppFrame APLICAO ( "Ol do Windows), AT (,, 280,200), SYSTEM,
redimensionar, MAX
MENUBAR
MENU ( '& File'), USE (? Arquivo)
ITEM ( '& Procurar Phone'), USE (? FileBrowseTelefono)
ITEM, separador
ITEM ( '& Sair'), USE (FileExit?), STD (STD: close)
END
ITEM ( '& About!'), USE (? Sobre)
END
END
CDIGO
ABERTO (AppFrame)
ACEITAR
CASE aceite ()
DE? Sobre
Ol
END
END
O mtodo principal no aceita parmetros. APLICAO AppFrame contm a estrutura. A
estrutura da aplicao a chave para a criao de programas com interface de documentos
mltiplos (MDI). Uma aplicao MDI pode conter vrios segmentos. Este o quadro "pai" MDI
necessrio para criar uma aplicao MDI.
estrutura de menu define os itens de menu disponveis para o usurio. MENU ( '& File') estrutura
cria o menu Arquivo padro em quase todos os programas do Windows. O comercial (&) precede
o "F" especifica que este o "atalho de teclado" e realar o sistema operativo durante a execuo.
ITEM ( '& BrowseTelefono') opo cria um item de menu que usamos para chamar um
procedimento (como veremos). sentena ITEM, separador cria uma linha divisria no menu e
selecionando Navegar Phone.
O item ( '& Sair') cria um item de menu para sair do procedimento (e do programa, uma vez que
este procedimento a nica conhecida do cdigo executvel Global). A DST (DST: Close)
atributo especifica a aco normal de fecho de uma janela para sair do ciclo ACCEPT. Este
esporque qualquer cdigo executvel associado a este item de menu no circuito ACCEPT no v: a
biblioteca Clarion tempo de execuo carregada automaticamente.

239
240 CLARION 5 CLARION
Aprendiendo

ITEM ( '& About') instruo cria um item de menu na barra de ao, direita do menu Arquivo. O
ponto de exclamao (!) uma conveno para indicar aos usurios que este item executa uma
ao, e no exibe um menu, mesmo que seja na barra de ao.
O loop ACCEPT contm apenas uma estrutura PROCESSO aceite (). O procedimento aceite
(aceito) retorna o nmero de controle de foco campo, quando um evento gerado: Aceito.
Podemos usar o procedimento aceito aqui, em vez de procedimentos de evento de campo e itens de
menu porque eles s gerar EVENTO: Aceite. O DE? Sobre clusula simplesmente chama o
procedimento Ol.
3. Clique no boto Executar.
O programa executado e apenas o item Sobre! Arquivo Sair e fazer algo. Note, porm, que faz
Arquivo Sair para terminar o programa, apesar de no ter escrito cdigo para executar essa ao.

Mais para o mundo real: a adio de um formulrio de lista e

ordem
Ter um menu bom, mas agora devemos fazer alguma programao negcio real. Agora adicione
um arquivo e procedimentos para mant-lo de dados.
Alterar o Cdigo Mundial
1. Modificar o incio do arquivo para ler:
PROGRAMA
Include ( 'KeyCodes.CLW') ! agregado
Include ( 'Errors.CLW') ! agregado

MAP
principal PROCEDIMENTO
BrowseTelefono PROCEDIMENTO ! agregado
UpdateTelefono PROCEDIMENTO (Ao LONG), LONG ! agregado
Ol PROCEDIMENTO
EventString PROCEDIMENTO (PassedEvent LONGO), STRING
END

telefone ARQUIVO, DRIVER ( 'TopSpeed'), crie ! agregado


KeyNombre Key (Name), DUP, NOCASE ! agregado
Rec RECORDE ! agregado
nome CORDA (20) ! agregado
nmero CORDA (20) ! agregado
END ! agregado
END
! agregado
InsertRecord EQUATE (1) ! agregado
ChangeRecord EQUATE (2) ! agregado
DeleteRecord EQUATE (3) ! agregado
ActionComplete EQUATE (1) ! agregado
ActionAborted EQUATE (2) ! agregado
EuCONTEDO 241

CDIGO
principal
Os dois novo padro incluem declaraes equivale adicionados aos cdigos-chave e nmeros de
erro. Usando equivalncias (iguala) em vez de nmeros torna o cdigo mais compreensvel e,
portanto, mais fcil de manter.

A estrutura do mapa adquiriu dois outros prottipos de procedimentos: O procedimento


BrowseTelefono e UpdateTelefono PROCEDIMENTO (aco a longo) de comprimento. O
procedimento BrowseTelefono exibe uma lista de registros no arquivo e atualizao
UpdateTelefono registros individuais.

No interesse de manter a simplicidade do cdigo (experimente este direito de distncia), o


procedimento BrowseTelefono ser limitado a mostrar todos os registros no arquivo em um
controle de lista. Este no exatamente o mesmo que um cdigo de procedimento Browse gerada
por modelos (as pginas que carregam para lidar com arquivos muito grandes), mas tm a mesma
finalidade aqui.

declarao Telefone arquivo cria um arquivo de dados simples usando o controlador TopSpeed.
Existem dois campos de dados: nome e nmero, tanto declarados como alfanumrico: String (20).
O campo de nmero declarao deste modo permite que voc contm nmeros de telefone em
qualquer lugar do mundo (mais sobre isso em breve)

Igualam cinco declaraes definir valores constantes que tornam o cdigo mais legvel.
InsertRecord, ChangeRecord e DeleteRecord definir aces a serem transmitidos como parmetros
para o procedimento UpdateTelefono. O ActionComplete e equivalncias ActionAborted definir
dois possveis valores devolvidos pelo procedimento UpdateTelefono.
2. Modificar o CASE cdigo aceite () procedimento principal assim:

CASE aceite ()
DE? FileBrowseTelefono ! agregado
START (BrowseTelefono, 25000) ! agregado
DE? Sobre
Ol
END
A declarao START (BrowseTelefono, 25000) executado quando o usurio escolhe o menu de
seleo Navegar Phone. O mtodo INICIAR cria um novo segmento de execuo do procedimento
BrowseTelefono e o segundo parmetro (25.000) especifica o tamanho (em bytes) da pilha de
novo segmento de execuo. procedimento de partida pode ser usado quando voc est chamando
um procedimento que contm uma janela filho MDI a partir do quadroo APLICAOComo cada
janela filho MDI deve estar em um segmento separado da execuo. Se voc no abrir (START) o
filho MDI, durante a execuo do erro "No possvel abrir a janela MDI em fio de aplicao"
aparece quando voc tenta chamar o procedimento BrowseTelefono eo programa ser encerrada
imediatamente.

241
242 CLARION 5 CLARION
Aprendiendo

Depois de ter iniciado uma nova thread de execuo, uma criana MDI pode simplesmente chamar
outro filho MDI no mesmo segmento sem iniciar um novo. Isto significa que, embora
BrowseTelefono e UpdateTelefono ambos contm janelas MDI, nica BrowseTelefono deve
iniciar (START) um novo segmento, como chamada a partir da janela do aplicativo.
Adicionar o procedimento BrowseTelefono

1. Adicionar a seo de dados da definio BrowseTelefono final PROCEDIMENTO do arquivo:

BrowseTelefono PROCEDIMENTO
TelefonoQue FILA
nome CORDA (20)
nmero CORDA (20)
posio CORDA (512)
END

Indicador INDICADOR ( 'Browse Phone'), AT (,, 185,156), SYSTEM, GRAY,


redimensionar, MDI
LISTA, AT (6,8,173,100), ALRT (MouseLeft2), USE (Lista?), | FORMATO (
'84L | 80L ~ Nome M ~ ~ I ~'), DE (TelefonoQue), VScroll
BUTTON ( '& Inserir'), AT (20.117), KEY (InsertKey), USE (? Insert)
BUTTON ( '& Change'), AT (76,117,35,14), KEY (enterkey), USE (? Mudar)
BUTTON ( '& Delete'), AT (131,117,35,14), KEY (DeleteKey), USE (?
Apagar) BUTTON ( 'Fechar'), AT (76,137,35,14), KEY (EscKey), USE (?
close)
END

A estrutura da "cauda" TelefonoQue FILA define a estrutura de dados contendo todos os arquivos
de registros de telefone e exibe-os no controle de lista. A "cauda" (FILA) Clarion semelhante a
um arquivo de dados, porque tem um buffer de dados e permite um nmero ilimitado de registros,
mas s existe na memria durante a execuo. Uma fila tambm pode ser comparado a um alocada
dinamicamente a matriz de tempo de execuo. Veja o Captulo memria filas ema referncia da
linguagem Para mais informaes sobre estas estruturas.

A fila TelefonoQue contm trs campos. campos nome e nmero de duplicar os campos na
estrutura do telefone arquivo e exibida nas duas colunas definidas pelo formato do atributo
controle List. O campo Posio ir conter o valor de retorno do procedimento POSIO telefone
cada arquivo de registro. Salvar a posio de cada registro nos permitir mudar imediatamente o
registro do arquivo de dados, antes de chamar UpdateTelefono para alterar ou excluir um registro.

A estrutura de janela de janela da lista contm um controlo e quatro botes (Button). O controle de
lista a chave para este procedimento. O ALRT (MouseLeft2) LISTA aviso de alerta de uma
possvel clicar duas vezes para o julgamento ACEITAR passar um evento: AlertKey o cdigo
Clarion. Isto ir permitir-nos para escrever cdigo para trazer o procedimento UpdateTelefono
para alterar o registro no qual o usurio d CLIQUE DUPLO.
EuCONTEDO 243

A barra vertical (|) no final da lista sentena o caractere de continuao Clarion, o que significa
que o controle de lista continua na prxima linha com o atributo de formato ( '84L | 80L M ~ nome
~ ~ I ~') embora se voc quiser, pode colocar tudo em uma nica linha, sem a barra de
afastamento. O atributo de parmetro FORMATO define a aparncia do controle da lista em tempo
de execuo.
melhor deixar os resultados projetista de ferramentas de design no Windows que seqncias de
formato tipo, como eles rapidamente tornar-se muito complexa. Este formato define duas colunas.
A primeira coluna tem 84 unidades de dilogo de largura (84), justificado esquerda (L), tem
uma borda direita (|) Ajustvel (M) ea palavra "Nome" o seu cabealho (~ nome ~). A segunda
coluna tem 80 unidades de dilogo de largura (80), com a justificao para a esquerda (L), e o seu
ttulo "N" (Nmero ~ ~).

DE (TelefonoQue) em LISTA especifica a fila (FILA) que apresenta o controlo LISTA e


VScroll adiciona o deslocamento vertical. LISTA ir exibir o nome eo nmero campos de todos os
itens em o TelefonoQue ignorando o campo Posio, j que o atributo formato especificado apenas
duas colunas.

LISTA automaticamente que permite aos usurios navegar pela lista sem codificao adicional.
LISTAfeito porque o atributo IMM (imediato) no est presente. Se existisse, deve escrever
cdigo para lidar com os registros de deslocamento (rolagem), como no modelo Procurar.

Button ( '& Insert) instruo define um boto de comando o usurio vai pressionar para adicionar
um novo registro. O atributo chave (InsertKey) especifica que o boto pressionado
automaticamente para o usurio pressione a tecla Insert. Note-se que os outros trs controles
Button tm atributos semelhantes KEY. Isso significa que voc no precisa escrever qualquer
cdigo especial para lidar com acesso ao teclado, se o usurio prefere o mouse.

2. Adicione o incio da seo de cdigo executvel que define o fim PROCEDIMENTO


BrowseTelefono do arquivo:

CDIGO
DO OpenFile
DO FillQue
ABERTO (janela)
ACEITAR
CASO CASE ()
DE EVENTO: OpenWindow
DO QueRecordsCheck
DE EVENTO: AlertKey
Keycode SE () = MouseLeft2
POST (EVENTO: aceitado, a mudana?)
END
END
END

243
244 CLARION 5 CLARION
Aprendiendo

O princpio da seo de cdigo comea com a frase DO OpenFile. DO executa uma rotina, neste
caso openfile, e quando este cdigo estiver concludo, o controle retorna para a prxima linha de
cdigo aps a instruo do que chamou de rotina.
O cdigo que define uma rotina deve ser no final do processo depois de tudo lgica do ncleo,
porque a rotina julgamento termina a seo de cdigo executvel de um procedimento.

H duas razes para usar uma rotina dentro PROCEDIMENTO: para escrever um monte de
instrues de cdigo a serem executadas em vrios pontos lgicos dentro do procedimento ou para
tornar o cdigo mais compreensvel para substituir com uma frase simples fazem um grupo de
frases eles executam uma obra nica lgica.

Neste caso, o julgamento DO OpenFile serve o segundo propsito, movendo o cdigo que abre ou
cria o arquivo fora do principal lgica do procedimento. Em seguida, a sentena FAZER FillQue
executa o cdigo que preenche a estrutura TelefonoQue fila com todos os registros retirados do
arquivo. Ambos fazem declaraes torn-lo fcil de seguir o fluxo lgico do mtodo.

Estruturas CASE EVENTO () clusula lgica do EVENTO: corra OpenWindow


QueRecordsCheck para chamar uma rotina que verifica se existem registros em TelefonoQue.

Ento caso de clusula contm o cdigo de acesso IF AlertKey () = Estrutura MouseLeft2 para
verificar duplo-clique LIST. dado o ALRT (MouseLeft2) atribuem s aparece no controle List,
sabemos que o POST julgamento (EVENTO: aceitado, Mudana) ser executado somente quando
o usurio clicar duas vezes em LIST.

declarao POST diz ACEITAR para "forward" o evento em seu primeiro parmetro (EVENTO:
aceitado) (? Mudar) de controle em seu segundo parmetro. O efeito que o cdigo executado
boto Alterar, como se o usurio tivesse pressionado o boto com o mouse ou teclado.

Isto ilustra uma excelente prtica de programao: escrever cdigo especfico uma vez e cham-lo
de muitos lugares. Este conceito de programao estruturada nos deu os procedimentos e rotinas.
Embora o cdigo EVENTO: Aceito para boto Alterar separado em um procedimento ou rotina,
o uso do POST julgamento ( "enviar") significa que esta a nica seo do cdigo que deve ser
mantida: se voc quer mudar a lgica, simplesmente fazer tudo isso em um s lugar.

3. Adicionar seo restante de cdigo executvel que define o procedimento BrowseTelefono o


final do arquivo:

CAMPO DO CASO ()
DE? Fechar
CASO CASE ()
DE EVENTO: Aceite
POST (CASO: CloseWindow)
END
EuCONTEDO 245

DE? Insert
CASO CASE ()
DE EVENTO: Aceite
SE UpdateTelefono (InsertRecord) = ActionComplete
DO AssignToQue
ADD (TelefonoQue)
IF ERRORCODE () depois parar (ERROR ()).
SORT (TelefonoQue, TelefonoQue.Nombre)
HABILITAO (? Alterar ,? Apagar)
END
SELECT (? List)
END

DE? Alterar
CASO CASE ()
DE EVENTO: Aceite
DO GetRecord
SE UpdateTelefono (ChangeRecord) = ActionComplete
DO AssignToQue
PUT (TelefonoQue)
IF ERRORCODE () depois parar (ERROR ()).
SORT (TelefonoQue, TelefonoQue.Nombre)
END
SELECT (? List)
END

DE? Excluir
CASO CASE ()
DE EVENTO: Aceite
DO GetRecord
SE UpdateTelefono (DeleteRecord) = ActionComplete
APAGAR (TelefonoQue)
IF ERRORCODE () depois parar (ERROR ()).
DO QueRecordsCheck
SORT (TelefonoQue, TelefonoQue.Nombre)
END
SELECT (? List)
END
END
FREE (TelefonoQue)
CLOSE (Telefone)

Aps o evento estrutura PROCESSO () a CAMPO DO CASO () estrutura est localizado. Note-se
que cada um contm o seu prprio DO EVENTO estrutura clusula PROCESSO (), cada um
contendo apenas uma clusula DO EVENTO: aceites. Devido a isso, que poderia ter substitudo a
estrutura PROCESSO CAMPO () com um caso aceite () e casos aninhados removido. Isso teria
um pouco melhor desempenho; mas muito pouco para perceber isso na tela. Ns no conseguimos
para manter a consistncia; haver muitas ocasies em que voc deve capturar eventos de campo
mais especficos nico evento: Aceito, e quando isso acontece, essa estrutura Case aninhada
lgico usar, por isso bom para acostumar agora. Ele tambm mostra o tipo de estrutura que
geram modelos de cdigo Clarion gerador de aplicaes.

245
246 CLARION 5 CLARION
Aprendiendo

? O encerramento da clusula executa o POST (EVENTO: CloseWindow) quando o usurio


pressiona o boto Fechar. Como no h segundo parmetro na declarao POST nomear um
controle, o evento enviado paraJANELA(E deve ser um campo de evento independente).
EVENTO: CloseWindow faz com que a resciso circuito aceitar e controlar a execuo cai para a
primeira declarao aps o loop resciso END ACEITAR. Neste caso, o controle vai para o
julgamento FREE (TelefonoQue), que libera toda a memria usada pelos registros da cauda,
fechamento e fechar o arquivo. Desde h outras declaraes para executar, o procedimento executa
um retorno implcito e retorna para o procedimento Main (de onde foi chamado).

A clusula INSERO DE? O contm SE UpdateTelefono (InsertRecord) = ActionComplete


estrutura. Isto exige procedimento UpdateTelefono, passando o valor InsertRecord constante que
definimos na seo de dados Global, e em seguida, verifica o valor de retorno ActionComplete.

O julgamento DO AssignToQue (atribudo fila) executada somente quando o usurio adiciona


um novo registro. AssingToQue uma rotina que aloca arquivo de registro do telefone de dados
tampo para tamponar a respectiva fila. Ento, a ADD julgamento (TelefonoQue) adiciona uma
nova entrada para a fila. IF frase ERROCODE () depois parar (ERROR ()) uma verificao de
erros padro que deve ser executada depois de cada ao em um arquivo ou em uma fila que tem a
capacidade de retornar um erro (outro bom hbito para formar).

O SORT (TelefonoQue, TelefonoQue.Nombre) declarao de linha para o campo Nome em ordem


alfabtica. Desde que no h nenhum atributo PRE (prefixo) na estrutura TelefonoQue voc deve
fazer referncia seus campos base na taxa da sintaxe campos Clarion, prefixar o nome da estrutura
que contm o campo (TelefonoQue) para o nome do campo (Name), conectando em conjunto com
um ponto assim: TelefonoQue.Nombre. Veja qualificao campo ema referncia da linguagem
para mais informacao.

A declarao ATIVAR (? Alterar ,? Apagar) garante que a mudana e apagar botes esto ativos
(se esta foi a primeira entrada em a FILA, Os botes ficam cinza por A rotina QueRecodsCheck).
A instruo SELECT (? List) retorna o usurio para o controle de lista.

O cdigo na Mudana clusula? quase idntico ao cdigo no DOS? Insira clusula. H uma frase
adicional DO GetRecord chamar uma rotina para definir o recorde aceso dentro do arquivo de log
telefone tampo TelefonoQue. A nica outra diferena a PUT sentena (TelefonoQue)
incorporando o usurio muda TelefonoQue.
O cdigo no DOS? Excluir clusula quase idntico ao cdigo no DOS? Alterar clusula. A
diferena o EXCLUIR (TelefonoQue) declarao de que remove o registro de TelefonoQue e
DO QueRecordsCheck chamada para verificar se o usurio tiver eliminado o ltimo registro.

4. Adicionar as rotinas chamados na definio do procedimento BrowseTelefono, no final do


arquivo:

AssignToQue ROTINA
TelefonoQue.Nombre = Telefono.Rec.Nombre
EuCONTEDO 247

TelefonoQue.Numero = Telefono.Rec.Numero
TelefonoQue.Position = POSITION (Telefone)

QueRecordsCheck ROTINA
Se no for Records (TelefonoQue)
DISABLE (? Alterar ,? Apagar)
SELECT (? Insert)
MAIS
SELECIONAR (? Lista 1)
END

GetRecord ROTINA
GET (TelefonoQue, escolha (? List))
IF ERRORCODE () depois parar (ERROR ()).
ReGet (telefone, TelefonoQue, posio)
IF ERRORCODE () depois parar (ERROR ()).

OpenFile ROTINA
ABERTO (telefone, 42h)
errorcode CASE ()
DE NoError oude IsOpenErr
SAIR
DE NoFileErr
CRIE (Telefone)
IF ERRORCODE () depois parar (ERROR ()).
ABERTO (telefone, 42h)
IF ERRORCODE () depois parar (ERROR ()).
MAIS
STOP (ERRO ())
RETURN
END

FillQue ROTINA
SET (telefone, KeyNombre)
LOOP
NEXT (Telefone)
SE errorcode () em seguida, quebrar.
DO AssignToQue
ADD (TelefonoQue)
IF ERRORCODE () depois parar (ERROR ()).
END
Como voc pode ver, h cinco rotinas neste procedimento. Note que, embora essas rotinas so
semelhantes a um procedimento no contm instrues de cdigo. Isso ocorre porque as aes
locais um dado procedimento de rotina e no costuma ter um dos dados da declarao seo
separada (embora possa t-lo: ROTINA ver ema referncia da linguagem Para um tratamento
completo deste tpico).

A rotina AssignToQue faz trs atribuies. A declarao TelefonoQue.Nombre =


Telefono.Rec.Nombre copiar os dados no buffer de log campo Nome e coloca-os no campo Nome
da fila. Desde nenhum prefixo (atributo PRE) na estrutura Telefone ARQUIVO, tambm deve

247
248 CLARION 5 CLARION
Aprendiendo

fazer referncia a seus campos de acordo com os campos de classificao sintaxe Clarion,
juntando-se o nome do arquivo (telefone), o nome do registro (Rec), eo nome campo (Name),
conectando com um ponto (Telefono.Rec.Nombre). Veja campo Qualificao ema referncia da
linguagem para mais informacao.

A sentena TelefonoQue.Numero = Telefono.Rec.Numero atribui os dados no telefone do campo


nmero do arquivo para o campo da TelefonoQue cauda "Nmero". A sentena
TelefonoQue.Position = POSITION (Telefone) atribui o valor retornado pelo valor do campo asa
TelefonoQue.Position procedimento POSITION. Este valor permite-nos recuperar o disco do
registro especfico que est atualmente no arquivo de telemvel buffer. O procedimento faz
POSIO entrar em contato com os arquivos de driver Clarion, e, portanto, recomendado fazer
registros em todos os sistemas de arquivos mtodo utilizado.

A rotina QueRecordsCheckverificar para ver se h registros em TelefonoQue. A estrutura SE


NO REGISTOS (TelefonoQue) utiliza o operador lgico contra o valor de retorno dos registos
de mtodo. Se os registros (TelefonoQue) retorna zero, a no torna verdadeira a condio eo
cdigo que segue o IF (zero sempre falsa, e no faz verdadeiro) executado. Se os registros
(TelefonoQue) retorna algo diferente de zero, o cdigo ser executado aps a outra coisa (qualquer
nmero diferente de zero sempre verdadeiro, e no faz false). Portanto, se no h registros na
TelefonoQue, DISABLE (? Alterar ,? Apagar) fila, ele executado para desativar os respectivos
botes e SELECT (? Insert) declarao coloca o utilizador no boto Insert (a prxima lgico ao
). Se houver registros no TelefonoQue instruo SELECT (? List) coloca o usurio emLIST.

GetRecord ROTINA rotina sincroniza o arquivo de log buffer telefone eo tampo fila
TelefonoQue dados atualmente iluminado com registro LIST. o declarao GET (TelefonoQue,
escolha (? List) usa o procedimento de escolha para "point" para "record" em destaque na lista e
recuperar (GET) "Register" ligada a tampo TelefonoQue (sempre a verificao de erros
inesperados.) Em seguida, o julgamento ReGet (telefone, TelefonoQue.Position) usa as
informaes armazenadas gravadas no disco para recuperar e enviar a fila de buffer de log.

OpenFile ROTINA rotina o telefone aberto ou criar arquivo. OPEN (telefone, 42h) declarao
tenta abrir o arquivo de telefone para ser compartilhado. O segundo parmetro um nmero
hexadecimal (condio indicada por "h"). Clarion suporta decimal sistema numrico, hexadecimal,
binria e octal. Este nmero representa o acesso totalmente compartilhada arquivo (Leitura /
Gravao, Negar nenhum) (veja a instruo OPEN ema referncia da linguagemPara saber mais
sobre maneiras de acessar os arquivos). Pedimos para acesso compartilhado, porque este um
programa MDI eo usurio poderia chamar vrias cpias do mesmo procedimento no mesmo
programa. No entanto, este programa faz todas as verificaes de acesso simultneo que so
necessrios para uma aplicao multi-utilizador real. Consulte a seo apropriadao
programador'Guia de S Para mais informaes sobre o assunto.

A estrutura CASE errorcode () verifica qualquer erro no aberto. Clusula DE NoError oude
IsOpenErr (agora pode ver porque ns inclumos o arquivo ERRORS.CLW) executa a instruo
Exit para sair imediatamente essa rotina. muito importante no confundir com RETURN SAIR,
uma vez que este termina imediatamente o procedimento enquanto Sada somente termina a rotina.
EuCONTEDO 249

RETURN vlida para usar dentro de uma rotina, mas certifique-se de terminar todo o processo, e
no apenas a rotina em si.

O DE NoFileErr clusula detecta nenhum arquivo de dados para abrir. CREATE (telefone)
declarao ir criar um novo arquivo de dados vazio. Voc deve garantir que, se voc tentar usar a
instruo CREATE que a declarao arquivo tambm contm o atributo CRIAR, ou a instruo
CREATE pode no funcionar. Esta declarao no abrir o arquivo, o que explica a instruo
OPEN (telefone, 42h). O cdigo na clusula ELSE executado se qualquer erro que no os ocorre.
A paragem de declarao (ERROR ()) exibe a mensagem de erro para o processo do usurio em
uma janela modal do sistema, o que lhe d a oportunidade de cancelar o programa (voltando ao
Windows) ou ignorar o erro. A declarao RETURN termina o procedimento, se o usurio escolhe
a ltima opo.

FillQue rotina ROTINA enche o rabo TelefonoQue com todo o arquivo de registros telefnicos. A
instruo SET (Telefono.KeyNombre) prepara o processamento de pedidos e o ponto do arquivo
de telefone de partida. O parmetro Telefono.KeyNombre faz com que o processamento alfabtica
de acordo com o campo Nome. A ausncia de um segundo parmetro no conjunto faz o ponto de
partida o incio (ou final) do arquivo. A estrutura LOOP no tem nenhuma condio, o que
significa que voc deve ter uma instruo break em algum lugar do LOOP, ou possa ter um loop
infinito. A declarao NEXT (Telefone) recupera o prximo registro no telefone arquivo de dados,
em seguida, a declarao ERROCODE IF () em seguida, quebrar assegura-nos para fora
(INTERVALO) de LOOP, quando eles foram lidos todos os registros. FAZER AssignToQue
julgamento chama a rotina de mesmo nome j foi discutido, e ADD (TelefonoQue) adiciona o
novo recorde para a fila.

Adicionando o procedimento UpdateTelefono


1. Adicionar a seo de dados da definio de UpdateTelefono final PROCEDIMENTO do
arquivo:
UpdateTelefono PROCEDIMENTO (ao prolongada)
ReturnValue LONG, AUTO
janela JANELA ( 'Atualizao Phone'), AT (,, 185,92), SYSTEM, GRAY, redimensionar, MDI,
MASK
Prompt ( 'N & ombre'), AT (14.14), USE (PROMPT1?)
ENTRADA (@ s20), AT (68,13), USE (Telefono.Rec.Nombre),
REQ
Prompt ( 'N & UMBER'), AT (14.43), USE (prompt2?)
ENTRADA (@ s20), AT (68,42), USE (Telefono.Rec.Numero)
BUTTON ( 'OK'), AT (45.74), USE (? Ok), REQ, PADRO
BUTTON ( 'Cancela'), AT (109,74,32,14), USE (? Cancelar)
END

249
250 CLARION 5 CLARION
Aprendiendo

UpdateTelefono PROCEDIMENTO sentena (ao prolongada) estabelece um mtodo de receber


um nico "Action" parmetro LONGO ser chamado dentro do procedimento (no importa qual
varivel ou constante passado).

ReturnValue LONG, AUTOLONGO declara uma varivel que permanece no inicializada pelo
compilador (devido ao atributo AUTO). Por padro, as variveis de memria so inicializados com
espaos em branco ou nulo (dependendo do tipo de dados). AUTO especificar economiza um
pouco de memria, mas com a condio de que o programador est convencido de que atribuir um
valor varivel no inicializada antes de verificar o seu contedo em primeiro lugar, ou muito
difcil de localizar bug intermitente iria ocorrer.

A estrutura janela tem a mscara atributo (mscara), o que significa que os padres de entrada de
dados so verificados como os dados so inseridos, em vez do comportamento padro de entrada
de dados Windows "forma livre".

Os dois controles de prompt de entrada e se combinam para entrada de dados. Os dois controles
Button permitir que o usurio para completar ou cancelar a ao atual.

Os controles de prompt definir rtulos de campos exibidos, e a tecla "acelerador" (ou atalho de
teclado) para navegar at a entrada de controle do PROMPT segue. Atalhos de teclado so
formadas usando ALT mais a letra seguinte e comercial. Por exemplo ( 'N & ombre') indica que
ALT + A ir concentrar para NOTCHcontrol.

atributos usar a entrada controla campos de dados Nome receber automaticamente a entrada do
usurio. A biblioteca de tempo de execuo assegura que o valor atual na varivel chamada no
atributo USO exibido quando o controle tem foco. Quando o usurio insere os dados no controle
de entrada e, em seguida, passar para outro controle, a biblioteca de tempo de execuo assegura
que a varivel chamada no uso atributo receber o valor atual exibido no controle.
O atributo REQ do primeiro controlo ENTRADA significa que o usurio no pode deix-lo em
branco, enquanto o atributo REQ no boto OK verifica se o usurio inseriu dados em todos os
controles de entrada de dados que necessitam dele. Esta verificao feita apenas quando o boto
pressionado com o atributo REQ, porque o usurio no pode sequer passaram pelo controle de
entrada com este atributo.

2. Adicionar a principal lgica do procedimento UpdateTelefono o final do arquivo:


CDIGO
ABERTO (Janela)
DO SetupScreen
ACEITAR
CAMPO DO CASO ()
DE Telefone: Rec: Nmero
CASO CASE ()
CASO DE: Selecionado
EuCONTEDO 251

DO SetupInsert
END
DE? Ok
CASO CASE ()
DE EVENTO: Aceite
EXECUTAR Ao
ADD (Telefone)
PUT (Telefone)
APAGAR (Telefone)
END
IF ERRORCODE () depois parar (ERROR ()).
ReturnValue = ActionComplete
POST (CASO: CloseWindow)
END
DE? Anular
CASO CASE ()
DE EVENTO: Aceite
ReturnValue = ActionAborted
POST (CASO: CloseWindow)
END
END
END
RETURN (ReturnValue)
FAZER julgamentos SetupScreen A rotina SetupScreenpara executar algumas funes de
inicializao da janela. Note que segue a instruo OPEN (janela). Quando alterar
dinamicamente a janela em um procedimento, ele deve ser aberto em primeiro lugar.
? Rec: O DE clusula de nmero de telefone no campo estrutura CASE () mostra duas coisas
importantes. O primeiro o campo de equivalncia (Campo Equate Label) em si. O atributo USE
(Telefono.Rec.Numero) contm pontos no nome do campo, e os pontos no so vlidos para
etiquetas de cdigo de Clarion. Portanto, para construir uma equivalncia para
Telefono.Rec.Numero, o compilador substitui clon item (desde que ambos os pontos so tag
vlido Clarion).
O segundo ponto a considerar o evento da clusula: Selecionado no EVENTO estrutura CASE ().
EVENTO: Selected gerado quando o controle tem foco para entrada de dados, mas antes que o
usurio comea a faz-lo. NO SetupInsert julgamento corre para dar ao operador uma opo e,
em seguida, defina a entrada de formato de exibio e os dados para esse controle ENTRADA.
O Cdigo de EVENTO: Aceito em DE Ok o cdigo que escreve o log para o disco. A estrutura
EXECUTAR ao executada exatamente uma das frases ADD (Telefone), PUT (telefone) ou
DELETE (Telefone).

Uma estrutura EXECUTAR semelhante s estruturas IF e cdigo de execuo em PROCESSO


condicionalmente, dependendo da avaliao de uma condio. A condio EXECUTAR deve
avaliar um nmero inteiro na gama de1 a n (em que n o nmero de instrues de cdigo no
interior da estrutura EXECUTAR), em seguida, executa o cdigo de linha dentro da estrutura que
corresponde ao valor da condio.

Neste cdigo, executar a consulta o parmetro Ao, e ento executa ADD (Telefone) se o valor
da ao 1, PUT (telefone), se dois ou DELETE (Telefone) se 3.

251
252 CLARION 5 CLARION
Aprendiendo

Em geral, quando o que estrutura avaliada cdigo Clarion a ser usado para uma clusula
condicional (SE / ELSIF, PROCESSO ou EXECUTE), a estrutura SE / ELSIF mais flexvel e
menos eficiente. CASE menos flexvel, mas mais eficiente do que IF / ELSIF e executar no
flexvel, mas muito eficiente. Portanto, quando se avalia a condio pode ser resolvido em um
nmero inteiro no intervalo1 an, utilize execute, caso contrrio, tente usar CASE. Se isso no
suficientemente flexvel, vire IF / ELSIF.

IF frase ERRORCODE () depois parar (ERROR ()) verificar se h erros, no importa qual
executar instruo executada. A sentena ReturnValue = ActionComplete definido para retornar ao
processo que fez a chamada, observando que o usurio tenha completado o arquivo de ao, e
ento o POST (EVENTO: CloseWindow) termina o circuito ACCEPT, deixando cair o controle
para a instruo return (ReturnValue ).

3. Adicionar as rotinas chamadas no UpdateTelefono definio do procedimento, no final do


arquivo:

ROTINA SetupScreen
Ao CASE
DE InsertRecord
CLEAR (Telefono.Rec)
TARGET {PROP: texto} = 'Adicionar nova srie'
DE ChangeRecord
TARGET {PROP: Texto} = 'nmero de telefone Modifica' |
& CLIP (Telefono.Rec.Nombre)
SE Telefone: Rec: Number [1] <> '+'
? Telefone: Rec: Number [PROP: Texto] = '@ P ### - ### -
#### P'
END
DE DeleteRecord
TARGET {PROP: Texto} = 'nmero de telefone Elimina' |
& CLIP (Telefonos.Rec.Nombre)
DISABLE (FIRSTFIELD (), LASTFIELD ())
HABILITAO (? Ok? Cancelar)
END

SetupInsert ROTINA
SE Action = InsertRecord
MENSAGEM CASE ( 'International?', 'Format', ICON: Pergunta, |
BUTTON: Se + BUTTON: No, BUTTON: No, 1)
DE BOTO: Sim
TARGET {PROP: Texto} = 'Adicionar nmero internacional'
? Telefone: Rec: Nmero {PROP: Texto} = '@ S20'
Telefone: Rec: Number [1] = '+'
EXIBIO
Selecione (?, 2)
DE BOTO: No
TARGET {PROP: Texto} = 'Adicionar nmero nacional'
? Telefone: Rec: Nmero {PROP: Texto} = '@ P ### - ###
- #### P'
EuCONTEDO 253

END
END

A rotina SetupScreenA ao comea avaliando CASE. Quando o usurio est adicionando um


registro (DE InsertRecord) frase CLEAR (Telefono.Rec) limpa o buffer de registro de colocar
todos os campos em branco ou zero. A declarao TARGET {PROP: Texto} = 'Adicionar novo
nmero de' sintaxe utiliza as propriedades de tempo de execuo Clarion para alterar
dinamicamente a barra de ttulo para "Adicionar novo nmero". A sintaxe permite que as
propriedades alterar qualquer propriedade (atributo) de um aplicativo, uma janela ou cdigo
executvel estrutura RELATRIO dinamicamente. Consulte o Anexo C - Propriedade
Assignaments ema referncia da linguagem Para saber mais sobre isso.

ALVO uma varivel incorporado sempre "pontos" para a estrutura janela aberta. chaves ({}), que
delimita a mesma propriedade, e PROP: Text um parmetro de equivalncia (contido no
EQUATES.CLW) que identifica o item de dados (neste caso, a janela acrdo).

O cdigo indicando ChangeRecord da meta {PROP: Texto} = 'Modificar o nmero de telefone &
CLIP (Telefono.Rec.Nombre) faz o mesmo, mas muda a barra de ttulo para mostrar: "Alterar o
nmero de telefone de algum" O comercial (&) as cordas alfanumricos operador de
concatenao em Clarion, eo clipe procedimento (Telefono.Rec.Nombre) remove espaos direita
do nome. Rec: IF estrutura nmero de telefone [1] <> '+' verifica a presena de um sinal de +
como o campo de nmero primeiro caractere. Este sinal de mais usado aqui como um sinal de
que um nmero internacional.

Note que o telefone: Rec: N [1] aponta para o primeiro byte do campo como uma matriz (array).
Mas voc deve se lembrar que havia atribuir DIM na declarao (que havia declarado um array).
Todos os tipos de corda, cstring, e pString em dados Clarion tambm implicitamente uma matriz
de cadeia (1), DIM (SIZE (Stringfield)). Isso significa que voc pode fazer referncia diretamente
a qualquer caractere nico na string, se foi declarada como uma matriz ou no.

Se o nmero no internacional, o julgamento Telefone: Rec: Nmero {PROP: Texto} = '@ P


### - ### - #### P' usa a mesma sintaxe para mudar a renda mscara controle. Note-se que PROP:
Texto refere-se a qualquer parmetro de controle. Portanto, em uma janela ( 'text ttulo') refere-se
ao ttulo, enquanto ENTRADA (@ S20) refere-se mscara (@ S20).

Do Cdigo DeleteRecord semelhante ao cdigo ChangeRecord. A DISABLE (FIRSTFIELD (),


LASTFIELD ()) instruo usa a FIRSTFIELD () e LASTFIELD () para desabilitar todos os
controles na janela, e depois habilitar (? Ok? Cancelar), permite apenas o OK e Cancelar .

O SetupInsert ROTINAEle executado pouco antes de o usurio vai para o controle de entrada de
nmero. A declarao Ao IF = InsertRecord verifica o valor de Ao e executa apenas o caso
MENSAGEM estrutura quando o usurio est adicionando um novo recorde. O mtodo de

253
254 CLARION 5 CLARION
Aprendiendo

mensagem pode ser utilizada para criar escolhas simples Sim / No para os usurios. Neste caso,
ser perguntado se o nmero internacional.

CDIGO DE BOTO: Se voc executar quando o usurio pressionou o boto Sim na mensagem
de caixa de dilogo. A declarao TARGET {PROP: Texto} = 'Adiciona nmero internacional'
alterar o ttulo da barra de ttulo, e depois Telefone: Rec: Nmero {PROP: Texto} = '@ S20'
mudanas de renda mascarar ENTRADA. Rec: O nmero frase telefone [1] = '+' coloca um sinal
de + na primeira posio do caractere, em seguida, exibe (display) e lugares selecionar o ponto de
insero do usurio na segunda posio (2?) controle atual.

O cdigo de Button: No como mudar o texto na barra de ttulo da janela, e uma mscara de
controle renda.

arquivo de projeto de atualizao

Desde ns adicionamos uma estrutura de arquivo de programa, devemos adicionar os arquivos de


driver (arquivo do driver) para o projeto, de modo que ele pode ser programa "linkeado". Se isso
no for feito, um erro semelhante far com que "erro de link: Arquivo Topspeed no est resolvido
no Hola.obj".

1. Escolha Editar Projeto ...


caixa de dilogo caixa de projeto exibida.
2. Destaque Bibliotecas Database Driver e clique no boto Add File ...
3. Topspeed destacado e, em seguida, pressione o boto OK.
4. Pressione o boto OK para fechar a caixa de dilogo Project.
5. Clique no boto Executar.
o programa executado.

modelos de cdigo OOP gerado pela ABC


Quando voc examinar o cdigo gerado para voc por Gerador de aplicaes, voc vai notar
algumas diferenas fundamentais sobre o cdigo que acabou de escrever. Isso ocorre porque os
modelos de utilizar a biblioteca a construo de aplicaes de alto nvel (Biblioteca Application
Builder Class [ABC]), que um conjunto de classes de Programao Orientada a Objetos (OOP).
O cdigo que acabou de escrever "processual" no POO. Agora vamos dar uma breve olhada
cdigo OOP gerado para mostrar o que aprendeu como codificar modelos que geram links. Ser
apenas uma rpida olhada, para destacar as principais diferenas.

Iniciar uma aplicao com incio rpido


EuCONTEDO 255

1. Escolha Arquivo Novo Aplicativo.


2. Tipo de telefone no campo Nome do arquivo e marque a caixa Quick Start, e em seguida,
clique no boto Salvar.
3. nome do arquivo do telefone, definir o nome e nmero dois campos com mscara @ S20, e
inserir uma chave duplicada, em seguida, pressione o boto OK.
4. Escolher projeto Gerar para gerar o cdigo-fonte.

Um olhar sobre o programa de origem


Vamos agora examinar o cdigo-fonte que foi gerado para voc.
1. Escolha a guia Module e destacar Telefono.clw
2. Clique direito e escolha mdulo a partir do menu de contexto.

O Mdulo de Programa

Este o mdulo de programa (o cdigo deve ser semelhante a este, mas pode no ser exatamente o
mesmo). A estrutura bsica de um programa Clarion OOP o mesmo que usar a linguagem
procedural. As duas primeiras frases so equivale definindo valores constantes que
precisamBiblioteca ABC.Abaixo esto vrias declaraes incluem. Estes dizer ao compilador para
colocar o arquivo de texto chamado no programa no ponto exato da declarao INCLUDE.

PROGRAMA
_ABCD11Mode_ EQUATE (0)
_ABCLinkMode_ EQUATE (1)

255
256 CLARION 5 CLARION
Aprendiendo

Include ( 'ABERROR.INC')
Include ( 'ABFILE.INC')
Include ( 'ABUTIL.INC')
Include ( 'ABWINDOW.INC')
Include ( 'EQUATES.CLW')
Include ( 'ERRORS.CLW')
Include ( 'KEYCODES.CLW')

Os quatro primeiros incluir arquivos (todos comeam com "AB" e terminam com ".INC") contm
definies de classe para algumas das classes biblioteca ABC. Os trs seguintes arquivos includos
(todos com a extenso ".CLW") contm uma srie de declaraes equiparar usada por modelos e
biblioteca.

MAP
MDULO ( 'TELEFOCB.CLW')
DctInit PROCEDIMENTO
DctKill PROCEDIMENTO
END
! --- Aplicao Global e Procedimento definies exportadas -------------
MDULO
principal PROCEDIMENTO ! Clarion 5 aplicao rpida
END
END

A estrutura do mapa contm duas estruturas MDULO. O primeiro declara dois procedimentos
DctInit e DctKill definidos no arquivo TELEFOCB.CLW. Estes dois procedimentos so gerados
para inicializar e no inicializar corretamente os arquivos de dados para uso pela biblioteca ABC.
A segunda estrutura MDULO simplesmente nomear a primeira aplicao chamada de
procedimento (neste caso, Main).

As prximas duas linhas de cdigo so o primeiro OOP frases:

Acesso: Telefone & FileManager


Relacionar: Telefone & RelationManager
A frase de acesso: Telefone declara uma referncia a um objeto FileManager enquanto Relacionar:
Telefone declara uma referncia a um objeto de RelationManager. Essas duas referncias so
incializadas por procedimento DctInit e desinicializadas por DctKill. Estas declaraes so muito
importantes porque eles definem a maneira que voc deve ir para o arquivo no cdigo OOP.
As prximas duas linhas de cdigo declarar um objeto e outro chamado GlobalErrors INIMgr.

GlobalErrors ErrorClass
INIMgr INIClass

Esses objetos lidar com todos os erros e seu arquivo de inicializao do programa (se houver),
respectivamente. Esses objetos so amplamente utilizados por outras classes de biblioteca ABC,
ento deve estar presente (como ser discutido em breve).
EuCONTEDO 257

GlobalRequest BYTE (0), THREAD


GlobalResponse BYTE (0), THREAD
VCRRequest LONGO (0), THREAD
telefone ARQUIVO, DRIVER ( 'TOSPEED'), PRE (TEL), CRIAR, que podem
ser ligada, THREAD
KeyNombre CHAVE (TEL: Name), DUP, NOCASE
registro RECORD, PR ()
nome CORDA (20)
nmero CORDA (20)
END
END
A seguir, h trs declaraes variveis globais que modelos ABC utilizados para comunicar os
procedimentos seguidos pelo Telefone ARQUIVO declarao. Note-se que as variveis globais
tm todo o atributo ROSCA. Isto necessrio, uma vez que, por padro, modelos ABC gerar uma
aplicao MDI, tornando-se necessrio ter variveis globais separadas para cada execuo de
thread ativo (que o que o atributo Thread) cpias.
A seco de cdigo global tem apenas seis linhas:

CDIGO
GlobalErrors.Init
DctInit
principal
DctKill
GlobalErrors.Kill

As duas primeiras frases chamar mtodos Init (no jargo OOP, Um procedimento em uma classe
chamado de "mtodo": ver classe em a referncia da linguagem e dois artigos sobre OOP o
programador'Guia de S). Estes so os mtodos construtores para GlobalErrors e objetos INIMgr.
Ser notado que este mtodo leva um parmetro. Na biblioteca ABC, todos os construtores objeto
mtodos so explicitamente chamado e chamado Init. H vrias razes para isso. A linguagem
Clarion suporta construtores (e destruidores) objeto automtico, e perfeitamente uso "legal" em
qualquer classe que voc escreve. No entanto, os construtores automticos no pode receber
parmetros e muitos dos mtodos InitBiblioteca ABCEles devem receber parmetros. Devido a
isso, e para a consistncia, os mtodos de todos os construtores ABC so nomeados explicitamente
objetos e nomeado Init. Esta prtica acrescenta a vantagem de aumentar a legibilidade do cdigo,
desde que voc pode ver explicitamente que est executando um construtor, enquanto que com os
construtores automticos devem observar a declarao classe para ver se um para ser executado
ou no.
O DctInit chamada de procedimento inicializa variveis de referncia de acesso: Telefone e
relacionar: telefone, para que o cdigo gerado pelos modelos (e qualquer cdigo que voc insira),
pode referir-se os mtodos de arquivo de dados usando a sintaxe de acesso: Telefono.Methodname
ou Relacionar: Telefono.Methodname. Isso fornece uma maneira consistente para fazer referncia
a qualquer arquivo em um programa gerado por modelos ABC: cada um ter a sua objetos de
acesso a arquivos: e se relacionam: correspondente.
O procedimento de chamada principal comea a execuo do resto do programa. Uma vez que o
usurio retorna ao procedimento principal, DctKill e GlobalErrors.Kill executar operaes de
limpeza necessrias antes de retornar para o sistema operacional.

257
258 CLARION 5 CLARION
Aprendiendo

O mdulo UpdateTelefono
Vamos agora examinar o cdigo-fonte que foi gerado por um dos procedimentos. Ns
UpdateTelefono observar o procedimento, que representante de todos os procedimentos gerados
por modelos ABC basicamente seguem o mesmo padro (alertamos novamente, o cdigo que voc
encontrar ser semelhante a este, mas no necessariamente iguais)
1. Escolha Fechar arquivo
2. UpdateTelefono destacar e clique direito e escolha mdulo a partir do menu de contexto.
A primeira coisa a notar a declarao MEMBRO na primeira linha. Esta uma declarao
exigida que diz ao compilador para mdulo de programa "pertence" este arquivo de origem.
Tambm marca o incio de uma "Seo de Dados Mdulo": uma rea onde as declaraes de
dados fonte que so visveis para qualquer procedimento no mesmo mdulo pode ser, mas no fora
dela (ver Declarao de dados e alocao de memria noa referncia da linguagem).
MEMBRO ( 'Telefono.clw') ! Este um membro do mdulo
Include ( 'ABRESIZE.INC')
Include ( 'ABTOOLBA.INC')
Include ( 'ABWINDOW.INC')
MAP
Include ( 'TELEF004.INC') ! Declarao do mdulo de procedimento local
END
Todos os trs contm definies classe incluem arquivos para algumas das classes biblioteca ABC.
Note que a lista de arquivos de incluso diferente do nvel global. s necessrio para incluir as
definies de classe que o compilador precisa saber para compilar apenas este cdigo-fonte. por
isso que a lista de arquivos de incluso um pouco diferente em cada mdulo.
Observe a estrutura de MAP. Por padro, modelos ABC Geral "Os mapas locais do" contendo as
declaraes include para incluir prottipos dos procedimentos definidos no mdulo e quaisquer
outras chamadas a partir do mdulo. Isto permite a compilao mais eficiente, j que apenas uma
recompilao global ser feita quando voc alterar alguns dados globais, e no apenas pela adio
de um novo procedimento de aplicao. Neste caso, h outros procedimentos chamados a partir
deste mdulo.
A declarao procedimento comea procedimento UpdateTelefono (que tambm termina do
Mdulo de Dados Seo).
PROCEDIMENTO UpdateTelefono ! Gerado a partir do modelo - Janela

CurrentTab Corda (80)


FilesOpened byte
ActionMessage Cstring (40)
Histria :: TEL: Record SIMILAR (TEL: RECORD) ESTTICO

Seguem-se quatro declaraes declarao PROCEDIMENTO. Os dois primeiros so comuns


maioria dos procedimentos gerados. Fornecer galhardetes locais usados internamente pelo modelo
de cdigo. O ActionMessage e Histria :: declaraes TEL: Record so especficos para um
procedimento Form. Declare uma mensagem para o usurio e uma "rea de armazenamento" para
o uso de chave histria campo (Histria Campo Key), tambm chamada de chave de "ditto" na
barra de ferramentas.
Aps a estrutura declaraes de janela so os seguintes itens:
EuCONTEDO 259

ThisWindow CLASSE (de janelas)


perguntar PROCEDIMENTO (), VIRTUAL
Init PROCEDIMENTO (), BYTE, Proc, VIRTUAL
matar PROCEDIMENTO (), BYTE, Proc, VIRTUAL
END
Toolbar ToolbarClass
ToolBarForn ToolbarUpdateClass
Resizer WindowResizeClass

Os trs ltimos so simples declaraes que criam objetos locais que permitem que o usurio use a
barra de ferramentas e redimensionar a janela. O que interessante aqui a classe declarao
ThisWindow. Esta estrutura de classe declara uma classe de janelas objeto derivado no qual pede,
Init, e que o Pai Kill (gerenciador de janelas) mtodos de classe so "ignorados" localmente.
mtodos virtuais que significa que todos os mtodos herdados da classe de janelas podem
continuar chamando mtodos negligenciados. Este um conceito muito importante naOOP, Que
mais profundo em referncias para a aula e OOP em Referncia de linguagem e Guia do
Programador.
Em seguida, vem o cdigo executvel do seu procedimento:
CDIGO
GlobalResponse = ThisWindow.Run ()
Exatamente ... uma nica frase! A chamada para ThisWindow.Run todo o cdigo executvel do
procedimento! Desta forma, voc perguntar: "Mas onde est todo o cdigo que executa todas as
funes que eu vejo correndo quando eu executar o programa" A resposta : "Na biblioteca ABC",
ou pelo menos a maioria . A boa notcia que todo o cdigo padro para operar qualquer
procedimento j est incorporado na biblioteca, o que reduz significativamente o "peso" total do
programa, uma vez que todos os procedimentos de partilhar o mesmo conjunto de cdigo comum
que foi refinado (e improvvel para entrar em qualquer problema que voc gerar programas).
Toda a funcionalidade especfica para este procedimento gerado nos mtodos "esquecido". Para
este procedimento, existem apenas trs mtodos que ao deve sofrer. Como a funcionalidade
que voc aplica para o procedimento, os modelos ABC vai esquecer os mtodos necessrios. Voc
tambm tem pontos de insero disponveis em cada mtodo possvel "ignorar" por isso fcil
para forar modelos para "ignorar" qualquer mtodo voc precisa de algo funcionalidade diferente,
simplesmente adicionando seu prprio cdigo nestes pontos insero (usando pontos de insero
editor do gerador de aplicaes).
Ok, ento vamos olhar para os mtodos "esquecido" neste procedimento:
PROCEDIMENTO ThisWindow.Ask
CDIGO
self.request CASE
DE InsertRecord
'Telefone Adicionando um Record' ActionMessage =
Registro de Mudana
'Telefone Mudando um Record' ActionMessage =
END
QuickWindow {Prop: Text} = ActionMessage
PARENT.Ask
A linha de realmente interessante deste procedimento a ltima. PARENT.Ask pai chama o
mtodo que foi "esquecido" pelo mesmo procedimento, para exercer a sua funcionalidade padro.

259
260 CLARION 5 CLARION
Aprendiendo

palavra-chave pai poderoso porque permite que um ltimo mtodo alta em uma chamada classe
derivada o mtodo que substitui a fazer o seu trabalho, permitindo que o passado mtodo para
aumentar a funcionalidade do pai mtodo esquecido.
PROCESSO ThisWindow.Init ()
CDIGO
Self.request = GlobalRequest
PARENT.Init IF () em seguida, retornar Nvel: Notificar.
SELF.FirstField = TEL: Nome: Prompt
SELF.VCRRequest & = VCRRequest
SELF.Errors & = GlobalErrors
CLEAR (GlobalRequest)
CLEAR (GlobalResponse)
SELF.AddItem (barra de ferramentas)
SELF.AddUpdateFile (Acesso: Telefone)
AUTO: HistoryKey = 734
SELF.AddHistoryFile (TEL: Record, Histria :: TEL: Record)
SELF.AddHistoryField (TEL: Nome, 1)
SELF.AddHistoryField (TEL: Nmero, 2)
SELF.AddItem (? Cancelar RequestCancelled)
Relacionar: Telefono.Open
FilesOpened = True
SELF.Primary & = Referir: Telefone
SELF.OkControl = Ok
SELF.PrimeUpdate IF () em seguida, retornar Nvel: Notificar.
ABERTO (QuickWindow)
ABERTO (QuickWindow)
SELF.Opened = True
Resizer.Init (AppStrategy: Superfcie, Redimensionar: SetMinSize)
SELF.AddItem (redimensionador)
Resizer.AutoTransparent = True
ToolBarForm.HelpButton = Ajuda
SELF.AddItem (ToolbarForm)
SELF.SetAlerts ()
RETURN Nvel: Benigna

Existem vrias linhas interessantes em ThisWindow.Init PROCEDIMENTO. Este o mtodo


construtor ThisWindow objeto, de modo que todo o cdigo que est includo na mesma executa
tarefas de inicializao especificamente exigido pelo procedimento UpdateTelefono.
A primeira frase self.request = GlobalRequest, recupera o valor da varivel global e coloca-lo na
propriedade SEFT.Request. AUTO outra palavra-chave poderosaOOPClarion, que sempre
significa "o objeto atual" ou "I". AUTO o objecto prefixo que permite mtodos de classe escritas
genericamente para se referir a qualquer objeto, uma instncia de uma classe, que est sendo
executado.
A segunda instruo chama o mtodo PARENT.Init (() (o pai cdigo de mtodo para todas as
funes padro) antes de o resto do procedimento de inicializao especfica cdigo executado.
Abaixo est uma srie de declaraes que inicializar vrios as propriedades necessrias Relacionar
sentena. Telefono.Open telefone abre o arquivo de dados para processamento, e se houvesse
crianas relacionados arquivos necessrios para o processamento de integridade referencial neste
processo, tambm aberto (neste caso, no h nenhuma).
EuCONTEDO 261

Alm de chamar mtodo PARENT.Kill () para executar todas as funes de perto (o mais
prximo), ThisWindow.Kill fecha todos os ficheiros abertos sobre o procedimento, e definir a
varivel GlobalResponse.
Escolha Fechar arquivo

O que vem a seguir

Este curso foi apenas uma breve introduo linguagem de programao Clarion e o cdigo
gerado pelos modelos ABC. H muito mais a aprender com o que ns cobrimos aqui, ento ...
Onde continuar?
artigos em o programador'Guia de S. Estes abrangem vrios aspectos da programao nesta
lngua. Apesar de no ser "cursos" fornecer informaes detalhadas lidar com reas
especficas, e h vrios que tratam especificamenteOOP Clarion.
O Manual do aplicativo de documentos totalmente a biblioteca e modelos ABC. Esta a
chave para obter o mximo de Generator Aplicao de recursos de tecnologia.
A referncia da linguagem a "Bblia" da lngua Clarion. sempre boa idia para l-lo
completamente.
Estudar o cdigo fonte produzido pelo gerador de aplicaes. Tendo feito este curso, a
estrutura bsica do cdigo deve parecer familiar, embora no a lgica especfica de
determinados sectores.
do Usurio'S GuiaEle contm oficinas sobre o uso de purificadores (depuradores). Isso
permitir que voc para ir passo a passo pelo cdigo Clarion como ele executado para ver
exatamente o efeito que cada declarao na execuo de um programa.
Os utilizadores registados a Argentina e os pases de lngua espanhola tm acesso ao suporte
tcnico atravs da Internet em http://www.unisoft.com.ar (ou tambm, www.clarion.com.ar)
Correio eletrnico: soporte@unisoft.com.ar
TopSpeed oferece seminrios educacionais em vrios locais. Contactar o Servio de Cliente
para os nmeros: (800) 354-5444 ou (954) 785-4555 para obter informaes.
CompuServe tipo GO Topspeed para entrar no frum de suporte tcnico TopSpeed, ou on-
line, digite a notcia grupo comp.lang.clarion por qualquer servidor Usenet (Altamente
recomendado!)

Boa sorte, e continuar trabalhando. Como dissemos: o poder da programao que coloca em suas
mos Clarion cresce medida que voc aprende mais sobre!

VOCABULARY

261
262 CLARION 5 CLARION
Aprendiendo

Ingls castelhano
classe construtor de aplicao [ABC] biblioteca = aplicaes high-end edifcio da Biblioteca
manual de aplicao = Aplicao manual
Assistente de aplicao = aplicaes Assistant
caixa = Box (para colocar tiles), segurana
pausa = salto
procurar = Exibir as listagens
amortecedor = rea de armazenamento temporrio
biblioteca de matemtica de negcios = Funo matemtica biblioteca de negcios
comportamento condicional = Operao condicional
criar = criar
omisso = Padro, pr-configurado
guia Dployment do usurio kit = Guide, Kit de Instalao
dilogo = Caixa de dilogo
editor de Dicionrio = Editor Dicionrio
motoristas = motoristas
editar-in-place = Modificao in situ
pontos incorporar = Pontos de insero
cdigo embutido = Insero Cdigo
ferramentas empresariais = Ferramentas do negcio
caixa de entrada = Caixa de entrada de dados
EQUATE = equivalncia
programao orientada a eventos = Agendamento Baseado
campo equiparar rtulo = Campo de rtulo Equivalent
arquivo = arquivo
arquivo esquema = rvore de arquivos
acabamento = Fim, extremidade
formas = fichas
manusear = Asa, "puxar gabinete"
ajudar = Ajuda
Ajuda ndice contedo de ajuda =
incrementais = progressiva
incrementalmente = progressivamente
iniciar fio = Comece segmento de execuo
EuCONTEDO 263

chaves = chave
etiqueta = Sinal; etiqueta
referncia languaje = Referncia da Linguagem
Lista Box Formatter = Designer Lista Boxes
Lookup = Consulta (um arquivo relacionado)
mapa = Mapa, mapeamento, correlao, correlacionando
ndice mestre = ndice Geral
novo = new
prximo = prxima
Objet Oriented Programming (OOP) = OOP (POO)
Form pgina = Pgina de Base (relatrios)
pgina estouro = Pgina Overflow (relatrios)
caminho = Caminho ou rota pesquisa
formato de imagem = Formato de dados (P #### P); visualizao padro e
arquivamento
token de imagem = Rendimento mscara (ou monitor) dados
menu pop-up = Menu Contextual
mecanismo de impresso = Motor de impresso (relatrios)
procedimento assistentes = Procedimento Assistentes
janela de progresso = Janela Indicator
carga rpida = (Assistente) "carga rpida"
de incio rpido = (Assistente) "Quick Start"
limite de alcance = Intervalo de limite (limite de pesquisa)
filtro de registro = Filtrar registros
de pedidos recorde = Ordem de registros
relatrio = relatrio
relatrio formatador = Report Designer
repor em = Redefinir sobre
corrida = executar
Salvar como tipo = Salvar como ...
instalao = Instalando, configurando
aba = Tab, chave de guia, guia
tally = marcador
modelo = template
thred = Segmento de execuo

263
264 CLARION 5 CLARION
Aprendiendo

ponta = Dimensionamento (legenda explicativa)


tipo de total Tipo = total (soma, mdia, mais elevada, a mais baixa)
atualizar = Modificao, actualizao
Guia do Usurio = Guia do Usurio
Formatter janela = Janela Designer
assistentes = participantes
castelhano Ingls
encenao = ponta
rvore de arquivos Esquemtica File =
arquivo = arquivo
manusear = manusear
Assistente de aplicao = Assistente Aplicao
participantes = Assistentes
procedimentos assistentes = assistentes Procedimento
ajudar = ajuda
prdio da biblioteca
aplicaes de alto nvel = Application Builder Class [ABC] Biblioteca
biblioteca funo matemtica
negcio = Biblioteca de matemtica de negcios
caixa = caixa
caixa de dilogo = Dilogo caixa de dilogo,
armrio = caixa
caixa de armrio ou entrada de dados = Caixa de entrada
chave = teclas
cdigo introduzido = Cdigo incorporado
verificaes de validade = verificaes de validade
configurao = configurao
consulta = lookup
contedo da Ajuda = contedo da Ajuda
controladores = motoristas
criar = criar
pgina Overflow = Estouro Pgina
Report Designer = Relatrio Formatter
Janela Designer Janela = Formatador
editor de Dicionrio = Editor Dicionrio
EuCONTEDO 265

corrida = executar
registros = Forms
filtrar registros = Filtro da ficha
formato de (P #### P) ou "padro
visualizao e arquivamento " = Formato de imagem
operao condicional = Comportamento condicional
salvar como ... Salvar como tipo =
Guia do Programador = Guia do Programador
Guia do Usurio = Guia do Usurio
Guia para Kit de Instalao = Guia de Implementao do Utilizador do Kit
ferramentas de negcios = ferramentas da empresa
thread de execuo = fio
ndice do frum = ndice de Mestrado
relatrio = relatrio
iniciar thread de execuo = Iniciado rosca
instalao = configurao
limite de alcance = Limite de Gama
limitar pesquisa = Limite de Gama
Guia de aplicaes = Manual de Aplicao
marcador = contagem
renda mscara (ou exibio)
dados = Imagem Sinal, formato de imagem
modificao in situ = Editar no lugar
mecanismo de impresso = Imprimir pgina
novo = new
ordem dos registros = Ordem Gravar
pgina base = Pgina de formulrio
modelo = template
programao baseada em evento = Programao orientada a eventos
OOP (POO) = Objet Programao Orientada (OOP)
pontos de insero = pontos Incorporar
Referncia da linguagem Idioma = referncia
sinal = rtulo
rota (ou faixa) pesquisa = caminho
saltar = pausa

265
266 CLARION 5 CLARION
Aprendiendo

seguinte = prxima
Finalmente, a extremidade = acabamento
janela do indicador = Janela Progresso
verificaes de validade = cheks Validade
rota (ou caminho) pesquisa = caminho
display = navegar

CLARION 5

EuCONTEDO 267

Primeiros
passos
Copyright 1994, 1995, 1996; 1997 por TopSpeed Corporao
Copyright 1998, Unisoft SRL
Todos os direitos reservados
Este trabalho protegido por copyright e todos os direitos reservados. no pode ser copiado,
fotocopiado, reproduzido, traduzido ou passado para mdia eletrnica ou computador sem o
consentimento escrito dos detentores de direitos.
Esta publicao acompanha Clarion 5. Pode conter erros tcnicos ou tipogrficos. TopSpeed e
Unisoft o entregue "como est" sem garantia, expressa ou implcita.

TopSpeed Corporao
150 East Road Amostra
Pompano Beach, Florida 33064
(+ 1-954) 785-4555

Unisoft SRL
Uruguai 263, piso 5
1015 - Buenos Aires
Tel./Fax: (54-11) 4372-7243 / 9850; 4374-2298 / 9469

Traduo: Hctor Daniel Calabia, Belca


Armado Lilia GB Calabia, Belca. Tel. 4774-6845. Fax: 4777-6683

267
268 CLARION 5 CLARION
Aprendiendo

sistemas RC: reviso e atualizao. Salta - Argentina. 1.999.

Mark Reconhecimento:
TopSpeed marca registrada da TopSpeed Corporation.
Clarion5 marca registrada da TopSpeed Corporation.
Btrieve Btrieve Technologies uma marca registrada.
Microsoft, Windows , e Visual Basic so marcas registradas da Microsoft Corporation.
Todos os outros nomes de produtos e empresas so marcas comerciais ou marcas registradas de
seus respectivos proprietrios.

impresso em a Argentina - Impresso na Argentina.

CONTEDO

1 - INTRODUO 7

Bem-vindo! 7
Nveis de usurios / desenvolvedor ............................................. ...........................................
7
O que h nesta seo ............................................. .................................................. ....... 9
Onde encontrar mais informaes .............................................. ....................................... 10
convenes da documentao 12
Convenes tipogrficas ................................................ .................................................. 12
convenes de teclado ............................................... .................................................. .. 12
Informaes sobre o produto 13
Registro ................................................. .................................................. ............................ 13
suporte tcnico ................................................ .................................................. ................. 13
Fax sistema de resposta ............................................. ................................................ 13
Configurao: Configurao 14
EuCONTEDO 269

Requisitos do sistema ............................................... ................................................. 14


Iniciando o Setup ............................................... .................................................. .............. 14
As opes de instalao ............................................... .................................................. ... .. 15
execuo Clarion ............................................... .................................................. ......... 16

2 - ITART RApido: CUrsillo 17


Quick Start Wizard (Quick Start Wizard) 18
criao dicionrio e aplicao .......................................... ....................... 18
assistente de carregamento rpido (Assistente de carga rpida)
23
Adicionar um arquivo ............................................... .................................................. ..............
23
Adicionar uma relao ............................................... .................................................. ...........
25
procedimentos assistentes (Procedimento assistentes) 28
Usando o Assistente para navegar ............................................. ..............................................
30
E, finalmente, o Assistente de aplicao! 34
Usar o Editor do Diccionary para configurar ............................... Assistente 34
Usando o Assistente de aplicao ............................................. ...................................... 35
Que segue ................................................ .................................................. .......................... 38

3 - PANORAMA PROCESSO DE DESENVOLVIMENTO


39

O Tao da Clarion 39
Clarion uma linguagem de programao ............................................ ................................
39
............................................... nveis de abstraco .................................................. ....... 39
nveis de abstrao Clarion ............................................. ......................................... 41
.............................................. modelos de programao controlados ............................... 42
ambiente de desenvolvimento Clarion 45
Qual ser a prxima? .................................................. .................................................. ..........
48

269
270 CLARION 5 CLARION
Aprendiendo

- EuNTRODUO

Bem-vindo!
Muito obrigado por adquirir Clarion. Agora voc tem em suas mos a ferramenta mais poderosa e
flexvel para desenvolvimento de aplicativos. Muito em breve, voc vai apreciar a si mesmo.

Nveis de usurios / Desenvolvedor

Clarion opera em vrios nveis, e suporta todos os nveis de usurio ou desenvolvedor.

um desenvolvimento automtico tratado por assistentes (wizards)

Quando voc precisa de uma aplicao "simples" para a manuteno de um banco de dados, o
trabalho vai levar apenas alguns minutos usando Clarion. A chave est no dicionrio de dados. Se
o Application Builder (Gerador de Aplicativos) arquivos conhecidos ou tabelas que voc precisa, e
como eles link, voc pode construir um aplicativo completo. Ento tudo que voc tem a fazer
escolher um ou mais arquivos, e indicar o tipo de relaes que eles tm uns com os outros (se dois
ou mais). curso de curta durao no Incio Rpido este livro voc vai encontrar uma demonstrao
de como fcil todo o processo.
Assim, o Application Wizard (Assistente de aplicao) pode criar uma aplicao completa usando
o conceito genrico de aplicaes Clarion. Chamamos de navegao-forma de conceito (
"procedimento de display / record"), que se estende directamente a partir da estrutura do banco de
dados. O aplicativo funciona da seguinte forma: (1) O usurio final navega o banco de dados -
tudo ou parte de um arquivo de dados ou bancos de dados mltiplos relacionadas-- percorrer uma
lista em que cada item representa um inscrio. A janela em que isso feito chamado de
"browse" (pronunciado / Braus /). (2) O utilizador selecciona um registo da lista para executar uma
aco, tal como a modificao de dados. Isso geralmente feito em uma janela separada, em que
os campos de banco de dados aparecem na edio caixas separadas. Isso chamado de "forma guia
ou update" ( "forma" update). A guia tambm pode aceitar novos dados. (3) Opcionalmente, o
utilizador final pode verificar um valor de uma tabela ligada para entrada de dados para a pgina.
EuCONTEDO 271

Isso abre outro em uma janela de navegao separada. O usurio pode escolher um item, fechando
a janela e colocar o valor na caixa de edio no separador. Isso chamado de "consulta" (lookup).
Esta seria a descrio mais genrica. Alm disso, cada janela de exibio ou navegar, voc pode
navegar a partir da barra de ferramentas, que se abre para um segmento separado da execuo,
com o seu prprio buffer de log, permitindo a manipulao de dados mais seguros. Vrios sistemas
podem ser selecionados por chave ( "chaves"), clicando em uma guia. Um duplo clique em uma
entrada da lista abre um guia de atualizao com o uso de verificao automtica simultnea (para
aplicaes multi-utilizador) e restries de integridade opcionalmente referenciais que mantm
relaes do banco de dados.

Qualquer um pode fazer isso. Comea simplesmente, escolher um arquivo de dados da lista.

um ambiente de desenvolvimento visual

Com Clarion, coloque um controle em uma janela faz muito mais do que em outro rpido
desenvolvimento de aplicaes, tipicamente uma vez controlar as ferramentas de interface de
usurio colocados, espero que voc escreva o cdigo para faz-lo funcionar. Com Clarion, voc
adicionar um modelo ou modelo, que contm o controle e todos os elementos de dados e cdigo
executvel necessrios. Isso significa que no escrever o cdigo, basta um clique para obter uma
soluo completa: interface de usurio de controle, e o cdigo que faz com que funcione. Alm
disso, cada modelo tem sua prpria interface do usurio. Quando se observam as propriedades do
modelo, que a guia "Aes" (aes). Atravs de aes como responder a uma caixa de dilogo,
selecione um item de uma lista drop-down, ou preencher uma caixa, voc pode alterar o
funcionamento do modelo para que ele responde exatamente s necessidades da aplicao. Durante
o curso aqui apresentado, haver muitas oportunidades para configurar essas aes. O workshop
sobre o Application Builder na seo Clarion Aprendizagem apresenta todas as ferramentas de
desenvolvimento rpido de aplicaes (RAD), que tem o programa.

Quando os modelos de interface para especificar tais comportamentos usado, o Application


Builder escreve o cdigo fonte Clarion que os implementa. um cdigo orientado a objeto,
construdo a partir da classe de aplicativo Clarion biblioteca (Application Builder Class [ABC]
Library), por isso um cdigo muito compacto e eficiente. Usando os modelos, voc pode fazer
uma enorme quantidade de totalmente configurado para suas necessidades de programao sem
escrever uma nica linha de cdigo com a mo.

A magnitude eo alcance da lngua Clarion pode parecer impressionante primeira vista.


refernciaLanguage (languaje Referncia) tem cerca de 1000 pginas. Uma das grandes vantagens
de ter os modelos do sistema, alm da capacidade de escrever cdigo manualmente, voc pode ir
est entrando na linguagem, ritmo e profundidade que voc deseja. Se voc no gosta da maneira
como os modelos de resolver um problema particular, voc pode us-los em primeiro lugar, apenas
para sobreviver. Voc pode ento usar o prprio modelo de interface para torn-lo mais ao seu
gosto. Finalmente, quando Clarion domina o idioma, voc pode escrever sua prpria soluo com
total liberdade. (Nota: Voc tambm pode comprar modelos de terceiros para ter uma outra
maneira de resolver problemas).
usurios avanados de computador geralmente no escrever programas que podem fazer isso
facilmente.

271
272 CLARION 5 CLARION
Aprendiendo

uma linguagem de programao completa


Em seu nvel mais bsico, voc pode codificar um aplicativo inteiramente mo, usando a
linguagem de quarta gerao Clarion. Clarion tem um alto nvel de abstrao, o que faz de banco
de dados compacto muito "legvel" e sintaxe para que um registro pode ser facilmente manipulado,
ou grupos dos mesmos. No h necessidade de saber para criar uma aplicao Clarion ... mas eu
sei como ele funciona, ele vai ajudar voc a entender o que eles fazem aplicaes, que vo
melhorar a sua qualidade. O workshop sobre o Construtor de aplicao na seco de
Aprendizagem cristalino, estimula a escrever uma pequena poro de cdigo fonte no interior do
Clarion gerado pelo molde, e a Workshop sobre Clarion Language (em corte) o completamente
inserido o codificao manual.

Desenvolvedores profissionais realmente apreciar a linguagem Clarion. Ele foi projetado desde o
incio para programadores de aplicativos de negcios. Facilidade de aprendizagem (em
comparao com outras linguagens de baixo nvel) no impede que voc tenha um desempenho
brilhante. compilador TopSpeed converte todo o cdigo, seja escrito mo ou usando o
Application Builder, altamente otimizado cdigo binrio.

NOTA: No importa o nvel tentar trabalhar, eventualmente: ele vai fazer muito
melhor se voc praticar cada curso at o final.

O que h nesta seo

Esta a introduo ao ambiente Clarion. A seguir est uma lista de partes desta seo, e resumiu
seu contedo:

introduo Chapter One: Clarion apresenta e instrues para


carreg-lo no computador.

Cursilho para um incio rpido Captulo Dois:algumas etapas fceis com o assistente
(Wizard) de incio rpido permitem que voc crie uma
aplicao completa em cinco minutos. Ento, em menos
de uma hora, este captulo vai te ensinar a usar os
assistentes e procedimentos Application Wizard para
criar uma aplicao simples, e depois estender sua
funcionalidade a um programa elaborado trabalhar com
dois arquivos. Este objectivo ser alcanado sem
escrever uma nica linha de cdigo.
EuCONTEDO 273

fluxo de desenvolvimento Captulo Trs: uma reviso do conceito Clarion de


desenvolvimento de aplicaes. Descreve todas as
ferramentas do ambiente de desenvolvimento.

Onde encontrar mais informaes

O primeiro lugar a olhar a seo Como posso ...? ( "Como posso ...?"). Estes tpicos responder a
muitas das perguntas mais comuns feitas recm-chegados a Clarion. Pressione o boto Como
posso ...? seo de ajuda do contens para ir a essa seo.

Clarion tem um sistema de ajuda muito extensa. ajuda hipertextual aparece quando voc pressiona
a tecla F1 ou selecione uma das ordens a partir do menu Ajuda. A ajuda on-line tratado por caixa
de dilogo para fornecer ajuda sensvel contexto, quando necessrio.

H tambm um nmero de livros includos no Clarion.

Comeando com Clarion


este volume, que adiciona dois volumes separados do original em Ingls: Introduo (esta
seo)
aprendizagem Clarion (Seco: Aprendizagem Clarion)
Esta ltima seo contm dois tutorial passo-a-passo. A primeira sobre o Application
Builder, que fornece uma introduo abrangente para todas as ferramentas do ambiente de
desenvolvimento. A segunda apresenta a prpria linguagem de programao Clarion.
Manual de aplicao (Aplicao manual)
o manual para as ferramentas Clarion voc vai usar mais no desenvolvimento do
aplicativo (em formato .PDF na edio padro CD). Descreve os modelos que esto
includos com o produto, fornece uma documentao completa das aplicaes de
construo de biblioteca de classe (ABC Biblioteca), utilizando o cdigo gerado pelos
modelos, e oferece informaes em profundidade sobre os drivers mais recentes (unidades)
arquivos Clarion .
Referncia da linguagem (Referncia da linguagem)
Complete a linguagem Clarion (em formato .PDF na edio CD padro) guia. Este livro
fornece descries da sintaxe completa Clarion, e todas as ordens disponveis, com
exemplos de cada um. A referncia da linguagem organizada por tpicos funcionais. O
texto completo deste livro tambm est disponvel na ajuda online. Ao trabalhar no Editor
de texto, coloque o ponto de insero em qualquer funo ou instruo Clarion, em seguida,
pressione Fl para obter ajuda sobre o assunto.
Guia do Usurio (Guia do Usurio)
Fornece classificados por diferentes tarefas do ambiente de desenvolvimento ordenadas
pelas componentes principais (em formato .PDF no padro CD e Professional Editions)
descrio.

273
274 CLARION 5 CLARION
Aprendiendo

Guia do Programador (Guia do Programador)


Coleo de artigos discutir em profundidade os vrios aspectos de artigos de linguagem
de programao Clarion sobre como personalizar o ambiente de desenvolvimento
(disponvel apenas nas edies profissionais e de negcios em formato PDF no CD de
edio Professional). Ele tambm contm o guia completo para a linguagem da modelos
Clarion, que fornece descries de todas as instrues e funes, com exemplos de cada
um, com claras demonstraes de como escrever seus prprios modelos.
Guia do Usurio do ReportrWriter (Guia do Usurio ReportWriter)
ReportWriter para Windows documenta a Clarion. Esta uma ferramenta independente
para fazer relatrios (includa apenas no Professional e Enterprise as edies em formato
.PDF na Professional Edition CD), que tambm est disponvel como um produto separado.
Ferramentas corporativas (Ferramentas de Negcios)
ferramentas Documenta disponveis para o desenvolvimento cliente / servidor (Dicionrio
de Dados e syncronizer), desenvolvimento de grupo (Version Control / Team Developer) e
ferramentas de Dados Modeller. tambm documentoso Busines Math biblioteca(Funo
Biblioteca Negcios Matemtica) e sbio para Clarion (ferramenta de usurio final para a
criao de instalaes). Este manual est includo apenas na verso da empresa (alguns
componentes tambm esto disponveis como um produto separado).
Wizatron Handbook.
Documenta os wizatrons, tecnologia avanada gerao de assistentes Clarion que
"aprender" como voc trabalha, e tornar-se seu assistente de programao automtica
(disponvel apenas com o Enterprise Edition).
ndice de mestre (Index)
Um ndice resumo completo de todos os documentos impressos e tipo .PDF que vem com
todas as edies do Clarion (impresso apenas no CD Enterprise Edition no formato .PDF
em todas as outras edies).

Todos os livros esto no formato .PDF no CD (ou em disquetes separados, no caso das verses em
espanhol) so acessveis pelo programa Adobe Acrobat ReaderQue tambm pode ser instalado a
partir do CD Clarion. pesquisas por assunto ou palavra podem ser feitas nesses arquivos .PDF, e
tambm pode ser impresso, se desejado.

Importante: Se alguma parte do texto em linha contradiz a documentao impressa,


documentao on-line tem precedncia. TopSpeed Corporao faz todos os esforos para
garantir que a documentao impressa at data. No entanto, o tempo necessrio para
impressoras podem causar algum imprecises: podemos atualizar os arquivos de ajuda para o
lanamento de uma reviso do produto em si; mas materiais impressos deve "pegar" mais tarde.
EuCONTEDO 275

convenes da documentao

convenes tipogrgicas:

itlico Indicar o que deve ser digitado no teclado, tais


como Escreve isto. tambm,
ocasionalmente, eles costumavam enfatizar
certas palavras ou frases ou expresses indicam
lngua estrangeira.

Small Caps Indicam teclas, como ENTER ou


ESCAPE, ou clique com o mouse.

negritas Indicam comandos ou opes de menu, ou


texto em uma caixa de dilogo. Nota: Este
estilo tambm pode usar uma famlia de fontes
diferentes, para coincidir com a Helvetica
negrito usando o Windows como sistema de
origem.

LETTERGOTHYC Ele usado para diagramas, listas de cdigo-


fonte, para discutir exemplos e exemplos de
uso de instrues de cdigo.

convenes de teclado

Fl Indica uma nica tecla. Neste caso, pressione e


solte a tecla Fl.

275
276 CLARION 5 CLARION
Aprendiendo

ALT + X Indica um impulso combinado. Neste caso,


pressione a teclaALT e pressione X, em seguida, solte
ambas as teclas.

Informaes sobre o produto


inscrio

Antes de comear a usar Clarion, preencher e devolver o carto de registro encontrada na caixa
UniSoft, Uruguai 263 piso 5 (1015), Buenos Aires, Argentina ou seu representante local. Este
carto permite-lhe desfrutar de vrios benefcios importantes. Uma vez cadastrado, voc pode usar
os servios de suporte tcnico, e receber automaticamente notificaes de anncios e melhorias do
produto.

suporte tcnico

em a Argentina
Usurios cadastrados a Argentina e os pases de lngua espanhola tm suporte tcnico
gratuito via Internet em: http://www.clarion.com.ar (ou, ww.unisoft.com.ar) por
servios de grupos de discusso e FTP. Uma equipe de tcnicos locais experientes
(CST: Suporte Clarion Equipe Argentina) ir responder s suas perguntas. Eles
tambm pode obter assistncia por e-mail para apoiar @ UniSoft, com.ar, ou pelo fax
(+ 54-11) 4.374-9.469.
H tambm planos de apoio alternativos por assinatura anual ou horas de consultoria,
como o "Suporte Corporativo", que inclui suporte ilimitado telefone,
acompanhamento de problemas, aconselhamento e outros servios. Para mais
informaes, consulte o (+ 54-11) 4372-7243.

apoio internacional
Voc pode receber suporte tcnico ilimitado de Informao CompuServe Servio Clarion e na
Internet. funcionrios Topspeed e Associates Certified Suporte TopSpeed Tcnica (um grupo
voluntrio de usurios conhecidos como Team TopSpeed Clarion), responder s suas perguntas
prontamente. Alm disso, voc pode obter conselhos e respostas de outros usurios Clarion.
Recomendamos vivamente os nossos clientes a fazer uso desses servios.
CompuServe tipo GO Topspeed para entrar no frum Topspeed suporte tcnico.
Internet, digite o servidor de notcias grupo comp.lang.clarion atravs de qualquer servidor
Usenet.
Internet, indique as topspeed.products grupo tsnews.clarion.com servidor de notcias.
Tambm na Internet, visite o website em http://www.topspeed.com TopSpeed. Clarion para
mais recursos.
O pagamento tambm pode ser obtido o servio de telefone o Coporacin TopSpeed em (1) (954)
785-4556.
EuCONTEDO 277

sistema de resposta Fax

TopSpeed tambm oferece discagem por fax para acessar os documentos tcnicos e de negcios
mais comuns. documentos online, incluindo folhetos de produtos, documentos tcnicos,
reimpresses de artigos, listas de preos, e at mesmo uma atualizao dos mais recentes produtos
TopSpeed ( "What'sHot").
Para pedir documentos especficos, disque (+ 1- 954) 4785-4555, pressione 53 e ouvir as
instrues do sistema. O menu interativo e acessvel. Primeiros chamadores podem solicitar uma
lista de documentos disponveis para fazer a sua escolha. Voc pode, em seguida, digite o nmero
do cdigo do documento, eo material ser transmitida para ele imediatamente. Voc pode acessar
o sistema a partir de sua mquina de fax ou qualquer telefone multifrecuente.

Configurao: Configurao
O programa de instalao descompacta e copia os arquivos Clarion para seu disco rgido.
Em todos os sistemas operacionais, oferece opes para instalar os vrios componentes, tais
como arquivos de amostra.
Em todas as verses do Windows, questionar antes de atualizar o caminho (PATH) no arquivo
AUTOEXEC.BAT para incluir o diretrio Clarion.
No Windows 3.x pergunta se pretende instalar os cones do gerente de programa para o
ambiente de desenvolvimento Clarion, e arquivos Debugger (depurador), Ajuda e ReadMe.
No Windows 95 e Windows NT, sugere a instalao de todo o ambiente de desenvolvimento
cones entre os programas menu Iniciar ( "Start").

Requisitos do sistema

Voc pode executar o ambiente de desenvolvimento Clarion em qualquer sistema que atenda aos
requisitos mnimos para Microsoft Windows 3.x, Windows 95 , ou Windows NT. Estes so os
nossos mnima recomendada:
Windows 3.x, 8 megabytes de RAM.
Windows 95, 16 megabytes de RAM.
Windows NT, 32 megabytes de RAM.
mnima de 12 35 megabytes de espao livre em disco, dependendo das configuraes (
"Setup") escolhido.
Aplicaes que voc desenvolve com Clarion ir correr confortavelmente em computadores que
atendem apenas aos requisitos mnimos para esses sistemas operacionais.

277
278 CLARION 5 CLARION
Aprendiendo

Iniciando o Setup

Para iniciar o programa de instalao no Windows 3.x Clarion:


1. Insira o CD de instalao no dispositivo de CD-ROM Clarion.
2. A partir do Gerenciador de programas ou Gerenciador de arquivos ou outro programa capaz
de executar um programa, selecione: Run arquivo.
Tipo D: \ SETUP na caixa de dilogo (onde D: a letra atribuda unidade de CD-ROM), e
pressione o boto OK.
O programa de instalao apresenta uma tela de introduo e alguns dados adicionais. Solicita
indicam as configuraes desejadas.

Clarion para iniciar o programa de instalao no Windows 95:


1. Insira o CD de instalao no dispositivo de CD-ROM.
2. A partir do menu Iniciar, escolha Painel de Controle para Configuraes.
3. Escolha Adicionar / Remover Programas e pressione o boto Instalar.
95 Assistente do Windows ir gui-lo atravs do processo de instalao.

Opes de instalao

Depois de iniciar a instalao, um grupo de telas do Assistente mostrando uma variedade de


opes sero exibidas:

1. Escolha as opes de configurao oferecidas pelas telas (tais como disco e diretrio de
destino), premindo o boto Prximo para rolar as telas de opes.
A instalao ir instalar os componentes principais do ambiente de desenvolvimento Clarion
para um subdiretrio BIN localizado em um diretrio de nvel inferior que voc indicou.
O programa instala todos os arquivos para o diretrio de destino e subdiretrios que esto
abaixo dele. no instala todos os arquivos em outros diretrios.
Durante a instalao, barras de progresso parecem mostrar uma cpia dos arquivos.
2. Escolha Sim ou No quando a instalao pergunta se ele pode modificar o caminho.
3.x Windows e Windows 95, o ambiente de desenvolvimento Clarion requer o subdiretrio
BIN est listado na varivel de ambiente PATH. Se voc escolher No, voc deve editar
manualmente o arquivo AUTOEXEC.BAT.
A nica outra alterao que faz com que seus arquivos de sistema Clarion adicionar sua
prpria seo para o arquivo de inicializao do Windows (Win.ini), quando executado pela
primeira vez.
EuCONTEDO 279

3. escolher Sim ou No quando a instalao pergunta se voc instalar os cones


em um grupo de programas Clarion ou no menu Iniciar.
4. Escolha Sim ou No quando a instalao pergunta se para exibir o arquivo ReadMe.
Se voc no quiser l-lo imediatamente, voc vai encontrar o cone correspondente no grupo
Program Manager (ou no menu Iniciar) que cria Setup. Recomendamos l-lo assim que a
instalao foi copiado todos os arquivos.
5. Pressione OK quando a instalao concluda.

execuo Clarion

Para executar Clarion, localize o cone apropriado no grupo Clarion de programas e clique duas
vezes nele, ou simplesmente clique no cone no menu Iniciar.
ambiente de desenvolvimento Clarion aparece, pronto para trabalhar.
Voc vai encontrar um guia rpido para o ambiente de desenvolvimento do partido, como um
diagrama dos cones na barra de tarefas, no captulo trs desta seo.
Agora v para o captulo dois deste livro para criar duas aplicaes impressionantes (do
dicionrio de dados, janelas para navegar, para Windows Forms), tudo em menos de uma hora.

- EuTART RApido: CUrsillo

Clarion, voc pode criar um dicionrio de dados e aplicao funcional sem codificao.
Tudo que voc precisa definir os campos no arquivo de dados e o Assistente de Incio
Rpido (Quick Start Wizard) cria um ... aplicao em cinco minutos, completa o
Windows se voc digitar rapidamente. O aplicativo inclui um guia de atualizao
procedimento para manter o arquivo, um visor (browse) em todas as chaves de
classificao, e muitos relatrios como chaves.

Usando o Assistente de Incio Rpido, voc s precisa definir o nome de cada campo no
arquivo de dados, a sua exibio formato (exibio de imagem) e informaes sobre as
chaves. Tudo o resto fornecido nos padres. O Assistente de Incio Rpido cuida do
resto!

279
280 CLARION 5 CLARION
Aprendiendo

Neste captulo:
Voc usar o Assistente de Incio Rpido para criar um arquivo do cliente e uma
aplicao para manter o arquivo, em seguida, compilar e executar o programa.
Use Carga rpida ( "carga rpida"). Este Clarion outro atalho que permite adicionar
rapidamente um arquivo para um dicionrio de dados.
Ele vai definir uma relao entre dois arquivos no Editor de dicionrio, incluindo
regras de integridade referencial.
Voc usa o Gerador de Aplicativos para adicionar mais funcionalidade para o
aplicativo, usando um do Procedimento Assistentes (Wizards of Procedure) Clarion.
Finalmente usar o Assistente de aplicao (Application Wizard) para criar uma
segunda base de dados relacionais completas a partir do mesmo dicionrio de dados.

Tudo isso levar cerca de 15 minutosSem "codificao" da sua parte. Para o final do
captulo, voc ter duas aplicaes completas para um banco de dados que contm dois
arquivos.

Bem-vindo! Vamos comear!

Assistente de Incio Rpido


(Assistente de Incio Rpido)

Ponto de partida:
Voc deve ser aberto apenas o ambiente de desenvolvimento
Clarion. dilogo Pic deve ser aberto.

criao dicionrio e aplicao


Primeiro, devemos criar um diretrio C: \ CLARION5 \ TUTORIAL para aplicaes que criam
este livro. Este tutorial assume que voc tenha instalado Clarion em C: \ CLARION5. Se voc usar
outro diretrio, voc deve modificar as instrues.

Criar um diretrio de trabalho


1. Trocar a ferramenta apropriada do sistema operacional que voc usa (Gerenciador de Arquivos,
Explorer, etc.) e criar um novo diretrio chamado subdiretrio TUTORIAL sob a Clarion5.
2. Voltar para Clarion.
EuCONTEDO 281

Criar seu primeiro aplicativo Clarion


1. Escolha a caixa ( "Select"), prima de dilogo no boto Novo ... ( "New").
A caixa de dilogo Novo aparece. uma caixa padro de arquivos do Windows Abra o dilogo
que lhe permite alterar o diretrio e digite o nome do arquivo.

2. Escolha Aplicattion (* .app) do Salvar lista drop-down tipo ( "Cuardar como ...")
3. Selecione C: \ CLARION5 \ tutuorial.
4. QWKTUTOR Tipee no nome do campo File ( "File")
O Assistente de Incio Rpido usa isso tanto quanto o nome do aplicativo e dicionrio para
criar QWKTUTOR.DCT (dicionrio de dados de arquivo) e QWKTUTOR.APP (o arquivo do
aplicativo). Voc pode usar nomes de arquivos longos, mas no vamos considerar isso os
usurios do workshop do Windows 3.1.
5. Tilde Use a caixa de incio rpido, pressione o boto ( "Save") Save. Clarion Quick Start (
"Quick Start") caixa de dilogo aparece.

Arquivo de definio de dados


1. Pressione TAB duas vezes, Tipo de dados do cliente no campo Nome do arquivo e pressione a
tecla TAB novamente.
O Assistente de Incio Rpido usa esse nome como o nome do arquivo de dados. Observe que
leva as trs primeiras letras, CLI, e coloca-os no campo Prefixo ( "prefixo"). O prefixo de um
arquivo identifica os campos que podem ser o mesmo (exceto para o prefixo) em vrios
arquivos.
2. Pressione TAB para aceitar CLI como o prefixo.
Em seguida, voc deve escolher o arquivo de driver (Driver File). Este campo indica, por
padro, Topspeed (um dos dois sistemas Clarion prprio).
3. Pressione TAB para aceitar Topspeed como arquivos de driver.
Isso leva voc para a caixa de listagem onde os campos esto definidos.

NOTA: No Windows 3.1, voc deve ter carregado SHARE.EXE ou driver


VSHARE.386 Windows para usar arquivos de driver Topspeed.
verses mais recentes do Windows fazer isso automaticamente.
281
282 CLARION 5 CLARION
Aprendiendo

4. Digite cusno na primeira linha da coluna Campo e pressione TAB.


Isso cria um campo chamado cusno. O Assistente de Incio Rpido tambm usa esse nome para
os ttulos e indicadores de coluna. O (prompt) sempre usado para colocar o campo em uma
janela. Os cabealhos das colunas so usadas em relatrios e caixas de listagem.
5. N4 Digite a coluna de imagem, e pressione TAB.
Isso especifica o formato de exibio para controles de janela e relatrios, que declara
implicitamente o tipo de dados para o Assistente de Incio Rpido.

6. Na coluna Key, pressione seta para baixo para exibir as opes. Destaque Autonumber (
"serializao") e pressione TAB.
Assim, uma chave nica a este campo como um componente ser criado. Autonumber
especificando a aplicao garante que cada cliente tem um nmero prprio, que aumentam
automaticamente cada vez que um cliente adicionado. O Assistente de Incio Rpido cria
navega e com base em cada chave que voc criar relatrios. Esta chave ir permitir o
movimento entre registros classificados por cusno.
O cursor colocado automaticamente na prxima linha, permitindo-lhe definir o prximo
campo.
7. Negcios no campo Tipo da coluna e TAB.
Isso cria um campo chamado Empresa para usar como o nome da empresa cliente.
8. Digite S20 na coluna Imagem e pressione TAB.
Este espcifica o formato dos nmeros exibidos em controles de janela e relatrios. Neste caso,
o campo tipo de dados uma seqncia de 20 caracteres.
9. Na coluna Key, pressione seta para baixo para exibir as opes. Destaque Duplicate, e TAB.
10. Terminar de definir o arquivo criando os campos restantes de acordo com a seguinte tabela:

FIELD PICTURE KEY


Nombres S20 (sin clave)
Apellidos S20 (sin clave)
Direccion S20 (sin clave)
Ciudad S20 (sin clave)
Provincia S3 (sin clave)
CP P####P Duplicate

formato de nota (P #### P) especificado para o campo CP (CEP). uma "visualizao padro
e arquivo", que formata dgitos CEP.
EuCONTEDO 283

Fechando o Assistente e aplicao criao


1. Quando tiver definido todos os campos, pressione o boto OK.
O assistente ir perguntar se voc terminar de definir os campos. Pressionando o boto OK, a
aplicao criada e aparece a caixa de dilogo rvore de Aplicao.

Observe a estrutura da aplicao. No topo da "rvore" o ( "Home") procedimento principal,


criando uma aplicao MDI quadro (: Multiple Document Interface Multiple Document
Interface) est localizado. Este procedimento contm o menu que chama outros procedimentos.
procedimento principal no mbito do processo um BrowseClientes (Browse) com um
procedimento UpdateCliente (Form) anexa est localizado. O visor (Procurar) apresenta os
dados com base nos trs chaves que foram especificados na definio campos.Tambin pode
ver trs relatrios (relatrios) com base nessas chaves.
O pedido est completo, sem voc fornecer mais informaes.

Os cones na barra de O boto Run


tarefas so, da esquerda
para a direita: Escolha,
Novo, Abrir, Salvar, fazer,
executar e depurar.

2. escolher projeto Executar (ou pressione o boto Executar na barra de tarefas).

283
284 CLARION 5 CLARION
Aprendiendo

Generator aplicativo cria o cdigo-fonte para as suas aplicaes, executa compilao, linkeado
e executa o programa resultante.
Parabns! A sua aplicao j est em execuo!
Explorando o aplicativo
Primeiro vamos adicionar alguns registros.
1. Escolha Browse Clientes procurar o arquivo
2. Pressione o boto Inserir na barra de tarefas.

boto Adicionar Alterar boto boto Excluir

Os cones na barra de tarefas so, da


esquerda para a direita: Home, Page Up,
Up Arquivo, Pesquisar, para baixo, Page
Down, End of File, Select, adicionar,
alterar, excluir, IDEM e Ajuda.

1. Depois de ter digitado os primeiros dados de clientes, pressione o boto OK para fechar a guia
e salvar o registro.
Isso demonstra o conceito de aplicaes Clarion Browse-Form. Navegar na lista de exibio
mostra banco de dados de registros e processo Form usado para atualizar (adicionar, alterar
ou eliminar) os registros de arquivos individuais. Clarion tambm suporta o conceito de
rolagem Form ( "Slider Tab"), em que os registros podem ser modificados diretamente na lista
de exibio (tente isso mais alelante).
EuCONTEDO 285

2. Adicionar mais alguns registros (voc tambm pode dar CLIQUE DIREITO [boto direito do

mouse] na lista de slides e escolha menu de contexto Inserir para adicionar registros). Veja
como cada vez que voc adicionar um novo registro para o arquivo do cliente, o valor de cusno
campo aumenta automaticamente por um. Observe os diferentes sistemas para consulta no
procedimento de procura, ento variar o tamanho das colunas e usar a barra de rolagem
horizontal para navegar os dados nos campos que esto escondidos direita da tela. Se desejar,
voc tambm pode imprimir relatrios.

3. Escolha Arquivo Sair para sair do aplicativo.


Voc tambm pode tentar executar o programa (QWKTUTOR.EXE) a partir do Gerenciador
de Arquivos ou Windows Explorer: um verdadeiro executvel do Windows que no precisa
do ambiente Clarion para ser executado.
Agora vamos salvar o trabalho e deixamos o Gerador de Aplicativos para modificar o
dicionrio de dados que criamos. Em seguida, adicionar um segundo arquivo relacionado, o
dicionrio.
4. Escolha Arquivo pertoOu pressione o boto OK para fechar o Gerador de Aplicativos.

Assistente Quick Charge


(Assistente de carga rpida)
Voc pode rapidamente adicionar um arquivo para o dicionrio de dados usando a opo de
carga rpida no Editor de dicionrio. Este assistente funciona de forma semelhante Quick Start
Wizard: arquivo (nomes de campos, formatos e chaves) introduzido, e um arquivo de

285
286 CLARION 5 CLARION
Aprendiendo

definio criada no dicionrio. Esta opo est disponvel sempre que um novo arquivo
adicionado ao dicionrio.

Adicionar um arquivo

Nesta seo, vamos adicionar um arquivo para salvar o nmero de telefone dos clientes. Isso
permite que cada cliente ter tantos nmeros de telefone, conforme necessrio (que cria uma relao
de um-para-muitos).
Usando carga rpida no Editor Dicionrio
1. Escolha Arquivo aberto (Ou pressione o boto Abrir na barra de tarefas).
caixa de dilogo Abrir aparece.
2. Escolha o tipo de dicionrio (* .dct) a partir da lista arquivos do tipo drop-down, selecione
QWKTUTOR.DCT, e pressione o boto Abrir.
caixa de dilogo Dicionrio Box Editor aparece.

3. Clique no boto Add File.


outra caixa aparece pedindo: ( "Voc quer usar carregamento rpido) "Voc quer usar Quick
Load".

Pressione o boto YES.


4. caixa de dilogo Clarion aparece Carga Rpida. Note-se que o dilogo muito parecido com o
Quick Start Wizard.
EuCONTEDO 287

5. Selecione o campo Arquivo de Dados Nome ( "Data File Name"), e do tipo de telefone e
pressione TAB.
6. Pressione TAB novamente para aceitar prefixo TEL.
Em seguida, voc ser solicitado a selecionar um arquivo de driver (Driver File).
7. Pressione TAB para aceitar Topspeed como um controlador.
Isto levar a uma lista de caixa em que os campos esto definidos.
8. Digite cusno na primeira linha da coluna Nome do campo, e pressionar TAB.
Isso cria um campo chamado cusno. Este campo a ligao (link) para o campo cusno os
clientes de arquivo. Usar os mesmos nomes de campo faz com que seja mais fcil para vincular
os dois arquivos. Do cristalino no cdigo que gera o ficheiro prefixo adicionado para os
nomes de campo (com dois pontos [:], tal como a separao), que produz nomes originais para
os campos que partilham o mesmo nome de ficheiro separados.Por portanto, este campo
realmente chamado, TEL: cusno, enquanto o campo no arquivo do cliente chamado CLI:
cusno.
9. N4 Digite a coluna de imagem, e pressione TAB.
10. Na coluna Key, pressione seta para baixo para exibir as opes. Duplicar e escolher TAB.
Isto especifica uma chave que permite duplicatas assentos, o que permite que mais de um
registro para cada cliente. Assim voc pode criar uma relao de relacionamento um-para-
muitos entre os dois arquivos (um cliente pode ter muitos telefones).
O cursor est localizado na prxima linha, que permite definir o prximo campo.
11. Na coluna Nome do Campo da prxima linha, digite DDN, e pressione TAB.
12. Na coluna de Quadro, tipo P (0 ###) P, e pressione TAB duas vezes (uma chave no
definido) para prosseguir para o prximo campo.
Esta ao inicia o campo DDN (National Discagem Direta) como um zero e mais trs dgitos,
entre parnteses, que a maneira padro de telediscado cdigos na Argentina. O padro
muito semelhante em todos os pases, mas pode se adaptar localmente, se necessrio.
13. Completar o arquivo de criao de campos da tabela:

FIELD PICTURE KEY


Telefono P###-####P (sin clave)
Descripcion S20 (sin clave)

14. Quando terminar de definir os campos, pressione o boto OK.


O assistente ir perguntar se voc terminar de definir os campos.

287
288 CLARION 5 CLARION
Aprendiendo

15. Pressione o boto OK.


O assistente cria arquivo de definies, e adiciona-la ao dicionrio.

Telefonos configurar o arquivo para usar o conceito de folha deslizante


(Formulrio de rolagem)

Uma vez que este arquivo tem apenas quatro campos, um bom exemplo do direito de modificar
os dados no arquivo de lista de slide.
1. Realce a lista Arquivos arquivo Telefone e clique no boto Propriedades ... ( "Propriedades")
2. Escolha a guia Opes.
3. Opes no usurio ( "Opes de utilizador") de controle, tipo EDITINPLACE.
Ento avisar Assistants ( "assistentes") do cdigo de gerao de Clarion que permite que voc
modifique os dados do arquivo diretamente na caixa de exibio o deslizamento (browse).

4. Pressione o boto OK.

Adicionar um relacionamento

Obviamente, queremos que o arquivo Telefonos contm os nmeros de telefone dos clientes. Isto
significa que os dois arquivos devem ser relacionados. Neste caso, um cliente pode ter muitos
telefones, o que o torna um "one-to-many". Para definir essa relao, que deve ligar os arquivos no
dicionrio de dados, para fornecer o gerador de aplicaes com as informaes necessrias para
acessar os registros relacionados.
Estabelecer uma relao entre dois arquivos
1. Selecione Arquivos de Cliente caixa de dilogo e clique no boto Add Relation.
EuCONTEDO 289

as novas propriedades de Relacionamento ( "Novas propriedades do relacionamento") caixa de


dilogo aparece. Aqui relaes so definidas.

2. Verifique se o campo Tipo, digite 1: Muitos (um-para-muitos).


3. No campo de chave primria ( "chave primria"), pressione a seta para baixo para exibir as
opes, selecione KeyNumCliente, e pressione TAB.
Esta a Clientes arquivo de chave (o lado "um" da relao), que sero utilizadas para ligar os
arquivos.
4. campo Arquivo relacionados ( "File relacionadas"), pressione seta para baixo para exibir as
opes, telefone detaque e TAB.
5. campo de chave externo ( "chave estrangeira"), pressione seta para baixo para exibir as opes,
selecione KeyNumCliente e TAB.
Este o arquivo de telefone chave (lado relacionamento "muitos") a ser utilizado para vincular
os dois arquivos.
Em seguida, os listados nas reas-chave deve ser "mapeados" para que o Gerador de
Aplicativos sabe exatamente quais os campos que esto interligados. Desde que ns usamos
nomes de campos idnticos, isto fcil.
6. Pressione o mapa boto Nome ( "Vinculando o nome").
Vinculativos campos entre os dois arquivos aparecem nas duas caixas campo mapeamento.

Configurar as restries de integridade referencial

289
290 CLARION 5 CLARION
Aprendiendo

1. Escolha Cascade ( "Cascade") da atualizao da lista ( "Quando modificada") na caixa de


integridade referencial Restringe ( "restries de integridade referencial").
2. Escolha Cascade na lista Excluir em caixa de integridade referencial Restringe.
O cdigo-fonte gerado automaticamente manter a integridade referencial entre os dois
arquivos. A seo tutorial explica Clarion Aprender mais amplamente. Consulte tambm
Utilizar o Editor de dicionrio no Guia do Usurio para obter um breve tratamento da teoria de
bancos de dados relacionais.
3. Pressione OK para fechar a caixa de dilogo Novo propriedades de relacionamento.
O dicionrio agora aparecer como segue:

4. escolher arquivo Salvar, ou pressione o boto Salvar na barra de tarefas para salvar o
dicionrio de dados.
5. selecionar arquivo Close, ou pressione o boto Fechar na caixa de dilogo dicionrio para
fechar o dicionrio.
EuCONTEDO 291

assistentes Procedimentos
(Procedimentos Assistentes)
Alm do Quick Start Wizard, Clarion tambm tem assistentes que criam procedimentos mostrar
arquivos, registros ou relatrios (Procurar, formulrio ou relatrio), to facilmente como o Assistente
de Incio Rpido cria um dicionrio de dados e uma aplicao. Esses assistentes esto disponveis
sempre que um novo processo criado em um aplicativo existente.
Agora vamos usar o Assistente de Pesquisa para criar um mtodo de exibio para o arquivo de
telefone. Voc tambm pode criar o procedimento de atualizao (Form), mas no desta vez, j que
modificaes podem ser feitas diretamente na exibida ( "editar no lugar")
Carregar Application Builder
1. Escolha Arquivo Escolha (ou pressione o boto correspondente na barra de tarefas).
2. Selecione a guia aplicativos, realce C: \ CLARION5 \ Tuturial \ QWKTUTOR.APP e pressione o
boto Select.
Box aplicao Tree ( "aplicativo rvore") caixa de dilogo aparece.
A modificao da guia procedimento
1. UpdateCliente ficar (Form) na rvore da aplicao, e clique direito para ativar o menu de contexto.
Este menu permite o acesso direto s ferramentas Application Builder sem primeiro abrir as
propriedades do procedimento.

O menu de contexto exibe um til ( ) com ferramentas que contm dados.


2. Um clique na janela.
Designer do Windows (Janela Formatter) aparece. Aqui voc pode modificar visualmente a janela
e seus controles.
3. Escolha Boto de controle, ou clique na ferramenta boto nos controles de caixa de ferramentas
(que tem um cone que se parece com um boto OK).

291
292 CLARION 5 CLARION
Aprendiendo

4. Clique perto do canto inferior esquerdo da janela para colocar o novo controle (boto) abaixo
da guia de lmina (folha guia).

5. Com o novo boto selecionado, clique direito para ativar o dilogo chamada Propriedades do
boto.
6. Escrever Phones no campo de texto.
Isso muda o texto que aparece no boto.
7. Selecione as Aes ( "Aes") de guia.
neste guia onde possvel especificar o que o controle. Neste caso, queremos chamar um
mtodo de navegao para mostrar todos os registros de telefone que esto ligados arquivo para
os clientes de arquivo registro atual.
8. Escolha chamar um procedimento a partir da lista drop-down quando pressionado.
caixa procedimentos que definem (Procedimento Definio) sobre as aes guia aparece.

9. Digite VerTelefonos no campo ProcedureName, e pressione o boto OK.


Ento, voc d nome ao procedimento a ser chamado quando o boto de impresso do usurio.
10. Escolha Exit! menu para voltar para a rvore de Aplicativos e clique no boto Sim quando
perguntado se voc salvar as alteraes na janela.
o procedimento VerTelfonos aparece na rvore como um item para produzir (ToDo).
EuCONTEDO 293

Usando o Assistente para navegar

procedimentos assistentes gerar procedimentos completos com base na informao mnima


prevista pelo usurio em resposta a uma srie de caixas de dilogo que fazem Assistente uma
pergunta de cada vez.
Assistente de execuo Browse
1. D um duplo clique sobre o procedimento VerTelfonos (ToDo).
A janela Selecionar Procedimento exibida. Isto permite-lhe escolher o (modelo) modelo
Generator aplicativo usado para criar o cdigo fonte.
2. Procure destacar o modelo, verificar o uso Assistente procedimento de caixa, em seguida,
pressione o boto Select.
O segredo para usar assistentes Procedimento marcada com um visto o Uso Assistente de
Procedimento caixa. Nas prximas BrowseWizards destaque tela e pressione Selecionar.

3. Depois de ler a primeira caixa de dilogo Assistente de informaes, clique no boto Avanar
para comear a criar o procedimento.

4. Entre telefone na caixa de entrada de dados (ou pressione o boto ... e selecione-o da lista),
respondendo pergunta "Qual voc quer arquivar navegar?" (Que arquivo para exibir?), E
pressione no boto Avanar.

293
294 CLARION 5 CLARION
Aprendiendo

5. Desmarque a caixa utilizando Procurar todas as chaves de registro ( "Display usando todas as
chaves de pesquisa), pressione o boto ... e escolha TEL: KeyNumCliente da lista e clique no
boto Avanar.
Isto especifica a chave a ser usada para classificar os registros para visualizao na lista.
6. Deixe em branco a caixa Procedimento de actualizao ( "Procedimento de atualizao") e
pressione o boto Avanar.
Esta caixa de entrada de dados permite que voc especifique o procedimento para criar a
Navegar Assistente para atualizar os registros no arquivo Phone. Neste caso, isso
desnecessrio, uma vez que o assistente ir criar o cdigo apropriado para modificar o arquivo
na mesma lista (no local), eliminando a necessidade de um procedimento de atualizao (guia).
No entanto, se no tivssemos especificado EDITINPLACE no arquivo de opes do usurio,
chame as folhas de Assistente de Assistente de Pesquisa para criar o guia interno. Nomeao
Aqui um "procedimento Update" evitar o trabalho das folhas Assistente tendo que, em
seguida, ativar.

7. Marque a caixa usando atualizao menu pop-up Chamada, e clique no boto Avanar.
Isso permite que os usurios usem um menu de contexto (que aparece quando voc d Boto
direito do mouse na lista) para chamar o procedimento de atualizao (ou a capacidade de fazer
alteraes na mesma lista).
EuCONTEDO 295

8. Desmarque a caixa Fornecer botes para arquivos filho ( "Faa botes para crianas Files"), e
clique no boto Avanar.

9. Selecione o boto de assumir que o registro pai est ativo ( "a presuno de que o registro de"
pai "est ativo") e pressione o boto Avanar.
Isso garante que o processo est configurado para exibir apenas os registros de telefone que
esto relacionados no arquivo de log clientes ativos na memria quando voc chamar o
procedimento.

10. Desmarque a caixa de fornecer um boto "Select" ( "Criar um boto" Select") e clique no boto
Avanar.
Uma vez que este procedimento no ser usado para consultar os dados que o operador deve
introduzir uma guia, o boto Select desnecessrio.

11. Vamos definir o controle boto de opo que deve o modelo de aplicao Uso ( "Que tipo de
controles vai usar o aplicativo?") Na barra de ferramentas ( "barra de ferramentas"), e clique no
boto Avanar.
12. Pressione o boto Finish para aceitar o padro da caixa Substituir procedimentos existentes (
"Substituir os procedimentos existentes").

295
296 CLARION 5 CLARION
Aprendiendo

Navegar Assistente agora cria o procedimento Procure o arquivo Phone. Se no tivssemos


especificado EDITINPLACE no arquivo de opes do usurio do telefone, Navegar Wizard
tambm iria criar um procedimento de atualizao (Form) para manter os registros no arquivo
Phone. Quando terminar, deixe ativa a janela Procedimento Propriedades Navegar novo
procedimento.
13. Pressione o boto OK para retornar rvore Applications.

Observe o novo procedimento que foi criado para voc na rvore.

14. escolha Executar projeto (ou pressione o boto Executar na barra de ferramentas).
Agora ele tem uma aplicao relacional completo com mltiplos sistemas para exibir o pai
listas de arquivos, criana verificao de arquivos limitados a registros ligados a um arquivo de
registro pai e integridade referencial cdigo para garantir que o banco de dados no registros
esto corrompidos com crianas "rfos".
Pressione o boto e adicionar novos registros de telefone celular para o arquivo para cada um
dos seus clientes.
15. Quando tiver terminado a explorar seu aplicativo, selecione Arquivo Sair para retornar ao
Clarion.
EuCONTEDO 297

16. Escolha Fechar arquivo ( "File: Close"), ou pressione o boto OK para fechar o Gerador de
Aplicativos.

E, finalmente, o Assistente de aplicao!

Todos os participantes tm visto: Quick Start, Browse, Form, e Relatrio so ferramentas


poderosas. No entanto, Clarion tem um outro assistente, ainda mais poderosa em seu arsenal de
ferramentas para superproductividad.
Assistente de Aplicaes (Application Wizard) cria uma completa aplicao a partir de um
dicionrio de dados. Este dicionrio pode ter tantos arquivos como voc gosta; mas eles devem ser
totalmente definidos, incluindo as relaes entre os arquivos, regras de integridade referencial e
integridade dos dados, que podem ser definidas no Editor de dicionrio.
Para facilitar o uso do assistente de Aplicao, o Editor de dicionrio tem opes de propriedades
de cada arquivo e campo de chave; todos concebidos especificamente para interagir com os
assistentes, que permitem personalizar as aplicaes que ele cria para voc.

Use o Editor de dicionrio para Assistente de configurar

1. Escolha Arquivo Escolha (ou pressione o boto Escolher na barra de ferramentas).


2. Selecione a guia Dicionrio, realce C: \ CLARION5 \ TUTORIAL \ QWKTUTOR.DCT, e
pressione o boto Select.
3. Clientes Realce o arquivo e clique no boto Campos / Chaves ...
4. Selecione as teclas de tabulao, clique no KeyNumCliente para ativ-lo, e pressione o boto
Propriedades.
caixa de dilogo Editar aparece Propriedades chave.
5. Escolha a guia Opes.
As configuraes deste guia usada para especificar o comportamento dos participantes.
Opes na metade superior da janela so usados com o conjunto padro de modelos includos
com o Clarion. caixa de opes do utilizador usar modelos adicionais fornecidos por
terceiros, o que permite que voc especifique restries ou opes para os assistentes que no
esto abrangidos pelas opes padro.
6. Verifique a caixa No Auto-preencher esta chave.
Quando esta caixa est marcada, o Assistente de aplicao no vai usar essa chave para criar
um procedimento Procure o arquivo. Isto ir eliminar a guia CLI: KeyNumCliente no
procedimento de Clientes arquivo de procura.

297
298 CLARION 5 CLARION
Aprendiendo

H muito mais que isso pode ser feito no Editor de dicionrio para personalizar o trabalho de
assistentes. Aps a concluso deste curso, ver a Seco Optimizar os assistentes de Aplicao
Manual para mais informaes sobre este importante tema.

7. Pressione o boto OK.


8. No caso de dilogo Definio de Campo / Key, clique no boto Fechar.
9. Pressione o boto Fechar no dicionrio dilogo. Quando solicitado, pressione o boto Sim para
salvar o dicionrio.
Isso tudo. Ento, vamos fazer o Application Wizard gera o aplicativo completo.

Utilizar as aplicaes Assistente

AppWizard produz aplicativos completos sobre as informaes fornecidas em resposta a uma srie de janelas
que vo Assistente pedindo informaes ao mesmo tempo.

Criar uma nova aplicao


1. Escolha Arquivo Novo Aplicao
A caixa de dilogo Novo aparece.
2. Selecione C: \ CLARION5 \ TUTORIAL
3. Tipo appwiz no campo Nome do arquivo.
4. Desmarque a caixa de Uso Quick Start, e clique no boto Salvar.
caixa de dilogo Propriedades do aplicativo caixa aparece.
EuCONTEDO 299

5. Pressione o boto ... direita do dicionrio de dados caixa de entrada de arquivo.


caixa de dilogo caixa Selecionar Dicionrio aparece.
6. Realce o arquivo C: \ CLARION5 \ TUTORIAL \ QWKTUTOR.DCT e pressione o boto
Abrir.
7. Marque a caixa Application Wizard (Assistente de "Aplicativos") e pressione o boto OK. em
seguida, selecione Assistente de aplicao pressione o boto Select.

8. Pressione o boto Avanar.

9. Pressione o boto Avanar.

299
300 CLARION 5 CLARION
Aprendiendo

10. Pressione o boto Avanar.

11. Pressione o boto Finish.

12. escolha Executar projeto (ou pressione Run no boto da barra de ferramentas)

Parabns!. Sua segunda aplicao completa j est em execuo.


EuCONTEDO 301

Agora voc pode explorar esta nova aplicao, e compar-lo com o j criado. Voc vai notar que
existem algumas pequenas diferenas entre os dois. Estas diferenas so devidas simplesmente
para construir a primeira aplicao de uma pea de cada vez, em vez de usar as aplicaes do
Assistente.

Que segue

Se voc pode fazer ambos os "atalhos" em Clarion, o que mais pode ser feito com todas as outras
ferramentas oferecidas?
Alm dos assistentes, Clarion tem um conjunto de ferramentas de produtividade no Gerador de
aplicaes, comeando com os modelos de controle, ramal e cdigo para adicionar mais
funcionalidades para o processo. Estas ferramentas tornam mais fcil de modificar e personalizar
os procedimentos tanto como assistentes e no requer escrever qualquer cdigo!
O prximo captulo deste livro a filosofia subjacente desenvolvimento Clarion. Ns sugerimos
que voc l-lo com cuidado. um importante apoio material, porque, como vimos, Clarion uma
ferramenta diferente de outro desenvolvimento. Clarion entender a filosofia ir torn-lo mais fcil
de traar a curva de aprendizagem.
O workshop sobre o Gerador de Aplicao est na seo de Aprendizagem Clarion. So
apresentados todas as ferramentas de Clarion, e tambm mostrar quanta energia estar disponvel
quando finalmente escrever algum cdigo fonte mesmo, para obter mais funcionalidade.
Por favor, v em frente. Ns mal arranhamos a superfcie, e h ainda mais!

- PANORAMA PROCESSO DE
DESENVOLVIMENTO

O Tao da Clarion

"Tao" significa "o caminho" em chins. Clarion uma forma completamente nova para criar
aplicaes do Windows. Assim demonstram os aplicativos que voc acabou de criar em cerca de
30 minutos! No entanto, Clarion vai muito alm de seus assistentes, ento agora dedicar algum
tempo para explicar os conceitos centrais por trs dessas ferramentas.

Clarion uma linguagem de programao

301
302 CLARION 5 CLARION
Aprendiendo

Na base da Clarion (como uma ferramenta de desenvolvimento) a linguagem de programao


Clarion. uma linguagem de quarta gerao, de uso geral, totalmente orientada a objeto, que tem
sido altamente otimizado desde a sua criao para o desenvolvimento de banco de dados
aplicaes comerciais. A linguagem Clarion uma ferramenta poderosa em suas mos agora. Mas
Clarion muito mais do que nica linguagem: tambm um conjunto completo de ferramentas
projetadas especificamente para a criao e manuteno de aplicaes de banco de dados.
No nvel superior da lngua Clarion o ambiente de desenvolvimento. um conjunto totalmente
integrado de ferramentas que foram especialmente concebidos para o desenvolvimento,
manuteno e melhoria de aplicao rpida. (Essas atividades so conhecidos em Inglscomo:
Rapid Application Development, RAD; Rpida aplicao de manuteno, RAM; Aplicao rpida
Enhancement, RAE). Estas ferramentas so voltadas para a gerao automtica de cdigo fonte
Clarion, para que voc no tem que escrever. esta Clarion poder: Embora voc pode escrever seu
prprio cdigo-fonte, o kit de ferramentas pode gerar (e regenerar) a maior parte do cdigo
"standard", permitindo a liberdade para voc se concentrar nos aspectos criativos da aplicao.

Nveis de abstrao

H um computador princpio indicando que quanto mais se afasta-se dos "ferros" mais produtivos
(cdigo binrio) pode ser.

Um pouco de histria
Os primeiros computadores foram programados em binrio, o que tornou muito difcil trabalhar o
programador. Ento veio a linguagem Assembly (ou "assemblia") que facilitou a tarefa, tornando
o cdigo pode ser lido em termos "humanos". Cada instruo de linguagem assembly produzido
apenas uma instruo para a mquina.

programadores de montagem primitivas advertiu repetidamente escrevendo nas mesmas


sequncias de instrues para executar funes comuns de computao. Devido a isto, foram
criadas as lnguas de terceira gerao (3GL tais como Fortran, C, PL / 1, etc.) de modo a que cada
declarao em uma das lnguas produzir mltiplas instrues mquina para estas tarefas comuns, o
que torna ainda mais programadores produtivos. Com isso, eles subiram para um nvel mais alto,
mais longe da "ferros" abstrao computador. A desvantagem foi que eles poderiam seqncias s
podem ser gerados padronizado cdigo de mquina, o que fez perder alguma flexibilidade para
trabalhar diretamente na montagem.

Atualmente: linguagens 4GL

O mesmo processo repetido para criar a quarta gerao de linguagens (4GL) e Clarion. Por
exemplo, a linguagem Clarion automaticamente manipula todas as tarefas comuns do Windows
(como a tela redesenha), os programadores devem escrever pessoalmente em linguagens 3GL.
EuCONTEDO 303

Clarion, um programa clssico que diz apenas "Ol, mundo!" Leva apenas nove linhas de cdigo
fonte Enquanto em C / C ++ para ser escrito mais de oitenta!
Up, o mais geral o nvel de abstrao pode ser programador mais produtivo. Como voc subir o
nvel de abstrao, o trabalho do programador paga mais, desde que o computador cuida dos
aspectos de rotina, gerando o cdigo padro para tarefas comuns. Este o princpio fundamental
por trs do kit de ferramentas que tornam Clarion.

O segredo da produtividade.

O "problema" para operar em nveis mais altos de abstrao perder a flexibilidade para fazer as
coisas exatamente da maneira que quiser. Com Clarion, este problema resolvido.

O segredo da verdadeira produtividade sem perda de flexibilidade esta: voc sempre tem de
operar no maior nvel de abstrao possvel do trabalho feito, da maneira que voc deseja que seja
feito. barra de ferramentas jogo Clarion contm vrios nveis de abstrao, tornando mais fcil
para trabalhar com o melhor nvel para fazer exatamente o que precisa ser feito. Nunca se est
"preso" a um nvel elevado ou forados a "pegar" baixa. O kit de ferramentas gera cdigo Clarion
fonte, orientado a objetos, usando a biblioteca construo de aplicaes high-end (Application
Builder Class [ABC] Library) e, quando necessrio, pode adicionar seu cdigo em um nvel baixo,
para aumentar funcionalidade dos templates.

Em outras palavras, o segredo da produtividade trabalhar mais esperto, no mais difcil. Isto o
que Clarion permite: escrever o cdigo padro de modo que voc no deve escrev-lo
pessoalmente. Mas tem flexibilidade suficiente para voc adicionar todos os "sinos e assobios" que
voc quer (o que muito mais divertido).

nveis Clarion de abstrao

Neste ponto, voc j trabalhou com nveis mais altos de abstrao Clarion: Assistentes. Mais tarde,
voc interage com a maioria dos seguintes (deixar os ttulos em Ingls, porque como a encontrar
os menus do programa):
editor de Dicionrio ( "Dicionrio Editor")
O dicionrio de dados o ponto central de armazenamento de todas as definies de arquivos
de dados e as configuraes padro para as configuraes de entrada de dados. Se h
necessidade de tomar essas definies de um arquivo de dados existente, o dicionrio pode
importar consultar o arquivo de dados em si.
Assistente de aplicao
AppWizard gera uma completa aplicao "standard" em questo de minutos, com base em
definies de dados e configuraes de dicionrio.
procedimento de Magos
Assistentes Procedimentos gerar procedimentos comuns (como listado para exibio ou de
entrada de dados -browse-- fichas) com base nas configuraes definidas no Dicionrio de
Dados.

303
304 CLARION 5 CLARION
Aprendiendo

Modelos de procedimento ( "Procedimentos de Modelos")


Criar procedimentos comuns (como o menu do quadro geral da aplicao, ou relatrios) com
base na janela do projeto ou relatrio que voc criou na janela Designer e Designer de
Relatrios, e sobre as opes que escolher proposto pelo modelo para criar o procedimento.
Modelos de controle ( "modelos de controle")
Adicionado "padro" controla janela projetos ou relatrio (como uma rvore de arquivo de
controle de navegao) e gerar todo o cdigo necessrio para controlar o seu desempenho.
Modelos de extenso ( "Modelos de extenso")
Gerar cdigo adicional em um procedimento que adiciona funcionalidade alheio a qualquer
controle especfico (como a exibio de data e barra de tempo o estado do aplicativo principal).
Modelos de cdigo ( "Code Templates")
Gerar o cdigo em um processo que normalmente realiza uma nica tarefa, relacionada com
um controle especfico (por exemplo, validao de entrada de dados).
Source Code incorporado (Fonte Incorporao)
Voc pode escrever seu cdigo em qualquer um dos inmeros pontos de insero (Incorporar
Pontos) para personalizar ou modificar o cdigo de comportamento gerada pelos participantes.
Template fonte (Fonte modelo)
Este assistente permite que voc escreva inteiramente por procedimentos manuais linguagem
Clarion, preservando a aplicao dentro do Gerador de Aplicativos.

Bibliotecas: o Windows API e C


Clarion em qualquer lugar do cdigo que voc escreve (procedimentos completos ou pontos de
entrada), voc pode chamar diretamente funes API Windows ou uma biblioteca de funes
comuns em C, se for realmente necessrio (prottipos de funes da linguagem C so includas
nos profissionais e de negcios questes Clarion).
Cdigo C / C ++ e Modula-2
Voc pode escrever C / C ++ ou Modula-2 funes que voc precisa, compil-los com
compiladores Topspeed includos nas edies Professional e Enterprise (tambm disponvel
separadamente) e linkearlas a aplicao Clarion.
Como pode ser visto, nveis de abstrao no Clarion executar a gama, desde o Gerador de
aplicaes para escrever cdigo C (ou at mesmo Assembleia, se voc quer trabalhar tanto!).

chave Clarion para a mxima produtividade

A chave sempre trabalhar para o melhor nvel possvel de abstrao:


Deixe o Assistente de aplicao criar um aplicativo "inicial" para voc.
Use Procedimentos assistentes para adicionar novos procedimentos, se necessrio.
Modificar o que for necessrio em cada procedimento Assistente usando ferramentas
interativas Clarion (tais como os designers do Windows e relatrios).
EuCONTEDO 305

Adicionar modelos de controle, extenso e cdigo, se forem necessrias para aumentar a


funcionalidade do aplicativo.
Personalize incorporando algum cdigo fonte para os pontos de insero.
Quando voc tem algo que voc pode fazer qualquer modelo, use o cdigo fonte do template
(modelo de origem) e na lngua Clarion (ou obter um terceiro modelo para fazer o que voc
precisa).
"Comear a profunda" recorrer a nveis API Windows e programao em C / C ++ quando
absolutamente necessrio.
Essa a filosofia de trabalho Clarion mais esperto, no mais difcil, deixando o conjunto de
ferramentas fazer o trabalho repetitivo. Produtividade e ficar muito alta, em comparao com
outras ferramentas que voc usou.

modelos de programao controlados

Gerador de aplicao "controlado por modelos". Isso significa que ele uma ferramenta que
muda de acordo com o modelo de configuraes usado para gerar o cdigo. procedimento
modelos, controle e extenso de cdigo toda a linguagem Clarion voc escreve, dando um grande
impulso sua produtividade. modelos Clarion oferecem muitos dos benefcios de, especialmente a
programao reutilizao orientada a objeto e um conjunto de modelos padro gerados usando
verdadeira biblioteca orientada a objeto a construo de aplicaes high-end (Biblioteca ABC) de
cdigo. Isso faz com que os modelos em A verdadeira chave ofertas Rpido Desenvolvimento de
Aplicaes Clarion.

O que um modelo?
Clarion, um modelo no uma ferramenta de gerao de cdigo "de uso nico", que, em seguida,
voc deve tomar cuidado para manter (tais como os chamados "modelos" ou "modelos" em outros
idiomas), mas uma ferramenta interativa permanente solicitando a informao especfica
necessria para gerar o cdigo. Se voc alterar as informaes, escreva modelo de cdigo diferente
da prxima vez que voc criar o aplicativo. esta interatividade que permite uma manuteno
rpida de aplicaes.

modelos Clarion permitem inserir seu prprio cdigo fonte Clarion em qualquer um dos muitos
pontos de insero disponveis dentro de cada modelo. Isso torna desnecessrio manter o cdigo
gerado para modificar o comportamento do aplicativo. Ele tambm garante que h personalizaes
especiais sero substitudas na prxima vez que o cdigo fonte gerado: o modelo respeita o
inserido dentro de seu prprio cdigo. Esta facilidade de personalizao e adaptao dos modelos
faz com que a chave para a melhoria rpida das aplicaes.

Todos os modelos so armazenados no arquivo de log (REGISTRY.TRF). Este arquivo contm


estruturas de cdigo e dados executveis pr-gravados que podem ser modificados e reutilizados.
Voc pode usar o Registro para modificar o desenho da janela padro de cada modelo aparea da
maneira que voc preferir criar um procedimento.

305
306 CLARION 5 CLARION
Aprendiendo

modelos Clarion so modificveis. Voc tambm pode adicionar modelos de terceiros, ou voc
pode escrever seu, e alm deles, e, juntamente com os modelos originais. Isso faz com que a
ferramenta infinitamente extensvel Gerador de Aplicativos.

Como so modelos usados?


Ao criar um novo procedimento, voc deve identificar o modelo de processo que gera o cdigo
apropriado para a tarefa a ser desenvolvida, e ento voc pode personaliz-lo com ferramentas de
desenvolvimento. Esses modelos incluem itens como "listagens exibir janelas" (navega) para ver
os registros de grupo e "guias ou Windows Forms" (formas) para modificar um tempo recorde. Se
o procedimento para uma janela que inclui um menu, as aes do menu so automaticamente
adicionados aos procedimentos de rvores, e, inicialmente marcado como "todo" (a ser feito).

A maneira usual para personalizar ou modificar um procedimento est sendo executado uma das
ferramentas de design. designers de janela e relatrios so ferramentas de design visual para
trabalhar pelo mtodo de "point-and-click". Voc s deve assumir o controle de uma caixa de
ferramentas, clique para colocar o controle, e ento um clique com o boto direito de modificarle
propriedades.

Depois de ter criado um procedimento, voc tambm pode usar modelos de controle, extenso e
Cdigo para adicionar ainda mais funcionalidades. modelos de controle conter controles e gerar
todas as informaes necessrias para usar e manter o cdigo executvel. Todos os controles pr-
configurados que aparecem em projetos padro modelos janelas em procedimentos so realmente
controlar modelos que executam todas as funes necessrias.

modelos de extenso adicionar cdigo executvel que aumenta a funcionalidade do processo. Cada
um oferece instrues na tela sobre quais os dados que devem fornecer o programador para
incorporar a funcionalidade do modelo de aplicativo.

Outra maneira de se adaptar um mtodo adicionar o prprio cdigo embutido. Generator


aplicativo exibe uma rvore indicando todos os pontos de insero que esto disponveis antes,
durante ou aps o principal lgica do procedimento, e para cada um "evento" que pode gerar a
janela ou controles embutidos. Voc tambm pode escrever cdigo incorporando-o no cdigo-
fonte gerado. Assim, pode-se escolher o ponto lgico exato onde o cdigo deve ser executado, em
seguida, escrev-lo " mo", ou ativar um modelo de cdigo para faz-lo em seu lugar. Generator
aplicao produz todo o cdigo fonte a partir dos modelos e mudanas pessoais que voc fez
(incluindo o cdigo fonte incorporada).

Clarion tem uma grande variedade de modelos padro para ajud-lo a desenvolver aplicaes
rapidamente. Assim como Cursilho para um captulo de incio rpido introduziu os participantes, o
workshop sobre Aplicaes Builderseo dois este manual lhe ensina como utilizar modelos
Clarion para produzir qualquer aplicativo do Windows que voc precisa.
EuCONTEDO 307

ambiente de desenvolvimento Clarion


O ambiente de desenvolvimento contm vrias ferramentas principais, os quais so acessveis para
o outro. Ao utilizar o Gerador de Aplicativos, existem botes e menus que levam a outras
ferramentas.
O fluxograma a seguir mostra como as ferramentas interagem uns com os outros e com o registo
de modelos, colocando o gerador de aplicaes para o centro de todo o processo:

307
308 CLARION 5 CLARION
Aprendiendo

Esta seco fornece uma descrio de cada ferramenta, a fim de que um programador tpico
usando o Gerador de Aplicativos poderia encontr-los. Cada ferramenta contm caixas de dilogo
que enchiam o programador para indicar a funcionalidade do aplicativo para o Gerador de
Aplicao. Quando voc quiser, o Gerador de Aplicao gera a fonte especificada, e Sistema de
projetos compila e linkea para transform-lo em um programa executvel.
EuCONTEDO 309

programa Clarion , de vrias maneiras, uma jornada pessoal atravs de uma srie de caixas de
dilogo. No h nenhuma sequncia obrigatria a ser seguido; mas eu ter preenchido alguns, um
pr-requisito para alcanar outros.

editor de Dicionrio
Dicionrio de Dados (um arquivo .dct), mantido pelo editor do dicionrio. Aqui est uma
descrio do banco de dados, que inclui arquivos, chaves, ndices, motoristas, as relaes entre os
arquivos, campos, regras de validao de campo, restries de integridade referencial, e
armazenado. Este o primeiro arquivo que voc cria ao projetar um aplicativo.

Voc pode criar arquivo de definies "do zero", ou podem ser importados definies de arquivos
de dados existentes. Se voc possui a edio Enterprise, voc pode usar o dicionrio sincronizador
para coordenar um dicionrio de Clarion dicionrio de dados motor de SQL. Isso permite que voc
tomar uma vez arquivo a partir de um banco de dados SQL (que elimina um monte de trabalho) e
dicionrio de dados mantendo Clarion permanentemente coordenado com o ambiente SQL
RDBMS todas as definies, independentemente das mudanas feitas pelo Gerentea base Dados
SQL.

As outras ferramentas do ambiente de desenvolvimento utilizando as informaes no dicionrio


para permitir, por exemplo, facilmente colocar campos de dados em uma caixa de dilogo
projetado para o usurio final. Generator aplicativo cria o cdigo para todas as instrues para
acessar os arquivos de dados com base em como o dicionrio construdo. Na verdade, o
Assistente de aplicao pode gerar uma aplicao totalmente funcional baseada unicamente em seu
Dicionrio de Dados!

Gerador de aplicao
Generator aplicao gera o cdigo fonte da aplicao, um processo de cada vez, com base em
modelos que escolheram o registro modelo. Ele permite que voc adicionar variveis de memria
global e local, e procedimentos de adaptao com ferramentas de design visual e cdigo fonte
inseridos.

Generator aplicativo fornece acesso a outras ferramentas do ambiente de desenvolvimento para


personalizar a aparncia e funcionalidade de janelas, menus, relatrios e outros elementos da
interface do usurio. Os modelos fornecem os seus prprios controles (que aparecem no Gerador
de Aplicativos), que permitem que o programador para fornecer as informaes necessrias para o
modelo de personalizar a funcionalidade desejada.

Designer do Windows
Aqui realizada o design visual de todas as janelas e controles da aplicao (tudo que voc v o
usurio final). gera automaticamente o cdigo-fonte para os elementos que voc projeta
visualmente na tela.

309
310 CLARION 5 CLARION
Aprendiendo

Report Designer
Report Designer trabalha com o Gerador de Aplicativos em uma janela de designer de moda muito
semelhantes. O programador simplesmente colocar controles em uma pgina do relatrio. Em
tempo de execuo, o mecanismo de relatrios processa registros, manipulao de todo o
gerenciamento de pginas impressas, a diviso de dados em grupos, cabealhos e rodaps, como
especificado.

editor de texto
O Editor de Texto um editor de programao totalmente funcional que pode ser usado para
escrever o cdigo fonte de seu aplicativo precisa. As chances so de que, usando Application
Builder, use o editor de texto para criar o cdigo-fonte embedded, personalizar o funcionamento
do processo. Ou, ainda, voc pode criar aplicaes completas "do zero" (se voc realmente quer ter
todo o trabalho).

cores editor de texto destacado por diferentes partes da sintaxe, tornando mais fcil para identificar
as diferentes partes da linguagem Clarion, ler e modificar. Ele tambm tem plena capacidade de
procurar e substituir, alm das ferramentas usuais para edio.

O editor de Frmula
O Editor de Frmula ajuda a gerar e gerenciar frmulas simples ou complexas baseadas em todos
os tipos de expresses matemticas ou alfanumricos. O Editor de Frmula oferece verificao de
sintaxe, e acesso imediato a todas as variveis, funes e operadores, para que as frmulas gerados
so sempre sintaticamente correto.

Sistema de projetos
Generator aplicao cria automaticamente os aplicativos arquivo de projeto (.PRJ). Este arquivo
contm opes para compilao e ligada a, como se para incluir o cdigo para depurao, opes
de otimizao, arquivos externos, arquivos de origem, bibliotecas e outros arquivos a serem
includos no processo de compilao e de cdigo linkeado.

lavadores
Depurao de um programa normalmente requer a execuo de um programa e ir vrias vezes
parando em vrios pontos na sua execuo para examinar o valor de diferentes variveis para
determinar a causa de erros lgicos que possa ter. Purificadores (depuradores) Clarion (ambos 16 e
32 bit) tm vrias janelas que exibem o cdigo fonte, o contedo das variveis, os processos
activos, e mais.

H trs oficinas sobre o uso de purificadores contidas no Guia do Usurio. Recomendamos estudar
depois de concluir todos os cursos neste livro.

ajuda on-line
EuCONTEDO 311

Clarion oferece um extenso contexto ajuda online sensvel, a partir de praticamente qualquer tela.
Um clique no boto Ajuda ou pressione F1.

seco de Perguntas Frequentes ( "Perguntas Frequentes") da ajuda on-line fornece instrues e


exemplos para executar tarefas comuns em aplicaes. Voc pode copiar e colar exemplos de
cdigo diretamente do sistema ajuda o seu programa. escolher Ajuda ndice, em seguida,
pressione o boto Como posso ...? ( "Como posso ...?")

Sistema de Ajuda Online Clarion inclui um arquivo de ajuda principal e arquivos auxiliares. Voc
pode olhar para os arquivos online usando palavras-chave e utilizando um ndice. Para procurar os
arquivos de suporte, abri-los diretamente do Windows Explorer ou o Gerenciador de programas.

Qual ser a prxima?

Onde ir para aprender mais sobre programao com Clarion?


Continue com a seo de Aprendizagem Clarion. Os dois campos que se seguem destinam-se
a apresent-lo a todas as ferramentas de desenvolvimento que Clarion oferece.
Unisoft oferece diversos cursos.
Chamada 372-7243 / 9850 ou 374-2998 / 9469 para obter informaes.
Registrado na lngua espanhola, os usurios podem consultar o seguinte website:
http://www.unisoft.com.ar.
Junte-se a (ou formar) um grupo de usurios local Clarion, e participar em projectos de
investigao conjuntas com outros desenvolvedores Clarion.
Participar frum TopSpeed no CompuServe (GO Topspeed) ou comp.lang.clarion newsgroup
Internet para formar uma rede com programadores Clarion em todo o mundo (altamente
recomendado!)
Boa sorte, e ir para ela!. programao poder Clarion coloca os dedos continua a crescer como voc
sabe mais.

311

Anda mungkin juga menyukai