Windows Guia de Plataforma

El backend de Windows usa la API nativa Win32 y GDI/GDI+ para todo el dibujo. Esta escrito en C++ y compilado con MSVC o BCC. Este es el backend mas maduro y completo en HarbourBuilder.

Vision General de la Arquitectura

Cada ventana y control de HarbourBuilder es una ventana Win32 nativa creada mediante CreateWindowEx(). El backend registra clases de ventana personalizadas al inicio. Los controles son controles comunes Win32 estandar: BUTTON, EDIT, STATIC, COMBOBOX, LISTBOX, msctls_progress32, msctls_trackbar32, SysTreeView32, SysListView32 y RichEdit.

Manejo de Eventos (WndProc)

El backend de Windows usa un WndProc central (procedimiento de ventana) que recibe todos los mensajes del SO. Los despacha a los manejadores de eventos de Harbour:

// win32_backend.cpp - Despacho de mensajes
LRESULT CALLBACK WndProc( HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam )
{
   switch( msg )
   {
      case WM_COMMAND:
         FireEvent( hWnd, EVENT_CLICK, CT_BUTTON );
         break;
      case WM_LBUTTONDOWN:
         FireEvent( hWnd, EVENT_MOUSEDOWN );
         break;
      case WM_KEYDOWN:
         FireEvent( hWnd, EVENT_KEYDOWN, (int) wParam );
         break;
      case WM_PAINT:
         FireEvent( hWnd, EVENT_PAINT );
         break;
      case WM_CLOSE:
         if( !FireCloseQuery( hWnd ) )
            return 0;  // Cancelar cierre
         break;
   }
   return DefWindowProc( hWnd, msg, wParam, lParam );
}

Soporte de Modo Oscuro

HarbourBuilder en Windows sigue el tema del sistema. El modo oscuro se implementa usando:

• DwmSetWindowAttribute() — Habilita barras de titulo oscuras en Windows 10/11 estableciendo DWMWA_USE_IMMERSIVE_DARK_MODE.
• Estilos de clase de ventana oscuros — Cuando el sistema esta en modo oscuro, el backend registra clases de ventana con pinceles de fondo oscuros.
• Colores oscuros GDI — Los colores de los controles usan valores de paleta oscura (fondos casi negros, texto claro).
• Tema oscuro de Scintilla — El editor de codigo usa un estilo de lexer oscuro que coincide con el tema del IDE.

Integracion de Scintilla

El backend de Windows usa Scintilla 5.6.1 como biblioteca dinamica:

Scintilla se carga en tiempo de ejecucion mediante LoadLibrary() y GetProcAddress().

Opciones del Compilador

Compiladores Soportados

Script de Construccion

El script build_win.bat maneja todo el proceso de construccion:

1. Deteccion del compilador — Busca instalaciones de MSVC (2019, 2022, Community, BuildTools) y BCC.
2. Configuracion del entorno — Llama a vcvarsall.bat para configurar el entorno del compilador.
3. Compilacion de Harbour — Construye Harbour desde el codigo fuente si aun no esta presente.
4. Construccion de Scintilla — Compila las DLLs de Scintilla y Lexilla.
5. Compilacion del IDE — Compila el codigo fuente de HarbourBuilder.
6. Enlazado — Enlaza contra user32.lib, gdi32.lib, comctl32.lib, dwmapi.lib y el runtime de Harbour.

Caracteristicas Especificas de la Plataforma

Limitaciones Conocidas

• Requisito de manifiesto — Las aplicaciones de Windows necesitan un manifiesto incrustado para estilos visuales (ComCtl32 v6) y consciencia DPI.
• Escalado DPI — El backend tiene consciencia DPI pero el posicionamiento de controles usa coordenadas de pixeles. Las pantallas de alto DPI pueden requerir ajustes de tamano manuales.
• Version de RichEdit — El control RichEdit depende de msftedit.dll que puede no estar disponible en versiones muy antiguas de Windows (anteriores a Windows 8).
• Windows XP/Vista/7/8 — No soportados oficialmente. El backend apunta a APIs de Windows 10+.

Dependencias