Windows Guia da Plataforma

O backend Windows usa a API Win32 nativa e GDI/GDI+ para todos os desenhos. Ele e escrito em C++ e compilado com MSVC ou BCC. Este e o backend mais maduro e completo em recursos do HarbourBuilder.

Visao Geral da Arquitetura

Criacao de Janelas Nativas

Cada janela e controle do HarbourBuilder e uma janela Win32 nativa criada via CreateWindowEx(). O backend registra classes de janela customizadas na inicializacao:

// win32_backend.cpp - Registro de classes de janela
void RegisterClasses( HINSTANCE hInstance )
{
   WNDCLASSEX wc = { sizeof( WNDCLASSEX ) };
   wc.hInstance     = hInstance;
   wc.lpfnWndProc   = WndProc;
   wc.hCursor       = LoadCursor( NULL, IDC_ARROW );
   wc.hbrBackground = (HBRUSH)( COLOR_WINDOW + 1 );

   wc.lpszClassName = "HBBUILDER_FORM";
   RegisterClassEx( &wc );

   wc.lpszClassName = "HBBUILDER_BUTTON";
   RegisterClassEx( &wc );

   // ... classes adicionais para EDIT, STATIC, etc.
}

Controles sao controles comuns Win32 padrao: BUTTON, EDIT, STATIC, COMBOBOX, LISTBOX, msctls_progress32, msctls_trackbar32, SysTreeView32, SysListView32 e RichEdit.

Tratamento de Eventos (WndProc)

O backend Windows usa um WndProc central (procedimento de janela) que recebe todas as mensagens do SO. Ele as despacha para manipuladores de eventos Harbour:

// win32_backend.cpp - Despacho de mensagens
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, (int) LOWORD( lParam ), (int) HIWORD( lParam ) );
         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 fechamento
         break;

      // ... tratamento adicional de mensagens
   }
   return DefWindowProc( hWnd, msg, wParam, lParam );
}

Suporte ao Modo Escuro

O HarbourBuilder no Windows segue o tema do sistema. O modo escuro e implementado usando:

• DwmSetWindowAttribute() — Habilita barras de titulo escuras no Windows 10/11 definindo DWMWA_USE_IMMERSIVE_DARK_MODE.
• Estilos de classe de janela escura — Quando o sistema esta em modo escuro, o backend registra classes de janela com pinceis de fundo escuros.
• Cores escuras GDI — Cores dos controles usam valores de paleta escura (fundos quase pretos, texto claro).
• Tema escuro Scintilla — O editor de codigo usa um estilo de lexer escuro que corresponde ao tema do IDE.

// win32_backend.cpp - Barra de titulo escura
void EnableDarkTitleBar( HWND hWnd )
{
   BOOL dark = TRUE;
   DwmSetWindowAttribute(
      hWnd,
      DWMWA_USE_IMMERSIVE_DARK_MODE,
      &dark,
      sizeof( dark )
   );
}

Integracao Scintilla

O backend Windows usa Scintilla 5.6.1 como biblioteca dinamica:

O Scintilla e carregado em tempo de execucao via LoadLibrary() e GetProcAddress(). O backend cria uma janela Scintilla como filha da aba do editor de codigo e comunica-se com ela via SendMessage().

Opcoes de Compilador

Compiladores Suportados

Script de Build

O script build_win.bat cuida de todo o processo de build: