Tutorial: Hola Mundo

En este tutorial construira su primera aplicacion HarbourBuilder desde cero — una ventana simple con un boton que muestra un saludo. Al final, comprendera el flujo de trabajo basico del proyecto: crear, disenar, codificar, compilar y ejecutar.

Paso 1: Crear un Nuevo Proyecto

1. Inicie HarbourBuilder.
2. Seleccione Archivo → Nuevo Proyecto desde la barra de menu.
3. En el dialogo Nuevo Proyecto, elija una carpeta (ej. C:\Projects\HolaMundo) e ingrese el nombre del proyecto HolaMundo.
4. Haga clic en Aceptar. El IDE crea un archivo de proyecto HolaMundo.hbp y un archivo fuente main.prg con una plantilla inicial.

Paso 2: Abrir el Disenador de Formularios

1. En el panel Gestor de Proyectos, haga doble clic en main.prg.
2. El Disenador de Formularios se abre mostrando un formulario vacio titulado "Mi Primera App".
3. El Inspector de Objetos a la izquierda muestra las propiedades del formulario.
4. Cambie la propiedad cTitle a "Hola Mundo" y presione Enter — la barra de titulo del formulario se actualiza inmediatamente.

Paso 3: Anadir un Boton

1. Haga clic en la pestania Estandar en la Paleta de Componentes en la parte superior del IDE.
2. Haga clic en el icono Boton en la paleta.
3. Haga clic en la superficie del formulario cerca del centro — aparece un boton.
4. En el Inspector de Objetos, establezca la propiedad cPrompt del boton a "Decir Hola".
5. Opcionalmente ajuste las propiedades nTop, nLeft, nWidth y nHeight para posicionar y dimensionar el boton.

Paso 4: Anadir una Etiqueta

1. Desde la pestania Estandar de la paleta, haga clic en el icono Etiqueta.
2. Haga clic en el formulario encima del boton para colocar la etiqueta.
3. Establezca la propiedad cValue de la etiqueta a "Pulse el boton de abajo!".
4. Establezca nWidth a 300 para que el texto quepa comodamente.

Paso 5: Establecer el Evento OnClick

1. Seleccione el boton en el formulario (haga clic una vez).
2. En el Inspector de Objetos, cambie a la pestania Eventos.
3. Haga doble clic en la fila del evento OnClick. El IDE cambia al Editor de Codigo y crea un esqueleto de manejador.
4. Complete el manejador para que actualice el texto de la etiqueta:

oBtn:OnClick := { || oLabel:SetValue( "Hola desde HarbourBuilder!" ) }

Paso 6: Compilar y Ejecutar

1. Presione F9 (o seleccione Ejecutar → Compilar y Ejecutar).
2. Observe el panel Mensajes en la parte inferior — muestra los pasos de preprocesamiento, compilacion, enlazado y lanzamiento.
3. Aparece la ventana de su aplicacion. Haga clic en el boton "Decir Hola".
4. El texto de la etiqueta cambia a "Hola desde HarbourBuilder!".

Listado Completo del Codigo

Aqui esta el main.prg completo para la aplicacion Hola Mundo:

#include "hbbuilder.ch"

function Main()

   local oForm, oBtn, oLabel

   DEFINE FORM oForm TITLE "Hola Mundo" ;
      SIZE 640, 480 FONT "Segoe UI", 10

   @ 30, 50 LABEL oLabel VALUE "Pulse el boton de abajo!" ;
      OF oForm SIZE 300, 24

   @ 70, 50 BUTTON oBtn PROMPT "Decir Hola" ;
      OF oForm SIZE 120, 32 ;
      ACTION oLabel:SetValue( "Hola desde HarbourBuilder!" )

   ACTIVATE FORM oForm CENTERED

return nil

Que Aprendio

• Como crear un nuevo proyecto HarbourBuilder.
• Como usar el Disenador de Formularios para colocar controles visualmente.
• Como establecer propiedades mediante el Inspector de Objetos.
• Como vincular un manejador de evento OnClick.
• Como compilar y ejecutar su aplicacion con F9.