Páginas filhas
  • LGX - LBROWSEEX

Versões comparadas

Chave

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

Pagetitle
LGX - LBROWSEREXLBROWSEEX
LGX - LBROWSEREX
Cria uma barra de status na janela atual.

Possui botões para visualizar detalhes sobre o programa em execução, teclas de atalho e maximar a janela atual.

InformaçõesPor padrão, este componente deve ser criado diretamente na referência da janela

LBROWSEEX
Componente gráfico no formato de tabela (grade) para edição de valores em variáveis de vetor (ARRAY).


Hierarquia



Métodos GET


Sintaxe

Bloco de código

Métodos acessíveis através da função 

_ADVPL_

create_component( NULL, "LSTATUSBAR", < cReference > )

Métodos GET

Métodos acessíveis através da função _ADVPL_get_property get_property que permite recuperar e manipular os valores do componente:


Exemplo

Expandir
titleGET COLUMN_BY_INDEX

Método GET:

TE 

COLUMN_BY_INDEX

Nome da coluna conforme índice da mesma.

Sintaxe



Bloco de código
_ADVPL_get_property( < cReferencel_table_reference >, "TEXT" )

Retorno

COLUMN_BY_INDEX",< nColumnIndex > ) ==> CHAR

Parâmetros



NomeTipoDescriçãoObrigatório
nColumnIndexINTEGERÍndica da coluna da grade da qual deseja-se retornar o nome.Sim

Retorno




TipoDescrição
CHAR
Texto 

Retorna o nome da coluna conforme o índice da mesma na grade.


Exemplo




Bloco de código
languageruby
themeConfluence
linenumberstrue
Expandir
titleGET

Método GET: TE 

Sintaxe

Bloco de código
LET l_column_name = _ADVPL_get_property( < cReference >, "TEXT" )

Retorno

TipoDescrição
CHAR

Texto 

Bloco de código
languageruby
themeConfluence
linenumberstrue
l_table_reference,"COLUMN_BY_INDEX",10)



Texto 
Expandir
titleGET COLUMN_SELECTED

Método GET:

TE 

COLUMN_SELECTED

Índice da coluna seleciona na grade.

Sintaxe




Bloco de código
_ADVPL_get_property( < cReferencel_table_reference >, "TEXTCOLUMN_SELECTED" )
Retorno
 ==> INTEGER


Retorno




TipoDescrição
CHAR
INTEGER

Índice da coluna selecionada na grade.


Exemplo




Bloco de código
languageruby
themeConfluence
linenumberstrue
LET l_column = _ADVPL_get_property(l_table_reference,"COLUMN_SELECTED")



Texto 
Expandir
titleGET COLUMN_VALUE

Método GET:

TE 

COLUMN_VALUE


Sintaxe




Bloco de código
_ADVPL_get_property( < cReferencel_table_reference >, "TEXTCOLUMN_VALUE",< )nColumn >, < nLine > ) ==> QUALQUER

Parâmetros




NomeTipoDescriçãoObrigatório?
nColumnCHARNome da coluna da grade da qual deseja-se retornar o valor.Sim
nLineINTEGERNúmero da linha da grade da qual deseja-se retornar o valor.Sim


Retorno




TipoDescrição
CHAR
QUALQUER

Valor de determinada linha e coluna da grade.


Exemplo




Bloco de código
languageruby
themeConfluence
linenumberstrue
LET l_value = _ADVPL_get_property(l_table_reference,"COLUMN_VALUE","cod_empresa",5)



Texto 
Expandir
Expandir
titleGET ITEM_COUNT

Método GET:

TE 

ITEM_COUNT

Total de linhas da grade.

Sintaxe




Bloco de código
_ADVPL_get_property( < cReference >, "TEXTITEM_COUNT" ) ==> INTEGER

Retorno




TipoDescrição
CHAR
INTEGER

Quantidade total de linhas da grade.

Exemplo




Bloco de código
languageruby
themeConfluence
linenumberstrue
Expandir
LET l_item_count = _ADVPL_get_property(l_table_reference,"ITEM_COUNT")


(informação) Veja também LGX - LTABLECOLUMNEX



Expandir
titleGET POPUP_REFERENCEtitleGET

Método GET:

TE 

POPUP_REFERENCE

Referência do menu popup da grade.

Sintaxe




Bloco de código
_ADVPL_get_property( < cReferencel_table_reference >, "TEXTPOPUP_REFERENCE" ) ==> VARCHAR

Retorno




TipoDescrição
CHAR

Texto 

VARCHAR(10)

Referência do menu popup da grade.

Exemplo




Bloco de código
languageruby
themeConfluence
linenumberstrue
LET l_popup_reference = _ADVPL_get_property(l_table_reference,"POPUP_REFERENCE")



Texto 
Expandir
titleGET ROW_SELECTED

Método GET:

TE 

ROW_SELECTED

Linha selecionada na grade.

Sintaxe




Bloco de código
_ADVPL_get_property( < cReferencel_table_reference >, "TEXTROW_SELECTED" ) ==> INTEGER

Retorno




TipoDescrição
CHAR
INTEGER

Linha selecionada na grade.

Exemplo




Bloco de código
languageruby
themeConfluence
linenumberstrue

Métodos SET

utilizando a função
LET l_row_selected  = _ADVPL_
set_property que permite alterar e manipular os valores do componente.
get_property(l_table_reference,"ROW_SELECTED")



Expandir
titleSET GET ACTIVATE_EDIT_FORM

Método

SET: TE 

GET: ACTIVATE_EDIT_FORM

Ativa/desativa a tela de edição da grade em modo formulárioExibe uma mensagem na barra de status.

Sintaxe




Bloco de código
_ADVPL_setget_property( < cReferencel_table_reference >, "TEXTACTIVATE_EDIT_FORM",< cText<l_activate> >)

Parâmetros




NomeTipoDescrição
Obrigatório
Obrigatóri?
   cText CHAR

l_activate

BOOLEANIndicador lógico que ativa/desativa a tela para edição e visualização da grade no modo formulário.Sim

Exemplo




Bloco de código
languageruby
themeConfluence
linenumberstrue
Expandir
titleSET

Método SET: TE 

Exibe uma mensagem na barra de status.

Sintaxe

Bloco de código
CALL _ADVPL_set_property(< cReference >,"TEXT",< cText >)

Parâmetros

NomeTipoDescriçãoObrigatório?   cText CHAR.Sim

Exemplo

Bloco de código
languageruby
themeConfluence
linenumberstrue
l_table_reference,"ACTIVATE_EDIT_FORM",TRUE)




Métodos SET


Uilizando a função _ADVPL_set_property que permite alterar e manipular os valores de uma propriedade do componente.


Expandir
titleSET ADD_ROW

Método SET:

TE 

ADD_ROW

Exibe uma mensagem na barra de statusInclui uma nova linha no final da grade.

Sintaxe




Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXT",< cText >)

Parâmetros

NomeTipoDescriçãoObrigatório?
   cText CHAR.Sim
ADD_ROW")

Exemplo




Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"ADD_ROW")




Expandir
titleSET ADJUST_COLUMNS_WIDTH

Método SET:

TE 

ADJUST_COLUMNS_WIDTH

Ajusta a largura das colunas conforme tamanho total atribuído para a grade e para cada uma das colunasExibe uma mensagem na barra de status.

Sintaxe




Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXT",< cText >)

Parâmetros

NomeTipoDescriçãoObrigatório?
   cText CHAR.Sim
ADJUST_COLUMNS_WIDTH")

(informação)  Este método verifica se a largura total da grade é maior que a soma das larguras das colunas e distribui este excedente proporcionalmente para cada coluna da grade.

Exemplo




Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"ADJUST_COLUMNS_WIDTH")




true
Expandir
titleSET AFTER_ADD_ROW_EVENT

Método SET:

TE 

AFTER_ADD_ROW_EVENT

Função executada após incluir uma nova linha na gradeExibe uma mensagem na barra de status.

Sintaxe




Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTAFTER_ADD_ROW_EVENT",< cTextc4GLFunction >)

Parâmetros




NomeTipoDescriçãoObrigatório?
   cText 
c4GLFunctionCHARFunção que será executada após incluir uma nova linha na grade.Sim

Exemplo

Bloco de código
languageruby
themeConfluence
linenumbers




Confluence
Expandir
titleSET AFTER_EDIT_ROW

Método SET:

TE 

AFTER_EDIT_ROW 

Função executada após a edição da linha (em qualquer coluna) da gradeExibe uma mensagem na barra de status.

Sintaxe




Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTAFTER_EDIT_ROW",< cTextc4GLFunction >)

Parâmetros




NomeTipoDescriçãoObrigatório?
   cText 
c4GLFunctionCHARFunção a ser executada após a edição da linha (em qualquer coluna) da grade.Sim

Exemplo

Bloco de código
languageruby
theme
linenumberstrue




true
Expandir
titleSET AFTER_ORDER_EVENT

Método SET:

TE 

AFTER_ORDER_EVENT 

Função executada após a ordenação de qualquer coluna da gradeExibe uma mensagem na barra de status.

Sintaxe




Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXT AFTER_ORDER_EVENT ",< cTextc4GLFunction >)

Parâmetros




NomeTipoDescriçãoObrigatório?
   cText 
c4GLFunctionCHARFunção que será executada após a ordenação de qualquer coluna da grade.Sim

Exemplo

Bloco de código
languageruby
themeConfluence
linenumbers




Confluence
Expandir
titleSET AFTER_REMOVE_ROW_EVENT

Método SET:

TE 

AFTER_REMOVE_ROW_EVENT 

Exibe uma mensagem na barra de status.

Sintaxe




Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTAFTER_REMOVE_ROW_EVENT",< cTextc4GLFunction >)

Parâmetros




NomeTipoDescriçãoObrigatório?
   cText 
c4GLFunctionCHARFunção 4GL que será executada após excluir qualquer linha da grade.Sim

Exemplo

Bloco de código
languageruby
theme
linenumberstrue




Exemplo

Expandir
titleSET AFTER_ROW_EVENT

Método SET:

TE 

AFTER_ROW_EVENT 

Função executada após sair de qualquer linha da gradeExibe uma mensagem na barra de status.

Sintaxe




Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTAFTER_ROW_EVENT",< cTextc4GLFunction >)

Parâmetros




NomeTipoDescriçãoObrigatório?
   cText 
c4GLFunctionCHAR
.Sim
Bloco de código
languageruby
themeConfluence
linenumberstrue
Função que será executada após sair de qualquer linha da grade.Sim

(informação)  Importante: esta função deverá retornar um indicador lógico que define se será permitido o usuário sair da linha ou não.




(informação) Importante: esta função deverá retornar um indicador lógico que define se permitirá ou não a inclusão da nova linha no final da grade.




Expandir
titleSET BEFORE_ADD_ROW_EVENT

Método SET:

TE 

BEFORE_ADD_ROW_EVENT

Função executada antes de incluir uma nova linha na gradeExibe uma mensagem na barra de status.

Sintaxe




Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTBEFORE_ADD_ROW_EVENT",< cTextc4GLFunction >)

Parâmetros




NomeTipoDescriçãoObrigatório?
   cText 
c4GLFunctionCHARFunção que será executada antes de incluir uma nova linha na grade.Sim

Exemplo

Bloco de código
languageruby
themeConfluence
linenumberstrue

(informação) Importante: esta função deverá retornar um indicador lógico que define se permitirá ou não a edição da linha da grade.




Expandir
titleSET BEFORE_EDIT_ROW

Método SET:

TE 

BEFORE_EDIT_ROW

Função executada antes da edição da linha (em qualquer coluna) da gradeExibe uma mensagem na barra de status.

Sintaxe




Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTBEFORE_EDIT_ROW",< cTextc4GLFunction >)

Parâmetros




NomeTipoDescriçãoObrigatório?
   cText 
c4GLFunctionCHARFunção a ser executada antes da edição da linha (em qualquer coluna) da grade.Sim

Exemplo

Bloco de código
languageruby
themeConfluence
linenumberstrue

Exemplo

Expandir
titleSET BEFORE_ORDER_EVENT

Método SET:

TE 

BEFORE_ORDER_EVENT

Função executada antes da ordenação de qualquer coluna da gradeExibe uma mensagem na barra de status.

Sintaxe




Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTBEFORE_ORDER_EVENT",< cTextc4GLFunction >)

Parâmetros




NomeTipoDescriçãoObrigatório
?
   cText 
c4GLFunctionCHAR
.Sim
Bloco de código
languageruby
themeConfluence
linenumberstrue
Função que será acionada antes da ordenação de qualquer coluna da grade.Sim

(informação) Importante: esta função deverá retornar um indicador lógico que define se a ordenação será ou não realizada.




(informação) Importante: esta função deverá retornar um indicador lógico que define se a exclusão da linha será ou não realizada.




Expandir
titleSET BEFORE_REMOVE_ROW_EVENT

Método SET:

TE 

BEFORE_REMOVE_ROW_EVENT

Função executada antes de excluir qualquer linha da gradeExibe uma mensagem na barra de status.

Sintaxe




Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTBEFORE_REMOVE_ROW_EVENT",< cTextc4GLFunction >)

Parâmetros




NomeTipoDescriçãoObrigatório?
   cText 
c4GLFunctionCHARFunção que será executada antes de excluir qualquer linha da grade.Sim

Exemplo

Bloco de código
languageruby
themeConfluence
linenumberstrue
true
Expandir
titleSET BEFORE_ROW_EVENT

Método SET:

TE 

BEFORE_ROW_EVENT

Função executada antes de entrar em qualquer linha da gradeExibe uma mensagem na barra de status.

Sintaxe




Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTBEFORE_ROW_EVENT",< cTextc4GLFunction >)

Parâmetros




NomeTipoDescriçãoObrigatório?
   cText 
c4GLFunctionCHARFunção que será executada antes de entrar em qualquer linha da grade.Sim

Exemplo

Bloco de código
languageruby
themeConfluence
linenumbers




Expandir
titleSET CAN_ADD_ROW

Método SET:

TE 

CAN_ADD_ROW

Habilita/desabilita a inclusão de novas linhas na gradeExibe uma mensagem na barra de status.

Sintaxe




Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTCAN_ADD_ROW",< cTextnCanAddRow >)

Parâmetros




NomeTipoDescriçãoObrigatório?
   cText 
nCanAddRow
CHAR
BOOLEANIndicador lógico que habilita/desabilita a inclusão de novas linhas na grade.Sim

Exemplo



Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"CAN_ADD_ROW",FALSE)




Expandir
titleSET CAN_COPY_ROW

Método SET:

TE 

CAN_COPY_ROW

Habilita/desabilita a cópia de linhas da gradeExibe uma mensagem na barra de status.

Sintaxe




Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTCAN_COPY_ROW",< cTextnCanCopyRow >)

Parâmetros




NomeTipoDescriçãoObrigatório?
   cText 
nCanCopyRow
CHAR
BOOLEANIndicador lógico que habilita/desabilita a cópia de linhas na grade.Sim

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
Expandir
titleSET
CALL _ADVPL_set_property(l_table_reference,"CAN_COPY_ROW",FALSE)




Exemplo

Expandir
titleSET CAN_REMOVE_ROW

Método SET: CAN_REMOVE_ROW

Habilita/desabilita a exclusão de linhas da grade

Método SET: TE 

Exibe uma mensagem na barra de status.

Sintaxe


Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTCAN_REMOVE_ROW",< cTextnCanRemoveRow >)

Parâmetros


NomeTipoDescriçãoObrigatório?
   cText 
nCanRemoveRow
CHAR.Sim
BOOLEANIndicador lógico que habilita/desabilita a exclusão de linhas na grade.Sim

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"CAN_REMOVE_ROW",FALSE)




Exemplo


Expandir
titleSET CLEAR

Método SET:

TE 

CLEAR

Remove todas as linhas da grade reinicia qualquer ordenação de coluna feita pelo usuárioExibe uma mensagem na barra de status.

Sintaxe


Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXT",< cText >CLEAR")

Parâmetros

NomeTipoDescriçãoObrigatório?
   cText CHAR.Sim
Bloco de código

Exemplo

Bloco de código
languageruby
themeConfluence
linenumberstrue
Expandir
titleSET

Método SET: TE 

Exibe uma mensagem na barra de status.

Sintaxe

Bloco de código
CALL _ADVPL_set_property(< cReference >l_table_reference,"TEXT",< cText >CLEAR")
Parâmetros




Exemplo

Exemplo

Expandir
NomeTipoDescriçãoObrigatório?
   cText CHAR.Sim
titleSET CLEAR_ALL_ATTRIBUTES

Método SET: CLEAR_ALL_ATTRIBUTES

Define se na exclusão de determinada linha da grade, todos os atributos da variável de controle nesta linha, serão inicializados

Bloco de código
languageruby
themeConfluence
linenumberstrue
Expandir
titleSET

Método SET: TE 

Exibe uma mensagem na barra de status.

Sintaxe


Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTCLEAR_ALL_ATTRIBUTES",< cTextnStatus >)

Parâmetros


NomeTipoDescriçãoObrigatório?
   cText 
nStatus
CHAR.Sim
BOOLEANIndicador lógico que define se na exclusão de determinada linha da grade, todos os atributos da variável de controle nesta linha, serão inicializados.Sim

(informação) O padrão deste método é TRUE, ele define se ao excluir uma determinada linha da grade, todos os atributos da variável de controle serão excluídos ou somente os que estão visíveis na grade.


Exemplo:
   A variável possui os atributos: campo1, campo2 e campo3, a grade está exibindo apenas os atributos: campo2 e campo3.
   Ao excluir a linha, se este método estiver ativado (TRUE), serão limpos os atributos campo1, campo2 e campo3, caso contrário (FALSE) será limpo apenas os atributos campo2 e campo3 da variável.

Exemplo


Bloco de código
Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"CLEAR_ALL_ATTRIBUTES",FALSE)




Expandir
titleSET CLEAR_ALL_LINE_COLOR
Expandir
titleSET

Método SET:

TE 

CLEAR_ALL_LINE_COLOR

Restaura a cor padrão para todas as linhas da gradeExibe uma mensagem na barra de status.

Sintaxe


Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXT",< cText >)

Parâmetros

NomeTipoDescriçãoObrigatório?
   cText CHAR.Sim
CLEAR_ALL_LINE_COLOR")

Exemplo


Exemplo

Bloco de código
languageruby
themeConfluence
linenumberstrue
Expandir
titleSET

Método SET: TE 

Exibe uma mensagem na barra de status.

Sintaxe

Bloco de código
CALL _ADVPL_set_property(< cReference >,"TEXT",< cText >)

Parâmetros

l_table_reference,"CLEAR_ALL_LINE_COLOR")




Exemplo

Expandir
titleSET CLEAR_ALL_LINE_FONT_COLOR

Método SET: CLEAR_ALL_LINE_FONT_COLOR

Restaura a cor padrão da fonte para todas as linhas da grade.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference  >,"CLEAR_ALL_LINE_FONT_COLOR")

Exemplo


Bloco de código
language
NomeTipoDescriçãoObrigatório?
   cText CHAR.Sim
Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"CLEAR_ALL_LINE_FONT_COLOR")




Expandir
titleSET CLEAR_LINE_COLOR

Método SET:

TE 

CLEAR_LINE_COLOR

Restaura a cor padrão para um determinada linha da gradeExibe uma mensagem na barra de status.

Sintaxe


Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTCLEAR_LINE_COLOR",< cTextnLine >)

Parâmetros


NomeTipoDescriçãoObrigatório?
   cText 
nLine
CHAR
INTEGERNúmero da linha da qual terá a cor de fundo restaurada.Sim

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
Expandir
titleSET

Método SET: TE 

Exibe uma mensagem na barra de status.

Sintaxe

Bloco de código
CALL _ADVPL_set_property(< cReference >,"TEXT",< cText >)

Parâmetros

NomeTipoDescriçãoObrigatório?   cText CHAR.Sim

Exemplo

true
Bloco de código
languageruby
themeConfluence
linenumbers
l_table_reference,"CLEAR_LINE_COLOR",5)




Expandir
titleSET CLEAR_LINE_FONT_COLOR

Método SET:

TE 

CLEAR_LINE_FONT_COLOR

Restaura a cor padrão da fonte de uma determinada linha da gradeExibe uma mensagem na barra de status.

Sintaxe


Bloco de código
_ADVPL_set_property(< cReference l_table_reference >,"TEXTCLEAR_LINE_FONT_COLOR",< cText nLine >)

Parâmetros


NomeTipoDescriçãoObrigatório?
   cText 
nLine
CHAR
INTEGERNúmero da linha que terá a cor da fonte restaurada.Sim

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"CLEAR_LINE_FONT_COLOR",5)




Expandir
titleSET COLUMN_VALUE

Método SET:

TE 

COLUMN_VALUE

Atribui o valor de uma determinada linha e coluna da gradeExibe uma mensagem na barra de status.

Sintaxe


Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXT",< cTextCOLUMN_VALUE",< nColumn >, < nLine >, < uValue >)

Parâmetros


NomeTipoDescriçãoObrigatório?
   cText 
nColumn
CHAR
INTEGERNome da coluna da grade da qual será atribuído o valor.Sim
Exemplo
nLine
Bloco de código
languageruby
themeConfluence
linenumberstrue
Expandir
titleSET
INTEGERNúmero da linha da grade da qual será atribuído o valor.Sim
uValueQUALQUERNúmero da coluna da grade da qual será atribuído o valor.Sim

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL 

Método SET: TE 

Exibe uma mensagem na barra de status.

Sintaxe

Bloco de código
_ADVPL_set_property(< cReference >,"TEXT",< cText >)

Parâmetros

NomeTipoDescriçãoObrigatório?   cText CHAR.Sim

Exemplo

Bloco de código
languageruby
themeConfluence
linenumberstrue
l_table_reference,"COLUMN_VALUE","cod_empresa",5,"50")




Expandir
titleSET COPY_ROW

Método SET: COPY_ROW

Copia uma determinada linha para uma nova criada no final da grade

Expandir
titleSET

Método SET: TE 

Exibe uma mensagem na barra de status.

Sintaxe


Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTCOPY_ROW",< cTextnLine >)

Parâmetros


NomeTipoDescriçãoObrigatório?
   cText 
nLine
CHAR
INTEGERNúmero da linha da grade que será copiada.Sim

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"COPY_ROW",5)




Expandir
titleSET ENABLE_EDIT_MODE

Método SET:

TE 

ENABLE_EDIT_MODE

Habilita/desabilita a edição e visualização da grade em modo formulárioExibe uma mensagem na barra de status.

Sintaxe


Bloco de código
_ADVPL_set_property(< cReferencel_table_reference  >,"TEXTENABLE_EDIT_MODE",< cTextnEnable >)

Parâmetros


NomeTipoDescriçãoObrigatório?
   cText 
nEnable
CHAR
BOOLEANIndicador lógico que define se será habilitada ou não a edição e visualização da grade no modo formulário.Sim

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
Expandir
titleSET

Método SET: TE 

Exibe uma mensagem na barra de status.

Sintaxe

Bloco de código
CALL _ADVPL_set_property(< cReference >,"TEXT",< cText >)

Parâmetros

NomeTipoDescriçãoObrigatório?   cText CHAR.Sim

Exemplo

Bloco de código
languageruby
themeConfluence
linenumberstrue
Expandir
titleSET
l_table_reference,"ENABLE_EDIT_MODE",FALSE)




language
Expandir
titleSET HEADER_CLICK_EVENT

Método SET: HEADER_CLICK_EVENT

Função executada ao clicar no cabeçalho de qualquer coluna da grade

Método SET: TE 

Exibe uma mensagem na barra de status.

Sintaxe


Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >, "TEXTHEADER_CLICK_EVENT", < cTextc4GLFunction >)

Parâmetros


NomeTipoDescriçãoObrigatório
?
   cText 
c4GLFunctionCHARFunção a ser executada ao clicar no cabeçalho de qualquer coluna da grade.Sim

Exemplo

Bloco de código
rubythemeConfluencelinenumberstrue




Expandir
titleSET ITEM_COUNT

Método SET:

TE 

ITEM_COUNT

Quantidade total de linhas da gradeExibe uma mensagem na barra de status.

Sintaxe


Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTITEM_COUNT",< cTextnLines >)

Parâmetros


NomeTipoDescriçãoObrigatório?
   cText 
nLines
CHAR.
INTEGERQuantidade total de linhas que será definida na grade.Sim

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"ITEM_COUNT",10)




Exemplo

Expandir
titleSET LINE_COLOR

Método SET:

TE 

LINE_COLOR

Cor de fundo para uma determinada linha da gradeExibe uma mensagem na barra de status.

Sintaxe


Bloco de código
_ADVPL_set_property(< cReferencel_table_reference >,"TEXTLINE_COLOR",< cText >)

Parâmetros

NomeTipoDescriçãoObrigatório?
   cText CHAR.Sim
Bloco de código
languageruby
themeConfluence
linenumberstrue
Expandir
titleSET

Método SET: TE 

Exibe uma mensagem na barra de status.

Sintaxe

Bloco de código
_ADVPL_set_property(< cReference >,"TEXT",< cTextnLine >, < nRedLevel >, < nGreenLevel >, < nBlueLevel >)

Parâmetros


NomeTipoDescriçãoObrigatório?
   cText 
nLine
CHAR
INTEGERNúmero da linha da qual será alterada a cor de fundo.Sim
Exemplo
nRedLevel
Bloco de código
languageruby
themeConfluence
linenumberstrue
Expandir
titleSET
INTEGERNúmero correspondente ao nível de vermelho da cor (R do RGB).Sim
nGreenLevelINTEGERNúmero correspondente ao nível de verde da cor (G do RGB).Sim
nBlueLevelINTEGERNúmero correspondente ao nível de azul da cor (B do RGB)

Método SET: TE 

Exibe uma mensagem na barra de status.

Sintaxe

Bloco de código
_ADVPL_set_property(< cReference >,"TEXT",< cText >)

Parâmetros

NomeTipoDescriçãoObrigatório?   cText CHAR
.Sim

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"LINE_COLOR",5,255,175,175)




Expandir
titleSET LINE_FONT_COLOR

Método SET: LINE_FONT_COLOR

Cor da fonte para uma determinada linha da grade.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"LINE_FONT_COLOR",< nLine >, < nRedLevel >, < nGreenLevel >, < nBlueLevel >)

Parâmetros


NomeTipoDescriçãoObrigatório?
nLineINTEGERNúmero da linha da qual será alterada a cor de fundo.Sim
nRedLevelINTEGERNúmero correspondente ao nível de vermelho da cor (R do RGB).Sim
nGreenLevelINTEGERNúmero correspondente ao nível de verde da cor (G do RGB).Sim
nBlueLevelINTEGERNú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(l_table_reference,"LINE_FONT_COLOR",5,255,0,0)




Expandir
titleSET REMOVE_EMPTY_ROWS

Método SET: REMOVE_EMPTY_ROWS

Remove todas as linhas em branco da grade.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"REMOVE_EMPTY_ROWS")

(informação) Este método verifica linha após linha se alguma coluna foi informada, caso nenhuma coluna tenha informação, a linha verificada é excluída.

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"REMOVE_EMPTY_ROWS")




Expandir
titleSET REMOVE_ROW

Método SET: REMOVE_ROW

Remove uma determinada linha da grade.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"REMOVE_ROW",< nLine >)

Parâmetros


NomeTipoDescriçãoObrigatóro
nLine INTEGERNúmero da linha que será removida.Sim

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"REMOVE_ROW",5)




Expandir
titleSET SELECT_COLUMN

Método SET: SELECT_COLUMN

Posiciona o foco para uma determinada coluna da grade.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"SELECT_COLUMN",< nColumn >)

Parâmetros


NomeTipoDescriçãoObrigatório?
nColumnINTEGERNúmero da coluna da qual o foco deverá ficar posicionado.Sim

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"SELECT_COLUMN",10)




Expandir
titleSET SELECT_ITEM

Método SET: SELECT_ITEM

Posiciona o foco para uma determinada linha e coluna da grade.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"SELECT_ITEM",< nLine >,< nColumn >)

Parâmetros


NomeTipoDescriçãoObrigatório?
nLineINTEGERNúmero da linha da qual o foco deverá ficar posicionado.Sim
nColumnINTEGERNúmero da coluna da qual o foco deverá ficar posicionado.Sim

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"SELECT_ITEM",5,10)




Expandir
titleSET SET_ROWS

Método SET: SET_ROWS

Define a variável que irá controlar os valores e a quantidade de linhas inicias que será atribuída para a grade.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"SET_ROWS",< oArrayOfRecord >, [ nLines ] )

Parâmetros


NomeTipoDescriçãoObrigatório?
oArrayOfRecordARRAY OF RECORDVariável ARRAY OF RECORD que irá controlar os valores da grade. Os atributos deste ARRAY deverá ter o mesmo nome das colunas criadas na grade.Sim
nLinesINTEGERQuantidade de linhas iniciais que será atribuída para a grade.Sim

(informação) Importante: este método deverá ser chamado apenas uma vez para cada componente criado. Caso deseja-se alterar a quantidade de linhas da grade, utilizar o método "ITEM_COUNT".

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"SET_ROWS",ma_variable,1)




Expandir
titleSET VARIABLE

Método SET: VARIABLE

Define a variável que irá controlar os valores da grade.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_grid_reference >,"VARIABLE",< oArrayOfRecord >)

Parâmetros


NomeTipoDescriçãoObrigatório?
oArrayOfRecordARRAY OF RECORDVariável ARRAY OF RECORD que irá controlar o valores da grade. Os atributos deste ARRAY OF RECORD deverão ter o mesmo nome dos componentes criados na grade.Sim

(informação) Importante: Este método deverá ser chamado apenas uma vez para cada componente criado.

Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"VARIABLE",ma_variable)





Exemplo


Expandir
titleExemplo de utilização

(informação) Importante: esta grid é para edição por coluna, caso deseja uma grid para consulta, utilize o componente LTableEx.

Bloco de código
languageruby
themeConfluence
linenumberstrue
DEFINE ma_variable ARRAY[100] OF RECORD
                                 componente CHAR(50),
                                 metodo     ARRAY[100] OF CHAR(50)
                                 END RECORD

#--------------------#
 FUNCTION LBrowseEx()
#--------------------#
     DEFINE l_value            CHAR(50)
     DEFINE l_variable         CHAR(50)
     DEFINE l_row              SMALLINT
     DEFINE l_column           SMALLINT
     DEFINE l_table_width      SMALLINT
     DEFINE l_dialog_reference VARCHAR(10)
     DEFINE l_table_reference  VARCHAR(10)
     DEFINE l_column_reference VARCHAR(10)
     # Neste exemplo será construída uma grade onde o número de colunas
     # pode ser indefinido.
     LET l_table_width = 0
     INITIALIZE ma_variable TO NULL

     LET l_dialog_reference = _ADVPL_create_component(NULL,"LDIALOG")
     CALL _ADVPL_set_property(l_dialog_reference,"SIZE",650,250)
     CALL _ADVPL_set_property(l_dialog_reference,"TITLE","Ex.: LBROWSEEX")

     LET l_table_reference = _ADVPL_create_component(NULL,"LBROWSEEX",l_dialog_reference)
     CALL _ADVPL_set_property(l_table_reference,"ENABLE",TRUE)
     CALL _ADVPL_set_property(l_table_reference,"EDITABLE",TRUE)
     CALL _ADVPL_set_property(l_table_reference,"ALIGN","CENTER")

     LET l_column_reference = _ADVPL_create_component(NULL,"LTABLECOLUMNEX",l_table_reference)
     CALL _ADVPL_set_property(l_column_reference,"ALIGN","LEFT")
     CALL _ADVPL_set_property(l_column_reference,"EDITABLE",FALSE)
     CALL _ADVPL_set_property(l_column_reference,"COLUMN_WIDTH",100)
     CALL _ADVPL_set_property(l_column_reference,"HEADER","Componente")
     CALL _ADVPL_set_property(l_column_reference,"VARIABLE","componente")

     LET l_table_width = l_table_width + 100
     # Cria as linhas e colunas
     FOR l_row = 1 TO 10
         LET l_value = "componente ",l_row USING "<<&&&"
         LET ma_variable[l_row].componente = l_value
         FOR l_column = 1 TO 4
             LET l_value = "metodo ",l_row USING "<<&&&",":",l_column USING "<<&&&"
             LET ma_variable[l_row].metodo[l_column] = l_value
             IF  l_row = 1 THEN
                 # Na varíavel, a primeira posição é o valor e a segunda é o
                 # cabeçalho.
                 LET l_value    = "Método ",l_column USING "<<&&&"
                 LET l_variable = "metodo[",l_column USING "<<<<<","]"
                 LET l_column_reference = _ADVPL_create_component(NULL,"LTABLECOLUMNEX",l_table_reference)
                 CALL _ADVPL_set_property(l_column_reference,"ALIGN","LEFT")
                 CALL _ADVPL_set_property(l_column_reference,"EDITABLE",TRUE)
                 CALL _ADVPL_set_property(l_column_reference,"COLUMN_WIDTH",50)
                 CALL _ADVPL_set_property(l_column_reference,"HEADER",l_value)
                 CALL _ADVPL_set_property(l_column_reference,"VARIABLE",l_variable)
                 CALL _ADVPL_set_property(l_column_reference,"EDIT_COMPONENT","LTEXTFIELD")
                 CALL _ADVPL_set_property(l_column_reference,"EDIT_PROPERTY","LENGTH",20)
                 CALL _ADVPL_set_property(l_column_reference,"EDIT_PROPERTY","PICTURE","@&")
                 # Efetua a soma das colunas somente na primeira linha.
                 LET l_table_width = l_table_width + 50
             END IF
         END FOR
     END FOR

     # Atualiza a grade com os tamanhos de colunas corretos, linhas e variável.

Exemplo

Expandir
titleExemplo de utilização
Bloco de código
languageruby
themeConfluence
linenumberstrue
#--------------------#
 FUNCTION statusbar()
#--------------------#
     DEFINE l_dialog_reference,
            l_statusbar_reference VARCHAR(10)

     LET l_dialog_reference = _ADVPL_create_component(NULL,"LDIALOG")
     CALL _ADVPL_set_property(l_dialog_reference,"FORM_INFO","Exemplo de utilização do componente LSTATUSBAR.")
     CALL _ADVPL_set_property(l_dialog_reference,"FORM_NAME","dlg_statusbar")
     CALL _ADVPL_set_property(l_dialogtable_reference,"SIZE",400,400l_table_width,250)
     CALL _ADVPL_set_property(l_dialogtable_reference,"TITLE","Exemplo de Utilização: LSTATUSBARADJUST_COLUMNS_WIDTH")

     LETCALL l_statusbar_reference = _ADVPL_create_component(NULL,"LSTATUSBAR",l_dialog_referenceADVPL_set_property(l_table_reference,"SET_ROWS",ma_variable,(l_row - 1))
     CALL _ADVPL_set_property(l_statusbartable_reference,"INFO_TEXT","Exemplo de mensagem informativa.REFRESH")
     CALL _ADVPL_set_property(l_statusbardialog_reference,"VISIBLE_HOTKEYMAXIMIZED",FALSE)

     CALL _ADVPL_set_property(l_dialog_reference,"ACTIVATE",TRUE) 
 END FUNCTION         


Visualização


Image RemovedImage Added