Páginas filhas
  • FWFilter
Classe: FWFilter


Compatível Países:Todos
Sistemas Operacionais:Todos
Compatível às Bases de Dados:Todos
Nível de Acesso:Nível 1 (Acesso Clientes)
Idiomas:Português, Inglês, Espanhol
Versão10.1.1.4


FWFilter
Descrição
Fornece um objeto que permite a inclusão, exclusão e execução de filtros nas rotinas
New
Sintaxe
FWFilter():New(< oOwner >, < bCanUse >)-> oSelf

Descrição
Método construtor da classe

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

oOwnerObjetoObjeto proprietário
X

bCanUseCode-BlockCode-Block de habilitacao de uso
X


 

Retorno
oSelf Objeto FWFilter
Activate
Sintaxe
FWFilter():Activate(< oOwner >, < lShow >)-> NIL

Descrição
Método de ativação da classe

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

oOwnerObjetoObjeto proprietário
X

lShowLógicoIndica se realiza a abertura da tela de filtros
X


 
CheckFil
Sintaxe
FWFilter():CheckFil()-> aCheckFil

Descrição
Retorna a seleção dos filtros

Retorno
aCheckFil Seleção dos Filtros
ClassName
Sintaxe
FWFilter():ClassName()-> cClassName

Descrição
Retorna o nome da classe (FWFILTER)

Retorno
cClassName Nome da classe
DeActivate
Sintaxe
FWFilter():DeActivate()-> NIL

Descrição
Método destrutor da classe
DeleteFilter
Sintaxe
FWFilter():DeleteFilter(< cID >)-> NIL

Descrição
Permite realizar a exclusão de filtros

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

cIDCaracteresIdentificador do Filtro
X


 
DisableAdd
Sintaxe
FWFilter():DisableAdd(< lDisable >)-> NIL

Descrição
Desabilita a inclusão dos filtros pelo usuário

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

lDisableLógicoIndica que a inclusão dos filtros está indisponível
X


 
DisableDel
Sintaxe
FWFilter():DisableDel(< lDisable >)-> NIL

Descrição
Desabilita a exclusão dos filtros pelo usuário

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

lDisableLógicoIndica que a exclusão dos filtros está indisponível
X


 
DisableExecute
Sintaxe
FWFilter():DisableExecute(< lDisable >)-> NIL

Descrição
Desabilita a execusão dos filtros pelo usuário

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

lDisableLógicoIndica que a execução dos filtros está indisponível
X


 
DisableSave
Sintaxe
FWFilter():DisableSave(< lDisable >)-> NIL

Descrição
Desabilita a gravação dos filtros realizados pelo usuário.

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

lDisableLógicoDefine se habilita ou nao a gravação dos filtros realizados pelo usuário.
X


 
DisableValid
Sintaxe
FWFilter():DisableValid()-> NIL

Descrição
Desabilita a validação da condiçção de filtro informada pelo usuário.
CleanFilter
Sintaxe
FWFilter():CleanFilter(< lDeActivate >)-> NIL

Descrição
Executa a limpeza de todos filtros adicionados pelo usuário

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

lDeActivateLógicolDeActivate
X


 
EditText
Sintaxe
FWFilter():EditText(< nPosFilter >, < oCheck >)-> NIL

Descrição
Permite a edição do texto do filtro

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

nPosFilterNuméricoIndica a posição do item no array aFilter
X

oCheckObjetoObjeto TCheckbox utilizado para atualizar a descrição
X


 
ExecuteFilter
Sintaxe
FWFilter():ExecuteFilter()-> NIL

Descrição
Executa o Code-Block, definido no método SetExecute(bFilter), para aplicação dos filtros
Finish
Sintaxe
FWFilter():Finish()-> NIL

Descrição
Executa um bloco de códigos na finalização da janela filtrar
GetAlign
Sintaxe
FWFilter():GetAlign()-> nAlign

Descrição
Retorna o alinhamento do componente na janela

Retorno
nAlign Alinhamento do componente na janela
GetButton
Sintaxe
FWFilter():GetButton()-> Indica

Descrição
Retorna se deverá exibir o componente, no objeto proprietário, através de um botão.

Retorno
Indica se exibe o objeto através de um botão
GetExprADVPL
Sintaxe
FWFilter():GetExprADVPL()-> cExpression

Descrição
Retorna a expressão dos filtros realizados em formato ADVPL

Retorno
cExpression Expressão dos filtros realizados em formato ADVPL
GetExprSQL
Sintaxe
FWFilter():GetExprSQL()-> cExpression

Descrição
Retorna a expressão dos filtros realizados em formato SQL

Retorno
cExpression Expressão dos filtros realizados em formato SQL
GetFilter
Sintaxe
FWFilter():GetFilter(< lFilterAsk >)-> aReturn

Descrição
Retorna a lista de filtros realizados

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

lFilterAskLógicoIndica se deve ser executado o filtro do tipo pergunta
X


Retorno
aReturn - Array com as informações do filtro
Lista de filtros
[n,1] Expressão literal
[n,2] Expressão no formato AdvPL
[n,3] Expressão no formato SQL
[n,4] Parser do filtro
[n,4,n,1] String contendo o campo, operador ou expressão do filtro
[n,4,n,2] Indica o tipo do parser (FIELD=Campo,OPERATOR=Operador e EXPRESSION=Expressão)
[n,5] Indica que não poderá retirar a marca
[n,6] Marcado/Desmarcado
[n,7] Indica se o filtro pergunta as informações na execução
[n,8] Alias

Observação
As posições dos filtros ADVPL e SQL podem estar vazias, portanto é necessária a validação das mesmas antes do uso, essa situação acontece por exemplo quando é selecionada a opção de informar o valor do filtro no momento da execução do mesmo.
GetFilterRelation
Sintaxe
FWFilter():GetFilterRelation()-> aReturn

Descrição
Retorna a lista de filtros do relacionamento realizados

Retorno
aReturn
Lista de filtros
[n,1] Expressão literal
[n,2] Expressão no formato AdvPL
[n,3] Expressão no formato SQL
[n,4] Parser do filtro
[n,4,n,1] String contendo o campo, operador ou expressão do filtro
[n,4,n,2] Indica o tipo do parser (FIELD=Campo,OPERATOR=Operador e EXPRESSION=Expressão)
[n,5] Marcado/Desmarcado
[n,6] Indica se o filtro pergunta as informações na execução
[n,7] Indica que não poderá retirar a marca
[n,8] Alias
GetFilterAdvPL
Sintaxe
FWFilter():GetFilterAdvPL(< nFilter >)-> cReturn

Descrição
Retorna um filtro da lista no formato AdvPL

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

nFilterNuméricoIndica a posição do filtro na lista
X


 

Retorno
cReturn Expressão do filtro no formato AdvPL
GetFilterSql
Sintaxe
FWFilter():GetFilterSql(< nFilter >)-> cReturn

Descrição
Retorna um filtro da lista no formato AdvPL

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

nFilterNuméricoIndica a posição do filtro na lista
X


 

Retorno
cReturn Expressão do filtro no formato AdvPL
GetFilterParser
Sintaxe
FWFilter():GetFilterParser(< nFilter >)-> aReturn

Descrição
Retorna o parser de um filtro da lista

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

nFilterNuméricoIndica a posição do filtro na lista
X


 

Retorno
aReturn
Estrutura do array
[n,1] String contendo o campo, operador ou expressão do filtro
[n,2] Indica o tipo do parser (FIELD=Campo,OPERATOR=Operador e EXPRESSION=Expressão)
GetLiteralFilter
Sintaxe
FWFilter():GetLiteralFilter(< nFilter >)-> cReturn

Descrição
Retorna a descrição de um filtro da lista

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

nFilterNuméricoIndica a posição do filtro na lista
X


 

Retorno
cReturn Descrição do filtro
GetProfileID
Sintaxe
FWFilter():GetProfileID()-> cProfileID

Descrição
Retorna o identificador do Browse utiliza na gravação das configurações no profile do usuário. Deve ser utilizado quando existir mais de um filtro na rotina.

Retorno
cProfileID Identificador do filtro
GetRelation
Sintaxe
FWFilter():GetRelation()-> aRelation

Descrição
Retorna os relacionamentos de tabelas no filtro

Retorno
aRelation
Array contendo os itens do relacionamento aRelation
[n,1] - Se .T., indica que o relacionamento foi selecionado aRelation
[n,2] - Alias aRelation
[n,3] - Descrição da tabela aRelation
[n,4] - Campos de relacionamento da tabela do principal aRelation
[n,5] - Campos de relacionamento da tabela do alias
Hide
Sintaxe
FWFilter():Hide()-> NIL

Descrição
Torna o filtro invisível
LoadFilter
Sintaxe
FWFilter():LoadFilter()-> NIL

Descrição
Carrega aos filtros gravados para o usuário
Relation
Sintaxe
FWFilter():Relation()-> NIL

Descrição
Permite definir os relacionamentos para o filtro
SaveFilter
Sintaxe
FWFilter():SaveFilter()-> NIL

Descrição
Salva os filtros de usuário utilizando a classe FWProfile
SetAlias
Sintaxe
FWFilter():SetAlias(< cAlias >)-> NIL

Descrição
Indica o alias da tabela que será utilizada no Browse

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

cAliasCaracteresAlias da tabela
X


 
SetAlign
Sintaxe
FWFilter():SetAlign(< nAlign >)-> NIL

Descrição
Indica o alinhamento do componente na janela

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

nAlignNuméricoAlinhamento do componente na janela
X


 
SetButton
Sintaxe
FWFilter():SetButton()-> NIL

Descrição
Indica se deverá exibir o componente, no objeto proprietário, através de um botão.
SetExecute
Sintaxe
FWFilter():SetExecute(< bFilter >)-> NIL

Descrição
Indica o Code-Block executado na ação do botão "Executar"

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

bFilterCode-BlockCode-Block executado na ação do botão "Executar"
X


 
SetCanFilterAsk
Sintaxe
FWFilter():SetCanFilterAsk(< lCanFilterAsk >)-> NIL

Descrição
Indica se permite executar filtros com interação do usuário

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

lCanFilterAskLógicoIndica se permite executar filtros com interação do usuário
X


 
SetCanUse
Sintaxe
FWFilter():SetCanUse(< bCanUse >)-> NIL

Descrição
Indica se permite executar filtros

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

bCanUseCode-BlockIndica se permite executar filtros
X


 
SetCleanFilter
Sintaxe
FWFilter():SetCleanFilter(< bCleanFilter >)-> NIL

Descrição
Indica o Code-Block executado na ação do botão "Limpar"

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

bCleanFilterCode-BlockCode-Block executado na ação do botão "Limpar"
X


 
SetField
Sintaxe
FWFilter():SetField(< aFields >)-> NIL

Descrição
Indica os campos disponíveis para edição dos filtros

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

aFieldsArray of RecordsEstrutura do array
[n][01] Campo
[n][02] Título
[n][03] Tipo de dado
[n][04] Tamanho
[n][05] Decimal
[n][06] Picture
[n][07] aOptions
[n][08] cLookUp
[n][09] bValid Indica o Code-Block de validação do campo
[n][10] xAnswer Resposta para a pergunta

X


 
SetFinish
Sintaxe
FWFilter():SetFinish(< bFinish >)-> NIL

Descrição
Code-Block executado na finalização da janela localizar

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

bFinishCode-BlockCode-Block executado a ser executado
X


 
SetOnStart
Sintaxe
FWFilter():SetOnStart(< bOnStart >)-> NIL

Descrição
Indica o Code-Block executado na criação do componente de filtro

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

bOnStartCode-BlockCode-Block executado na criação do componente de filtro
X


 
SetProfileID
Sintaxe
FWFilter():SetProfileID(< cProfielID >)-> NIL

Descrição
Define o identificador do Browse utiliza na gravação das configurações no profile do usuário. Deve ser utilizado quando existir mais de um filtro na rotina.

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

cProfielIDCaracteresIdentificador do Filtro
X


 
SetRelation
Sintaxe
FWFilter():SetRelation(< aRelation >, < bChangeFields >)-> NIL

Descrição
Indica que deverá disponibilizar a opção de relacionamento de tabelas no filtro

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

aRelationArray of RecordsArray contendo os itens do relacionamento
aRelation[n,1] - Se .T., indica que o relacionamento foi selecionado
aRelation[n,2] - Alias
aRelation[n,3] - Descrição da tabela
aRelation[n,4] - Campos de relacionamento da tabela do principal
aRelation[n,5] - Campos de relacionamento da tabela do alias

X

bChangeFieldsCode-BlockIndica o Code-Block executado para trocar os campos para o filtro
X


 
SetSqlFilter
Sintaxe
FWFilter():SetSqlFilter(< lSqlFilter >)-> NIL

Descrição
Indica que deverá disponibilizar a expressão SQL do filtro

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

lSqlFilterLógicoIndica que deverá disponibilizar a expressão SQL do filtro
X


 
SetOwner
Sintaxe
FWFilter():SetOwner(< oOwner >)-> NIL

Descrição
Indica o container para criação do filtro

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

oOwnerObjetoObjeto container
X


 
SetValidExecute
Sintaxe
FWFilter():SetValidExecute(< bValidExecute >)-> NIL

Descrição
Define um bloco de códigos para validar se o filtro deve ser executado

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

bValidExecuteCode-BlockBloco de código a ser utilizado
X


 
Show
Sintaxe
FWFilter():Show()-> NIL

Descrição
Torna o filtro visível
UnCheckFilter
Sintaxe
FWFilter():UnCheckFilter(< cID >)-> NIL

Descrição
Permite desmarcar a execução de filtros específicos

Parâmetros



NomeTipoDescriçãoDefaultObrigatórioReferência

cIDCaracteresIdentificador do Filtro
X


 
Valid
Sintaxe
FWFilter():Valid()-> lValid

Descrição
Retorna se deverá realizar a validação do filtro informado pelo usuário

Retorno
lValid Indica se deverá realizar a validação do filtro informado pelo usuário
Visible
Sintaxe
FWFilter():Visible()-> lVisible

Descrição
Retorna se o filtro está visível

Retorno
lVisible Indica se o filtro está visível
  • Sem rótulos