Pagetitle

	LGX - LTEXTFIELD
	LGX - LTEXTFIELD

Componente para edição de textos alfanuméricos de múltiplas linhas permitindo formatar o texto dentro do campo.

O valor deste campo será um código HTML com a formatação definida pelo usuário.

Hierarquia

LCOMPONENT

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

title	GET BLANK

Método GET: BLANK

Retorna se o campo aceita valor em branco.

Sintaxe

Bloco de código
_ADVPL_get_property( < l_textfield_reference>, "BLANK") => BOOLEAN

Retorno

Tipo	Descrição
`BOOLEAN`	Indicador se o campo aceita espaço em branco.

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

LET l_blank = _ADVPL_get_property(l_textfield_reference,"BLANK")

Expandir

title	GET LENGTH

Método GET: LENGTH

Quantidade de caracteres que podem ser informados no campo.

Sintaxe

Bloco de código
_ADVPL_get_property( < l_textfield_reference>, "LENGTH") => INTEGER

Retorno

Tipo	Descrição
`INTEGER`	Quantidade que indica quantos caracteres poderá ser informado no campo.

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

LET l_length = _ADVPL_get_property(l_textfield_reference,"LENGTH")

Expandir

title	GET PASSWORD

Método GET: PASSWORD

Retorna se o campo é do tipo senha.

Sintaxe

Bloco de código
_ADVPL_get_property( < l_textfield_reference>, "PASSWORD") => BOOLEAN

Retorno

Tipo	Descrição
`BOOLEAN`	Indicador de campo para informação de senha.

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

LET l_password = _ADVPL_get_property(l_textfield_reference,"PASSWORD")

Expandir

title	GET PICTURE

Método GET: PICTURE

Retorna se o campo é do tipo senha.

Sintaxe

Bloco de código
_ADVPL_get_property( < l_textfield_reference>, "PICTURE") => CHAR

Retorno

Tipo	Descrição
`CHAR`	Máscara de formatação informado para o campo.

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

LET l_picture = _ADVPL_get_property(l_textfield_reference,"PICTURE")

Expandir

title	GET VALUE_WITH_PICTURE

Método GET: VALUE_WITH_PICTURE

Valor informado no campo com os caracteres de máscara inclusive.

Sintaxe

Bloco de código
_ADVPL_get_property( < l_textfield_reference>, "VALUE_WITH_PICTURE") => CHAR

Retorno

Tipo	Descrição
`CHAR`	Valor formatado com a máscara informada para o campo.

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

LET l_value = _ADVPL_get_property(l_textfield_reference,"VALUE_WITH_PICTURE")

Métodos SET

Métodos acessíveis utilizando a função _ADVPL_set_property que permite alterar e manipular os valores do componente.

Expandir

title	SET BLANK

Método SET: BLANK

Define se, mesmo o campo não seja informado, o valor fique com espaço em branco.

Sintaxe

Bloco de código
_ADVPL_set_property( < l_textfield_reference >, "BLANK",< Aceita espaço em branco?>)

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
`Aceita espaço em branco?`	`BOOLEAN`	Indicador para definir se o campo, mesmo não informado, passar espaço em branco como valor para a variável.	Sim

Este método funciona de forma semelhante aos comandos:

LET l_valor = " " e
LET l_valor = 1 SPACE.

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

CALL _ADVPL_set_property(l_textfield_reference,"BLANK",TRUE)

Expandir

title	SET LEFT_TRIM

Método SET: LEFT_TRIM

Define se o componente deverá retirar os espaços em branco a esquerda do texto.

Sintaxe

Bloco de código
_ADVPL_set_property( < l_textfield_reference >, "LEFT_TRIM", < Retira espaços em branco à esquerda? >)

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
`Retira espaços em branco à esquerda?`	`BOOLEAN`	Indicador que define se o componente deverá retirar os espaços em branco à esquerda do texto informado.	Sim

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

CALL _ADVPL_set_property(l_textfield_reference,"LEFT_TRIM",TRUE)

Expandir

title	SET LENGTH

Método SET: LENGTH

Quantidade de caracteres que poderão ser informados no campo.

Sintaxe

Bloco de código
_ADVPL_set_property( < l_textfield_reference >, "LENGTH", < Quantidade >)

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
`Quantidade`	`NUMERIC`	Quantidade indicando quantos caracteres poderão ser informados no campo.	Sim

Num primeiro momento, este método define o tamanho do componente em tela, mas este pode ser alterado posteriormente.

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

CALL _ADVPL_set_property(l_textfield_reference,"LENGTH",10)

Expandir

title	SET PASSWORD

Método SET: PASSWORD

Define se o campo é para informar uma senha, ou seja, não exibirá o valor informado pelo usuário.

Sintaxe

Bloco de código
_ADVPL_set_property( < l_textfield_reference >, "PASSWORD", < Campo de senha? >)

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
`Campo de senha?`	`BOOLEAN`	Indicador para definir se o campo será um campo de senha.	Sim

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

CALL _ADVPL_set_property(l_textfield_reference,"PASSWORD",TRUE)

Expandir

title	SET PICTURE

Método SET: PICTURE

Máscara de formatação de valor para o campo.

Sintaxe

Bloco de código
_ADVPL_set_property( < l_textfield_reference >, "PICTURE", < Máscara >)

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
`Máscara`	`CHAR`	Máscara de formatação de valor conforme lista de máscara disponível.	Sim

Para acessar a lista de máscaras de formatação válidas, clique aqui.

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

CALL _ADVPL_set_property(l_textfield_reference,"PICTURE","@!")

Expandir

title	SET TEXT_TRANSFORM

Método SET: TEXT_TRANSFORM

Ação a ser executada para modificar o texto após o mesmo ser informado.

Sintaxe

Bloco de código
_ADVPL_set_property( < l_textfield_reference >, "TEXT_TRANSFORM", < Comando >)

Parâmetros

Nome	Tipo	Descrição	Obrigatório?
`Comando`	`CHAR`	Comando a ser executada após edição do campo, sendo: LOWERCASE: altera o texto informado para minúsculo. UPPERCASE: altera o texto informado para maiúsculo. CAPITALIZE: altera o texto informado para deixar a primeira letra de cada palavra do texto em maiúsculo.	Sim

Exemplo

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

CALL _ADVPL_set_property(l_textfield_reference,"PASSWORDTEXT_TRANSFORM",TRUE"CAPITALIZE")

Exemplos

Expandir

title	Exemplo de utilização

Bloco de código

language	ruby
theme	Confluence
linenumbers	true

#----------------------# FUNCTION LTextEditorLTextField()#----------------------#
     DEFINE l_dialog_reference     VARCHAR(10)
     DEFINE l_texteditortextfield_reference VARCHAR(10)

     LET l_dialog_reference = _ADVPL_create_component(NULL,"LDIALOG")
     CALL _ADVPL_set_property(l_dialog_reference,"SIZE",480160,240120)
     CALL _ADVPL_set_property(l_dialog_reference,"TITLE","Ex.: LTextEditorLTEXTFIELD")
     CALL _ADVPL_set_property(l_dialog_reference,"BACKGROUND_COLOR",210,210,210)

     LET l_texteditortextfield_reference = _ADVPL_create_component(NULL,"LTEXTEDITORLTEXTFIELD",l_dialog_reference)
     CALL _ADVPL_set_property(l_texteditortextfield_reference,"SIZE",470,205LENGTH",10)
     CALL _ADVPL_set_property(l_textfield_reference,"PICTURE","@!")
     CALL _ADVPL_set_property(l_texteditortextfield_reference,"POSITION",05,05)

     LET l_textfield_reference = _ADVPL_create_component(NULL,"LTEXTFIELD",l_dialog_reference)
     CALL _ADVPL_set_property(l_textfield_reference,"LENGTH",10)
     CALL _ADVPL_set_property(l_textfield_reference,"PASSWORD",TRUE)
     CALL _ADVPL_set_property(l_textfield_reference,"POSITION",05,35)
     CALL _ADVPL_set_property(l_dialog_reference,"MAXIMIZED",FALSE)
     CALL _ADVPL_set_property(l_dialog_reference,"ACTIVATE",TRUE) END FUNCTION

Visualização

Image Removed

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

Hierarquia

Métodos GET

Método GET: BLANK

Sintaxe

Retorno

Exemplo

Método GET: LENGTH

Sintaxe

Retorno

Exemplo

Método GET: PASSWORD

Sintaxe

Retorno

Exemplo

Método GET: PICTURE

Sintaxe

Retorno

Exemplo

Método GET: VALUE_WITH_PICTURE

Sintaxe

Retorno

Exemplo

Métodos SET

Método SET: BLANK

Sintaxe

Parâmetros

Exemplo

Método SET: LEFT_TRIM

Sintaxe

Parâmetros

Exemplo

Método SET: LENGTH

Sintaxe

Parâmetros

Exemplo

Método SET: PASSWORD

Sintaxe

Parâmetros

Exemplo

Método SET: PICTURE

Sintaxe

Parâmetros

Exemplo

Método SET: TEXT_TRANSFORM

Sintaxe

Parâmetros

Exemplo

Exemplos

Visualização