O objeto hpAccordion é um menu no estilo sanfona que exibe um único item de cada vez, enquanto oculta os demais itens. Este objeto é útil para menus com muito conteúdo e que necessitem de economia de espaço em tela.

Este objeto funciona como uma calculadora de coordenadas entre objetos do tipo Button, um botão, e do tipo Content, o conteúdo. Cada objeto Button tem um objeto Content equivalente, e o objeto Button recebe o clique do mouse para exibir todo o conteúdo disposto no respectivo objeto Content.

Os objetos Button e Content podem ser qualquer primitiva, grupo de primitivas ou XControl personalizado. Os nomes devem ser declarados nas propriedades ButtonList e ContentList, respectivamente uma lista com os nomes de objetos do tipo Button e uma lista com os nomes de objetos do tipo Content, separados por ponto e vírgula.

Para selecionar um conteúdo específico para ser exibido ao iniciar este objeto, adicione o marcador asterisco (*) na frente do nome do objeto Button correspondente na propriedade ButtonList.

Todos os objetos do tipo Button e Content devem ter a mesma largura, ou seja, a mesma propriedade Width, mas podem ter alturas diferentes, ou seja, diferentes propriedades Height.

Os objetos do tipo Button, Content e hpAccordion devem estar dispostos no mesmo nível hierárquico na Tela, ou seja, todos devem estar instanciados diretamente na Tela ou dentro de um mesmo grupo, desde que estejam no mesmo nível.

Sempre que um usuário alterar qualquer um dos parâmetros deste objeto no Studio, deve executar novamente o evento CustomConfig para que o posicionamento dos objetos seja recalculado com os novos valores.

Funcionalidade de Objetos do Tipo Button

Sempre que um usuário clicar em um objeto do tipo Button, deve informar ao objeto hpAccordion a mudança de seleção. Isto é realizado usando a propriedade ClickedButton. A recomendação é que cada objeto do tipo Button execute um script ao receber o clique do mouse, escrevendo o nome do objeto na propriedade ClickedButton, conforme o script a seguir.

Parent.Item("hpAccordion1").ClickedButton = Name

Visualização de Objetos do Tipo Content

Recomenda-se que os objetos do tipo Content tenham fundo transparente e que a altura seja a altura exata do conteúdo. Desta forma, pode-se configurar um único fundo no objeto hpAccordion, comum a todos os conteúdos, usando as propriedades BackgroundVisible, BackgroundColorStyle e BackgroundColor.