Histórico da Página
| Composition Setup |
|---|
import.css=/download/attachments/327912/newLayout.css |
Classe: FWFormGridModel
| 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ão | P10 R1.4 |
Descrição
Fornece um objeto com o submodelo de edição FormGrid.
Um submodelo do tipo Grid permite manipular diversos registros por
vez. Ele tem um relacionamento do tipo Nx1 ou NxM com outros submodelos.
Um submodelo do tipo Grid permite manipular diversos registros por
vez. Ele tem um relacionamento do tipo Nx1 ou NxM com outros submodelos.
ClassName
Sintaxe
FWFORMGRIDMODEL():ClassName()-> NIL
Descrição
Fornece o nome da classe
SetLPost
Sintaxe
FWFORMGRIDMODEL():SetLPost(<bLinePost >)-> NIL
Descrição
Configura o bloco de código de pós validação da linha do grid.
A Pós-validação será realizada na validação do submodelo no momento da
gravação dos dados e durante a inclusão de uma nova linha.
A Pós-validação será realizada na validação do submodelo no momento da
gravação dos dados e durante a inclusão de uma nova linha.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| bLinePost | Bloco de Código | Bloco de código de pós validação da linha | X |
SetLPre
Sintaxe
FWFORMGRIDMODEL():SetLPre(<bLinePre >)-> NIL
Descrição
Configura o bloco código de pré validação da linha do grid.
O bloco será invocado durante qualquer tentativa de atribuição
de valor na linha.
O Bloco deve retornar um valor lógico, caso retorne falso
a atribuição de valor não será permitida.
O bloco será invocado durante qualquer tentativa de atribuição
de valor na linha.
O Bloco deve retornar um valor lógico, caso retorne falso
a atribuição de valor não será permitida.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| bLinePre | Bloco de Código | bloco código de pré validação da linha | X |
SetUseOldGrid
Sintaxe
FWFORMGRIDMODEL():SetUseOldGrid([ lUseCols ])-> NIL
Descrição
Indica que o submodelo deve trabalhar com acols/aheader.
Este método é utilizado para compatibilizar com o Browse antigo do Protheus
Este método é utilizado para compatibilizar com o Browse antigo do Protheus
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| lUseCols | Lógico | Define se ira trabalhar com acols/aheader. | .T. |
SetStruct
Sintaxe
FWFORMGRIDMODEL():SetStruct(<oFormModelStruct >)-> NIL
Descrição
Configura o objeto com a estrutura de dados
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| oFormModelStruct | Objeto | Objeto com a estrutura de dados. | X |
GetOldData
Sintaxe
FWFORMGRIDMODEL():GetOldData()-> aData
Descrição
Fornece um objeto com a folha de dados de compatibilidade com o aCols/aHeader.
Retorno
aData Array com a seguinte estrutura:
[1] aHeader
[2] aCols
[1] aHeader
[2] aCols
AddLine
Sintaxe
FWFORMGRIDMODEL():AddLine()-> nLine
Descrição
O grid inicia sempre com uma linha. Esse método AddLine deve ser usado para
adicionar novas linhas.
O método retorna a quantidade total de linhas da grid. Se a grid já possui 2 linhas e
tudo correu bem na adição da linha, o AddLine retornara 3, se ocorreu algum problema
retornará 2, pois a nova linha não foi inserida.
Os motivos para a inserção não ser bem sucedida podem ser algum campo obrigatório não
informado, a pós-validação da linha retornou falso ou o grid atingiu a quantidade
máxima de linhas, por exemplo.
Se a linha for incluida com sucesso o grid posiciona na mesma.
adicionar novas linhas.
O método retorna a quantidade total de linhas da grid. Se a grid já possui 2 linhas e
tudo correu bem na adição da linha, o AddLine retornara 3, se ocorreu algum problema
retornará 2, pois a nova linha não foi inserida.
Os motivos para a inserção não ser bem sucedida podem ser algum campo obrigatório não
informado, a pós-validação da linha retornou falso ou o grid atingiu a quantidade
máxima de linhas, por exemplo.
Se a linha for incluida com sucesso o grid posiciona na mesma.
Retorno
nLine Indica a quantidade de linhas do grid
Veja também
Length
UnDeleteLine
Sintaxe
FWFORMGRIDMODEL():UnDeleteLine()-> lDeleted
Descrição
Desfaz a deleção da linha atual no Grid.
Retorno
lDeleted Indica se a deleção foi desfeita com sucesso.
DeleteLine
Sintaxe
FWFORMGRIDMODEL():DeleteLine()-> lDeleted
Descrição
Deleta a linha atual no Grid e posiciona na linha anterior.
Retorno
lDeleted Indica se a linha foi deletada com sucesso
IsUpdated
Sintaxe
FWFORMGRIDMODEL():IsUpdated([ nLine ])-> lUpdated
Descrição
Indica se a linha recebeu valores
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| nLine | Numérico | Indica a linha a ser verificada | ::NLINE |
Retorno
lUpdated Indica se a linha recebeu valores
SetNoInsertLine
Sintaxe
FWFORMGRIDMODEL():SetNoInsertLine([ lSet ])-> NIL
Descrição
Especifica que o grid não pode receber inserção de linha
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| lSet | Lógico | Especifica se a inserção deve esta ligada .F. ou desligada .T. | .T. |
SetNoUpdateLine
Sintaxe
FWFORMGRIDMODEL():SetNoUpdateLine([ lSet ])-> NIL
Descrição
Especifica que o grid não pode receber alteração nas linhas
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| lSet | Lógico | Especifica se a alteração deve esta ligada .F. ou desligada .T. | .T. |
SetNoDeleteLine
Sintaxe
FWFORMGRIDMODEL():SetNoDeleteLine([ lSet ])-> NIL
Descrição
Especifica que o grid não pode receber exclusão de linha
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| lSet | Lógico | Especifica se a exclusão deve esta ligada .F. ou desligada .T. | .T. |
IsDeleted
Sintaxe
FWFORMGRIDMODEL():IsDeleted([ nLine ])-> lDeleted
Descrição
Fornece se a linha esta deletada
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| nLine | Numérico | Indica a linha a ser verificada | ::NLINE |
Retorno
lDeleted Indica se a linha esta deletada
SetLine
Sintaxe
FWFORMGRIDMODEL():SetLine([ nLine ])-> nLine
Descrição
Altera a linha em que o Grid está posicionado, se e somente se, a linha atual estiver valida.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| nLine | Numérico | Numero da linha | 0 |
Retorno
nLine Indica a linha atualmente posicionada
GoLine
Sintaxe
FWFORMGRIDMODEL():GoLine(<nLine >)-> nLine
Descrição
Altera a linha em que o Grid está posicionado, mesmo se a linha atual
estiver invalida
estiver invalida
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| nLine | Numérico | Numero da linha do grid que será utilizado como DEFAULT | X |
Retorno
nLine Indica a linha atual
Veja também
SetLine
GetLine
Sintaxe
FWFORMGRIDMODEL():GetLine()-> nLine
Descrição
Fornece a linha do atuamente posicionada no Grid
Retorno
nLine Indica a linha atual
SetValue
Sintaxe
FWFORMGRIDMODEL():SetValue(<cId >, [ xValue ])-> lAtribuido
Descrição
Atribui um valor a folha de dados do submodelo
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| cId | Caracteres | Codigo/Nome do atributo da folha de dados | X | ||
| xValue | Qualquer | Valor a ser atribuido | ::ADATAMODEL[::NLINE][MODEL_GRID_DATA][MODEL_GRIDLINE_VALUE][NIDFIELD] |
Retorno
lAtribuido Indica que o valor foi atribuido
Veja também
CanSetValue
LoadValue
Sintaxe
FWFORMGRIDMODEL():LoadValue(<cId >, [ xValue ])-> lAtribuido
Descrição
Carrega um valor a folha de dados do objeto. Este metodo somente pode ser utilizado quando há SetValue na pilha de chamadas
de função ( CallStack ). Diferentemente do metodo SetValue, este método não executa a validação do campo, mas fornece
todas as indicações de que ele foi atualizado. Ele é muito utíl quando dentro de uma validação de campo, necessitamos
alterar valores de outros campos, sem que isto implique em valida-los.
de função ( CallStack ). Diferentemente do metodo SetValue, este método não executa a validação do campo, mas fornece
todas as indicações de que ele foi atualizado. Ele é muito utíl quando dentro de uma validação de campo, necessitamos
alterar valores de outros campos, sem que isto implique em valida-los.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| cId | Caracteres | Codigo/Nome do atributo da folha de dados | X | ||
| xValue | Qualquer | Valor a ser atribuido |
Retorno
lAtribuido Indica que o valor foi atribuido
GetValue
Sintaxe
FWFORMGRIDMODEL():GetValue(<cId >, [ nLine ])-> xRetorno
Descrição
Fornece o valor da folha de dados de um campo do submodelo
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| cId | Caracteres | Codigo/Nome do atributo da folha de dados | X | ||
| nLine | Numérico | Numero da linha | ::NLINE |
Retorno
xRetorno Valor do campo
VldLineData
Sintaxe
FWFORMGRIDMODEL():VldLineData(<lVldOwner >)-> lRetorno
Descrição
Valida a linha atualmente posicionada no grid
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| lVldOwner | Lógico | Verifica se será validado o submodelo e seus filhos (.T.) ou se será validado apenas o contexto do submodelo (.F.) | .T. | X |
Retorno
lRetorno Indica que a linha atual está valida
VldData
Sintaxe
FWFORMGRIDMODEL():VldData(<lVldOwner >)-> lRetorno
Descrição
Valida a folha de dados do submodelo
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| lVldOwner | Lógico | Verifica se será validado o submodelo e seus filhos (.T.) ou se será validado apenas o contexto do submodelo (.F.) | .T. | X |
Retorno
lRetorno Indica que a folha de dados é valida
CanSetValue
Sintaxe
FWFORMGRIDMODEL():CanSetValue(<cId >)-> lRetorno
Descrição
Verificar se pode-se atribuir um valor a folha de dados do submodelo
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| cId | Caracteres | Codigo/Nome do atributo da folha de dados | X |
Retorno
lRetorno Indica se o valor foi atribuido
SetLoadFilter
Sintaxe
FWFORMGRIDMODEL():SetLoadFilter([ aLoadFilter ], [ cLoadFilter ])-> NIL
Descrição
Atribui o critério de filtro a ser usado na carga do formulário de dados
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| aLoadFilter | Array | Estrutura de filtro [n] Array [n][1] ExpC: ID do campo do submodelo de destino [n][2] ExpC: Valor que o campo deve usar no filtro [n][3] Operador Relacional (Opcional, default é MVC_LOADFILTER_EQUAL ) MVC_LOADFILTER_EQUAL Igual a MVC_LOADFILTER_NOT_EQUAL Diferente de MVC_LOADFILTER_LESS Menor que MVC_LOADFILTER_LESS_EQUAL Menor que ou Igual a MVC_LOADFILTER_GREATER Maior que MVC_LOADFILTER_GREATER_EQUAL Maior que ou Igual a MVC_LOADFILTER_CONTAINS Contém MVC_LOADFILTER_NOT_CONTAINS Não Contém MVC_LOADFILTER_IS_CONTAINED Está Contido Em MVC_LOADFILTER_IS_NOT_CONTAINED Não Está Contido Em Para os operadores relacionais MVC_LOADFILTER_IS_CONTAINED e MVC_LOADFILTER_IS_NOT_CONTAINED o 2o elemento de cada array deverá ser uma array em formato caracter oModel:GetModel( 'ZA2DETAIL' ):SetLoadFilter( { { 'ZA2_AUTOR', "{'000500','000501','000502','000503','000504'}", MVC_LOADFILTER_IS_CONTAINED } } ) [n][4] Operador Logico (Opcional, default MVC_LOADFILTER_AND ) MVC_LOADFILTER_AND "e" MVC_LOADFILTER_OR "ou" | {} | ||
| cLoadFilter | Caracteres | Expressao de filtro - Se for informado o parâmetro de expressão de filtro o 1o parâmetro será ignorado - Deve-se prever no código que a expressão tenha a sintaxe para banco de dados ou não, conforme o caso. | "" |
Exemplo
// Para dado igual a
oModel:GetModel( 'IDGRID' ):SetLoadFilter( { { 'ZA2_AUTOR', "'000500'" } } )
// Para dado igual a um ou outro valor
oModel:GetModel( 'IDGRID' ):SetLoadFilter( { { 'ZA2_AUTOR', "'000500'" }, { 'ZA2_AUTOR', "'000600'",, MVC_LOADFILTER_OR } } )
// Para dado diferente
oModel:GetModel( 'IDGRID' ):SetLoadFilter( { { 'ZA2_AUTOR', "'000500'", MVC_LOADFILTER_NOT_EQUAL } } )
// Para dado maior que valor
oModel:GetModel( 'IDGRID' ):SetLoadFilter( { { 'ZA2_VALOR', "0", MVC_LOADFILTER_GREATER } } )
// Para dado entre um valor e outro
oModel:GetModel( 'IDGRID' ):SetLoadFilter( { { 'ZA2_VALOR', "0", MVC_LOADFILTER_GREATER_EQUAL }, { 'ZA2_VALOR', "100", MVC_LOADFILTER_LESS_EQUAL } } )
// Para dado que contém um valor
oModel:GetModel( 'IDGRID' ):SetLoadFilter( { { 'ZA2_AUTOR', "'0005'", MVC_LOADFILTER_CONTAINS } } )
// Para dado que está contido
oModel:GetModel( 'IDGRID' ):SetLoadFilter( { { 'ZA2_AUTOR', "{'000500','000501'}", MVC_LOADFILTER_IS_CONTAINED } } )
// Usando uma expressão
oModel:GetModel( 'IDGRID' ):SetLoadFilter( , " ( ZA2_AUTOR >= '000500' .AND. ZA2_AUTOR < '000600' ) .OR. ZA2_VALOR > 0 " )
GetLoadFilter
Sintaxe
FWFORMGRIDMODEL():GetLoadFilter()-> aRelation
Descrição
Fornece o critério de filtro na carga do formulário de dados
Retorno
aRelation Estrutura de relacionamento
[1] cIdField do submodelo de destino
[2] cIdField ou expressão do submodelo de destino
[3] Operador
[1] cIdField do submodelo de destino
[2] cIdField ou expressão do submodelo de destino
[3] Operador
SetUniqueLine
Sintaxe
FWFORMGRIDMODEL():SetUniqueLine(<aUnique >, [ bUnique ])-> NIL
Descrição
Define que determinado(s) campo(s) não pode ser repetido dentro do grid.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| aUnique | Array | Array unidimensional com os IDs dos campos | X | ||
| bUnique | Bloco de Código | Bloco de código de execução quando há linha duplicada. O bloco deve retornar um valor lógico. |
Exemplo
oModel:GetModel( 'ZA2DETAIL' ):SetUniqueLine( { "ZA2_AUTOR" , "ZA2_ITEM"} )
SetDelAllLine
Sintaxe
FWFORMGRIDMODEL():SetDelAllLine([ lDelAllLine ])-> NIL
Descrição
Especifica se todas as linha do grid podem ser apagadas.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| lDelAllLine | Lógico | Indica se todas as linhas podem ser apagadas | .F. |
GetQTDLine
Sintaxe
FWFORMGRIDMODEL():GetQTDLine()-> NIL
Descrição
Retornar a quantidade de linhas do grid.
Obsoleto
Use o método Length
Length
Sintaxe
FWFORMGRIDMODEL():Length([ lOnlyActive ])-> nMax
Descrição
Retorna a quantidade de linhas que o grid possui
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| lOnlyActive | Lógico | Se for verdadeiro retorna só a quantidade de linhas ativas (não deletadas) | .F. |
Retorno
nMax Quantidade de linhas
CanInsertLine
Sintaxe
FWFORMGRIDMODEL():CanInsertLine()-> lInsertLine
Descrição
Informa se o grid aceita a inserção de novas linhas
Retorno
lInsertLine Se verdadeiro o grid permite a inclusão de linhas
CanUpdateLine
Sintaxe
FWFORMGRIDMODEL():CanUpdateLine()-> lUpdateLine
Descrição
Informa se o grid aceita edição nas linhas
Retorno
lUpdateLine Se verdadeiro o grid permite a edição de linhas
CanDeleteLine
Sintaxe
FWFORMGRIDMODEL():CanDeleteLine()-> lDeleteLine
Descrição
Informa se o grid aceita que as linhas sejam apagadas
Retorno
lDeleteLine Se verdadeiro o grid permite a exclusão de linhas
SeekLine
Sintaxe
FWFORMGRIDMODEL():SeekLine(<aBusca >, [ lDeleted ])-> lRetorno
Descrição
Localiza uma linha baseada no contéudo dos campos informados
como parametro. Se houver mais de uma linha com os valores procurados,
o método irá retornar a primeira linha que for encontrada.
Se a linha for encontrada o grid posiciona nessa linha, não sendo necessário
posicionar novamente.
como parametro. Se houver mais de uma linha com os valores procurados,
o método irá retornar a primeira linha que for encontrada.
Se a linha for encontrada o grid posiciona nessa linha, não sendo necessário
posicionar novamente.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| aBusca | Array | Array com os dados de busca na seguinte estrutura: [n] [n][1] ExpC: Id do campo [n][2] ExpX: Conteudo | X | ||
| lDeleted | Lógico | Indica se considera as linhas deletadas na busca | .F. |
Retorno
lRetorno Indica se a linha foi encontrada
Exemplo
oGrid:SeekLine({{"XXH_MODULO",cModule},{"XXH_CODIGO",cCode}})
IsFieldUpdated
Sintaxe
FWFORMGRIDMODEL():IsFieldUpdated(<cID >, [ nLine ])-> lRet
Descrição
Retorna se um Campo foi atualizado
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| cID | Caracteres | Codigo do Field | X | ||
| nLine | Numérico | Numero da Linha | ::NLINE |
Retorno
lRet Indica que o valor foi Atualizado
SetMaxLine
Sintaxe
FWFORMGRIDMODEL():SetMaxLine(<nMax >)-> NIL
Descrição
Determina quantas linhas o grid pode possuir.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| nMax | Numérico | Valor máximo | X |
Veja também
GetMaxLines
GetMaxLines
Sintaxe
FWFORMGRIDMODEL():GetMaxLines()-> nMAx
Descrição
Retorna quantas linhas o grid pode possuir
Retorno
nMAx Quantidade maxima de linhas permitidas no grid
Veja também
SetMaxLine
IsLineValidate
Sintaxe
FWFORMGRIDMODEL():IsLineValidate([ nLine ])-> lRet
Descrição
Analisa se uma determinada linha está valida
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| nLine | Numérico | Linha a analisar | ::NLINE |
Retorno
lRet Se verdadeiro a linha esta valida
ClearField
Sintaxe
FWFORMGRIDMODEL():ClearField(<cId >, [ nLine ], [ lClearTrigger ])-> lAtribuido
Descrição
Limpa o conteudo de um campo
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| cId | Caracteres | Codigo/Nome do atributo da folha de dados | X | ||
| nLine | Numérico | Indica a linha | ::NLINE | ||
| lClearTrigger | Lógico | Indica se limpa os campos gatilhados | .F. |
Retorno
lAtribuido Indica se o campo foi limpo
IsEmpty
Sintaxe
FWFORMGRIDMODEL():IsEmpty()-> lRet
Descrição
Verifica se o grid não possui nenhuma linha.
Retorno
lRet Se verdadeiro o submodelo esta em branco.
IsInserted
Sintaxe
FWFORMGRIDMODEL():IsInserted([ nLine ])-> lInserted
Descrição
Verifica se uma linha é nova no grid, ou seja, ela não existia e foi
criada pelo método addLine.
criada pelo método addLine.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| nLine | Numérico | Indica a linha a ser verificada | ::NLINE |
Retorno
lInserted Indica se a linha foi inserida
SetOnlyView
Sintaxe
FWFORMGRIDMODEL():SetOnlyView()-> NIL
Descrição
Define que o submodelo não irá permitir a edição de dados.
Se a operação for inclusão o when dos campos passará a ser falso
e se for qualquer outra operação os campos não permitirão edição.
Além disse não permite inserção e nem exclusão de linhas.
Se a operação for inclusão o when dos campos passará a ser falso
e se for qualquer outra operação os campos não permitirão edição.
Além disse não permite inserção e nem exclusão de linhas.
IsModified
Sintaxe
FWFORMGRIDMODEL():IsModified()-> NIL
Descrição
Retorna se o submodelo não foi modificado.
GetDataId
Sintaxe
FWFORMGRIDMODEL():GetDataId([ nLine ])-> nID
Descrição
Fornece o recno do registro de origem dos dados da linha
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| nLine | Numérico | Indica a linha a ser verificada | ::NLINE |
Retorno
nID ID dos dados da Linha
nID ID do registro
nID ID do registro
InitValue
Sintaxe
FWFORMGRIDMODEL():InitValue(<cIdField >)-> xValue
Descrição
Fornece o valor do inicializador padrao da folha de dados de um campo
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| cIdField | Caracteres | Codigo/Nome do atributo da folha de dados | X |
Retorno
xValue Valor do inicializador do campo
Compare
Sintaxe
FWFORMGRIDMODEL():Compare(<aCompare >, <oFWFormGridModel >)-> NIL
Descrição
Faz a comparação entre os dados de um objeto do tipo FWFormGridModel passado por referência
com o próprio objeto. Os dois objetos devem possuir a mesma estrutura, pois esse
método compara apenas os dados, supondo que a estrutura seja a mesma.
com o próprio objeto. Os dois objetos devem possuir a mesma estrutura, pois esse
método compara apenas os dados, supondo que a estrutura seja a mesma.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| aCompare | Array | - Array que deve ser passado por referencia,para que o metodo salve as informações de diferencas no formato: [n][1] - ExpC: ID do subModelo [n][2] - ExpC: Tipo (G) [n][3] - ExpA: SubArray com os campos alterados [n][3][1] - ExpN: Número da linha no submodelo do Model [n][3][2] - ExpC: Operação da linha (3 - Inclusão , 4 - Alteração ou 5 - Exclusão ) [n][3][3][1] - ExpC: ID do Campo [n][3][3][1] - ExpX: Valor do Modelo(self) [n][3][3][1] - ExpX: Valor do modelo passado no segundo parametro | X | ||
| oFWFormGridModel | Objeto | - Outro FWFormGridModel para ser feita a comparação, ele deve possuir exatamente a mesma estrutura. | X |
LineShift
Sintaxe
FWFORMGRIDMODEL():LineShift([ nLineFrom ], [ nLineTo ])-> NIL
Descrição
Realiza uma troca de dados entre duas linhas. Os dados da linha origem
serão movidos para a linha destino e os dados da linha destino serão
movidos para a linha origem.
Se a linha atualmente posicionada é a origem ou o destino, o número
da linha posicionada irá ser mudado para o numero da origem ou do
destino, porque os dados são trocados porém a linha ainda precisa
ser validada.
serão movidos para a linha destino e os dados da linha destino serão
movidos para a linha origem.
Se a linha atualmente posicionada é a origem ou o destino, o número
da linha posicionada irá ser mudado para o numero da origem ou do
destino, porque os dados são trocados porém a linha ainda precisa
ser validada.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| nLineFrom | Numérico | Numero da linha de origem | ::NLINE | ||
| nLineTo | Numérico | Numero da linha de destino | ::NLINE |
Exemplo
oModel:GetModel("ZA2DETAIL"):LineShift(5,6)
GetLinesChanged
Sintaxe
FWFORMGRIDMODEL():GetLinesChanged([ nType ])-> NIL
Descrição
Retorna um array unidimensional com o numero das linhas que sofreram alguma modificação
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| nType | Numérico | Tipo da informação: MODEL_GRID_LINECHANGED_ALL Todas as linhas modificadas MODEL_GRID_LINECHANGED_INSERTED Somente as linhas inseridas MODEL_GRID_LINECHANGED_UPDATED Somente as linhas alteradas MODEL_GRID_LINECHANGED_DELETED Somente as linhas excluidas | MODEL_GRID_LINECHANGED_ALL |
SetLineModify
Sintaxe
FWFORMGRIDMODEL():SetLineModify(<nLine >)-> NIL
Descrição
Define a linha como modificada
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| nLine | Numérico | Numero da Linha | X |
LdValueByPos
Sintaxe
FWFORMGRIDMODEL():LdValueByPos(<cId >, [ xValue ])-> lAtribuido
Descrição
Carrega um valor para a folha de dados através de acesso direto a posicao
do campo na estrutura. Use esse método somente quando possuir um
grande volume de processsamento na rotina.
Para determinar a posicao do campo utilize o metodo GetArrayPos da
estrutura de dados do submodelo (FWFormModelStruct).
O valor será atribuido para a linha que estiver posicionada no grid.
do campo na estrutura. Use esse método somente quando possuir um
grande volume de processsamento na rotina.
Para determinar a posicao do campo utilize o metodo GetArrayPos da
estrutura de dados do submodelo (FWFormModelStruct).
O valor será atribuido para a linha que estiver posicionada no grid.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| cId | Caracteres | Codigo/Nome do atributo da folha de dados | X | ||
| xValue | Qualquer | Valor a ser atribuido |
Retorno
lAtribuido Indica que o valor foi atribuido
Exemplo
aPosFields := oStruZA2:GetArrayPos("ZA2_MUSICA", "ZA2_ITEM")
oModel:GetModel("ZA2DETAIL"):LdValueByPos(aPosFields[1], "00001")
oModel:GetModel("ZA2DETAIL"):LdValueByPos(aPosFields[2], "1")
Veja também
GetValueByPos
GetArrayPos -> FWFormModelStruct
GetValueByPos
Sintaxe
FWFORMGRIDMODEL():GetValueByPos(<nIdPos >, [ nLine ])-> NIL
Descrição
Fornece o valor da folha de dados de um campo, baseado na posição dele
na estrutura, utilize ele somente quando a rotina possui um grande volume
processamento. Para saber a posicao do campo use o metodo GetArrayPos
do objeto de estrutura de dados (FWFormModelStruct).
Atenção!! Esse metodo nao verifica se o campo existe.
na estrutura, utilize ele somente quando a rotina possui um grande volume
processamento. Para saber a posicao do campo use o metodo GetArrayPos
do objeto de estrutura de dados (FWFormModelStruct).
Atenção!! Esse metodo nao verifica se o campo existe.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| nIdPos | Numérico | Posicao do campo na estrutura de dados | X | ||
| nLine | Numérico | Linha do grid onde o valor será atribuido | ::NLINE |
Exemplo
aPosFields := oStruZA2:GetArrayPos("ZA2_MUSICA", "ZA2_ITEM")
cMusica := oModel:GetModel("ZA2DETAIL"):GetValueByPos(aPosFields[1], 1)
cItem := oModel:GetModel("ZA2DETAIL"):GetValueByPos(aPosFields[2], 2)
Veja também
GetArrayPos -> FWFormModelStruct
LdValueByPos
SetFldNoCopy
Sintaxe
FWFORMGRIDMODEL():SetFldNoCopy(<aFldNoCopy >)-> NIL
Descrição
Define quais campos do submodelo não serão copiados no processo de cópia
do submodelo.
do submodelo.
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| aFldNoCopy | Array | Array unidimensional com o IDs do campos que não serão copiados | X |
Exemplo
oModel:GetModel("ZA2DETAIL"):SetFldNoCopy( { 'ZA2_MUSICA', 'ZA2_ITEM' } )
GetFldNoCopy
Sintaxe
FWFORMGRIDMODEL():GetFldNoCopy()-> NIL
Descrição
Retorna quais campos do formulário não serão copiados no processo de cópia
CanClearData
Sintaxe
FWFORMGRIDMODEL():CanClearData()-> NIL
Descrição
Determina se o ClearData pode ser executado.
Se veio de banco não permite.
Se veio de banco não permite.
isEnable
Sintaxe
FWFORMGRIDMODEL():isEnable()-> lRet
Descrição
Executa o bloco de bPre do modelo, retornando se ele está disponivel para edição ou não
Retorno
lRet - Indica se o modelo está disponivel
MaxValueField
Sintaxe
FWFORMGRIDMODEL():MaxValueField(<cFieldID >)-> nMax
Descrição
Retorna o valor maximo de um campo do grid, o campo precisa ser numerico
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| cFieldID | Caracteres | cFieldID | X |
Retorno
nMax Maior valor
InstallObserver
Sintaxe
FWFORMGRIDMODEL():InstallObserver(<cPoint >, <oObserver >)-> NIL
Descrição
Faz a instalaçao de um Observador em uma ação
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| cPoint | Caracteres | ID do local, ids disponíves "SETINSERTLINE" | X | ||
| oObserver | Objeto | Objeto que precisa derivar da classe FWObserver | X |
Veja também
FWObserver
getObservable
Sintaxe
FWFORMGRIDMODEL():getObservable(<cPoint >)-> oObserable
Descrição
Retorna um Observable baseado numa ação
Parâmetros
| Nome | Tipo | Descrição | Default | Obrigatório | Referência |
| cPoint | Caracteres | ID do local, ids disponíves "SETINSERTLINE" | X |
Retorno
oObserable Objeto do tipo FWObserable
Veja também
FWObservable
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas