Páginas filhas
  • LGX - LTITLEDPANEL

Cria um painel visível com borda e título, para que seja possível agrupar, alinhar e organizar uma lista de componentes.


Hierarquia


  • LCOMPONENT
    • LCONTAINER
      •  LTITLEDPANEL


Sintaxe


_ADVPL_create_component( NULL, "LTITLEDPANEL", < l_container_reference > ) => l_component_reference


Métodos GET



Método GET: TITLE

Retorna o título do painel.

Sintaxe



_ADVPL_get_property(< l_panel_reference >,"TITLE") ==> l_title


Parâmetros



NomeTipoDescriçãoObrigatório?
l_panel_reference
CHAR

Referência do painel.

Sim

Retorno



Tipo

Descrição

CHAR

Título do painel.

Exemplo



LET l_title = _ADVPL_get_property(l_panel_reference,"TITLE")




Método GET: HEIGHT

Retorna a altura do componente (em pixels).

Sintaxe



_ADVPL_get_property(< l_panel_reference >,"HEIGHT") => l_height

Retorno



TipoDescrição
SMALLINTTamanho do componente, no que se refere a sua altura.

Exemplo



LET l_height = _ADVPL_get_property(l_panel_reference,"HEIGHT")




Método GET: WIDTH

Retorna a largura do componente (em pixels).

Sintaxe



_ADVPL_get_property(< l_panel_reference >,"WIDTH") => l_width

Retorno



TipoDescrição
SMALLINTTamanho do componente, no que se refere a sua largura.

Exemplo



LET l_width = _ADVPL_get_property(l_panel_reference,"WIDTH")




Para visualizar os métodos herdados da classe pai, visite a página do componente LComponent.


Métodos SET



Método SET: TITLE

Ajustar o título do painel com borda.

Sintaxe



_ADVPL_set_property( < l_panel_reference > , "TITLE" , < l_title > )

Parâmetros



NomeTipoDescriçãoObrigatório?
l_panel_reference
CHAR
Referência do painel.Sim
l_title
CHAR
Título a ser apresentado no painel de componentes.Sim


Exemplo



CALL _ADVPL_set_property(l_panel_reference,"TITLE","Central do Usuário")




Método SET: BOUNDS

Ajusta a dimensão e posição do painel com borda e título.

Sintaxe



_ADVPL_set_property(< l_panel_reference >,"BOUNDS", < l_x >, < l_y >, < l_width >, < l_height > ) 

Parâmetros



NomeTipoDescriçãoObrigatório?
l_panel_reference
CHAR
Referência do painel com borda e título.Sim
l_x
SMALLINT
Posição em pixels do eixo X (horizontal) do componente em relação ao componente pai.Sim
l_y
SMALLINT
Posição em pixels do eixo Y (vertical) do componente em relação ao componente pai.Sim
l_widthSMALLINTLargura em pixels do componente.Sim
l_heightSMALLINTAltura em pixels do componente.Sim

Exemplo



CALL _ADVPL_set_property(l_panel_reference,"BOUNDS", 100, 100, 500, 300)




Método SET: WIDTH

Ajusta a largura em pixels do painel com borda e título.

Sintaxe



_ADVPL_set_property(< l_panel_reference >,"WIDTH", < l_width > ) 

Parâmetros



NomeTipoDescriçãoObrigatório?
l_panel_reference
CHAR
Referência do painel com borda e título.Sim
l_widthSMALLINTLargura em pixels do componente.Sim

Exemplo



CALL _ADVPL_set_property(l_panel_reference,"WIDTH", 500)




Método SET: HEIGHT

Ajusta a altura em pixels do painel com borda e título.

Sintaxe



_ADVPL_set_property(< l_panel_reference >,"HEIGHT", < l_height > ) 

Parâmetros



NomeTipoDescriçãoObrigatório?
l_panel_reference
CHAR
Referência do painel com borda e título.Sim
l_heightSMALLINTAltura em pixels do componente.Sim

Método SET: X

Ajusta a posição em pixels do eixo X (horizontal) do painel em relação ao componente pai.

Sintaxe



_ADVPL_set_property(< l_panel_reference >,"X", < l_x > ) 

Parâmetros



NomeTipoDescriçãoObrigatório?
l_panel_reference
CHAR
Referência do painel com borda e título.Sim
l_x
SMALLINT
Posição em pixels do eixo X (horizontal) do componente em relação ao componente pai.Sim

Exemplo



CALL _ADVPL_set_property(l_panel_reference,"X", 100)




Método SET: Y

Ajusta a posição em pixels do eixo Y (vertical) do painel em relação ao componente pai.

Sintaxe



_ADVPL_set_property(< l_panel_reference >,"Y", < l_y > ) 

Parâmetros



NomeTipoDescriçãoObrigatório?
l_panel_reference
CHAR
Referência do painel com borda e título.Sim
l_y
SMALLINT
Posição em pixels do eixo Y (vertical) do componente em relação ao componente pai.Sim


Exemplo



CALL _ADVPL_set_property(l_panel_reference,"Y", 100)




Método SET: POSITION

Ajusta a posição em pixels do eixo X (horizontal) e eixo Y (vertical) do painel em relação ao componente pai.

Sintaxe



_ADVPL_set_property(< l_panel_reference >,"POSITION", < l_x >, < l_y > ) 

Parâmetros



NomeTipoDescriçãoObrigatório?
l_panel_reference
CHAR
Referência do painel com borda e título.Sim
l_x
SMALLINT
Posição em pixels do eixo X (horizontal) do componente em relação ao componente pai.Sim
l_y
SMALLINT
Posição em pixels do eixo Y (vertical) do componente em relação ao componente pai.Sim

Exemplo



CALL _ADVPL_set_property(l_panel_reference,"POSITION", 100, 100)




Método SET: ALIGN 

Ajusta o alinhamento do painel em relação ao seu componente pai.

Sintaxe



_ADVPL_set_property(< l_panel_reference >, "ALIGN", < l_align >) 

Parâmetros



NomeTipoDescriçãoObrigatório?
l_panel_reference
CHAR
Referência do componente painel.Sim
l_align
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.
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.


Exemplo



#----------------------------------# 
FUNCTION TesteAlignTitledPanel()
#----------------------------------#
     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,"LTITLEDPANEL",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,"LPANEL",l_dialog_reference)
     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,"LTITLEDPANEL",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

Método SET: ALIGN

Ajusta a posição em pixels do eixo X (horizontal) e eixo Y (vertical) do painel em relação ao componente pai.

Sintaxe



_ADVPL_set_property(< l_panel_reference >,"POSITION", < l_x >, < l_y > ) 

Parâmetros



NomeTipoDescriçãoObrigatório?
l_panel_reference
CHAR
Referência do painel com borda e título.Sim
l_x
SMALLINT
Posição em pixels do eixo X (horizontal) do componente em relação ao componente pai.Sim
l_y
SMALLINT
Posição em pixels do eixo Y (vertical) do componente em relação ao componente pai.Sim

Exemplo



CALL _ADVPL_set_property(l_panel_reference,"POSITION", 100, 100)




Método SET: SIZE

Ajusta a dimensão do painel com borda e título.

Sintaxe



_ADVPL_set_property(< l_panel_reference >,"SIZE", < l_width >, < l_height > ) 

Exemplo



CALL _ADVPL_set_property(l_panel_reference,"SIZE", 500, 300)




Para visualizar os métodos herdados da classe pai, visite a página do componente LComponent.



Exemplo

Clique no link na lateral direita para expandir o código de exemplo.
Código de exemplo da classe LTITLEDPANEL
#---------------------------#
 FUNCTION testTitledPanel()
#---------------------------#
     DEFINE l_dialog_reference,
            l_panel_reference,
            l_label_reference VARCHAR(10)
 
     LET l_dialog_reference = _ADVPL_create_component(NULL,"LDIALOG")
     CALL _ADVPL_set_property(l_dialog_reference,"SIZE",400,400)
     CALL _ADVPL_set_property(l_dialog_reference,"TITLE","Exemplo de Utilização: LTITLEDPANEL")
 
     LET l_panel_reference = _ADVPL_create_component(NULL,"LPANEL",l_dialog_reference)
     CALL _ADVPL_set_property(l_panel_reference,"ALIGN","TOP")
     CALL _ADVPL_set_property(l_panel_reference,"BACKGROUND_COLOR",200,190,230)
     CALL _ADVPL_set_property(l_panel_reference,"HEIGHT",50)
 
     LET l_label_reference = _ADVPL_create_component(NULL,"LCLABEL",l_panel_reference)
     CALL _ADVPL_set_property(l_label_reference,"ALIGN","CENTER")
     CALL _ADVPL_set_property(l_label_reference,"TEXT","Painel Superior")
 
     LET l_panel_reference = _ADVPL_create_component(NULL,"LPANEL",l_dialog_reference)
     CALL _ADVPL_set_property(l_panel_reference,"ALIGN","LEFT")
     CALL _ADVPL_set_property(l_panel_reference,"BACKGROUND_COLOR",150,215,235)
     CALL _ADVPL_set_property(l_panel_reference,"WIDTH",65)
 
     LET l_label_reference = _ADVPL_create_component(NULL,"LCLABEL",l_panel_reference)
     CALL _ADVPL_set_property(l_label_reference,"ALIGN","CENTER")
     CALL _ADVPL_set_property(l_label_reference,"TEXT","Painel à Esquerda")
 
     LET l_panel_reference = _ADVPL_create_component(NULL,"LPANEL",l_dialog_reference)
     CALL _ADVPL_set_property(l_panel_reference,"ALIGN","RIGHT")
     CALL _ADVPL_set_property(l_panel_reference,"BACKGROUND_COLOR",240,230,175)
     CALL _ADVPL_set_property(l_panel_reference,"WIDTH",65)
 
     LET l_label_reference = _ADVPL_create_component(NULL,"LCLABEL",l_panel_reference)
     CALL _ADVPL_set_property(l_label_reference,"ALIGN","CENTER")
     CALL _ADVPL_set_property(l_label_reference,"TEXT","Painel à Direita")
 
     LET l_panel_reference = _ADVPL_create_component(NULL,"LTITLEDPANEL",l_dialog_reference)
     CALL _ADVPL_set_property(l_panel_reference,"ALIGN","CENTER")
     CALL _ADVPL_set_property(l_panel_reference,"BACKGROUND_COLOR",225,225,225)
 
     LET l_label_reference = _ADVPL_create_component(NULL,"LCLABEL",l_panel_reference)       
     CALL _ADVPL_set_property(l_dialog_reference,"TITLE","Exemplo de Utilização: LTITLEDPANEL")
     CALL _ADVPL_set_property(l_label_reference,"ALIGN","CENTER")
     CALL _ADVPL_set_property(l_label_reference,"TEXT","Painel Centralizado/Total")
 
     LET l_panel_reference = _ADVPL_create_component(NULL,"LPANEL",l_dialog_reference)
     CALL _ADVPL_set_property(l_panel_reference,"ALIGN","BOTTOM")
     CALL _ADVPL_set_property(l_panel_reference,"BACKGROUND_COLOR",245,125,130)
     CALL _ADVPL_set_property(l_panel_reference,"HEIGHT",50)
 
     LET l_label_reference = _ADVPL_create_component(NULL,"LCLABEL",l_panel_reference)
     CALL _ADVPL_set_property(l_label_reference,"ALIGN","CENTER")
     CALL _ADVPL_set_property(l_label_reference,"TEXT","Painel Inferior")
 
     CALL _ADVPL_set_property(l_dialog_reference,"ACTIVATE",TRUE)
 END FUNCTION

Visualização