Filter

Filtras as linhas de uma DataWindow ou DataStore de acordo com o filtro definido na função SetFilter.

Sintaxe:

dwcontrol.Filter()

 

Retorno:

  • 1: sucesso
  • -1: erro
  • null: se o dwcontrol for nulo.

 

Destalhes sobre a função!

Appeon: Funciona sem restrições.

  • De acordo com o manual da Sybase, o retorno desta função não é utilizado.
  • A função Filter faz com que as linhas sejam recuperadas (executa um Retrieve) e depois filtra o resultado.
  • Mesmo se a opção Retrieve As Needed estiver habilitada, a função Filter vai recuperar todos os registros e depois aplicar o filtro.
  • Filter utiliza os critérios definidos na função SetFilter. Para alterar os critérios, basta utilizar o SetFilter novamente.
  • Se a função Filter for chamada sem um filtro, a Datawindow irá recuperar os dados com os parâmetros padrões.
  • Filter não tem efeito em DataWindows do tipo Composite.
  • Quando a função Filter é chamada em uma Datawindow com Grupos, você precisa utilizar a função GroupCalc novamente, para atualizar os grupos atuais.

 

Como utilizar:

Exemplo 01: Filtrando uma DataWindow para retornar apenas os valores com ID entre 11 e 34.

Exemplo 02: Limpando filtro da DataWindow.

Argumentos:

Argumento Obrigatório Tipo Descrição
dwcontrol Sim Datastore/Datawindow Control Referência para a Datawindow ou Datastore que será filtrada.

 

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