Páginas filhas
  • Obtendo a referência de componentes do programa metadado ou freeform em execução

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Em determinados eventos será necessário obter a referência de componentes do programa metadado ou freeform em execução para que, com esta informação, seja possível recuperar ou alterar valores em tempo de execução.

Guia passo-a-passo


Em qualquer evento do formulário:

  1. Recuperar a referência do janela em execução através da função getFormReference() passando por parâmetro o nome do formulário metadado/freeform.
  2. Com a referência do formulário será possível obter a referência de qualquer campo da tela atual utilizando a propriedade COMPONENT_REFERENCE.

...

Informações
titleDICAS


  • Uma boa prática é recuperar a referência do formulário no evento de After Load do formulário e armazená-lo em uma variável modular, pois desta forma será preciso recuperar a referência do formulário apenas uma vez, já que a esta referência não muda de valor durante a execução do programa.
  • Se uma coluna é definida num formulário contendo um alias, deve-se repassar o alias como parâmetro nas funções _ ADVPL_get_property() e _ADVPL_set_property() para o evento "VALUE". Acesse a documentação do componente LFormMetaData ou LParMetadata para informações detalhadas sobre os parâmetros disponíveis para o evento "GET_VALUE" e "SET_VALUE".

Artigos relacionados

...