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.
long ll_ret string ls_Filter ls_Filter = 'id > 10 and id < 35' ll_ret = dw_1.SetFilter(ls_Filter) ll_ret = dw_1.Filter()
Exemplo 02: Limpando filtro da DataWindow.
dw_1.SetFilter("") dw_1.Filter()
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.
Arquiteto de Software e Desenvolvedor Backend (quase Fullstack), geralmente trabalho com C#, PowerShell, Python, Golang, bash e Unity (esse é mais por hobby). Estou sempre buscando algo novo para aprender, adicionando novas ferramentas ao meu cinto de utilidades.
Latest posts by Breno RdV (see all)
- O que é Metaclass e como ela funciona. (#python #dev #metaclass) - janeiro 11, 2023
- Entenda a mágica dos Generators. (#python, #dev, #generator, #iterator) - dezembro 28, 2022
- Ordenando um DataFrame por múltiplas colunas. (#python #pandas #jupyter #dev #data) - agosto 3, 2022