Linha Logix

Páginas filhas
  • LGX - LCOMPONENT

Versões comparadas

Versão antiga 5

changes.mady.by.user Ieda Ferreira Alves Flock

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Cleane Hermann

Gravado em

Chave

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

Pagetitle
LGX - LCOMPONENT
LGX - LCOMPONENTLFormLForm
Componente abstrato base para outros componentes. Todos os métodos contidos neste componente poderão ser executados pelos componentes que o herdam.


Hierarquia

  • LCOMPONENT


Métodos GET

Métodos acessíveis utilizando a função _ADVPL_get_property, que permite recuperar e manipular os valores do componente: 


Expandir
titleGET ALIGN

Método GET: ALIGN 

Alinhamento do componente em relação ao seu componente pai.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"ALIGN") ==> AlinhamentocALign

Parâmetros


NomeTipoDescriçãoObrigatório?
l_form_reference cComponentReference 
CHAR

Referência do formuláriocomponente.

Sim


Retorno


Tipo

Descrição

CHAR
  • Alinhamento do componente em relação ao componente pai, sendo:
    • NONE: nenhum alinhamento.
    • TOP: alinhamento ao topo.
    • LEFT: alinhamento à esquerda.
    • RIGHT: alinhamento à direita.
    • CENTER: alinhamento central.
    • BOTTOM: alinhamento ao fundo.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_align = _ADVPL_get_property(l_component_referencecComponentReference,"ALIGN")



Expandir
titleGET CAN_GOT_FOCUS

Método GET:

COMPONENT

CAN_GOT_FOCUS

_REFERENCE

Retorna se o componente poderá ganhar

Referência do componente em foco.

Sintaxe


Bloco de código
_ADVPL_get_property(< m_form_referencecComponentReference >,"CAN_GOT_FOCUS ") ==> Permite ganhar foco?lCanGotFocus

Parâmetros


NomeTipoDescriçãoObrigatório?
m_form_referencecComponentReference
CHAR

Referência do formuláriocomponente.

Sim

Retorno


Tipo

Descrição

BOOLEAN

Indicador que define se o componente pode ganhar foco.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_component_referencecComponentReference = _ADVPL_get_property(m_form_reference,"CAN_GOT_FOCUS ")



Expandir
titleGET CHANGE_EVENT

Método GET: CHANGE_EVENT

Evento executado quando o valor do componente for alterado.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"CHANGE_EVENT ") ==> FunçãocFunctionName


Parâmetros


NomeTipoDescriçãoObrigatório?
l_form_referencecComponentReference
CHAR

Referência do formuláriocomponente.

Sim

Retorno


Tipo

Descrição

CHAR

Função que é executada quando o valor do componente for alterado.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_change_event = _ADVPL_get_property(l_component_referencecComponentReference,"CHANGE_EVENT")



Expandir
titleGET CLICK_EVENT

Método GET: CLICK_EVENT 

Evento executado ao clicar no componente.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"CLICK_EVENT") ==> FunçãocFunctionName


Parâmetros


NomeTipoDescriçãoObrigatório?
l_form_referencecComponentReference
CHAR

Referência do formuláriocomponente.

Sim

Retorno


Tipo

Descrição

CHAR

Função que é executada ao clicar no componente.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_click_event = _ADVPL_get_property(l_component_referencecComponentReference,"CLICK_EVENT")



Expandir
titleGET COMPONENT_TYPE

Método GET: COMPONENT_TYPE

Tipo do componente.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"COMPONENT_TYPE") ==> TipocType


Parâmetros


NomeTipoDescriçãoObrigatório?
l_form_referencecComponentReference
CHAR

Referência do formuláriocomponente.

Sim

Retorno


Tipo

Descrição

CHAR

Tipo do componente criado (LDialog, LCheckBox, LTextField, etc).

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_component_type = _ADVPL_get_property(l_component_referencecComponentReference,"COMPONENT_TYPE")



Expandir
titleGET DOUBLE_CLICK_EVENT

Método GET: DOUBLE_CLICK_EVENT 

Evento executado ao efetuar um duplo clique no componente.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"DOUBLE_CLICK_EVENT") ==> FunçãocFunctionName


Parâmetros


NomeTipoDescriçãoObrigatório?
l_form_referencecComponentReference
CHAR

Referência do formuláriocomponente.

Sim

Retorno


Tipo

Descrição

CHAR

Função que é executada ao efetuar um duplo clique no componente.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_double_click_event = _ADVPL_get_property(l_component_referencecomponentReference,"DOUBLE_CLICK_EVENT")



Expandir
titleGET EDITABLE

Método GET: EDITABLE

Retorna se o componente está editável.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"EDITABLE") ==> Editável?lEditable


Parâmetros


NomeTipoDescriçãoObrigatório?
cComponentReferencel_form_reference
CHAR

Referência do formuláriocomponente.

Sim

Retorno


Tipo

Descrição

BOOLEAN

Indicador que define se o componente está editável.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_editable = _ADVPL_get_property(l_component_referencecComponentReference,"EDITABLE")



Altura em pixels do componente
Expandir
titleGET HEIGHTENABLE

Método GET:

HEIGHTAltura do componente em pixels

ENABLE 

Retorna se o componente está habilitado.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"ENABLE") ==> AlturalEnable


Parâmetros


NomeTipoDescriçãoObrigatório?
l_form_referencecComponentReference
CHAR

Referência do formuláriocomponente.

Sim

Retorno


Tipo

Descrição

( )
BOOLEAN

Indicador que define se o componente está habilitado.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_heightenable = _ADVPL_get_property(l_component_referencecComponentReference,"HEIGHTENABLE")



Expandir
titleGET HELPFORM_NAMEREFERENCE

Método GET:

HELP

FORM_

NAMECódigo do campo a ser identificado na ajuda online do componente

REFERENCE

Referência da janela em que o componente está criado.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"HELPFORM_NAMEREFERENCE") ==> TextocFormReference


Parâmetros


NomeTipoDescriçãoObrigatório?
l_form_referencecComponentReference
CHAR

Referência do formuláriocomponente.

Sim


Retorno


Tipo

Descrição

CHAR
Texto que identifica o componente na URL da ajuda online

Referência da janela onde o componente foi criado.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_helpform_namereference = _ADVPL_get_property(l_component_referencecComponentReference,"HELPFORM_NAMEREFERENCE")



Expandir
titleGET LOSTGOT_FOCUS_EVENT

Método GET:

LOST

GOT_FOCUS_EVENT 

Evento executado quando o componente

perder seu

ganhar foco.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"LOSTGOT_FOCUS_EVENT") ==> FunçãocFunctionName


Parâmetros


NomeTipoDescriçãoObrigatório?
l_form_referencecComponentReference
CHAR

Referência do formuláriocomponente.

Sim


Retorno


Tipo

Descrição

CHAR

Função que é executada quando o componente

perder seu

ganhar foco.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_lostgot_focus = _ADVPL_get_property(l_component_referencecComponentReference,"LOSTGOT_FOCUS_EVENT")



Expandir
titleGET PARENT_REFERENCEHANDLER

Método GET:

PARENT_REFERENCE

HANDLER

Código nativo

Referência

do componente

pai do componente atual

.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"PARENT_REFERENCEHANDLER") ==> ReferêncianHandlerID


Parâmetros


NomeTipoDescriçãoObrigatório?
l_form_referencecComponentReference
CHAR

Referência do formuláriocomponente.

Sim


Retorno


Tipo

Descrição

CHAR
NUMERIC
Referência

Código nativo AdvPL do componente

pai do componente atual

.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_parent_referencehadler = _ADVPL_get_property(l_component_referencecComponentReference,"PARENT_REFERENCEHANDLER")



Referência da janela onde o componente foi criado
Expandir
titleGET FORM_REFERENCEHEIGHT

Método GET:

FORM_REFERENCE

HEIGHT

Altura do componente em pixels.Referência da janela em que o componente está criado.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"FORM_REFERENCEENABLE") ==> ReferêncianHeight


Parâmetros


NomeTipoDescriçãoObrigatório?
l_form_referencecComponentReference
CHAR

Referência do formuláriocomponente.

Sim

Retorno


Tipo

Descrição

CHAR
NUMERIC

Altura em pixels do componente.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_form_referenceheight = _ADVPL_get_property(l_component_referencecComponentReference,"FORM_REFERENCEHEIGHT")



Expandir
titleGET GOTHELP_FOCUS_EVENTNAME

Método GET:

GOT

HELP_

FOCUS_EVENT

NAME

Código do campo a ser identificado na ajuda online do componente

Evento executado quando o componente ganhar foco.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"GOTHELP_FOCUS_EVENTNAME") ==> FunçãocText


Parâmetros


NomeTipoDescriçãoObrigatório?
l_form_referencecComponentReference
CHAR

Referência do formuláriocomponente.

Sim

Retorno


Tipo

Descrição

CHAR
Função

Texto que

é executada quando

identifica o componente

ganhar foco

na URL da ajuda online.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_gothelp_focusname = _ADVPL_get_property(l_component_referencecomponentReference,"GOTHELP_FOCUS_EVENTNAME")



Código nativo AdvPL do componente
Expandir
titleGET HANDLER LOST_FOCUS_EVENT

Método GET:

HANDLER

LOST_FOCUS_EVENT

Evento executado quando o componente perder seu focoCódigo nativo do componente.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"HANDLERLOST_FOCUS_EVENT") ==> CódigofunctionName


Parâmetros


NomeTipoDescriçãoObrigatório?
l_form_referencecComponentReference
CHAR

Referência do formuláriocomponente.

Sim

Retorno


Tipo

Descrição

()
CHAR

Função que é executada quando o componente perder seu foco.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_hadlerlost_focus = _ADVPL_get_property(l_component_reference,"HANDLER"cComponentReference,"LOST_FOCUS_EVENT")



Expandir
titleGET HANDLER PARENT_REFERENCE

Método GET:

HANDLER

PARENT_REFERENCE

Referência do componente pai Código nativo do componente atual.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"HEIGHTPARENT_REFERENCE") ==> CódigocParentRerence


Parâmetros


NomeTipoDescriçãoObrigatório?
l_form_referencecComponentReference
CHAR

Referência do formuláriocomponente.

Sim

Retorno


Tipo

Descrição

()
CHAR

Referência do componente pai

Código nativo AdvPL

do componente atual.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_parent_hadlerreference = _ADVPL_get_property(l_component_reference,"HANDLER"cComponentReference,"PARENT_REFERENCE")



Expandir
titleGET MAXIMIZED RIGHT_CLICK_EVENT

Método GET:

MAXIMIZED 

RIGHT_CLICK_EVENT

Evento executado ao efetuar um clique com o botão direito do mouse no componenteRetorna se a janela da aplicação está maximizada.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"MAXIMIZEDRIGHT_CLICK_EVENT") ==> Maximizada?cFunctionName


Parâmetros


NomeTipoDescriçãoObrigatório?
l_form_referencecComponentReference
CHAR

Referência do formuláriocomponente.

Sim


Retorno


Tipo

Descrição

BOOLEAN
CHAR
Indicador que define se a janela da aplicação está maximizada

Função que é executada ao efetuar um clique com o botão direito do mouse no componente.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_maximizedright_click_event = _ADVPL_get_property(l_form_reference,"MAXIMIZED"cComponentReference,"RIGHT_CLICK_EVENT")



Expandir
titleGET TITLE SHOW_TOOLTIP

Método GET:

TITLE

SHOW_TOOLTIP

Retorna se está sendo exibido o texto de ajuda (exibido quando o usuário posicionar o cursor do mouse em cima do componente) informadoTítulo da janela da aplicação.

Sintaxe


Bloco de código
_ADVPL_get_property(< l_form_referencecComponentReference >,"TITLESHOW_TOOLTIP") ==> TítulolShowTooTip


Parâmetros


NomeTipoDescriçãoObrigatório?
l_form_referencecComponentReference
CHAR

Referência do formuláriocomponente.

Sim


Retorno


Tipo

Descrição

BOOLEAN
Título da janela da aplicação

Indicador que define se está sendo exibido o texto de ajuda (exibido quando o usuário posicionar o cursor do mouse em cima do componente) informado.

Exemplo


Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_titleshow_tooltip = _ADVPL_get_property(l_form_referencecComponentReference,"TITLESHOW_TOOLTIP")
Métodos SET


Métodos acessíveis utilizando a função _ADVPL_set_property que permite alterar e manipular os valores do componente.
(informação) Para ativar ou desativar um formulário, deverá ter executado previamente o método "FORM" ou "INIT_FORM" para o mesmo.
Exemplo
 Expandir
titleSET ACTIVATEGET TOOLTIP
Método 
 SET
GET: 
 ACTIVATE
TOOLTIP
Texto de ajuda exibido quando o usuário posicionar o cursor do mouse em cima do componenteAtiva/Desativa a janela da aplicação.
Sintaxe

 Bloco de código
_ADVPL_setget_property(< l_form_referencecComponentReference >,"ACTIVATETOOLTIP",) < l_status >)==> cText

Parâmetros

NomeTipoDescriçãoObrigatório?
l_form_reference
cComponentReference
CHAR
Referência do 
 formulário
componente.
Sim
l_statusSMALLINT
Indicador que define se será ativado ou desativado o formulário.
   TRUE - Ativa o formulário
   FALSE - Desativa/Fecha o formulário.
Sim

Retorno

Tipo
Descrição
CHAR
Texto que é exibido quando o usuário posicionar o cursor do mouse em cima do componente.
Exemplo

 Bloco de código
languageruby
themeConfluenceEclipse
linenumberstrue
CALLLET l_tooltip = _ADVPL_setget_property(l_form_referencecComponentReference,"ACTIVATETOOLTIP",TRUE)


 Expandir
titleSET CENTERGET VALID 
Método 
 SET
GET: 
 CENTER
VALID 
Texto de ajuda exibido quando o usuário posicionar o cursor do mouse em cima do componenteCentraliza a janela da aplicação na área de trabalho do usuário.
Sintaxe

 Bloco de código
_ADVPL_setget_property(< l_form_referencecComponentReference >,"CENTERVALID") ==> cFunctionName

Parâmetros

NomeTipoDescriçãoObrigatório?
l_form_reference
cComponentReference
CHAR
Referência do 
 formulário
componente.
Sim
(informação) Se este método não for informado, será utilizada a modificação do formulário no cadastro do metadado (em programas metadado) ou a modificação do 4GL (para programas freeform).
Exemplo

Retorno

Tipo
Descrição
CHAR
Função que é executada para validar o conteúdo do componente quando este perder o foco.
Exemplo

 Bloco de código
languageruby
themeEclipse
linenumberstrue
LET l_valid = _ADVPL_get_property(cComponentReference,"VALID
 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_reference,"CENTER")


 Expandir
titleSET CENTERED GET VALUE
Método 
 SET
GET: 
 CENTERED
VALUE  
Valor definido para o componenteDefine se a tela abrirá no centro da área de trabalho.
Sintaxe

 Bloco de código
_ADVPL_setget_property(< l_form_referencecComponentReference >,"CENTEREDVALUE",< l_status >)) ==> uValue

Parâmetros

NomeTipoDescriçãoObrigatório?
l_form_reference
cComponentReference
CHAR
Referência do 
 formulário
componente.
Sim
l_status
BOOLEAN

Retorno

Tipo
Descrição
ANY
Valor que está definido para o componente
Indicador que define se a tela será aberta no centro da área de trabalho do usuário
.
Exemplo

 Bloco de código
languageruby
themeConfluenceEclipse
linenumberstrue
CALLLET l_value = _ADVPL_setget_property(l_form_referencecComponentReference,"CENTEREDVALUE",TRUE)


Exemplo

 Expandir
titleSET ENABLE_ESC_CLOSEGET VISIBLE
Método 
 SET: ENABLE_ESC_CLOSE
GET: VISIBLE 
Retorna se o componente está visívelDefine se habilita o encerramento da janela com a tecla ESC.
Sintaxe

 Bloco de código
_ADVPL_setget_property(< l_form_referencecComponentReference >,"ENABLE_ESC_CLOSE",< l_status >)VISIBLE") ==> lVisible

Parâmetros

NomeTipoDescriçãoObrigatório?
l_form_reference
cComponentReference
CHAR
Referência do 
 formulário
componente.
Sim
l_status

Retorno

Tipo
Descrição
BOOLEAN
Indicador que define se 
 a janela poderá ser encerrada com a tecla ESC
o componente está visível.
Sim
 Bloco de código
languageruby
themeConfluenceEclipse
linenumberstrue
CALLLET l_visible = _ADVPL_setget_property(l_form_referencecComponentReference,"ENABLE_ESC_CLOSE",FALSE)VISIBLE")


(informação) Se este método não for informado, será utilizada a modificação do formulário no cadastro do metadado (em programas metadado) ou a modificação do 4GL (para programas freeform).
Exemplo

Retorno

 Expandir
titleSET FORM_INFO GET WIDTH
Método 
 SET
GET: 
 FORM_INFO 
WIDTH 
Largura do componente em pixelsDefine se habilita o encerramento da janela com a tecla ESC.
Sintaxe

 Bloco de código
_ADVPL_setget_property(< l_form_referencecComponentReference >,"FORM_INFO",< informação >)WIDTH") ==> nWidth

Parâmetros

NomeTipoDescriçãoObrigatório?
l_form_reference
cComponentReference
CHAR
Referência do 
 formulário
componente.
Sim
informação
CHAR
Breve informação sobre o formulário.Sim
Tipo
Descrição
INTEGER
Largura em pixels do componente.
Exemplo

 Bloco de código
language
 Bloco de código
languageruby
themeConfluenceEclipse
linenumberstrue
CALLLET l_width = _ADVPL_setget_property(l_form_referencecomponentReference,"FORM_INFO","Formulário de manutenção de usuário Logix."WIDTH")


(informação) Se este método não for informado, será utilizada a modificação do formulário no cadastro do metadado (em programas metadado) ou a modificação do 4GL (para programas freeform).

 Expandir
titleSET FORM_MODIFICATION GET X
Método 
 SET: FORM_INFO 
GET: X 
Posição em pixels do eixo X (horizontal) do componente em relação ao componente paiModificação do formulário.
Sintaxe

 Bloco de código
_ADVPL_setget_property(< l_form_referencecComponentReference >,"FORM_MODIFICATION",< informação >)X") ==> nPos

Parâmetros

NomeTipoDescriçãoObrigatório?
l_form_reference
cComponentReference
CHAR
Referência do 
 formulário
componente.
Sim
informação

Retorno
CHAR
Breve informação sobre o formulário.Não
Tipo
Descrição
INTEGER
Posição em pixels do eixo X do componente.
Exemplo

 Bloco de código
languageruby
themeConfluenceEclipse
linenumberstrue
CALLLET l_x = _ADVPL_setget_property(l_form_referencecComponentReference,"FORM_MODIFICATION","01"X")


(informação) Se este método não for informado, será utilizada a modificação do formulário no cadastro do metadado (em programas metadado) ou a modificação do 4GL (para programas freeform)

 Expandir
titleSET FORM_NAME GET Y
Método 
 SET
GET: 
 FORM_NAME 
Y
Posição em pixels do eixo Y (vertical) do componente em relação ao componente paiModificação do formulário.
Sintaxe

 Bloco de código
_ADVPL_setget_property(< l_form_namecComponentReference >,"FORM_INFO",< formulário >)Y") ==> nPos

Parâmetros

NomeTipoDescriçãoObrigatório?
l_form_name
cComponentReference
CHAR
Referência do 
 formulário
componente.
Sim
formulário

Retorno
CHAR
Nome do formulário.Sim
Tipo
Descrição
INTEGER
Posição em pixels do eixo Y do componente.
Exemplo

 Bloco de código
languageruby
themeConfluenceEclipse
linenumberstrue
CALLLET l_y = _ADVPL_setget_property(l_form_namecomponentReference,"FORM_NAME","LOG5500")Y")


Métodos SET
Métodos acessíveis utilizando a função _ADVPL_set_property que permite alterar e manipular os valores do componente.

(informação) Se este método não for informado, será utilizada a modificação do formulário no cadastro do metadado (em programas metadado) ou a modificação do 4GL (para programas freeform).
Exemplo
 Expandir
titleSET FORM_RELEASE ALIGN
Método SET:
 FORM_RELEASE 
 ALIGN 
Release do formulárioAlinhamento do componente em relação ao seu componente pai.
Sintaxe

 Bloco de código
_ADVPL_set_property(< l_form_referencecComponentReference >,"FORM_RELEASEALIGN",< releasecAlign >)
Parâmetros

NomeTipoDescriçãoObrigatório?
l_form_reference
cComponentReference
CHAR
Referência do 
 formulário
componente.Sim
release
cAlign
CHAR
Release do formulário.Sim
 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_reference,"FORM_RELEASE","02")
 Expandir
titleSET FORM_VERSION 
Alinhamento do componente em relação ao componente pai, sendo:
  • NONE: nenhum alinhamento.
  • TOP: alinhamento ao topo.
  • LEFT: alinhamento à esquerda.
  • RIGHT: alinhamento à direita.
  • CENTER: alinhamento central.
  • BOTTOM: alinhamento ao fundo.
Sim
(informação) Importante: Cada tipo de alinhamento possui um comportamento diferente, conforme descrito abaixo para cada tipo de alinhamento:
  • TOP: ocupa a largura total do componente pai, necessitando definir apenas a altura do componente.
  • LEFT: ocupa a altura total do componente pai, necessitando definir apenas a largura do componente.
  • RIGHT: ocupa a altura total do componente pai, necessitando definir apenas a largura do componente.
  • CENTER: ocupa todo o espaço útil do componente pai, dispensando a necessidade de definir tamanho para o componente.
  • BOTTOM: ocupa a largura total do componente pai, necessitando definir apenas a altura do componente
Método SET: FORM_VERSION 
Versão do formulário.
Sintaxe
 Bloco de código
_ADVPL_set_property(< l_form_reference >,"FORM_VERSION",< versao >)
Parâmetros
NomeTipoDescriçãoObrigatório?l_form_reference
CHAR
Referência do formulário.Simversao
CHAR
Versão do formulário.Sim(informação) Se este método não for informado, será utilizada a modificação do formulário no cadastro do metadado (em programas metadado) ou a modificação do 4GL (para programas freeform)
  • .
Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_reference,"FORM_VERSION","10")
 Expandir
titleSET HOTKEY 
#---------------------# 
FUNCTION TesteAlign()
#---------------------#
     DEFINE l_dialog_reference VARCHAR(10)
     DEFINE l_label_reference  VARCHAR(10)

     LET l_dialog_reference = _ADVPL_create_component(NULL,"LDIALOG")
     CALL _ADVPL_set_property(l_dialog_reference,"SIZE",640,480)
     CALL _ADVPL_set_property(l_dialog_reference,"TITLE","Teste de Alinhamento")
     
#Alinhamento ao topo.
     LET l_label_reference = _ADVPL_create_component(NULL,"LPANEL",l_dialog_reference)
     CALL _ADVPL_set_property(l_label_reference,"HEIGHT",80)
     CALL _ADVPL_set_property(l_label_reference,"ALIGN","TOP")
     CALL _ADVPL_set_property(l_label_reference,"BACKGROUND_COLOR",255,255,0)
    
 #Alinhamento à esquerda.
     LET l_label_reference = _ADVPL_create_component(NULL,"LPANEL",l_dialog_reference)
     CALL _ADVPL_set_property(l_label_reference,"WIDTH",80)
     CALL _ADVPL_set_property(l_label_reference,"ALIGN","LEFT")
     CALL _ADVPL_set_property(l_label_reference,"BACKGROUND_COLOR",255,0,0)
    
 #Alinhamento central.
     LET l_label_reference = _ADVPL_create_component(NULL,"LTITLEDPANEL",l_dialog_reference)       
     CALL _ADVPL_set_property(l_label_reference,"TITLE","Teste de Alinhamento")
     CALL _ADVPL_set_property(l_label_reference,"ALIGN","CENTER")
     CALL _ADVPL_set_property(l_label_reference,"BACKGROUND_COLOR",0,255,0)
    
 #Alinhamento à direita.
     LET l_label_reference = _ADVPL_create_component(NULL,"LPANEL",l_dialog_reference)
     CALL _ADVPL_set_property(l_label_reference,"WIDTH",80)
     CALL _ADVPL_set_property(l_label_reference,"ALIGN","RIGHT")
     CALL _ADVPL_set_property(l_label_reference,"BACKGROUND_COLOR",0,0,255)
    
 #Alinhamento ao fundo.
     LET l_label_reference = _ADVPL_create_component(NULL,"LPANEL",l_dialog_reference)
     CALL _ADVPL_set_property(l_label_reference,"HEIGHT",80)
     CALL _ADVPL_set_property(l_label_reference,"ALIGN","BOTTOM")
     CALL _ADVPL_set_property(l_label_reference,"BACKGROUND_COLOR",0,255,255)
     CALL _ADVPL_set_property(l_dialog_reference,"MAXIMIZED",FALSE)
     CALL _ADVPL_set_property(l_dialog_reference,"ACTIVATE",TRUE) 
END FUNCTION


 Expandir
titleSET BACKGROUND_COLOR
Método SET: BACKGROUND_COLOR 
Cor de fundo do componente em RGB (Red, Green and Blue).
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"BACKGROUND_COLOR",< nRed >, < nGreen >, < nBlue >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
nRed
INTEGER
Número correspondente ao nível de vermelho da cor (R do RGB).Sim
nGreen
INTEGER
Número correspondente ao nível de verde da cor (G do RGB).Sim
nBlue
INTEGER
Número correspondente ao nível de azul da cor (B do RGB).Sim
Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"BACKGROUND_COLOR",255,0,0)


 Expandir
titleSET BOUNDS
Método SET: BOUNDS 
Limite do componente (posição horizontal e vertical, altura e largura) em relação ao componente pai.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"BOUNDS",< nXPos >, < nYPos > , < nWidht >, < nHeight >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
nXPos
INTEGER
Posição em pixels do eixo X (horizontal) do componente.Sim
nYPos
INTEGER
Posição em pixels do eixo Y (vertical) do componente.Sim
nWidht
INTEGER
Largura em pixels do componente.Sim
nHeight
INTEGER
Altura em pixels do componente.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"BOUNDS",10,10,320,240)


 Expandir
titleSET CAN_GOT_FOCUS
Método SET: CAN_GOT_FOCUS
Define se o componente poderá ganhar foco.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"CAN_GOT_FOCUS",< lCanGotFocus >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
lCanGotFocus
BOOLEAN
Indicador que define se o componente poderá ganhar foco.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"CAN_GOT_FOCUS",FALSE)


 Expandir
titleSET CHANGE_EVENT
Método SET: CHANGE_EVENT     
Evento executado quando o valor do componente for alterado.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference > ,"CHANGE_EVENT",< cFunctionName >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
cFunctionName 
CHAR
Função executada quando o valor do componente for alterado.Sim
Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"CHANGE_EVENT","job0003_execucao_gatilho_select_all")


 Expandir
titleSET CLICK_EVENT
Método SET: CLICK_EVENT   
Evento executado ao clicar no componente.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cButtonReference >,"CLICK_EVENT",< cFunctionName >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cButtonReference 
CHAR
Referência do componente.Sim
cFunctionName 
CHAR
Função executada ao clicar no componente.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cButtonReference,"CLICK_EVENT","job0005_stop_process_monitor")


 Expandir
titleSET CSS
Método SET: CSS  
Estilo CSS (Cascading Style Sheets) definido para o componente.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"CSS",< cCodeCSS >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference CHARReferência do componente.Sim
cCodeCSS
CHAR
Código CSS que será definido para o componente.Sim
(informação)  Importante: nem todos comandos de estilos disponíveis para o componente QT poderão ser compatíveis com a tecnologia Totvstec.
Para definir o código CSS para o componente, deverá ser utilizado o nome dos componentes nativos do AdvPL (QT). 

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"CSS","QPushButton { background-image: url(rpo:BTPESQ.PNG); }")


 Expandir
titleSET DOUBLE_CLICK_EVENT
Método SET: DOUBLE_CLICK_EVENT  
Evento executado ao efetuar um duplo clique no componente.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"DOUBLE_CLICK_EVENT",< cFunctionName >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference
CHARReferência do componente.Sim
cFunctionName
CHAR
Função executada ao efetuar um duplo clique no componente.Sim
Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"DOUBLE_CLICK_EVENT","job0003_parametros_update_variable")


 Expandir
titleSET EDITABLE
Método SET: EDITABLE
Habilita ou desabilita a edição do componente.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"EDITABLE",< lEditable >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
lEditable
BOOLEAN
Indicador que define se o componente será editável.Sim
(informação) Independente se o componente é editável ou não, este sempre ganhará foco.
Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"EDITABLE",FALSE)


 Expandir
titleSET ENABLE
Método SET: ENABLE
Habilita ou desabilita o componente.
Sintaxe

 Bloco de código
_ADVPL_set_property( < cComponentReference > ,"ENABLE", < lEnable > )
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
lEnable
BOOLEAN
Indicador que define se o componente será habilitado.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"ENABLE",FALSE)


 Expandir
titleSET FONT
Método SET: FONT 
Configurações de fonte utilizados para os textos do componente.
Sintaxe

 Bloco de código
_ADVPL_set_property( < cComponentReference > ,"FONT", [ cFont ], [ nLength ], [ lBold ], [ lItalic ])
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
cFont
CHAR
Nome do fonte que será utilizado pelo componente.Não
nLength
INTEGER
Tamanho do fonte que será utilizado.Não
lBold
BOOLEAN
Indicador que define se o texto será negrito.Não
lItalic
BOOLEAN
Indicador que define se o texto será itálico.Não

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"FONT","Courier New",10,TRUE,FALSE)




 Expandir
titleSET FORCE_GET_FOCUS
Método SET: FORCE_GET_FOCUS 
Força o foco para o componente.
Sintaxe

 Bloco de código
_ADVPL_set_property( < cComponentReference >,"FORCE_GET_FOCUS", [ lForce ] )
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
lForce
BOOLEAN
Indicador que define se, caso o componente estiver em uma aba, esta também ganhe foco.Não

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"FORCE_GET_FOCUS",TRUE)


 Expandir
titleSET FOREGROUND_COLOR
Método SET: FOREGROUND_COLOR
Cor da fonte do componente em RGB (Red, Green and Blue).
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"FOREGROUND_COLOR", [ nRed ], [ nGreen ], [ nBlue ])
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
nRed
INTEGER
Número correspondente ao nível de vermelho da cor (R do RGB).Sim
nGreen
INTEGER
Número correspondente ao nível de verde da cor (G do RGB).Sim
nBlue
INTEGER
Número correspondente ao nível de azul da cor (B do RGB).Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(componentReference,"FOREGROUND_COLOR",255,0,0)


 Expandir
titleSET GOT_FOCUS_EVENT
Método SET: GOT_FOCUS_EVENT 
Evento executado quando o componente ganhar foco.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"GOT_FOCUS_EVENT", < cFunctionName > )
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference
CHAR
Referência do componente.Sim
cFunctionName
CHAR
Função executada quando o componente ganhar foco.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"GOT_FOCUS_EVENT", "eai100001_got_focus_event_mensagem")


 Expandir
titleSET HEIGHT
Método SET: HEIGHT
Altura do componente em pixels.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"HEIGHT", [ nHeight ])
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
nHeight
INTEGER
Altura em pixels do componente.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"HEIGHT",200)


 Expandir
titleSET HELP_NAME
Método SET: HELP_NAME
Código do campo a ser identificado na ajuda online do componente.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"HELP_NAME",[ cText ])
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
cText
CHAR
Texto que será identificado na URL da ajuda online do componente.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"HELP_NAME","frm_toolbar_parent_name")


 Expandir
titleSET HOTKEY 
Método SET: HOTKEY 
Tecla de atalho definida para o componente.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >, "HOTKEY",< cKey >,< functioName >,< cDescription >,< lOnlyExecuteOnFocus >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference CHARReferência do componente.Sim
cKey
CHAR
Tecla de atalho conforme teclas disponíveis na lista de teclas de atalhos.Sim
functionNameCHARFunção que será executada ao acionar a tecla de atalho.Sim
cDescriptionCHARDescrição do objetvo da tecla de atalho. Esta descrição será exibida na janela de teclas disponível no formulário para o usuário.Sim
lOnlyExecuteOnFocusBOOLEANIndicador lógico que define se a atalho deverá ser executado sempre ou somente quando o componente informado no método estiver focado em tela.Sim
(informação) Para acessar a lista de teclas de atalhos válidas disponíveis, clique aqui.
Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"HOTKEY","F4","Zoom de empresas.",TRUE)


 Expandir
titleSET LOST_FOCUS_EVENT
Método SET: LOST_FOCUS_EVENT
Código do campo a ser identificado na ajuda online do componente.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference>,"LOST_FOCUS_EVENT",< cFunctionName >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference
CHAR
Referência do componente.Sim
cFunctionName
CHAR
Função executada quando o componente perder seu foco.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"LOST_FOCUS_EVENT","log08100_zoom_tabela")


 Expandir
titleSET POSITION
Método SET: POSITION
Posição (horizontal e vertical) em pixels do componente em relação ao componente pai.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"POSITION",[ nXPos ], [ nYPos ])
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference CHARReferência do componente.Sim
nXPos
INTEGER
Posição em pixels do eixo X (horizontal) do componente.Sim
nYPos
INTEGERPosição em pixels do eixo Y (vertical) do componente.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"POSITION",05,10)


 Expandir
titleSET PROPERTY
Método SET: PROPERTY
Atribui novas propriedades para o componente.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"PROPERTY",[ cProperties ])
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
cProperties
CHAR
Texto com as propriedades que serão atribuídas para o componente.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"PROPERTY","{'PICTURE','@!'}{'LENGTH',10}")


 Expandir
titleSET REFRESH_SIZE
Método SET: REFRESH_SIZE
Atualiza as propriedades de coordenadas do componente (posição e tamanho)
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"REFRESH_SIZE")

(informação) Esta função atualiza as propriedades de coordenadas do componente (X, Y, WIDTH e HEIGHT).

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"REFRESH_SIZE")


 Expandir
titleSET REMOVE_VARIABLES
Método SET: REMOVE_VARIABLES
Remove as variáveis definidas para o componente.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"REMOVE_VARIABLES")
Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"REMOVE_VARIABLES")


 Expandir
titleSET RIGHT_CLICK_EVENT
Método SET: RIGHT_CLICK_EVENT  
Evento executado ao efetuar um clique com o botão direito do mouse no componente.

Sintaxe


 Bloco de código
_ADVPL_set_property(< cComponentReference >,"RIGHT_CLICK_EVENT",< cFunctionName >)

Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference
CHAR
Referência do componenteSim
cfunctionName
CHAR
Função executada ao efetuar um clique com o botão direito do mouse no componente.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"RIGHT_CLICK_EVENT","sup2033_marca_desmarca_nos")


 Expandir
titleSET SAVE_IMAGE
Método SET: SAVE_IMAGE
Salva uma imagem (print) do componente em uma imagem do tipo bitmap (BMP).
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"SAVE_IMAGE",< cPath >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
cPath
CHAR
Caminho completo onde será salva a imagem do componente.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"SAVE_IMAGE","C:\\totvs\\temp\\component_image.bmp")


 Expandir
titleSET SHOW_TOOLTIP
Método SET: SHOW_TOOLTIP
Define se será exibido o texto de ajuda (exibido quando o usuário posicionar o cursor do mouse em cima do componente) informado.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"SHOW_TOOLTIP",< lShowToolTip >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
lShowToolTip
BOOLEAN
Indicador que define se será exibido o texto de ajuda (exibido quando o usuário posicionar o cursor do mouse em cima do componente) informado.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"SHOW_TOOLTIP",FALSE)


 Expandir
titleSET SIZE
Método SET: SIZE
Tamanho (largura e altura) em pixels do componente.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"SIZE",< nWidth >, < nHeight >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
nWidth
INTEGER
Largura em pixels do componente.Sim
nHeight
INTEGER
Altura em pixels do componente.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"SIZE",640,480)


 Expandir
titleSET TOOLTIP
Método SET: TOOLTIP
Texto de ajuda exibido quando o usuário posicionar o cursor do mouse em cima do componente.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"TOOLTIP",< cText >)
Parâmetros

NomeTipoDescriçãoObrigatório?
componentReference CHARReferência do componente.Sim
cText
CHAR
Texto que será exibido quando o usuário posicionar o cursor do mouse em cima do componente.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"TOOLTIP","Código da empresa corrente.")


 Expandir
titleSET VALID
Método SET: VALID
Evento executado para validar o conteúdo do componente quando este perder seu foco.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"VALID",< cFunctionName >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
cFunctionName
CHAR
Função executada para validar o conteúdo do componente quando este perder o foco.Sim
(informação) Importante: esta função deverá retornar um indicador lógico de sucesso na validação do conteúdo do campo. Se a mesma retornar falso, o foco continua no campo, caso contrário a entrada de dados continua normalmente.
(informação) Este evento será executado antes da execução do evento do método LOST_FOCUS_EVENT.


 Expandir
titleSET VALUE
Método SET: VALUE
Valor definido para o componente.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"VALUE",< uValue >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
uValue
ANY
Valor que será definido para o componente.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"VALUE",10)


(informação) Para acessar a lista de teclas de atalhos válidas disponíveis, clique aqui.
Exemplo

 Expandir
titleSET VARIABLE
Método SET: VARIABLE
Adiciona uma variável que será controlada pelo componente.
Sintaxe

 Bloco de código
_ADVPL_set_property(< cComponentReference >,"VARIABLE",< record4GL >, < cVariableName >)
Parâmetros

NomeTipoDescriçãoObrigatório?
cComponentReference 
CHAR
Referência do componente.Sim
record4GL 
OBJECT
Record 4GL que contém a variável de controle do componente.Sim
cVariableName
CHAR
Nome da variável do Record 4GL que controlará o componente. Quando não for informado , tenta procurar uma variável com o mesmo nome do campo Não
(informação) Ao alterar o valor em tela, automaticamente o valor da variável definida também será alterada, mas quando o valor da variável for alterada no 4GL, deverá ser utilizado o método REFRESH no componente para atualizar o valor em tela
Método SET: HOTKEY 
Tecla de atalho a ser executada quando a janela da aplicação estiver ativa.
Sintaxe
 Bloco de código
_ADVPL_set_property(< l_form_reference >,< tecla >,< função >,< descrição >,< componente >, < status >)
Parâmetros
NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR
Referência do formulário.Sim
tecla
CHAR
Tecla de atalho conforme teclas disponíveis na lista de teclas de atalhos.Sim
funçãoCHARFunção que será executada ao acionar a tecla de atalho.Sim
descriçãoCHARDescrição da execução da tecla de atalho, esta descrição será exibida na janela de tecla disponíveis no formulário para o usuário.Sim
componenteCHARReferência do componente do qual pertence a tecla de atalho.Não
statusBOOLEANIndicador lógico que define se o atalho deverá ser executado sempre ou somente quando o componente informado no método estiver focado em tela.Não
 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_referencecomponentReference,"HOTKEYVARIABLE","CTRL-I","Incluir um novo registro.",l_menubutton_reference,FALSEmr_tela,"cod_item")


(informação) Este método pode ser chamado mais de uma vez, sendo que as funções serão empilhadas e executadas na ordem em que foram enviadas.
 Expandir
titleSET INIT_EVENT VISIBLE
Método SET:
 INIT_EVENT 
 VISIBLE
Habilita ou desabilita a visualização do componenteAdiciona um evento a ser executado ao iniciar a janela da aplicação.
Sintaxe

 Bloco de código
_ADVPL_set_property(< l_form_referencecComponentReference >,"VARIABLE",< lVisible função>>)
Parâmetros

NomeTipoDescriçãoObrigatório?
l_form_reference
CHAR
Referência do formulário.Sim
função
CHAR
Função executada executada ao iniciar a janela de aplicação.Sim
cComponentReference 
CHAR
Referência do componente.Sim
lVisible
BOOLEAN
Indicador que define se o componente será visível.Sim
(informação) Mesmo o componente sendo invisível, o espaço ocupado pelo mesmo continuará em tela.
Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"VISIBLE",FALSE)


(informação) Importante: por padrão no Logix, caso não definido este método, toda janela pai (primeira execução) são abertas maximizadas. As janelas abertas na mesma thread por outras janelas são abertas no modo normal.
 Expandir
titleSET MAXIMIZED WIDTH
Método SET:
 MAXIMIZED 
 WIDTH
Largura do componente em pixelsDefine se a tela abrirá maximizada.
Sintaxe

 Bloco de código
_ADVPL_set_property(< l_form_referencecComponentReference >,"MAXIMIZEDWIDTH",< statusnWidth >)
|
Parâmetros

NomeTipoDescriçãoObrigatório?
l_form_reference
cComponentReference 
CHAR
Referência do 
 formulário
componente.Sim
status
nWidth
BOOLEAN
Indicador que define se a janela abrirá maximizada.Sim
INTEGER
Largura em pixels do componente.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_referencecComponentReference,"MAXIMIZEDWIDTH",FALSE250)


 Expandir
titleSET TITLE X
Método SET:
 MAXIMIZED 
 X
Posição em pixels do eixo X (horizontal) do componente em relação ao componente paiTítulo da janela.
Sintaxe

 Bloco de código
_ADVPL_set_property(< l_form_referencecComponentReference >," TITLE X",< nPos título>>)
|
Parâmetros

NomeTipoDescriçãoObrigatório?
l_form_referencecComponentReference CHARReferência do formuláriocomponente.Sim
títulonPos
CHAR
INTEGER
Posição em pixels do eixo X (horizontal) do componenteTítulo da janela.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_form_referencecComponentReference,"TITLEX","Central do Usuário"10)


 Expandir
titleSET VALID Y
Método SET:
 VALID 
 Y
Posição em pixels do eixo X (horizontal) do componente em relação ao componente paiDefine se a tela abrirá maximizada.
Sintaxe

 Bloco de código
_ADVPL_set_property(cComponentReference,"Y",< funçaonPos >)
|
Parâmetros

NomeTipoDescriçãoObrigatório?
funçãocComponentReference 
CHAR
Função 		 que será executada quando o usuário fechar a janela de diálogoReferência do componente.Sim
(informação) Importante: este evento é executado tanto na chamada do método ACTIVATE (para desativar a janela de diálogo), quanto no fechamento da janela pelo sistema operacional (pelo X da janela de diálogo). Este evento não é o mesmo evento definido no método EVENT para o botão LQuitButton.
(informação)Importante: caso a função informada neste método retornar falso, a tela não será finalizada.
nPos
INTEGER
Posição em pixels do eixo Y (horizontal) do componente.Sim

Exemplo

 Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(cComponentReference,"Y",10)