10. Notas de versão #

← Migrar da 1.0 para a 2.0 · Índice

Uma versão adquirida nunca perde os seus componentes: a 2.0 contém os dezasseis da 1.0, e uma chave cuja manutenção cobre a data do seu build compila com a DLL mais recente — ver Licença.

2.0 — setembro 2026 #

Cinco componentes, todos dedicados à navegação #

• Menu bar — barra de menus da aplicação: menus, submenus, entradas marcáveis, separadores, ícones, atalhos e mnemónicas &Ficheiro, desenhada pela biblioteca no tema da aplicação.
• Command palette — um atalho, três letras, e qualquer ação da aplicação é alcançada sem a procurar nos menus. Pesquisa no rótulo, no grupo e nas palavras-chave, várias palavras de uma vez.
• Radial menu — os comandos em coroa à volta do cursor ao clique direito, escolhidos pela direção em vez de percorrer uma lista.
• Shell explorer — a árvore do verdadeiro shell do Windows: Ambiente de trabalho, Este PC, unidades, pastas, Rede, com os ícones do computador. Um só of_expand abre um caminho profundo.
• Stepbar — o fio de etapas de um assistente: as concluídas, a atual e as que faltam, na horizontal ou na vertical.

Uma API remodelada nos dezasseis da 1.0 #

Uma chave, um endereço; tudo a partir do componente; uma adição devolve um código. As três regras, o antes/depois e cada assinatura alterada estão em Migrar da 1.0 para a 2.0. O motivo: um handle que adicionava não podia dizer que tinha recusado, e três argumentos para designar um item obrigavam cada componente a inventar a sua própria maneira de o fazer.

Em todos os componentes #

• of_count, of_keys_at e of_has, no componente e em cada nível: o que um componente contém pergunta-se, já não é preciso guardá-lo por conta própria.
• Todo o método que devolve um long diz o que o seu retorno significa: 0 aplicado, -5 argumento inválido, -2 componente não criado — na doc incorporada da demonstração como aqui.
• As propriedades de um item releem-se ao vivo: o ícone de uma entrada da listbar, o texto e o ícone de um mosaico, o estado de um botão de barra — um getter diz o que está no ecrã, nunca um valor memorizado.
• ib_visible em cada entrada de menu — barra de menus, menu contextual, menu radial, menus da faixa de opções: ocultar não é acinzentar, a entrada sai do menu, atalho incluído, e guarda a sua chave para voltar.
• A barra de estado constrói os seus menus entrada a entrada (of_add_menu_item ("panel/id", …)), com um handle de entrada que acinzenta, marca e oculta — em vez dos dois arrays paralelos de of_set_panel_menu.
• ue_script_error: um erro de script na página chega ao PowerBuilder com a sua mensagem e a sua pilha, em vez de se perder.

Corrigido #

• Um item desativado ou oculto já não responde a nada: nem clique nem teclado — a listbar ainda selecionava uma entrada acinzentada com Enter.
• O texto acinzentado lê-se em todos os temas (contraste 3:1 no mínimo), e o texto sob o rato também no modo escuro — dois botões desativados da faixa de opções ficavam invisíveis no Office 2007.
• Um caminho Windows lido da página voltava com as barras invertidas duplicadas (C:\\Windows); um valor com aspas ficava cortado.
• Dock container: o painel fixado à esquerda perdia a sua margem direita acima de 100 % de escala do ecrã.
• Faixa de opções: o ícone de um botão desativado não ficava acinzentado no modo compacto; um título da barra de menus acendia-se ao mesmo tempo que o que estava sob o rato.
• Editor de código: o texto relido após um dobrar era o antigo, e desdobrar apagava o que fora escrito.

1.0 — agosto 2026 #

Primeira versão: dezasseis componentes — button, code editor, dock container, listbar, message box, PDF viewer, picture, progress, ribbon, statictext, statusbar, tab, tiles box, toaster, toolbar, web browser — uma só DLL a implementar, x86 e x64 com o mesmo nome, sem dependência .NET, ActiveX nem PBNI. Temas Office, Fluent e Metro, claro e escuro; seis línguas e RTL; licença totalmente offline; PowerBuilder 10.2 a 2025.

← Migrar da 1.0 para a 2.0 · Índice