cAliasCaractereObrigatório
Alias SX2/SX3.
FUNçãOEm revisão
BuildExpr
BuildExpr( <cAlias>, [oWnd], <cFilter>, [lTopFilter], [bOk], [oDlg], [aUsado], [cDesc], [nRow], [nCol], [aCampo], [lVisibleTopFilter], [lExpBtn], [cTopFilter] ) --> cRetAbre um construtor visual de expressão de filtro pelo dicionário.
Visão geral
BuildExpr usa SX2/SX3 para oferecer campos e construir uma expressão de filtro. A ficha histórica apresenta 14 posições; cAlias e cFilter são necessários no contrato descrito, por isso o exemplo passa uma string vazia explicitamente na terceira posição, mantendo Nil para o objeto de janela. O texto retornado não equivale a uma consulta executada. Restrições de campos podem ser configuradas por aUsado/aCampo; não converter livremente texto recebido em código nem supor que o construtor autorize acesso aos dados. Exige sessão interativa e alias registrado e aberto. (TOTVS, s.d., ref. 1)
Sintaxe
BuildExpr( <cAlias>, [oWnd], <cFilter>, [lTopFilter], [bOk], [oDlg], [aUsado], [cDesc], [nRow], [nCol], [aCampo], [lVisibleTopFilter], [lExpBtn], [cTopFilter] ) --> cRetParâmetros
oWndObjetoOpcional
Janela de referência.
cFilterCaractereObrigatório
Expressão inicial, podendo ser vazia.
lTopFilterLógicoOpcional
Permite expressão TOP; padrão falso.
bOkBloco de códigoOpcional
Validação, condicionada ao uso de oDlg.
oDlgObjetoOpcional
Diálogo relacionado ao processamento.
aUsadoArrayOpcional
Campos usados/restritos conforme contrato da ficha.
cDescCaractereOpcional
Descrição da expressão.
nRowNuméricoOpcional
Linha de posicionamento.
nColNuméricoOpcional
Coluna de posicionamento.
aCampoArrayOpcional
Configuração de campos.
lVisibleTopFilterLógicoOpcional
Visibilidade de filtro TOP.
lExpBtnLógicoOpcional
Controle do botão de expressão.
cTopFilterCaractereOpcional
Expressão TOP inicial.
Retorno
Caractere com expressão de filtro; o exemplo somente consulta seu tamanho se o tipo for C.
Exemplo comentado
#Include "Protheus.ch"
User Function EdBuildex()
Local cFiltro := ""
// SA1 deve estar aberta em sessao interativa de homologacao.
If Select("SA1") > 0
cFiltro := BuildExpr("SA1", Nil, cFiltro, .F.)
If ValType(cFiltro) == "C"
ConOut(cValToChar(Len(cFiltro)))
EndIf
EndIf
Return NilResultado esperado
Comprimento depende da interação; não aplica filtro, executa consulta ou grava registros. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Conferir os 14 argumentos na referência da versão instalada. Preservar contexto do chamador e validar campos e expressão antes de qualquer aplicação posterior.
- 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.