Linha Logix

Páginas filhas
  • _ADVPL_create_component
Tempo aproximado para leitura: 2 minutos


Cria um componente gráfico ADVPL, respeitando os componentes de classes especializadas desenvolvidas para o produto Logix.

Sintaxe

_ADVPL_create_component( [ <component_reference> ], <componet_type> , [ <parameter1> ]  , [ <parameter2> ]  , [ <parameter3> ]  , [ <parameter4> ]  , [ <parameter5> ] ) ==> CHAR

Parâmetros

Nome

Tipo

Descrição

Obrigatório
component_reference

CHAR

Nome de referência do componente a ser criado/instanciado.
(aviso) Preferencialmente enviar neste parâmetro o valor NULL para que a própria instância da classe gere um código de referência dinâmico, que visa evitar conflitos de referência de componentes duplicados durante a execução de um mesmo programa.

Não

component_type

CHAR

Nome da propriedade do componente.

(aviso) Acesse a lista de propriedades válidas para cada componente.

Sim

parameter1..5

CHAR

De acordo com a propriedade informada, podem existir 1 até o limite de 5 parâmetros que podem ser obrigatórios ou opcionais. 

(informação) Esta informação na maioria da criação dos componentes não é obrigatória. Para mais informações dos parâmetros disponíveis para o método construtor de cada componente acesse a documentação do componente desejado. 

Não

Retorno

Tipo

Descrição

CHAR

Quando o parâmetro component_reference for enviado como NULL, será retornado o código de referência dinâmico gerado para o novo componente criado, caso contrário, retornará o mesmo valor do nome de referência enviado como parâmetro.

Exemplo

#---------------------------------#
 FUNCTION create_component_test()
#---------------------------------#
  DEFINE l_form_reference VARCHAR(10)

  #cria componente da classe LDIALOG e recupera a referência do componente que é utilizada nas funções _ADVPL_set_property() e _ADVPL_get_property()
  LET l_form_reference = _ADVPL_create_component(NULL,"LDIALOG")

END FUNCTION