bCondBloco de códigoObrigatório
Bloco que retorna lógico para cada registro.
FUNçãOEm revisão
DBSetFilter
DBSetFilter( bCond, cCond ) --> NilDefine uma condição de visibilidade na área.
Visão geral
DBSetFilter recebe bloco lógico e expressão textual equivalentes. A chamada não reposiciona imediatamente: DBGoTop aplica a navegação ao filtro. DBGoTo pode alcançar registros fisicamente fora dele, portanto filtro não substitui autorização. A demonstração requer ED_COD caractere na tabela própria e mantém filtro/posição alterados; a rotina completa precisa administrar esse estado. EDTRB identifica exclusivamente uma tabela própria de teste, já aberta com a estrutura e os direitos necessários; os exemplos não se destinam a tabelas padrão. (TOTVS, s.d., ref. 1)
Sintaxe
DBSetFilter( bCond, cCond ) --> NilParâmetros
cCondCaractereObrigatório
Expressão equivalente ao bloco.
Retorno
Nil; não é um indicador lógico de sucesso.
Exemplo comentado
#Include "Protheus.ch"
User Function Ed337()
// ED_COD deve existir como caractere na tabela propria.
If Select("EDTRB") > 0
EDTRB->(DBSetFilter({|| ED_COD == "A"}, "ED_COD == 'A'"))
EDTRB->(DBGoTop())
ConOut(cValToChar(!EDTRB->(Eof())))
EndIf
Return NilResultado esperado
Indica se há registro visível com o código fictício; depende da tabela. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Conferir RDD, alias e operações pendentes. Navegação pode efetivar atualizações; preservar contexto conforme o contrato do chamador e tratar erros na rotina completa.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.