Linha Logix

Páginas filhas
  • LGX - LTABLECOLUMNEX

Versões comparadas

Versão antiga 1

changes.mady.by.user Ieda Ferreira Alves Flock

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Ieda Ferreira Alves Flock

Gravado em

Chave

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

Pagetitle
LGX - LTABLECOLUMNEX
LGX - LTABLECOLUMNEX
Componente que permite criar as colunas em grades do tipo LTableEx e LBrowseEx.


Hierarquia


Métodos GET

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


Expandir
titleGET EDIT_COMPONENT

Método GET: EDIT_COMPONENT

Componente freeform de edição da coluna.

Sintaxe


Bloco de código
_ADVPL_get_property(l_column_reference,"EDIT_COMPONENT") ==> Componente

Retorno


TipoDescrição
CHAR

Componente freeform utilizado na edição da coluna.


Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
LET l_edit_component = _ADVPL_get_property(l_column_reference,"EDIT_COMPONENT")


Expandir
titleGET HEADER

Método GET:

ED 

HEADER

Cabeçalho da coluna.

Sintaxe


Bloco de código
_ADVPL_get_property(l_column_reference,"EDIT_COMPONENTHEADER") ==> ComponenteCabeçalho

Retorno


TipoDescrição
CHAR

Texto de cabeçalho da coluna.


Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
LET l_header = _ADVPL_get_property(l_column_reference,"HEADER")


Expandir
titleGET IMAGE_HEADER

Método GET:

ED 

IMAGE_HEADER

Imagem de cabeçalho da coluna.

Sintaxe


Bloco de código
_ADVPL_get_property(l_column_reference,"EDITIMAGE_COMPONENTHEADER") ==> ComponenteImagem

Retorno


TipoDescrição
CHAR

Nome da imagem do RPO utilizada no cabeçalho da coluna.


Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
LET l_image_header = _ADVPL_get_property(l_column_reference,"IMAGE_HEADER")


Exemplo

Expandir
titleGET INDEX_COLUMN

Método GET:

ED 

INDEX_COLUMN

Índice da coluna na grade.

Sintaxe


Bloco de código
_ADVPL_get_property(l_column_reference,"EDITINDEX_COMPONENTCOLUMN") ==> ComponenteÍndice

Retorno


CHAR
TipoDescrição
( )

Índice da coluna na grade.


Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
Expandir
titleGET

Método GET: ED 

Sintaxe

Bloco de código
_ADVPL_LET l_index_column = _ADVPL_get_property(l_column_reference,"EDITINDEX_COMPONENT") ==> Componente

Retorno

TipoDescrição
CHAR
true
Bloco de código
languageruby
themeConfluence
linenumbers
COLUMN")


Exemplo

Expandir
titleGET NO_VARIABLE

Método GET:

ED 

NO_VARIABLE

Retorna se coluna não possui variável.

Sintaxe


Bloco de código
_ADVPL_get_property(l_column_reference,"EDITNO_COMPONENTVARIABLE") ==> Possui Componentevariável?

Retorno


TipoDescrição
CHAR
BOOLEAN

Retorna um indicador lógico informando se a coluna possui ou não variável definida.


Exemplo


Bloco de código
languageruby
Bloco de código
languageruby
themeConfluence
linenumberstrue
LET l_no_variable = _ADVPL_get_property(l_column_component,"NO_VARIABLE")


Expandir
titleGET ROW_SELECTED

Método GET:

ED 

ROW_SELECTED

Linha selecionada na grade.

Sintaxe


Bloco de código
_ADVPL_get_property(l_column_reference,"EDITROW_COMPONENTSELECTED") ==> ComponenteLinha

Retorno


CHAR
TipoDescrição
( )

Linha selecionada na grade.


Exemplo


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


Expandir
titleGET VALUEtitleGET

Método GET:

ED 

VALUE

Valor da coluna.

Sintaxe


Bloco de código
_ADVPL_get_property(l_column_reference,"EDIT_COMPONENT"< Linha > ) ==> Componente

Parâmetros

Retorno


NomeTipoDescrição
CHAR
Obrigatório?
 Linha INTEGERNúmero da linha da qual deseja-se retornar o valor da coluna.Sim


Exemplo


Bloco de código
languageruby
themeConfluence
linenumberstrue
LET l_value = _ADVPL_get_property(l_column_reference,"VALUE")



Métodos SET

utilizando a função _ADVPL_set_property que permite alterar e manipular os valores do componente.


Expandir
titleSET ADDAFTER_EDIT_ROWEVENT

Método SET:

ADD

AFTER_EDIT_

ROW

EVENT

Função executada após finalizar a edição da coluna

Inclui uma nova linha no final da grade.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"ADDAFTER_EDIT_ROW"EVENT",< Função >)
Exemplo

Parâmetros

code


Nome
language
Tipo
ruby
Descrição
theme
Obrigatório?
Confluence
Função
linenumberstrue
CHARFunção que será executada após finalizar a edição da coluna.Sim
CALL _ADVPL_set_property(l_table_reference,"ADD_ROW")



Expandir
titleSET ADJUSTBEFORE_COLUMNSEDIT_WIDTHEVENT

Método SET:

ADJUST

BEFORE_

COLUMNS

EDIT_

WIDTH

EVENT

Função executada antes de iniciar a edição da coluna

Ajusta a largura das colunas conforme tamanho total atribuído para a grade e para cada uma das colunas.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"ADJUSTBEFORE_COLUMNSEDIT_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
EVENT",< Função >)

Parâmetros


NomeTipoDescriçãoObrigatório?
 Função CHARFunção a ser executada antes de iniciar a edição da coluna.Sim

(informação) Importante: esta função deverá retornar um identificador lógico que define se será permitida ou não a edição da coluna.

CALL _ADVPL_set_property(l_table_reference,"ADJUST_COLUMNS_WIDTH")



expandtitleSET AFTER
Expandir
titleSET AFTER_ADD_ROW_EVENTBLANK

Método SET:

AFTER_ADD_ROW_EVENT

BLANK

Define se a coluna, caso não for informado, fique com o valor em branco ao invés de nuloFunção executada após incluir uma nova linha na grade.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"AFTER_ADD_ROW_EVENT",< Função"BLANK",<  Permite valor em branco? >)

Parâmetros


NomeTipoDescriçãoObrigatório?
 Permite valor em branco?BOOLEANIdentificador lógico que define que, caso a coluna não seja informado, a coluna receberá o valor em branco ao invés de nuloFunçãoCHARFunção que será executada após incluir uma nova linha na grade.Sim


Exemplo


Bloco de código
CALL _ADVPL_set_property(l_column_reference,"BLANK",TRUE)




EDIT_ROW


Expandir
titleSET CLEAR_EDIT_PROPERTY

Método SET: CLEAR_EDIT_PROPERTY

Limpa todas as propriedades definidas para o componente de edição

Método SET: AFTER_EDIT_ROW 

Função executada após a edição da linha (em qualquer coluna) da grade.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"AFTERCLEAR_EDIT_ROW",< Função >PROPERTY")
Parâmetros

Exemplo

NomeTipoDescriçãoObrigatório?
FunçãoCHARFunção a ser executada após a edição da linha (em qualquer coluna) da grade.Sim
Bloco de código
CALL _ADVPL_set_property(l_column_reference,"CLEAR_EDIT_PROPERTY")




Expandir
titleSET AFTERCOLUMN_ORDER_EVENT WIDTH

Método SET:

AFTER

COLUMN_

ORDER_EVENT 

WIDTH

Largura da coluna em pixels

Função executada após a ordenação de qualquer coluna da grade.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >," AFTER_ORDER_EVENT COLUMN_WIDTH",< FunçãoLargura >)

Parâmetros


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


Exemplo


Bloco de código
CALL _ADVPL_set_property(l_column_reference,"COLUMN_WIDTH",50)




Expandir
titleSET AFTER_REMOVE_ROW_EVENT EDIT_COMPONENT

Método SET:

AFTER_REMOVE_ROW_EVENT 

EDIT_COMPONENT

Componente freeform de edição da colunaExibe uma mensagem na barra de status.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"AFTER_REMOVE_ROW_EVENTEDIT_COMPONENT",< FunçãoComponente >)

Parâmetros


NomeTipoDescriçãoObrigatório?
FunçãoComponenteCHARFunção Componente freeform que será executada após excluir qualquer linha da grade.Sim
Expandir
titleSET AFTER_ROW_EVENT
utilizado para editar o valor da coluna.Sim

(informação) Se este método não for executado, não será possível efetuar a edição do componente.

Exemplo


Bloco de código
CALL

Método SET: AFTER_ROW_EVENT 

Função executada após sair de qualquer linha da grade.

Sintaxe

Bloco de código
_ADVPL_set_property(< l_tablecolumn_reference >,"AFTEREDIT_ROW_EVENT",< Função COMPONENT","LTEXTFIELD")




Expandir
titleSET PICTURE

Método SET: PICTURE

Propriedade do componente de edição.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"PICTURE",< Propriedade/Método >, < Valores>>)

Parâmetros


NomeTipoDescriçãoObrigatório?
FunçãoPropriedade/MétodoCHARFunção Nome da propriedade que será executada após sair de qualquer linha da gradedefinida para o componente de edição.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.

ValoresQUALQUERValores da propriedade que será definida para o componente de edição.Sim

(informação) As propriedades do componente de edição podem ser encontradas na documentação do componente freeform definida no método EDIT_COMPONENT.

Exemplo


Bloco de código
CALL _ADVPL_set_property(l_column_reference,"EDIT_PROPERTY","PICTURE","@!")




Expandir
titleSET HEADER

Método SET: HEADER

Cabeçalho da coluna

Expandir
titleSET BEFORE_ADD_ROW_EVENT

Método SET: BEFORE_ADD_ROW_EVENT

Função executada antes de incluir uma nova linha na grade.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"BEFORE_ADD_ROW_EVENTHEADER",< FunçãoCabeçalho >)

Parâmetros


NomeTipoDescriçãoObrigatório?
   FunçãoCabeçalhoCHARFunção que será executada antes de incluir uma nova linha na gradeTexto de cabeçalho da coluna.Sim
(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.


Exemplo


Bloco de código
CALL _ADVPL_set_property(l_column_reference,"HEADER","Component")




Expandir
titleSET BEFOREHEADER_EDITCLICK_ROWEVENT

Método SET:

BEFORE

HEADER_

EDIT

CLICK_

ROW

EVENT 

Função executada antes da edição da linha (em qualquer coluna) da gradeao clicar no cabeçalho da coluna.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"BEFOREHEADER_EDITCLICK_ROWEVENT",< Função >)

Parâmetros


NomeTipoDescriçãoObrigatório?
FunçãoCHARFunção a ser executada antes da edição da linha (em qualquer coluna) da grade.Sim
(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.
ao clicar no cabeçalho da coluna.Sim



(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_ORDER_EVENTIMAGE

Método SET:

BEFORE_ORDER_EVENT

IMAGE

Define uma ou várias imagens a serem exibidas na colunaFunção executada antes da ordenação de qualquer coluna da grade.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"BEFORE_ORDER_EVENTIMAGE",< FunçãoImagem >)

Parâmetros


NomeTipoDescriçãoObrigatório?
FunçãoImagemCHARFunção que será acionada antes da ordenação de qualquer coluna da gradeNome da imagem ou um texto com as condições para que a imagem seja exibida na coluna.Sim

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

Expandir
titleSET BEFORE_REMOVE_ROW_EVENT

Para este método, pode-se informar o nome das imagens de duas formas:

  • Fixo: informa o nome de apenas uma imagem que será exibida para todas as linhas da coluna (apenas para colunas que não possuem valor);
    • Ex.: CHECKED
  • Variável:informa no formato de parâmetro, o valor e o nome da imagem que a coluna deverá exibir caso a mesma estiver com o valor definido;
    • Ex.: {'S','CHECKED'}{'N','UNCHECKED'}

Exemplo


Bloco de código
CALL

Método SET: BEFORE_REMOVE_ROW_EVENT

Função executada antes de excluir qualquer linha da grade.

Sintaxe

Bloco de código
_ADVPL_set_property(< ll_tablecolumn_reference >,"BEFORE_REMOVE_ROW_EVENT",< Função >)

Parâmetros

NomeTipoDescriçãoObrigatório?
FunçãoCHARFunção que será executada antes de excluir qualquer linha da grade.Sim
Expandir
IMAGE","{'S','CHECKED'}{'N','UNCHECKED'}")




Expandir
titleSET IMAGE_COLUMN

Método SET: IMAGE_COLUMN

Assume o valor da coluna como o nome da imagem a ser exibida.

Sintaxe


Bloco de código
_ADVPL_
titleSET BEFORE_ROW_EVENT

Método SET: BEFORE_ROW_EVENT

Função executada antes de entrar em qualquer linha da grade.

Sintaxe

Bloco de código
_ADVPL_set_property(< l_table_reference >,"BEFOREIMAGE_ROW_EVENTCOLUMN",< FunçãoAssume valor como nome da imagem? >)

Parâmetros


NomeTipoDescriçãoObrigatório?
FunçãoCHARFunção que será executada antes de entrar em qualquer linha da grade.Sim
Expandir
titleSET CAN_ADD_ROW
Assume valor como nome da imagem?BOOLEANIndicador lógico que define se o valor da coluna será ou não considerado como o nome da imagem que deverá ser exibida.Sim

(informação) Este método é útil quando deseja-se exibir várias imagens na grade, diferente para cada linha, basta ativar este método e atribuir no valor da coluna o nome da imagem do RPO que deseja exibir.

Exemplo


Bloco de código
CALL

Método SET: CAN_ADD_ROW

Habilita/desabilita a inclusão de novas linhas na grade.

Sintaxe

Bloco de código
_ADVPL_set_property(< l_tablecolumn_reference >,"CANIMAGE_ADD_ROWCOLUMN",< Permite incluir linhas? >TRUE)
Parâmetros




Exemplo

Expandir
titleSET IMAGE_HEADER

Método SET: IMAGE_HEADER

Imagem de cabeçalho da coluna.

Sintaxe


Bloco de código
NomeTipoDescriçãoObrigatório?
Permite incluir linhas?BOOLEANIndicador lógico que habilita/desabilita a inclusão de novas linhas na grade.Sim
Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(< l_table_reference >,"CANIMAGE_ADD_ROWHEADER",FALSE)
Expandir
titleSET CAN_COPY_ROW
< Imagem >)

Parâmetros


NomeTipoDescriçãoObrigatório?
ImagemCHARNome da imagem no RPO que será utilizada no cabeçalho da coluna.Sim


Exemplo


Bloco de código
CALL

Método SET: CAN_COPY_ROW

Habilita/desabilita a cópia de linhas da grade.

Sintaxe

Bloco de código
_ADVPL_set_property(< l_tablecolumn_reference >,"CANIMAGE_COPY_ROW",< Permite copiar linhas? >)

Parâmetros

NomeTipoDescriçãoObrigatório?Permite copiar linhas?BOOLEANIndicador lógico que habilita/desabilita a cópia de linhas na grade.Sim
HEADER","CHECKED")




Expandir
titleSET NO_VARIABLE

Método SET: NO_VARIABLE

Assume que a coluna não possui variável, é apenas para exibição de imagem ou texto fixo, sem valor.

Sintaxe


Bloco de código

Exemplo

Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(< l_table_reference >,"CANNO_COPY_ROWVARIABLE",FALSE)
Expandir
titleSET CAN_REMOVE_ROW
)

(informação) Este método é muito utilizado quando deseja-se que a coluna exiba uma imagem ou texto fixo, sem variável por linha. Quando este método está ligado, não é necessário incluir na variável ARRAY OF RECORD definida para a grade, um atributo para a coluna em questão.

Exemplo


Bloco de código
CALL

Método SET: CAN_REMOVE_ROW

Habilita/desabilita a exclusão de linhas da grade.

Sintaxe

Bloco de código
_ADVPL_set_property(< l_tablecolumn_reference >,"CANNO_VARIABLE")




Expandir
titleSET ORDER

Método SET: ORDER

Habilita/desabilita a ordenação dos valores da coluna.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"ORDER",< Permite ordenar os valores da colunaREMOVE_ROW",< Permite excluir linhas? >)

Parâmetros


NomeTipoDescriçãoObrigatório?
Permite excluir linhasordenar os valores da coluna?BOOLEANIndicador lógico que habilita/desabilita a exclusão de linhas na gradedefine se será ou não permitido a ordenação dos valores da coluna.Sim


Exemplo


true
Bloco de código
languageruby
themeConfluence
linenumbers
CALL _ADVPL_set_property(l_tablecolumn_reference,"CAN_REMOVE_ROWORDER",FALSETRUE)




Expandir
titleSET CLEARORDER_BY_COLUMN

Método SET:

CLEAR

ORDER_BY_COLUMN

Ordena os valores da colunaRemove todas as linhas da grade reinicia qualquer ordenação de coluna feita pelo usuário.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"CLEAR"ORDER_BY_COLUMN",< Ordenação >)
Exemplo

Parâmetros

code


Nome
language
Tipo
ruby
Descrição
theme
Obrigatório?
Confluence
OrdenaçãoCHARTipo de ordenação que será realizada na coluna, sendo:


  • ASC: ordenação em forma crescente.
  • DESC ordenação de forma decrescente.
Sim


Exemplo


true
Bloco de código
linenumbers
CALL _ADVPL_set_property(l_tablecolumn_reference,"ORDER_BY_COLUMN","CLEARASC")




Método SET: CLEAR_ALL_LINE_COLOR

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

Sintaxe

Expandir
titleSET CLEAR_ALL_ATTRIBUTESTEXT

Método SET:

CLEAR_ALL_ATTRIBUTES

TEXT

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

Sintaxe

um ou vários textos a serem exibidos na coluna.

Sintaxe


Bloco de código
_
Bloco de código
_ADVPL_set_property(< l_table_reference >,"CLEAR_ALL_ATTRIBUTESTEXT",< Inicializa atributos da linha na exclusão? Texto >)

Parâmetros


NomeTipoDescriçãoObrigatório?
Inicializa atributos da linha na exclusão?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.

Ex.:
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
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"CLEAR_ALL_ATTRIBUTES",FALSE)
Expandir
titleSET CLEAR_ALL_LINE_COLOR
Bloco de código
_ADVPL_set_property(< l_table_reference >,"CLEAR_ALL_LINE_COLOR")

Exemplo

Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"CLEAR_ALL_LINE_COLOR")
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
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(l_table_reference,"CLEAR_ALL_LINE_FONT_COLOR")
Expandir
titleSET CLEAR_LINE_COLOR

Método SET: CLEAR_LINE_COLOR

Restaura a cor padrão para um determinada linha da grade.

Sintaxe

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

Parâmetros

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

Exemplo

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

Método SET: CLEAR_LINE_FONT_COLOR

Restaura a cor padrão da fonte de uma determinada linha da grade.

Sintaxe

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

Parâmetros

NomeTipoDescriçãoObrigatório?LinhaINTEGERNú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: COLUMN_VALUE

Atribui o valor de uma determinada linha e coluna da grade.

Sintaxe

Bloco de código
_ADVPL_set_property(< l_table_reference >,"COLUMN_VALUE",< Coluna>, < Linha>, < Valor>)

Parâmetros

NomeTipoDescriçãoObrigatório?ColunaINTEGERNome da coluna da grade da qual será atribuído o valor.SimLinhaINTEGERNúmero da linha da grade da qual será atribuído o valor.SimValorQUALQUERNúmero da coluna da grade da qual será atribuído o valor.Sim

Exemplo

Bloco de código
languageruby
themeConfluence
linenumberstrue
CALL _ADVPL_set_property(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.

Sintaxe

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

Parâmetros

NomeTipoDescriçãoObrigatório?LinhaINTEGERNú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: ENABLE_EDIT_MODE

Habilita/desabilita a edição e visualização da grade em modo formulário.

Sintaxe

Bloco de código
_ADVPL_set_property(< l_table_reference  >,"ENABLE_EDIT_MODE",< Permite editar e visualizar no modo formulário? >)

Parâmetros

NomeTipoDescriçãoObrigatório?Permite editar e visualizar no modo formulário?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
CALL _ADVPL_set_property(l_table_reference,"ENABLE_EDIT_MODE",FALSE)
Expandir
titleSET HEADER_CLICK_EVENT

Método SET: HEADER_CLICK_EVENT

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

Sintaxe

Bloco de código
_ADVPL_set_property(< l_table_reference >HEADER_CLICK_EVENT",< Função >)

Parâmetros

NomeTipoDescriçãoObrigatório?FunçãoCHARFunção a ser executada ao clicar no cabeçalho de qualquer coluna da grade.Sim Expandir
titleSET ITEM_COUNT

Método SET: ITEM_COUNT

Quantidade total de linhas da grade.

Sintaxe

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

Parâmetros

NomeTipoDescriçãoObrigatório?LinhasINTEGERQuantidade 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)
Expandir
titleSET LINE_COLOR

Método SET: LINE_COLOR

Cor de fundo para uma determinada linha da grade.

Sintaxe

Bloco de código
_ADVPL_set_property(< l_table_reference >,"LINE_COLOR",< Linha>, < Nível de vermelho>, < Nível de verde>, < Nível de azul>)

Parâmetros

NomeTipoDescriçãoObrigatório?LinhaINTEGERNúmero da linha da qual será alterada a cor de fundo.SimNível de vermelhoINTEGERNúmero correspondente ao nível de vermelho da cor (R do RGB).SimNível de verdeINTEGERNúmero correspondente ao nível de verde da cor (G do RGB).SimNível de azulINTEGERNúmero correspondente ao nível de azul da cor (B do RGB).Sim
TextoCHARTexto fixo ou de condições para exibição do mesmo na coluna.Sim

(informação)  Para este método, pode-se informar o texto de duas formas:

  • Fixo: informa o texto que será exibido para todas as linhas da coluna (apenas para colunas que não possuem valor);
    • Ex.: Item
  • Variável: informa no formato de parâmetro, o valor e o texto que a coluna deverá exibir caso a mesma estiver com o valor definido;
    • Ex.: {'I','Item'}{'C','Componente'}

Exemplo


Bloco de código

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",< Linha>, < Nível de vermelho>, < Nível de verde>, < Nível de azul>)

Parâmetros

NomeTipoDescriçãoObrigatório?LinhaINTEGERNúmero da linha da qual será alterada a cor de fundo.SimNível de vermelhoINTEGERNúmero correspondente ao nível de vermelho da cor (R do RGB).SimNível de verdeINTEGERNúmero correspondente ao nível de verde da cor (G do RGB).SimNível de azulINTEGERNú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",< Linha >)

Parâmetros

NomeTipoDescriçãoObrigatório?LinhaINTEGERNú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",< Coluna >)

Parâmetros

NomeTipoDescriçãoObrigatório?ColunaINTEGERNú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",< Linha>,< Coluna >)

Parâmetros

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

Exemplo

true
Bloco de código
languageruby
themeConfluence
linenumbers
CALL _ADVPL_set_property(l_tablecolumn_reference,"SELECT_ITEM",5,10TEXT","{'I','Item'}{'C','Componente'}")




(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

Expandir
titleSET SET_ROWSVALUE

Método SET: VALUE

Valor da coluna

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_ROWSVALUE",< Variável>Linha>, [< Linhas]Valor>)

Parâmetros


NomeTipoDescriçãoObrigatório?
Variável
Linha
ARRAY 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
LinhasINTEGERQuantidade de linhas iniciais que será atribuída para a grade.Sim
INTEGERNúmero da linha da qual será atribuído o valor para a coluna.Sim
ValorQUALQUERValor a ser atribuído para a coluna.Sim


Exemplo


true
Bloco de código
Bloco de código
languageruby
themeConfluence
linenumbers
CALL _ADVPL_set_property(l_tablecolumn_reference,"SET_ROWSVALUE",ma_variable,15,"50")




Expandir
titleSET VARIABLE

Método SET: VARIABLE VARIABLE

Variável (atributo) do ARRAY OF RECORD definido para a grade, Define a variável que irá controlar os valores o valor da gradecoluna.

Sintaxe


Bloco de código
_ADVPL_set_property(< l_table_reference >,"VARIABLE",<  Variável (nome da coluna)>)

Parâmetros


NomeTipoDescriçãoObrigatório?
 Variável (nome da coluna)CHARVariável (atributo) do VariávelARRAY OF RECORDVariável ARRAY OF RECORD definido para a grade, que irá controlar os valores da grade. Os atributos deste ARRAY deverá ter o mesmo nome das colunas criadas na grade.Sim
(informação) Importante: este método deverá ser chamado apenas uma vez para cada componente criado.
o valor da coluna.Sim


Exemplo


true
Bloco de código
languageruby
themeConfluence
linenumbers
CALL _ADVPL_set_property(l_tablecolumn_reference,"VARIABLE",ma"cod_variableempresa")





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 Este componente só poderá ser criado tendo um componente LTableEx ou LBrowseEx como componente pai.

Bloco de código
languageruby
themeConfluence
linenumberstruetrue
 DEFINE ma_variable ARRAY[100] OF
                    RECORD
                 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.
     CALL _ADVPL_set_property(l_table_reference,"SIZE",l_table_width,250)
     CALL _ADVPL_set_property(l_table_reference,"ADJUST_COLUMNS_WIDTH")
     CALL _ADVPL_set_property(l_table_reference,"SET_ROWS",ma_variable,(l_row - 1))
     CALL _ADVPL_set_property(l_table_reference,"REFRESH")
     CALL _ADVPL_set_property(l_dialog_reference,"MAXIMIZED",FALSE)
     CALL _ADVPL_set_property(l_dialog_reference,"ACTIVATE",TRUE) END FUNCTION


Visualização

Image RemovedImage Added