O objeto hpTabsBar é um item de menu organizado em forma de abas dispostas horizontalmente ou verticalmente, que oferece uma forma visualmente limpa e organizada de navegação entre itens de uma mesma página ou até mesmo entre páginas distintas.

Aba disposta horizontalmente

Aba disposta verticalmente

Com este objeto pode-se:

•Criar inúmeras abas configurando uma única propriedade

•Controlar a largura das abas por associação

•Controlar o status de disponibilidade das abas por associação

•Calcular automaticamente a largura das abas, inclusive na troca de idioma

•Configurar a orientação horizontal ou vertical

•Aparar automaticamente espaços excedentes nos rótulos das abas

Este objeto pode ser rapidamente configurado, conforme os procedimentos a seguir.

1.Instancie este objeto em Tela.

2.Defina a orientação do objeto configurando a propriedade Orientation com o valor 0 (zero) para Horizontal ou 1 (um) para Vertical.

3.Configure a propriedade LabelList com os textos descritivos das abas, separados por ponto e vírgula.

4.Em seguida, configure a propriedade WidthList com os valores em Himetric da largura das abas, separados por ponto e vírgula, ou deixe esta propriedade vazia para que os valores sejam calculados automaticamente.

5.Execute a aplicação.

Opcionalmente no Studio, clique com o botão direito do mouse no objeto e selecione a opção Configurar para visualizar previamente a aparência deste objeto em tempo de execução.

Exemplo de configuração para 3 (três) abas com orientação horizontal, largura definida pelo usuário e iniciando com a aba 2 (dois) selecionada:

•LabelList: Aba1;Aba2;Aba3

•WidthList: 2000;3000;2500 (larguras das abas um, dois e três respectivamente)

•EnabledList: 1;1;0 (abas um e dois habilitadas e aba três desabilitada)

•Orientation: 0 (zero)

•Index: 2 (dois, aba dois inicia selecionada)

A mesma configuração, porém com larguras calculadas automaticamente e todas as abas habilitadas:

•LabelList: Aba1;Aba2;Aba3

•WidthList: "" (larguras calculadas automaticamente)

•EnabledList: 1 (um, todas as abas habilitadas)

•Orientation: 0 (zero)

•Index: 2 (dois, aba dois inicia selecionada)

Funcionalidade de Objetos Personalizados

Ao informar uma classe personalizada nas propriedades HorizontalClassName ou VerticalClassName, o objeto pertencente a esta classe deve cumprir com os seguintes critérios:

•Ter na lista de propriedades as mesmas propriedades existentes nos objetos nativos da Biblioteca HighPerformance Template, ~hpTabH ou ~hpTabV.

•Ao receber um clique de mouse, deve escrever o valor da propriedade Id na propriedade Index do objeto hpTabsBar.

Exemplo de script a ser executado no evento de clique do mouse:

Set tab = Parent
Set bar = tab.Parent.Parent
tab.SetFocus()
bar.Index = tab.Id

Em que tab refere-se ao objeto personalizado e bar refere-se ao objeto hpTabsBar.