statictext — u_pbt_statictext #

← Referência dos componentes · Índice do guia

Bloco de texto formatado: etiquetas, alinhamentos, hiperligações e ações clicáveis, aspeto de cabeçalho, modo deslizante (marquee) e zona para largar ficheiros.

▶ Ver ao vivo — Aplicação de demonstração, mosaico Statictext: a pré-visualização, o código que o produz e esta página, lado a lado.

Em resumo #

Início rápido #

// event open da window
uo_text.is_text = "Bem-vindo ao [b][accent]PBToolboxAI[/accent][/b][br]" &
                   + "Consulte a [hyperlink=https://pbtoolboxai.net]documentação[/hyperlink]."
uo_text.is_align = uo_text.ALIGN_CENTER
uo_text.is_valign = uo_text.VALIGN_CENTER

O texto aceita o texto formatado com etiquetas: é este componente que dele tira o melhor partido, pois é o único que torna clicáveis as zonas [action=…] (um [hyperlink=…] abre-se em qualquer lado).

Constantes #

start e end são lógicos: seguem o sentido de escrita (Idioma e RTL). Os valores físicos left e right continuam a ser aceites como alias.

Propriedades #

Texto e formatação #

Aspeto de bloco (aspeto «cabeçalho») #

Modo deslizante (marquee) #

Interações opcionais #

Métodos #

Eventos #

Exemplos #

Um cabeçalho de secção #

Fundo preenchido, texto branco centrado e altura ajustada ao conteúdo: o bloco lê-se como uma verdadeira barra de título.

// Congelar a apresentacao enquanto tudo e definido
uo_header.of_set_redraw(/*on*/ false)

// O titulo, centrado
uo_header.is_text  = "[b]Painel de vendas"
uo_header.is_align = uo_header.ALIGN_CENTER

// Fundo preenchido e texto branco legivel
uo_header.il_back_color = RGB(/*red*/ 60, /*green*/ 110, /*blue*/ 190)
uo_header.il_text_color = RGB(/*red*/ 255, /*green*/ 255, /*blue*/ 255)
uo_header.ii_padding = 14

// O bloco cola-se ao seu conteudo : le-se como uma barra de titulo
uo_header.ib_auto_height = true

// Tudo e desenhado de uma so vez
uo_header.of_set_redraw(/*on*/ true)

// event ue_auto_height de uo_header
of_reposition_below_header(al_height)   // desloca o conteudo para baixo do cabecalho

Texto formatado com hiperligação e ação #

// Uma ligacao para uma pagina web e uma acao tratada pela sua aplicacao (ue_action)
uo_text.is_text = "A sua licença expira a [b]31/12[/b]. " &
                   + "[hyperlink=https://pbtoolboxai.net]Saber mais[/hyperlink] " &
                   + "ou [action=renew]renová-la agora[/action]."

// event ue_action de uo_text : (string as_key)
choose case as_key
    case "renew" ; of_open_renewal()
end choose

ue_hyperlink está reservado aos URL (o navegador abre-se sozinho); [action=id] é a escolha certa quando o clique deve permanecer dentro da aplicação. A variante [invisibleaction=id] aciona o mesmo ue_action sem o aspeto de uma hiperligação.

Um bloco recolhível #

// Duas seccoes recolhiveis : a segunda comeca recolhida
uo_recap.is_text = "[b]Encomenda 2026-0148[/b][br]" &
                   + "[foldarea:[b]Entrega[/b]]Enviado a 12/07, em 48 horas.[/foldarea]" &
                   + "[foldarea-closed:[i]Aviso legal[/i]]Devolucao aceite em 14 dias.[/foldarea]"

// O bloco encolhe quando uma seccao e recolhida
uo_recap.ib_auto_height = true

Um [foldarea:Título] acrescenta um cabeçalho clicável por cima do seu conteúdo: o leitor recolhe a secção com um clique e o marcador passa de − para +. [foldarea-closed:Título] produz o mesmo bloco, recolhido logo à partida. Os blocos aninham-se e o recolhimento não emite qualquer evento: é uma questão de leitura, não de código. Se ib_auto_height estiver ativo, a altura é notificada de novo a cada recolha. O título é texto com etiquetas: [foldarea:[b][accent]Encomenda 2026-0148[/accent][/b]] coloca o seu a negrito e com a cor de destaque.

Uma faixa deslizante #

// A mensagem da faixa
uo_banner.is_text = "[b]Informação[/b] -- encerramento excecional do serviço na sexta-feira, dia 12."

// Modo deslizante, a maneira de um fio de noticias
uo_banner.ib_marquee = true
uo_banner.ii_marquee_speed = 90        // pixels por segundo
uo_banner.is_marquee_direction = uo_banner.MARQUEE_START

O deslocamento repete-se sem tempos mortos. Para o parar, basta repor ib_marquee a false: o texto retoma a sua disposição normal.

Uma vez definido ib_track_cycle = true, a cada passagem completa do texto o evento ue_cycle é acionado — prático para fazer rodar várias mensagens:

// Em ue_cycle da faixa : passar a mensagem seguinte
ii_message = Mod(ii_message, UpperBound(is_messages)) + 1
uo_banner.is_text = is_messages[ii_message]

Uma zona para largar ficheiros #

// Aceitar os ficheiros arrastados a partir do Explorador do Windows
uo_zone.ib_allow_drop = true

// O que a zona mostra, centrado
uo_zone.is_text = "[size=32][accent][b]Largue aqui os seus ficheiros[/b][/accent][/size][br][br]" &
                  + "Arraste um ou vários ficheiros a partir do Explorador do Windows."
uo_zone.is_align  = uo_zone.ALIGN_CENTER
uo_zone.is_valign = uo_zone.VALIGN_CENTER

// event ue_drop_files de uo_zone : (string as_files[])
integer li

// Cada ficheiro largado, um apos o outro
for li = 1 to UpperBound(as_files)
    of_import(as_files[li])       // as_files[li] = caminho COMPLETO do ficheiro
next

// event ue_drag_enter de uo_zone : assinalar o destino durante o sobrevoo
uo_zone.il_border_color = RGB(/*red*/ 21, /*green*/ 101, /*blue*/ 192)
uo_zone.ii_border_width = 2

Os caminhos recebidos são completos: podem ser passados diretamente a FileOpen ou à rotina de importação.

Uma etiqueta que se comporta como um botão #

// Um texto que se comporta como um botao-ligacao
uo_link.is_text = "Selecionar tudo"
uo_link.il_text_color = RGB(/*red*/ 21, /*green*/ 101, /*blue*/ 192)
uo_link.ii_padding = 8
uo_link.ii_corner_radius = 6
uo_link.ib_hover_effect = true       // reage ao sobrevoo como um botao

// event ue_clicked de uo_link
of_select_all()

Um registo escrito linha a linha #

Cada chamada envia só a linha acrescentada; ib_follow_end mantém a última à vista enquanto o leitor não subir.

// Once, when the window opens
uo_log.ib_follow_end = true
uo_log.is_text = "[b]Import[/b]"

// For every row imported : one line, sent alone
uo_log.of_append_text(/*markup*/ "Row " + String(ll_row) + " [color=#2e7d32]imported[/color]")

Uma etiqueta da largura do seu texto #

// A status chip : background, rounded corners, and the width of its text
uo_status.is_text = "[b]Status :[/b] connected"
uo_status.il_back_color = RGB(/*red*/ 232, /*green*/ 245, /*blue*/ 233)
uo_status.ii_corner_radius = 12
uo_status.ib_auto_width = true

Boas práticas #

• Um texto sem etiquetas não tem qualquer custo adicional: pode substituir-se sistematicamente os statictext do PowerBuilder, mesmo para texto simples.
• É preferível is_align = uo.ALIGN_START a "left": o ecrã continuará correto se a aplicação passar a escrita da direita para a esquerda.
• ib_selectable permanece desativado por predefinição, como uma etiqueta. Deve ativar-se apenas onde a cópia faça sentido (número de processo, mensagem de erro técnica).
• Para um cabeçalho, deve combinar-se il_back_color + ii_padding + ib_auto_height: o bloco dimensiona-se sozinho quando o texto muda de comprimento.
• Só se deve ativar ib_track_mouse se ue_mouse_enter / ue_mouse_leave forem realmente programados.
• Convém chamar of_reset() antes de reutilizar um bloco para outro conteúdo: sem isso, um fundo, um contorno ou o modo deslizante anteriores permanecem em vigor.

Herdado da base comum #

Estes membros existem em todos os componentes visuais — não são próprios deste. São detalhados uma só vez, nos capítulos transversais; esta tabela apenas diz onde os ler.

Duas ajudas não são herdadas: of_icon e of_escape_markup vivem em n_pbt_utils. Declare um — n_pbt_utils lnv_utils, nada a criar — e chame-as nele.

← Referência dos componentes · Índice do guia