SetFilter

Define um filtro para a DataWindow

Sintaxe:

dwcontrol.SetFilter(format)

 

Retorno:

  • 1 – Sucesso;
  • -1 – Se ocorreu algum erro ou se não foi especificado nenhum DataObject na DataWindow;

 

Destalhes sobre a função!

Appeon: Função suportada sem restrições.

  • Após recuperar os dados (retrieve) e aplicar o filtro, as linhas que atenderem os critérios serão automaticamente transferidos do buffer Primary! para o buffer Filter!.
  • O método SetFilter substitui o filtro existente na DataWindow;
  • Os filtros devem ser operações que utilizam as colunas e devem resultar em um indicador booleano (true ou false);
  • São aceitos somente os operadores lógicos AND e OR. NOT não é suportado.
  • As comparações dos filtros são feitas em ordem alfabética, no exemplo abaixo, o filtro retornará todas as linhas cuja segunda coluna começa com A, a B ou b.

  • Se quiser que o filtro faça a pesquisa utilizando a ordenação ASCII ao invés da ordem alfabética, utilize \s no final do filtro. O exemplo abaixo retorna linhas cuja segunda coluna comece com a ou b, pois na tabela ASCII, as letras maiusculas e minusculas estão listadas separadamente.

  • Para fazer com que o usuário insira um filtro para a datawindow, passe uma variável nula, do tipo string. (Isso não funciona para DataStores, apenas para DataWindow);
  • As configurações regionais não alteram a formatação dos números (ou moedas);
  • Para utilizar os caracteres % ou _ em uma string filtro, você deve usar o caractere  de escape, veja o exemplo abaixo:

  • Para remover um filtro, chame a função SetFilter passando uma string vazia.

Como utilizar:

Exemplo 01: Filtra DW_1, retornando as linhas onde a coluna 2 possua valores entre 100 e 1000.

 

Argumentos:

Argumento Obrigatório Descrição
dwcontrol Sim DataWindow Control da DW que será filtrada
format Sim String contendo a expressão utilizada para o filtro.

Referência:

 

Dúvidas sobre  o artigo? Sugestões? Precisa de ajuda com outra funcionalidade do PowerBuilder? Deixe um comentário.

The following two tabs change content below.
Breno RdV
Ex-Psicólogo, com quase uma década de experiência em Recursos Humanos e Gestão de Pessoas, atual desenvolvedor e Analista de Sistemas, trabalhando com PowerBuilder, C#, PowerShell e expandindo horizontes para Python, Xamarin, PHP, Angular e (por que não?) Unity.

Comments

comments

Posted in Dev, PowerBuilder and tagged , , , , , .