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

GET TITLE

Método GET: TITLE

Retorna o título do painel.

Sintaxe

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

Parâmetros

Nome	Tipo	Descrição	Obrigató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")

GET HEIGHT

Método GET: HEIGHT

Retorna a altura do componente (em pixels).

Sintaxe

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

Retorno

Tipo	Descrição
`SMALLINT`	Tamanho do componente, no que se refere a sua altura.

Exemplo

LET l_height = _ADVPL_get_property(l_panel_reference,"HEIGHT")

GET WIDTH

Método GET: WIDTH

Retorna a largura do componente (em pixels).

Sintaxe

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

Retorno

Tipo	Descrição
`SMALLINT`	Tamanho 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

SET TITLE

Método SET: TITLE

Ajustar o título do painel com borda.

Sintaxe

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

Parâmetros

Nome	Tipo	Descrição	Obrigató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")

SET BOUNDS

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

Nome	Tipo	Descrição	Obrigató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_width	`SMALLINT`	Largura em pixels do componente.	Sim
`l_height`	SMALLINT	Altura em pixels do componente.	Sim

Exemplo

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

SET WIDTH

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

Nome	Tipo	Descrição	Obrigatório?
`l_panel_reference`	`CHAR`	Referência do painel com borda e título.	Sim
`l_width`	`SMALLINT`	Largura em pixels do componente.	Sim

Exemplo

CALL _ADVPL_set_property(l_panel_reference,"WIDTH", 500)

SET HEIGHT

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

Nome	Tipo	Descrição	Obrigatório?
`l_panel_reference`	`CHAR`	Referência do painel com borda e título.	Sim
`l_height`	`SMALLINT`	Altura em pixels do componente.	Sim

SET X

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

Nome	Tipo	Descrição	Obrigató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)

SET Y

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

Nome	Tipo	Descrição	Obrigató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)

SET POSITION

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

Nome	Tipo	Descrição	Obrigató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)

SET ALIGN

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

Nome	Tipo	Descrição	Obrigató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

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

SET POSITION

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

Nome	Tipo	Descrição	Obrigató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)

SET SIZE

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

Páginas filhas

LGX - LTITLEDPANEL

Hierarquia

Sintaxe

Métodos GET

Método GET: TITLE

Sintaxe

Parâmetros

Retorno

Exemplo

Método GET: HEIGHT

Sintaxe

Retorno

Exemplo

Método GET: WIDTH

Sintaxe

Retorno

Exemplo

Métodos SET

Método SET: TITLE

Sintaxe

Parâmetros

Exemplo

Método SET: BOUNDS

Sintaxe

Parâmetros

Exemplo

Método SET: WIDTH

Sintaxe

Parâmetros

Exemplo

Método SET: HEIGHT

Sintaxe

Parâmetros

Método SET: X

Sintaxe

Parâmetros

Exemplo

Método SET: Y

Sintaxe

Parâmetros

Método SET: POSITION

Sintaxe

Parâmetros

Exemplo

Método SET: ALIGN

Sintaxe

Parâmetros

Método SET: ALIGN

Sintaxe

Parâmetros

Exemplo

Método SET: SIZE

Sintaxe

Exemplo

Exemplo