dockcontainer — u_pbt_dockcontainer #

← Referência dos componentes · Índice do guia

Painéis acopláveis ao estilo do Visual Studio: acoplagem por arrastar e largar, empilhamento em separadores, divisores redimensionáveis, janelas flutuantes, ocultação automática — e gravação/reposição da disposição.

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

Em resumo #

Tal como em tab, cada painel aloja um controlo PowerBuilder verdadeiro (dragobject): userobject, DataWindow ou outro componente PBToolboxAI. Ver Alojar controlos reais do PowerBuilder.

Início rápido #

// event open da window : os controlos de painel ja estao colocados sobre ela
uo_dock.of_add_panel(/*chave*/ "document", /*posicao*/ "", /*relativo_a*/ "", &
                     /*tamanho*/ 0, /*titulo*/ "Document", /*conteudo*/ uo_editeur)

uo_dock.of_add_panel(/*chave*/ "explorateur", /*posicao*/ uo_dock.POSITION_START, &
                     /*relativo_a*/ "document", /*tamanho*/ 260, &
                     /*titulo*/ "Explorador", /*conteudo*/ uo_arbre)

uo_dock.of_add_panel(/*chave*/ "proprietes", /*posicao*/ uo_dock.POSITION_END, &
                     /*relativo_a*/ "document", /*tamanho*/ 300, &
                     /*titulo*/ "Propriedades", /*conteudo*/ uo_props)

// A zona central : nao pode ser fechada pela acoplagem, nem flutuar, nem ser ocultada
uo_dock.is_main = "document"

Propriedades #

Posições de acoplagem #

As constantes do componente alimentam as_position em of_add_panel e of_move_panel:

Propriedades de um painel — n_pbt_dock_panel #

Obtidas através de of_item(chave).

Métodos #

Eventos #

Com o teclado #

O conteúdo de um painel é um verdadeiro controlo PowerBuilder: aí o teclado pertence ao seu código, como em qualquer janela. Aquilo de que o componente trata é o seu próprio invólucro — cabeçalhos, separadores, divisores:

Um divisor é um separator focável que anuncia a sua posição; os botões do cabeçalho (destacar, ocultar, fechar) têm um nome, e o painel ativo de um grupo está marcado com aria-selected. Uma deslocação com o teclado é comunicada em ue_layout_changed exatamente como um arrastamento com o rato.

Exemplos #

Uma window ao estilo de um IDE #

// event open : cada conteudo e um controlo PB verdadeiro colocado sobre a window
uo_dock.of_add_panel("document", "", "", 0, "Document", uo_editeur)
uo_dock.of_add_panel("explorateur", uo_dock.POSITION_START,   "document", 260, "Explorador", uo_arbre)
uo_dock.of_add_panel("proprietes",  uo_dock.POSITION_END,  "document", 300, "Propriedades",  uo_props)
uo_dock.of_add_panel("sortie",      uo_dock.POSITION_BOTTOM, "document", 200, "Saida",      uo_console)

// Um segundo painel empilhado em separador sobre "proprietes"
uo_dock.of_add_panel("aide", uo_dock.POSITION_STACK, "proprietes", 0, "Ajuda", uo_aide)

uo_dock.is_main = "document"

Memorizar e repor a disposição do utilizador #

// event close da window : gravar aquilo que o utilizador organizou
string ls_disposition
ls_disposition = uo_dock.of_get_layout()
of_enregistrer_preference("dock_principal", ls_disposition)

// event open : RECRIAR primeiro os paineis, repor a disposicao depois
string ls_disposition

of_creer_les_panneaux()          // os of_add_panel acima

ls_disposition = of_lire_preference("dock_principal")
if ls_disposition <> "" then uo_dock.of_set_layout(ls_disposition)

A ordem é imperativa: of_set_layout não cria nenhum painel, limita-se a recolocar os que já existem.

Acompanhar as alterações continuamente #

// event ue_layout_changed de uo_dock : (string as_json)
// Gravacao imediata, sem esperar pelo fecho da window.
of_enregistrer_preference("dock_principal", as_json)

Comandar um painel através do respetivo handle #

n_pbt_dock_panel lnv_panneau

lnv_panneau = uo_dock.of_item("proprietes")
lnv_panneau.is_title  = "Propriedades (3 modificadas)"
lnv_panneau.ib_pinned = false        // recolhe-se numa patilha junto ao bordo

// Ocultar um painel reservado aos administradores
uo_dock.of_item("audit").ib_visible = gb_administrateur

Chamar a atenção para um painel em segundo plano #

// Um processamento em segundo plano escreveu na consola : assinalar sem roubar o foco
uo_dock.of_notify_panel("sortie")

Reorganizar a partir do código #

// Deslocar um painel como se o utilizador tivesse arrastado o seu separador
uo_dock.of_move_panel(/*chave*/ "sortie", /*destino*/ "document", /*posicao*/ "bottom")

// Empilha-lo em separador sobre outro painel
uo_dock.of_move_panel(/*chave*/ "aide", /*destino*/ "proprietes", /*posicao*/ "stack")

Destacar um painel para um segundo ecrã #

// Janela flutuante nativa : o utilizador pode coloca-la noutro ecra
uo_dock.of_float_panel("proprietes")

// event ue_panel_docked de uo_dock : (string as_key)
// O utilizador voltou a fechar a janela flutuante : o painel regressou.
of_journaliser("Painel novamente acoplado: " + as_key)

Fechar corretamente um painel #

// event ue_panel_closed de uo_dock : (string as_key)
// Retirar tambem o painel do contentor para libertar o controlo alojado.
uo_dock.of_remove_panel(as_key)

Boas práticas #

• Designar sempre um painel principal com is_main: sem zona central, o utilizador pode ocultar tudo e ficar perante uma window vazia.
• Gravar a disposição em ue_layout_changed em vez de o fazer apenas no fecho: assim, um encerramento anormal não perde nada.
• of_set_layout vem depois dos of_add_panel, nunca antes.
• Utilizar of_notify_panel para os processamentos em segundo plano: é menos intrusivo do que uma caixa de diálogo e a informação permanece visível.
• Um controlo alojado é uma janela nativa: desenha-se por cima da camada web, e nenhum efeito visual do componente passa por cima dele.
• of_reset() antes de qualquer reconstrução: sem ele, os controlos anteriormente alojados permanecem reparentados no contentor esvaziado e a reutilização de uma chave falha.
• Para simples páginas exclusivas, sem acoplagem nem flutuação, tab é mais leve.

← Referência dos componentes · Índice do guia