Tutorial: Ola Mundo

Neste tutorial voce vai criar sua primeira aplicacao HarbourBuilder do zero — uma simples janela com um botao que exibe uma saudacao. Ao final, voce entendera o fluxo basico de trabalho do projeto: criar, projetar, codificar, compilar e executar.

Passo 1: Criar um Novo Projeto

1. Inicie o HarbourBuilder.
2. Selecione Arquivo → Novo Projeto na barra de menu.
3. No dialogo Novo Projeto, escolha uma pasta (ex. C:\Projetos\HelloWorld) e informe o nome do projeto HelloWorld.
4. Clique em OK. A IDE cria um arquivo de projeto HelloWorld.hbp e um arquivo fonte main.prg com um modelo inicial.

Passo 2: Abrir o Designer de Formularios

1. No painel Gerenciador de Projetos, clique duas vezes em main.prg.
2. O Designer de Formularios abre mostrando um formulario vazio intitulado "My First App".
3. O Inspetor de Objetos a esquerda exibe as propriedades do formulario.
4. Altere a propriedade cTitle para "Hello World" e pressione Enter — a barra de titulo do formulario atualiza imediatamente.

Passo 3: Adicionar um Botao

1. Clique na aba Padrao na Paleta de Componentes no topo da IDE.
2. Clique no icone Botao na paleta.
3. Clique na superficie do formulario proximo ao centro — um botao aparece.
4. No Inspetor de Objetos, defina a propriedade cPrompt do botao para "Dizer Ola".
5. Opcionalmente ajuste as propriedades nTop, nLeft, nWidth e nHeight para posicionar e dimensionar o botao.

Passo 4: Adicionar um Rotulo

1. Na aba Padrao da paleta, clique no icone Rotulo (Label).
2. Clique no formulario acima do botao para colocar o rotulo.
3. Defina a propriedade cValue do rotulo para "Clique no botao abaixo!".
4. Defina nWidth como 300 para que o texto caiba confortavelmente.

Passo 5: Definir o Evento OnClick

1. Selecione o botao no formulario (clique uma vez).
2. No Inspetor de Objetos, alterne para a aba Eventos.
3. Clique duas vezes na linha do evento OnClick. A IDE muda para o Editor de Codigo e cria um stub de manipulador.
4. Preencha o manipulador para que atualize o texto do rotulo:

oBtn:OnClick := { || oLabel:SetValue( "Ola do HarbourBuilder!" ) }

Passo 6: Compilar e Executar

1. Pressione F9 (ou selecione Executar → Compilar e Executar).
2. Observe o painel Mensagens na parte inferior — ele mostra as etapas de pre-processamento, compilacao, vinculacao e inicializacao.
3. A janela da sua aplicacao aparece. Clique no botao "Dizer Ola".
4. O texto do rotulo muda para "Ola do HarbourBuilder!".

Listagem Completa do Codigo

Aqui esta o main.prg completo para a aplicacao Ola Mundo:

#include "hbbuilder.ch"

function Main()

   local oForm, oBtn, oLabel

   DEFINE FORM oForm TITLE "Hello World" ;
      SIZE 640, 480 FONT "Segoe UI", 10

   @ 30, 50 LABEL oLabel VALUE "Clique no botao abaixo!" ;
      OF oForm SIZE 300, 24

   @ 70, 50 BUTTON oBtn PROMPT "Dizer Ola" ;
      OF oForm SIZE 120, 32 ;
      ACTION oLabel:SetValue( "Ola do HarbourBuilder!" )

   ACTIVATE FORM oForm CENTERED

return nil

O Que Voce Aprendeu

• Como criar um novo projeto HarbourBuilder.
• Como usar o Designer de Formularios para colocar controles visualmente.
• Como definir propriedades pelo Inspetor de Objetos.
• Como conectar um manipulador de evento OnClick.
• Como compilar e executar sua aplicacao com F9.