tab — u_pbt_tab #

← Referência dos componentes · Índice do guia

Separadores modernos que alojam controlos reais do PowerBuilder: faixa reposicionável, ícones por separador, separadores que se podem fechar, reordenação com o rato.

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

Em resumo #

O argumento decisivo: uma página não é uma maqueta HTML, é um dragobject do PowerBuilder — um userobject, uma DataWindow, um conjunto de controlos ou até outro componente PBToolboxAI. O componente encarrega-se do posicionamento, do redimensionamento e da apresentação/ocultação na mudança de separador. Ver Alojar controlos reais do PowerBuilder.

Início rápido #

// event open da janela : cada pagina e um controlo PB ja colocado na janela
uo_onglets.of_add_page("clients",  "Clientes",  uo_page_clients)
uo_onglets.of_add_page("factures", "Faturas", uo_page_factures, /*fechavel*/ true)

// Um icone por separador, colocado no handle da pagina
uo_onglets.of_item("clients").is_icon  = "mono:img\clients.svg"
uo_onglets.of_item("factures").is_icon = "mono:img\invoice.svg"

uo_onglets.of_select_page("clients")

// event ue_selection_changed de uo_onglets : (string as_from_id, string as_id)
of_charger_page(as_id)

Propriedades #

Propriedades de uma página — n_pbt_tab_page #

Obtidas através de of_item(id), podem ser alteradas a quente, sem reconstruir a faixa.

Métodos #

of_add_page devolve um código negativo se o identificador estiver vazio, já estiver a ser utilizado ou se o controlo indicado não for válido.

Quando há demasiados separadores — reduzem-se para caber na banda, mas nunca abaixo de uma largura legível: o ícone e a cruz de fecho ocupam o seu espaço para além do título, nunca no lugar dele. Os que já não cabem saem da banda, e na sua extremidade aparece um botão ···: abre a lista de todos os separadores visíveis, com o ativo assinalado, e a escolha passa para ele. O separador ativo permanece sempre visível. A banda não desliza — esse botão é o caminho para os separadores fora do enquadramento. Nada a programar, o comportamento é automático.

Eventos #

Exemplos #

Um dossiê de páginas de negócio #

// event open : os userobjects de pagina ja estao colocados na janela
uo_onglets.of_set_redraw(false)

uo_onglets.of_add_page(/*id*/ "identite", /*titulo*/ "Identidade",  /*pagina*/ uo_identite)
uo_onglets.of_add_page(/*id*/ "adresses", /*titulo*/ "Moradas",  /*pagina*/ uo_adresses)
uo_onglets.of_add_page(/*id*/ "compta",   /*titulo*/ "Contabilidade", /*pagina*/ uo_compta)

uo_onglets.of_item("identite").is_icon = "mono:img\user.svg"
uo_onglets.of_item("adresses").is_icon = "mono:img\map.svg"
uo_onglets.of_item("compta").is_icon   = "mono:img\euro.svg"

uo_onglets.of_set_redraw(true)
uo_onglets.of_select_page("identite")

Documentos que se podem fechar, abertos a pedido #

// Abrir um documento num novo separador que se pode fechar
uo_onglets.of_add_page(/*id*/ ls_cle, /*titulo*/ ls_libelle, /*pagina*/ uo_editeur, &
                       /*fechavel*/ true, /*icone*/ "mono:img\doc.svg")
uo_onglets.of_select_page(ls_cle)

// event ue_tab_closed de uo_onglets : (string as_id)
// O separador ja foi retirado ; falta libertar os dados de negocio.
of_liberer_document(as_id)

Reordenação com o rato #

uo_onglets.ib_reorderable = true

// event ue_tab_reordered de uo_onglets : (string as_id, integer ai_index)
// ai_index = nova posicao, a partir de 1 : memoriza-se a ordem escolhida.
of_enregistrer_ordre(as_id, ai_index)

Faixa vertical #

// Banda de separadores do lado esquerdo, util quando as etiquetas sao longas
uo_onglets.is_position = uo_onglets.POSITION_START

Inativar ou ocultar um separador consoante os direitos #

// O caminho passa sempre pelo handle da pagina
uo_onglets.of_item("compta").ib_enabled = of_a_le_droit("compta")
uo_onglets.of_item("audit").ib_visible  = gb_mode_expert

Reagir à seleção #

// event ue_selection_changed de uo_onglets : (string as_from_id, string as_id)
choose case as_id
    case "identite" ; uo_identite.of_rafraichir()
    case "adresses" ; uo_adresses.of_rafraichir()
    case "compta"   ; uo_compta.of_rafraichir()
end choose

Recusar uma mudança de separador ou um fecho #

// As duas perguntas sao colocadas por PREDEFINICAO: nada a ativar. Estas linhas
// fazem o contrario, eliminam-nas quando arbitrar nao serve.
uo_onglets.ib_veto_selection = false
uo_onglets.ib_veto_close     = false

// event ue_selection_changing de uo_onglets : (string as_from_id, string as_id)
// Devolver FALSE mantem o utilizador na pagina que abandona.
if of_page_modifiee(as_from_id) then
    if MessageBox("Modificações", "Sair sem guardar?", Question!, YesNo!) = 2 then
        return false
    end if
end if
return true

// event ue_tab_closing de uo_onglets : (string as_id)
// Devolver FALSE mantem o separador e a pagina que aloja abertos.
return not of_page_modifiee(as_id)

Recomeçar com uma faixa vazia #

// of_reset devolve CADA pagina alojada a sua janela de origem antes de esvaziar
uo_onglets.of_reset()
uo_onglets.of_add_page("accueil", "Início", uo_accueil)

Boas práticas #

• Os controlos alojados têm de existir antes da chamada: devem ser colocados na janela em tempo de desenho, cabendo ao componente ocultá-los e reposicioná-los.
• Recomenda-se carregar as páginas uma única vez no open e comandar em seguida apenas a seleção: é mais rápido do que acrescentar e retirar páginas continuamente.
• Deve chamar-se of_preload_icons no arranque se os separadores tiverem ícones: sem isso, a primeira abertura de um separador oculto apresenta um breve atraso antes do ícone.
• As duas perguntas são colocadas por predefinição: um evento deixado vazio autoriza sempre a ação, não tem nada a fazer. Desative-as com ib_veto_selection / ib_veto_close a false se arbitrar não lhe serve, porque cada pergunta custa uma ida e volta ao PowerBuilder.
• Um controlo alojado é uma janela nativa: desenha-se por cima da camada web. Nenhum efeito visual do componente pode passar à frente dele.
• Não esquecer of_reset() antes de reconstruir uma faixa: sem essa chamada, a reutilização de um identificador de página falha e os controlos anteriores permanecem visíveis.
• Para zonas redimensionáveis e destacáveis em vez de páginas exclusivas, é preferível utilizar dockcontainer.

← Referência dos componentes · Índice do guia