Ponto de partida: abra o ambiente de desenvolvimento Clarion. O diálogo Pick deverá estar aberto.
Primeiro, nós criaremos um diretório C:\TUTORIAL para as aplicações que você criará a partir deste site.
Este tutorial assume que você instalou o Clarion no diretório C:\. Se você usou um diretório diferente, você
terá que modificar as instruções de acordo.

Crie o Diretório de Trabalho

1. Alterne de tarefa para a ferramenta apropriada no seu sistema operacional (Gerenciador de Arquivos,
Explorer, etc.) e crie um novo diretório chamado TUTORIAL abaixo da Raiz C:.

2. Retorne para o Clarion.

Crie sua primeira aplicação Clarion

1. Clique no ícone "Pick File" (É o 1.º ícone da barra de ferramentas).

2. No diálogo Pick, selecione a ficha Application e pressione o botão [New...].

3. O diálogo New aparecerá. Ele é um diálogo Open File padrão do Windows
que permite que você altere o diretório e digite um nome de arquivo.

4. Selecione o diretório \TUTORIAL e digite QWKTUTOR no campo Nome do Arquivo.
Você pode usar nomes de arquivos longos, mas este tutorial
não os usará para benefício de usuários do Windows 3.1.

5. Marque a caixa Use Quick Start e então pressione o botão [Salvar].
O diálogo Clarion Quick Start aparecerá.

Definindo o Arquivo de Dados

1. Pressione [Tab] duas vezes, digite Clientes no campo Data File Name epressione [Tab] outra vez.
O Quick Start Wizard usará este nome como nome do arquivo de dados. Note que ele leva as três primeiras
letras, CLI, e coloca-as no campo Prefix. Um Prefixo de arquivo torna os nomes de campos únicos através de
múltiplos arquivos que compartilham nomes de campos comuns.

2. Pressione [Tab] para aceitar CLI como o Prefixo. Depois, você escolhe
um File Driver. Este campo tem como valor padrão TopSpeed (um dos
sistemas de arquivos proprietários do Clarion).

3. Pressione [Tab] para aceitar TopSpeed como o File Driver. Isto
leva você para o list box onde você define os campos.

Nota: Sob o Windows 3.1, você deve ter SHARE.EXE ou o driver Windows VSHARE.386 carregado para usar o
file driver TopSpeed. Versões mais novas do Windows gerenciam isto para você.

4. NumeroCliente na primeira linha da Column Name e pressione [Tab]. Isto cria um campo nomeado
NumeroCliente. Quick Start Wizard também usa este nome para o Prompt padrão e o Cabeçalho
de Coluna. O prompt é usado sempre que você coloca o campo em uma janela. Cabeçalhos de Coluna
são usados em relatórios e list boxes.

5. Digite N4 na coluna Picture, e pressione [Tab].

Isto especifica a máscara (Numero com 4 casas) para controles de janelas e relatórios,
que implicitamente declaram o tipo de dados para o Quick Start Wizard.

6. Na coluna KEY, pressione a seta para baixo para mostrar as escolhas e
destaque AutoNumber e então pressione [Tab].

7. Digite Empresa na Column Name, e pressione [Tab]. Isto cria um campo de nome Empresa, para ser
utilizado com o nome da empresa onde o Cliente trabalha.

8. Digite S20 na coluna Picture, e pressione [Tab]. Isto especifica a máscara
padrão para janelas e relatórios. Neste caso, o tipo de dado é um campo tipo STRING
(cadeia de caracteres) com 20 posições.

9. Na coluna key, clique sobre a seta apontada para baixo para visualizar as opções. Selecione a
opção Duplicatee tecle [Tab]. Isto especifica que a chave será criada permite entradas duplicadas.
Isto permite a você ter dois Clientes com o mesmo nome de Empresa.

10. Finalize criando os seguintes campos restantes (nomes sem acento ou ç),
conforme tabela abaixo:

Field Name	Picture	Key
Nome	S20	(no key)
Sobrenome	S20	(no key)
Endereco	S40	(no key)
Cidade	S20	(no key)
Estado	S2	(no key)
Cep	P#####-###P	Duplicate

A máscara P#####-###P especifica o formato utilizado para o Código de Endereçamento Postal (CEP).
Isto é, uma máscara com cinco dígitos numéricos.

Termine o assistente Quick Start Wizard e crie a aplicação

1. Quando você tiver definido todos os campos, pressione o botão [OK]. Primeiro o Quick
Start Wizard perguntará se você fez as definições de todos
os campos. Quando você pressionar o botão [OK], ele criará
sua aplicação e mostrará a janela QWKTUTOR.App - Application Tree.

Note a estrutura de árvore da aplicação. Na parte superior temos o procedimento Main (Frame),
que cria uma janela moldura de aplicação (MDI - Multiple Document Interface). Esta procedure
contém o menu que chama as outras procedures. Abaixo do procedimento Main está o
procedimento BrowseClientes, do tipo Browse, chamando um procedimento complementar UpdateClientes,
do tipo Form. O Browse mostra os dados baseados em todas as três chaves que você
especificou quando definindo os campos. Você também pode ver três
relatórios baseados nestas chaves. A aplicação está completa,
sem exigir mais nenhuma informação de você. A barra de ícones do Clarion for Windows

2. Escolha Project -> Run (ou pressione o botão Run na barra de ferramentas). O Gerador de Aplicações
cria o código fonte para sua aplicação, então compila, linka e
executa o programa resultante. Parabéns! Sua aplicação já está rodando.

Explore a sua aplicação A barra de ícones da aplicação gerada.

Primeiro, adicione alguns registros.

1. Escolha Browse -> Browse the Clientes File.

2. Pressione o botão [Insert] ou [+] a barra de ferramentas.

3. Depois que você digitou os dados do primeiro cliente, pressione o botão [OK] para
fechar a janela Form e salvar os registros no arquivo de dados.

Isto demonstra a metáfora da aplicação Browse-Form padrão do Clarion. A lista Browse mostra
os registros no arquivo de dados, e a procedure Form é usada para atualizar (adicionar, alterar
ou excluir) os registros individuais no arquivo. Clarion também pode suportar a metáfora
Scrolling Form onde os registros de dados são editados diretamente
no browse (veremos isto mais tarde).

Adicione uns poucos registros (você também pode clicar com o botão direito na lista
browse e escolher Insert no menu suspenso para inserir registros). Note que cada
vez que você adiciona um novo registro no arquivo de Clientes, o valor do campo NumeroCliente
automaticamente incrementa em um a partir do último número adicionado
anteriormente. Observe as diferentes ordens de classificação na procedure Browse, e então
redimensione as colunas e use a barra de rolagem horizontal para examinar dados nos campos
que não aparecem na lista inicialmente. Você pode mesmo imprimir os relatórios, se você quiser.

4. Escolha File -> Exit para sair de sua aplicação. Você também pode tentar executar seu
programa (QWKTUTOR.EXE) a partir do Gerenciador de Arquivos ou Explorer - é um executável
real Windows que não requer o ambiente Clarion para rodar. Agora salvaremos
nosso trabalho e sairemos do Gerador de Aplicações para modificar o dicionário de dados
que criamos. Depois, nós adicionaremos um segundo arquivo relacionado no Dicionário de Dados.

5. Selecione File -> Close ou pressione o botão [OK] para fechar o Gerador de Aplicações.

Muito bom! Agora siga para o próximo passo!