Ribbon Nativo vs Hwgui vs WebView2

Entendendo o que cada tecnologia faz — e por que elas se complementam

Índice

1. Introdução
2. O que "controle completo" significa
3. O que o Ribbon pode fazer
4. O que o Ribbon NÃO pode fazer
5. A arquitetura correta
6. Quando usar cada um
7. Exemplo concreto: editor simples
8. Como os componentes se comunicam
9. Comparação com o Office
10. Arquitetura recomendada
11. Resumo

1. Introdução

Quando você trabalha com o Windows Ribbon Framework (o mesmo componente do WordPad e do Paint), surge uma dúvida natural:

"Os controles do Ribbon são completos? Substituem a Hwgui?"

A resposta é: são completos, mas não substituem a Hwgui. O Ribbon é uma barra de comandos, não um framework de UI. Este documento explica a diferença e mostra como combinar as peças.

2. O que "controle completo" significa

Um <ComboBox> no Ribbon é um ComboBox de verdade:

Tem lista de itens que você popula
Abre popup ao clicar
Aceita seleção por teclado
Envia eventos de mudança
Guarda estado (item selecionado)

Um <Spinner> é um Spinner de verdade:

Seta pra cima/baixo
Aceita digitação
Respeita min/max/increment
Dispara evento quando muda

Um <ToggleButton> é um botão de estado:

Liga/desliga
Muda visual (apertado/solto)
Guarda estado booleano

Não é "só o desenho". O comportamento todo está no Windows. Você só implementa o Execute (o que fazer quando clica) e o UpdateProperty (que valores mostrar).

3. O que o Ribbon pode fazer

Controle	Uso típico
`Button`	Ações (Salvar, Imprimir)
`ToggleButton`	Opções com estado (Negrito on/off)
`ComboBox`	Escolhas curtas (fonte, tamanho)
`Spinner`	Valores numéricos (zoom, quantidade)
`CheckBox`	Opções binárias
`Gallery`	Galeria de estilos (como no Word)
`ColorPicker`	Escolha de cor
`FontControl`	Seletor de fonte completo
`DropDownButton`	Menu suspenso com comandos
`SplitButton`	Botão + dropdown

4. O que o Ribbon NÃO pode fazer

O Ribbon é uma barra de comandos, não uma área de trabalho. Ele só pode fazer uma coisa: mostrar abas/grupos/botões numa faixa no topo da janela.

O que você precisa	Ribbon pode?
Grid/tabela de dados	NÃO
Editor de texto (RichEdit)	NÃO
Árvore (TreeView)	NÃO
Lista com scroll	NÃO
Formulário com vários campos	NÃO
Gráficos / dashboard	NÃO
Calendário	NÃO
Área de desenho	NÃO
Múltiplas janelas	NÃO
Qualquer coisa abaixo da faixa de comandos	NÃO

5. A arquitetura correta

┌─────────────────────────────────────────┐ │ Ribbon (nativo do Windows) ~120px │ ← só comandos ├─────────────────────────────────────────┤ │ │ │ Área de trabalho │ ← o resto │ │ │ Aqui entra Hwgui OU WebView2 OU o que │ │ você quiser: grids, forms, editores │ │ │ └─────────────────────────────────────────┘

O Ribbon não substitui a Hwgui. Ele convive com ela.

6. Quando usar cada um

Situação	Ferramenta
Barra de menus/ferramentas no topo	Ribbon
Grid de clientes	Hwgui (Browse) ou WebView2 (DataTables)
Formulário de cadastro	Hwgui (Edits, Gets) ou WebView2 (HTML form)
Dashboard com gráficos	WebView2 (Chart.js)
Editor de texto	Hwgui (RichEdit) ou WebView2 (Quill)
Menus contextuais (botão direito)	Hwgui
Diálogos modais	Hwgui
Barra de status	Hwgui

7. Exemplo concreto: editor simples

┌──────────────────────────────────────────┐ │ [Arquivo] [Home] [Insert] [View] │ ← Ribbon (nativo) │ ┌─Clipboard─┐ ┌─Font─┐ ┌─Paragraph─┐ │ │ │Paste Cut │ │B I U │ │• 1 2 ¶ │ │ │ └──────────┘ └──────┘ └───────────┘ │ ├──────────────────────────────────────────┤ │ │ │ Área de edição do texto │ ← Hwgui (RichEdit) │ (o usuário digita aqui) │ │ │ ├──────────────────────────────────────────┤ │ Linha 1, Coluna 1 | INS | 100% │ ← Hwgui (status bar) └──────────────────────────────────────────┘

O Ribbon manda os comandos (Negrito, Itálico, Salvar). A Hwgui faz o trabalho pesado (edição, arquivo, status).

8. Como os componentes se comunicam

Usuário clica "Negrito" no Ribbon ↓ CApplication::Execute(ID_CMD_BOLD) ↓ PostMessage(hwnd, WM_USER+200, ...) ↓ Harbour: HandleRibbonCmd() detecta ID_CMD_BOLD ↓ Harbour aplica negrito no RichEdit do Hwgui: oRichEdit:SetFont( ..., .T. )

O Ribbon só avisa "o usuário clicou em Negrito". Quem faz o negrito acontecer é o Harbour + Hwgui.

9. Comparação com o Office

O Office funciona exatamente assim:

Parte	Tecnologia
Ribbon	Motor próprio da Microsoft (não o nativo)
Área de edição	Motor próprio
Comunicação	Protocolo interno

Se você abrir o Word, verá:

Ribbon no topo
Documento (área cliente) embaixo
São dois componentes diferentes trabalhando juntos

10. Arquitetura recomendada

┌────────────────────────────────────────────┐ │ Ribbon nativo (menus, botões) │ ← ribbon_wrapper.dll ├────────────────────────────────────────────┤ │ │ │ WebView2 (HTML/CSS/JS) │ ← webview_wrapper.dll │ Grids, forms, dashboards... │ │ │ ├────────────────────────────────────────────┤ │ Hwgui: status bar, diálogos, menus ctx │ ← hwgui └────────────────────────────────────────────┘ ↓ Harbour (regras de negócio, DBF)

Cada camada faz o que sabe fazer melhor:

Camada	Responsabilidade
Ribbon	Comandos no topo (visual nativo do Windows)
WebView2	Interface rica e flexível (HTML/CSS/JS)
Hwgui	Janela hospedeira, status bar, diálogos
Harbour	Lógica de negócio, acesso a DBF

Não é "ou" — é "e". Os três se complementam.

11. Resumo

Pergunta	Resposta
Os controles do Ribbon são completos?	SIM — comportamento todo no Windows
Substituem a Hwgui?	NÃO — são só a barra de comandos
Dá pra fazer um app só com Ribbon?	NÃO — falta a área de trabalho
Preciso de Hwgui?	SIM — pra grid, form, editor, status bar
Preciso de WebView2?	OPCIONAL — pode substituir a Hwgui na área cliente
Os três convivem?	SIM — arquitetura válida