Páginas filhas
  • LGX - LBROWSEEX

Versões comparadas

Chave

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

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


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 COLUMN_BY_INDEX

Método GET: COLUMN_BY_INDEX

Nome da coluna conforme índice da mesma.

Sintaxe



Bloco de código
_ADVPL_get_property( < l_table_reference >, "COLUMN_BY_INDEX",< Coluna> ) ==> Nome da coluna

Parâmetros



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

Retorno



TipoDescrição
CHAR

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


Exemplo



Bloco de código
languageruby
themeConfluence
linenumberstrue
LET l_column_name = _ADVPL_get_property(l_table_reference,"COLUMN_BY_INDEX",10)



Expandir
titleGET COLUMN_SELECTED

Método GET: COLUMN_SELECTED

Índice da coluna seleciona na grade.

Sintaxe



Bloco de código
_ADVPL_get_property( < l_table_reference >, "COLUMN_SELECTED" ) ==> Coluna


Retorno



TipoDescrição
()
  • Í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")



Expandir
titleGET COLUMN_VALUE

Método GET: COLUMN_VALUE


Sintaxe



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

Parâmetros



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

Retorno



TipoDescrição
()

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)



Expandir
titleGET ITEM_COUNT

Método GET: ITEM_COUNT

Total de linhas da grade.

Sintaxe



Bloco de código
_ADVPL_get_property( < cReference >, "ITEM_COUNT" ) ==> Linha

Retorno



TipoDescrição
( )

Quantidade total de linhas da grade.

Exemplo



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


(informação) Veja também LTableColumnEx



Expandir
titleGET POPUP_REFERENCE

Método GET: POPUP_REFERENCE

Referência do menu popup da grade.

Sintaxe



Bloco de código
_ADVPL_get_property( < l_table_reference >, "POPUP_REFERENCE" ) ==> Referência

Retorno



TipoDescrição
( )

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")



Expandir
titleGET ROW_SELECTED

Método GET: ROW_SELECTED

Linha selecionada na grade.

Sintaxe



Bloco de código
_ADVPL_get_property( < l_table_reference >, "ROW_SELECTED" ) ==> Linha

Retorno



TipoDescrição
( )

Linha selecionada na grade.

Exemplo



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



Expandir
titleGET ACTIVATE_EDIT_FORM

Método GET: ACTIVATE_EDIT_FORM

Ativa/desativa a tela de edição da grade em modo formulário.

Sintaxe



Bloco de código
_ADVPL_get_property( < l_table_reference >, "ACTIVATE_EDIT_FORM",< Ativar tela da grade no modo formulário?> )

Parâmetros



NomeTipoDescriçãoObrigatório?
Ativar tela da grade no modo formulário?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
CALL _ADVPL_set_property(l_table_reference,"ACTIVATE_EDIT_FORM",TRUE)




Métodos SET


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


Expandir
titleSET ADD_ROW

Método SET: ADD_ROW

Inclui uma nova linha no final da grade.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_table_reference >,"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: ADJUST_COLUMNS_WIDTH

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 >,"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")




Expandir
titleSET AFTER_ADD_ROW_EVENT

Método SET: AFTER_ADD_ROW_EVENT

Funçã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 >)

Parâmetros



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




Expandir
titleSET AFTER_EDIT_ROW

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 >,"AFTER_EDIT_ROW",< Função >)

Parâmetros



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




Expandir
titleSET AFTER_ORDER_EVENT

Método SET: AFTER_ORDER_EVENT 

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 ",< Função >)

Parâmetros



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




Expandir
titleSET AFTER_REMOVE_ROW_EVENT

Método SET: AFTER_REMOVE_ROW_EVENT 

Exibe uma mensagem na barra de status.

Sintaxe



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

Parâmetros



NomeTipoDescriçãoObrigatório?
FunçãoCHARFunção que será executada após excluir qualquer linha da grade.Sim




Expandir
titleSET AFTER_ROW_EVENT

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_table_reference >,"AFTER_ROW_EVENT",< Função >)

Parâmetros



NomeTipoDescriçãoObrigatório?
FunçãoCHARFunçã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.




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_EVENT",< Função >)

Parâmetros



NomeTipoDescriçãoObrigatório?
   FunçãoCHARFunção que será executada antes de incluir uma nova linha na grade.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.




Expandir
titleSET BEFORE_EDIT_ROW

Método SET: BEFORE_EDIT_ROW

Função executada antes da edição da linha (em qualquer coluna) da grade.

Sintaxe



Bloco de código
_ADVPL_set_property(< l_table_reference >,"BEFORE_EDIT_ROW",< 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.




Expandir
titleSET BEFORE_ORDER_EVENT

Método SET: BEFORE_ORDER_EVENT

Função executada antes da ordenação de qualquer coluna da grade.

Sintaxe



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

Parâmetros



NomeTipoDescriçãoObrigatório?
FunçãoCHARFunçã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.




Expandir
titleSET BEFORE_REMOVE_ROW_EVENT

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

(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_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 >,"BEFORE_ROW_EVENT",< Função >)

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

Método SET:

TE 

CAN_ADD_ROW

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

Sintaxe



Bloco de código
_ADVPL_set_property(< l_table_reference >,"TEXTCAN_ADD_ROW",< cText Permite incluir linhas? >)

Parâmetros



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

Exemplo



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




Expandir
titleSET CAN_COPY_ROW

Método SET: CAN_COPY_ROW

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

Método SET: TE 

Sintaxe



Bloco de código
_ADVPL_set_property(< l_table_reference >,"TEXTCAN_COPY_ROW",< cTextPermite copiar linhas? >)

Parâmetros



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

Exemplo



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




Expandir
titleSET CAN_REMOVE_ROW

Método SET:

TE 

CAN_REMOVE_ROW

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

Sintaxe



Bloco de código
_ADVPL_set_property(< l_table_reference >,"TEXTCAN_REMOVE_ROW",< cText >Permite excluir linhas? >)

Parâmetros



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

Exemplo



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




Expandir
titleSET CLEAR

Método SET:

TE 

CLEAR

Remove 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 >,"TEXT",< cText >)

Parâmetros

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

Exemplo



Bloco de código
languageruby
themeConfluence
linenumberstrue
Expandir
titleSET

Método SET: TE 

Sintaxe

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




Sim

Exemplo



Expandir
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.

Sintaxe



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

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.

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




Expandir
titleSET CLEAR_ALL_LINE_COLOR

Método SET:

TE 

CLEAR_ALL_LINE_COLOR

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

Sintaxe



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

Parâmetros

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

Exemplo



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




Sim
Expandir
titleSET CLEAR_ALL_LINE_FONT_COLOR

Método SET:

TE 

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  >,"TEXT",< cText >)

Parâmetros

NomeTipoDescriçãoObrigatório?
   cText CHAR.
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 SET CLEAR_LINE_COLOR

Método SET:

TE 

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 >,"TEXTCLEAR_LINE_COLOR",< cTextLinha >)

Parâmetros



NomeTipoDescriçãoObrigatório?
   cText LinhaCHARINTEGERNú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

Método SET: TE 


Sintaxe



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

Parâmetros



NomeTipoDescriçãoObrigatório?
   cText CHAR.Sim

Exemplo



Bloco de código
languageruby
themeConfluence
linenumberstrue




Expandir
titleSET

Método SET: TE 


Sintaxe



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

Parâmetros



NomeTipoDescriçãoObrigatório?
   cText CHAR.Sim

Exemplo



Bloco de código
languageruby
themeConfluence
linenumberstrue




Expandir
titleSET

Método SET: TE 


Sintaxe



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

Parâmetros



NomeTipoDescriçãoObrigatório?
   cText CHAR.Sim

Exemplo



Bloco de código
languageruby
themeConfluence
linenumberstrue




Expandir
titleSET

Método SET: TE 


Sintaxe



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

Parâmetros



NomeTipoDescriçãoObrigatório?
   cText CHAR.Sim

Exemplo



Bloco de código
languageruby
themeConfluence
linenumberstrue




Expandir
titleSET

Método SET: TE 


Sintaxe



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

Parâmetros



NomeTipoDescriçãoObrigatório?
   cText CHAR.Sim

Exemplo



Bloco de código
languageruby
themeConfluence
linenumberstrue




Expandir
titleSET

Método SET: TE 


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




Expandir
titleSET

Método SET: TE 


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




Expandir
titleSET

Método SET: TE 


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




Expandir
titleSET

Método SET: TE 


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




Expandir
titleSET

Método SET: TE 


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




Expandir
titleSET

Método SET: TE 


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




Expandir
titleSET

Método SET: TE 


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




Expandir
titleSET

Método SET: TE 


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




Expandir
titleSET

Método SET: TE 


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




Expandir
titleSET

Método SET: TE 


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





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_dialog_reference,"SIZE",400,400)
     CALL _ADVPL_set_property(l_dialog_reference,"TITLE","Exemplo de Utilização: LSTATUSBAR")

     LET l_statusbar_reference = _ADVPL_create_component(NULL,"LSTATUSBAR",l_dialog_reference)
     CALL _ADVPL_set_property(l_statusbar_reference,"INFO_TEXT","Exemplo de mensagem informativa.")
     CALL _ADVPL_set_property(l_statusbar_reference,"VISIBLE_HOTKEY",FALSE)

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


Visualização