4D Doc Center : SET FILTER

4D v14.3

SET FILTER


SET FILTER ( {* ;} objeto ; filtroEntrada )

Parâmetro	Tipo	Descrição
*	Operador	se especificado, objeto é um nome de objeto (string), se omitido, objeto é um campo ou uma variável
objeto	Objeto de formulário	Nome de objeto (se* é especificado) ou Campo ou Variável (se * é omitido)
filtroEntrada	cadeia	Novo filtro de entrada de dados para a área editável

Descrição

OBJECT SET FILTER substitui o filtro de entrada para os objetos especificados por objeto por filtroEntrada.

Se passa o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (string). Se não passa este parâmetro, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, é passada uma referência de campo ou variável (campo ou variável objeto unicamente) ao invés de um string.Para mais informações sobre nomes de objetos, consulte a seção

OBJECT SET FILTER pode ser utilizado em formulários de entrada e diálogos e pode ser aplicado aos campos e variáveis editáveis que aceitem um filtro de entrada noambiente Desenho

Ao passar uma string vazia em filtroEntrada é eliminado o filtro de entrada atual para os objetos.

Nota: este comando não pode ser utilizado com campos localizados no formulário listado de um subformulário.

Nota: em filtroEntrada, para utilizar filtros de entrada pré-definidos utilizando a Caixa de ferramentas, coloque um prefixo no filtro de entrada, uma barra vertical (|).

Exemplo 1

O exemplo a seguir define o filtro de entrada para o campo código postal CEP. Se a direção é de Espanha, o filtro é definido para os códigos postais espanhóis. Do contrário, pode aceitar todo valor de entrada:

 If([Empresas]Pais ="ES") ` Definir o filtro para um formato do código postal espanhol

    OBJECT SET FILTER([Empresas]Código Postal;"&9#####")

 Else ` Definir o filtro para aceitar todo valor alfanumérico e maiúsculas

    OBJECT SET FILTER([Empresas]Código Postal;"~@")

 End if

Exemplo 2

O exemplo a seguir permite unicamente a entrada das letras “a,” “b,” “c,” ou “g” em um campo de duas letras:

OBJECT SET FILTER([Tabela]Campo ;"&"+Char(Double quote)+"a;b;c;g"+Char(Double quote)+"##")

Nota: este exemplo define o filtro de entrada &"a;b;c;g"##.