11. Notas de versão #

← Migrar da 2.0 para a 3.0 · Índice

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

3.0 — setembro 2026 #

Onze componentes: dados, utilitários e multimédia #

• Breadcrumb — o trilho de navegação: onde se está, e regresso a qualquer nível com um clique. Ramos abertos a pedido, introdução direta do caminho, ficheiros largados sobre um segmento.
• Button bar — uma fila de botões de comando — ícone, rótulo ou ambos — num único componente; um clique devolve a chave do botão.
• Crosstab — a tabela dinâmica de um DataStore: linhas, colunas, valores agregados, filtros, subtotais, campos e medidas calculados, exportação para CSV e Excel.
• Crypto — resumos, HMAC, cifragem por palavra-passe ou por chave, assinaturas RSA, ECDSA e Ed25519, JWT, palavras-passe com sal, TOTP de dois fatores e DPAPI — sem instalar nada.
• JSON — construir um documento JSON tipo a tipo, lê-lo ao longo de um caminho e alterá-lo no próprio sítio, em PowerScript puro.
• JSON tree — um documento JSON mostrado como num editor de código: números de linha, coloração por tipo, cada bloco recolhível, pesquisa.
• REST client — um cliente HTTPS nativo e assíncrono: GET, POST, cabeçalhos, JSON, multipart, cookies, novas tentativas, transferência de ficheiros — sem o muro CORS de um navegador.
• Speech out — a leitura em voz alta com as vozes instaladas no posto: frase e palavra em curso, fila de espera, dicionário de pronúncia, leitura síncrona.
• Video player — um leitor de vídeo com a sua própria barra conforme o tema: legendas, ecrã inteiro, capítulos, marcadores, lista de reprodução, captura de imagem.
• XML — construir um documento XML elemento a elemento e lê-lo com um verdadeiro XPath: espaços de nomes, alteração, transformação XSLT.
• XML tree — um documento XML mostrado como num editor de código: etiquetas, atributos e texto coloridos, cada elemento recolhível, pesquisa.

O que muda #

• Toda a posição passada a um método conta a partir de 1, como as que os eventos de reordenação já devolvem; uma entrada em cascata devolve o seu endereço completo. Os detalhes, e o que alterar: Migrar da 2.0 para a 3.0.
• Button continua a ser fornecido e suportado, mas fica obsoleto em favor de Button bar: uma fila de botões cabe num único componente.

No resto da biblioteca #

• of_set_property, of_get_property e of_component_name: controlar uma propriedade pelo seu nome, para um ecrã de definições ou uma configuração guardada.
• A caixa de mensagem propõe uma lista de escolhas (of_add_choice, of_choose) além dos seus botões.

Corrigido #

• Uma cor relida (il_text_color, il_accent…) devolvia 0, preto, estivesse definida ou não: devolve a cor definida, e -1 quando é a do tema.
• ue_error de Picture e Shell explorer nunca era levantado.
• Texto rico: uma [palavra] desconhecida fazia desaparecer o resto do texto; agora é mostrada tal como está.
• Barra de estado: ue_panel_rclicked dá coordenadas de ecrã, a passar tal como estão a um menu de contexto.

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 2.0 para a 3.0 · Índice