Recupera a referência de uma janela de diálogo de um programa com interface metadado ou FreeForm que estiver em execução.

Esta função é utilizada nos códigos de scripts de automação como parâmetro para as funções _ADVPL_get_property() e _ADVPL_set_property(), quando a referência de uma janela for o parâmetro necessário.

Sintaxe

_ADVPL_getFormReference( [ < l_formulario > ] ) => VARCHAR

Parâmetros

Nome

Tipo

Obrigatório?

Descrição

l_formulario

CHAR

Sim

Termo pelo qual será feita a pesquisa do formulário desejado, podendo informar qualquer uma das informações a seguir para pesquisa da janela de formulário desejada:

  • Nome do formulário (quando for programa principal pode ser o nome do programa)
  • Título da tela do formulário, considerando palavras acentuadas, símbolos e espaços em branco.

Retorno

Tipo

Descrição

VARCHAR(10)

Código da referência do objeto do tipo janela de diálogo (LDIALOG, LTITTLEDIALOG ou LPOPUPDIALOG) , que pode ser a referência da janela principal de um formulário metadado ou de uma janela de programa desenvolvido no formato FreeForm (uso de componentes do metadado de forma livre).

Observações

Para ficar mais clara a forma de uso desta funç;ão, acesse os exemplos de aplicação desta função nas páginas onde constam alguns modelos de scripts de automação.