CrappUIFrame

O CrappUIFrame serve para exibir páginas html, locais ou remotas.

Características	Valor
Class	crapp.ui.frame.CrappUIFrame
Extends	CrappUIDisplay
Style Tag	Nenhum

Exemplos

<priori>
    <imports>
        <crapp.ui.frame.CrappUIFrame />
    </imports>
    <view>
        <CrappUIFrame src="some/page.html"/>
    </view>
</priori>

Propriedades do Componente

• src:String: Endereço da página a ser exibida.

• window:Window: Retorna o objeto Window da página html.

Eventos Especiais

• PriEvent.COMPLETE: Disparado quando a página é carregada com sucesso.

• PriEvent.ERROR: Disparado quando houve algum erro para carregar a página.

Métodos do Componente

• addChild(child:PriDisplay): Adiciona um objeto dentro do outro. O objeto que está contido é chamado de child. O objeto que contém o child é chamado de parent. Caso você tente adicionar um child que já possui um parent, ele será removido primeiro do parent atual.

• addChildList(childList:Array<PriDisplay>): O mesmo que o método addChild, porém com a conveniência de adicionar diversos objetos simultaneamente.

• removeChild(child:PriDisplay): Remove o elemento visual de dentro do objeto parent. Caso o child não exista dentro deste parent, o método não terá efeito.

• removeChildList(childList:Array<PriDisplay>): O mesmo que o método removeChild, porém com a conveniência de remover diversos objetos simultaneamente.

• removeFromParent(): Remove o objeto do seu parent, caso ele possua algum.

• removeAllChildren(): Remove todos os elementos child do objeto.

Métodos usados para inicialização e atualização

Os métodos abaixos fazem parte do ciclo de vida do componente Crapp UI e podem ser sobrescritos para obter controle sobre a inicialização e renderização do componente:

• setup(): O método setup é executado sempre durante o processo de construção da instância, ou seja, é garantido que ele será executado apenas uma vez de forma automática. Este método normalmente é utilizado para instanciar novos elementos, objetos, definir algumas configurações iniciais e qualquer outro procedimento que precise ser tratado durante o processo da instância.

• paint(): O método paint será executado pelo menos uma vez, slogo após o método setup ser executado. Posteriormente, este método será executado repetidas vezes, sempre que o componente identificar que existe uma boa razão para atualizar a renderização de um objeto. Ao sobrescrever este método, é comum adicionar instruções relacionadas a posicionamento de objetos, ajustes de tamanho e outras propriedades visuais. Caso exista mudanças intensas e recorrentes, encontre formas otimizadas de decidir se todas as mudanças são realmente necessárias todas as vezes para garantir boa performance da aplicação. Não execute chamadas diretas ao método paint. Caso deseje executar as operações do paint, você deve executar o método updatedisplay. O método paint normalmente será executado nas seguintes situações:

  • O elemento sofreu uma mudança de altura ou largura;

  • Algum filho foi adicionado ou removido;

  • O próprio objeto foi adicionado ou removido;

  • Alguma instrução executou o método updateDisplay;

• updateDisplay(): Este método não deve ser chamado em situações que você deseja efetuar um re-paint, ou seja, é uma forma indireta de executar o método paint. Esta é a forma adequada pois o método updateDisplay poderá decidir se efetuará a chamada ao paint de forma otimizada e essa chamada será trasmitida a todos os seus filhos descendentes.

Nunca execute diretamente o método paint(). Ao invés disso, execute chamadas ao updateDisplay() sempre que desejar efetuar um re-paint do objeto.

O ciclo de vida de um objeto pode ser entendido da seguinte maneira: