Referência dos componentes #
Uma página por componente da biblioteca. Cada página segue o mesmo plano: Em resumo → Início rápido → Propriedades → Métodos → Eventos → Exemplos → Boas práticas.
Os mecanismos comuns a todos os componentes (motor de propriedades, items, temas, tooltips, of_reset) não são repetidos aqui: encontram-se descritos uma única vez no guia do programador.
Vitrina #
| Componente | Userobject | Função |
|---|---|---|
| angulargauge | u_pbt_angulargauge | Mostrador: um valor numa escala circular — ponteiro, arco cheio ou marca, intervalos coloridos e os seus tons, objetivo, meio mostrador, valor ajustável à mão |
| chartcartesian | u_pbt_chartcartesian | Gráfico cartesiano: colunas, barras, linhas, áreas, nuvens, mapas de calor e cotações — o tipo define-se por série, logo os combinados existem |
| chartpie | u_pbt_chartpie | Gráfico circular: tarte, anel ou meia roda — etiquetas dentro ou fora, total no buraco, a legenda esconde uma fatia |
| commandpalette | n_pbt_commandpalette | Paleta de comandos: um atalho, três letras, qualquer ação |
| gauge | u_pbt_gauge | Indicador linear: um valor ao longo de uma escala reta, horizontal ou vertical — barra ou marca, intervalos coloridos e os seus tons, objetivo, valor ajustável à mão |
| ribbon | u_pbt_ribbon | Faixa de opções ao estilo Office: separadores, grupos, controlos ricos, menu da aplicação, barra de acesso rápido |
Contentores e navegação #
| Componente | Userobject | Função |
|---|---|---|
| breadcrumb | u_pbt_breadcrumb | Trilho de navegação: o caminho clicável que diz onde se está, e que dobra o meio quando já não cabe |
| dockcontainer | u_pbt_dockcontainer | Painéis acopláveis ao estilo Visual Studio, que alojam controlos reais do PowerBuilder |
| listbar | u_pbt_listbar | Barra de navegação lateral com secções recolhíveis |
| menubar | u_pbt_menubar | Barra de menus da aplicação: menus, submenus, entradas marcáveis, atalhos |
| shellexplorer | u_pbt_shellexplorer | A árvore da shell do Windows: Ambiente de trabalho, Este PC, unidades, Rede — com os ícones reais do posto |
| contextmenu | u_pbt_contextmenu | Menu de contexto em cascata, no cursor ou sob um controlo: ícones, atalhos mostrados, marcas de verificação, entradas de opção, cabeçalhos de secção, listas longas que deslizam e respondem à escrita |
| radialmenu | u_pbt_radialmenu | Menu de contexto radial: os comandos em coroa à volta do cursor, escolhidos pela direção |
| tab | u_pbt_tab | Separadores modernos que alojam controlos reais do PowerBuilder |
| tilesbox | u_pbt_tilesbox | Mosaicos agrupados ao estilo ecrã inicial, com tamanhos variáveis e mosaicos animados |
| toolbar | u_pbt_toolbar | Barra de ferramentas multibanda: botões, alternadores, menus, excedente |
Barras e progresso #
| Componente | Userobject | Função |
|---|---|---|
| buttonbar | u_pbt_buttonbar | Uma fila de botões de comando num só componente: ícone, rótulo, cada botão desativado, colorido ou ocultado pelo seu handle |
| progressbar | u_pbt_progressbar | Barra de progresso determinada ou indeterminada |
| statusbar | u_pbt_statusbar | Barra de estado com painéis |
| stepbar | u_pbt_stepbar | Sequência de etapas de um assistente |
Texto e introdução de dados #
| Componente | Userobject | Função |
|---|---|---|
| button | u_pbt_button | Botão com tema: ícone, estilos, emblema, atalho |
| codeeditor | u_pbt_codeeditor | Editor de código com coloração sintática |
| form | u_pbt_form | Um formulário de introdução inteiro num só controlo: campos tipados (texto, número, lista, botões de opção, data, hora, cor, caixa de verificação, palavra-passe, e-mail, texto longo, imagem) em colunas e secções recolhíveis, validação com erros de negócio, alterações desde o carregamento, uma linha de DataWindow lida e escrita |
| markdownview | u_pbt_markdownview | Visualizador de Markdown só de leitura com as cores do tema: títulos, listas, tabelas, listas de tarefas, código colorido, imagens; as ligações vão para a aplicação, o HTML em bruto nunca é executado |
| propertygrid | u_pbt_propertygrid | Inspetor de valores com nome, como a janela de propriedades de um IDE: categorias recolhíveis, editores tipados (texto, número, caixa de verificação, lista, cor, data, palavra-passe), vista alfabética, pesquisa, painel de ajuda, botão … para uma caixa de diálogo sua |
| statictext | u_pbt_statictext | Texto rico, clicável, com modo deslizante (marquee) |
Dados #
| Componente | Userobject | Função |
|---|---|---|
| crosstab | u_pbt_crosstab | Tabela dinâmica alimentada por um DataStore: zonas de linhas, colunas e valores, agregados, filtros, agrupamento de datas, exportações CSV e Excel |
| datagrid | u_pbt_datagrid | Grelha de dados alimentada por um DataStore: colunas tipadas e ricas, ordenação, filtros, agrupamento, totais, edição, paginação, exportação CSV |
| gantt | u_pbt_gantt | Diagrama de Gantt: grelha de tarefas e barras numa escala de tempo, resumos calculados, marcos, ligações e caminho crítico, arrastar para deslocar, redimensionar ou avançar, pergunta antes de uma alteração, alimentado por um DataStore que recebe as alterações |
| jsontree | u_pbt_jsontree | Um visualizador de árvore JSON recolhível, colorido por tipo — ecrãs de configuração, respostas de API, depuração de integração |
| kanban | u_pbt_kanban | Quadro de cartões em colunas, arrastados de uma coluna para outra: limites de trabalho em curso, etiquetas, responsável, prazos em atraso, corpo dos cartões por modelo, teclado, pergunta antes de uma deslocação, alimentado por um DataStore que recebe as deslocações |
| scheduler | u_pbt_scheduler | Calendário à maneira do Outlook: vistas dia, semana, mês e agenda, arrastar e largar, recursos, categorias, cartões e tooltips por modelos, alimentado por um DataStore |
| treeview | u_pbt_treeview | Árvore de dados e lista em árvore com colunas: nós endereçados por caminho, caixas de três estados, ramos carregados a pedido, edição do rótulo, arrastar e largar com pergunta prévia, pesquisa, ordenação, alimentada por um DataStore hierárquico |
| xmltree | u_pbt_xmltree | Um visualizador de árvore XML recolhível e colorido — o gémeo do jsontree para XML |
Retorno ao utilizador #
| Componente | Objeto | Função |
|---|---|---|
| messagebox | n_pbt_messagebox | Caixa de diálogo modal com tema, retorno síncrono |
| toaster | n_pbt_toaster | Notificações «toast» ao canto do ecrã |
Utilitários não visuais #
| Componente | Objet | Função |
|---|---|---|
| crypto | n_pbt_crypto | Hashes, HMAC, cifra por palavra-passe, valores aleatórios, assinaturas RSA — a Web Crypto do posto, nada a instalar |
| json | n_pbt_json | Construir um JSON tipo a tipo e reler um ao longo de um caminho — em PowerScript puro, gratuito |
| restclient | n_pbt_restclient | Cliente HTTPS: GET, POST, cabeçalhos, JSON, transferência — nativo, sem CORS, também para PowerBuilder 10 |
| xml | n_pbt_xml | Escrever um XML elemento a elemento e reler um com XPath verdadeiro |
Multimédia e visualizadores #
| Componente | Userobject | Função |
|---|---|---|
| carousel | u_pbt_carousel | Carrossel como o Cover Flow do iTunes, faixa plana ou pilha de cartões: imagens, texto formatado ou cartões escritos por modelo, deslizar com inércia, roda e teclado, reprodução automática, pergunta antes de uma mudança, alimentado por um DataStore |
| pdfviewer | u_pbt_pdfviewer | Visualizador de PDF integrado |
| picture | u_pbt_picture | Apresentação de imagem: modo de enquadramento, alinhamento, emblema, imagem clicável |
| soundplayer | n_pbt_soundplayer | Toca um som ou uma música — ficheiro do posto ou URL — de forma síncrona ou não, e um bip sem ficheiro |
| speechout | n_pbt_speechout | Leitura em voz alta: a aplicação lê um texto frase a frase e diz qual, para que a realce |
| video | u_pbt_video | Leitor de vídeo: ficheiro do posto (em fluxo) ou URL, barra de transporte com o tema, legendas, cartaz, captura de imagem |
| webbrowser | u_pbt_webbrowser | Navegador web integrado: navegação, histórico, menu de contexto |