Histórico da Página
Fornece um objeto do tipo grid que permite a exibição de dados do tipo array, texto, tabela e query.
...
Construtor da classe.FWBrowse(): New ( [ oOwner] ) --> oSelf |
---|
|
---|
oSelf
oBrowse := FWBrowse():New() |
---|
...
Ativação da classe.FWBrowse(): Activate ( [ lFWBrowse] ) --> |
---|
|
---|
oBrowse:Activate() |
---|
Permite adicionar a informacao de um browse relacionado.FWBrowse(): AddBrwRelation ( < oBrwRel> ) --> |
---|
|
---|
Adiciona uma coluna no Browse em tempo de execução.FWBrowse(): AddColumn ( < aColumn> ) --> |
---|
|
---|
aColumn Estrutura da Coluna [n][01] Título da coluna |
---|
Permite adicionar uma configuração customizada na opção de configuração do Browse.FWBrowse(): AddCustomConfig ( < cTitle>, < bView>, [ bSave] ) --> |
---|
|
---|
|
---|
|
---|
oBrowse:AddCustomConfig("Filial",{|o| MBrFilialCfg(o,Self) }, { || MBrSaveFilCfg(Self) } ) |
---|
Permite adicionar um filtro na lista de opções de filtros do Browse.FWBrowse(): AddFilter ( < cFilter>, < cExpAdvPL>, [ lNoCheck], [ lSelected], [ cAlias], [ lFilterAsk], [ aFilParser], [ cID] ) --> |
---|
|
---|
|
---|
|
---|
|
---|
|
---|
|
---|
|
---|
|
---|
oBrowse:AddFilter(cTitle,xCondition) |
---|
Permite adicionar uma coluna com a opção de marca e desmarca.FWBrowse(): AddMarkColumns ( < bMark>, [ bLDblClick], [ bHeaderClick] ) --> |
---|
|
---|
|
---|
|
---|
Permite adicionar uma coluna de status.FWBrowse(): AddStatusColumns ( < bStatus>, [ bLDblClick] ) --> |
---|
|
---|
|
---|
Retorna o Alias utilizado no Browse.FWBrowse(): Alias ( ) --> cAlias cAlias
|
---|
Executa o Code-Block definido no método SetAllOK(bAllOK).FWBrowse(): AllOk ( ) --> lReturn lReturn
|
---|
Retorna a posição atual do registro.FWBrowse(): At ( ) --> nAt nAt
|
---|
Retorna o componente Browse (TGRID).FWBrowse(): Browse ( ) --> oBrowse oBrowse
|
---|
Retorna o nome da classe (FWBROWSE).FWBrowse(): ClassName ( ) --> cClassName cClassName
|
---|
Executa a limpeza dos filtros estendidos realizados no Browse.FWBrowse(): CleanExFilter ( ) --> |
---|
Elimina as configurações realizadas no Browse do perfil do usuário.FWBrowse(): CleanProfile ( ) --> |
---|
Retorna a coluna posicionada no BrowseFWBrowse(): ColPos ( [ lDeleted] ) --> nColPos |
---|
|
---|
nColPos
|
---|
Retorna o objeto de dados no Browse.FWBrowse(): Data ( ) --> oData oData
|
---|
Retorna se o dados apresentados no Browse é de Array.FWBrowse(): DataArray ( ) --> lDataArray lDataArray
|
---|
Retorna se o dados apresentados no Browse é de Query.FWBrowse(): DataQuery ( ) --> lDataQuery lDataQuery
|
---|
Retorna se o dados apresentados no Browse é de Tabela.FWBrowse(): DataTable ( ) --> lDataTable lDataTable
|
---|
Retorna se o dados apresentados no Browse é de Texto.FWBrowse(): DataText ( ) --> lDataText lDataText
|
---|
Indica se utiliza filtro para tabelas CODEBASE.FWBrowse(): DBFFilter ( ) --> lDBFFilter lDBFFilter
|
---|
Método de destruição da classe.FWBrowse(): DeActivate ( [ lFreeChildren] ) --> |
---|
|
---|
Indica que uma determinada coluna está deletada.FWBrowse(): DelColumn ( < nColumn> ) --> |
---|
|
---|
Permite realizar a exclusão de filtros.FWBrowse(): DeleteFilter ( [ cID] ) --> |
---|
|
---|
Executa o Code-Block, definido no método SetDelete(lDelete,bDelete), para deleção de uma linha no Browse.FWBrowse(): DelLine ( ) --> |
---|
Executa o Code-Block, definido no método SetDelOk(bDelOK), para validar a deleção de uma linha no Browse.FWBrowse(): DelOk ( ) --> lReturn lReturn |
---|
Desabilita a utilização do localizador de registro no Browse.FWBrowse(): DisableLocate ( ) --> Desabilita a impressão das informações disponíveis no Browse.FWBrowse(): DisableReport ( ) --> |
---|
Desabilita a gravação das configurações realizadas no Browse.FWBrowse(): DisableSaveConfig ( ) --> |
---|
Aplica os filtros realizados no Browse.FWBrowse(): ExecuteFilter ( [ lBrwUpdate] ) --> |
---|
|
---|
Indica se o Browse está filtrado.FWBrowse(): Filtrate ( ) --> lFiltrate lFiltrate
|
---|
Retorna o objeto FWFilter.FWBrowse(): FWFilter ( ) --> oFWFilter oFWFilter
|
---|
Retorna a cor de fundo do Browse.FWBrowse(): GetBackColor ( ) --> nBackColor nBackColor
|
---|
Retorna a cor alternada do Browse.FWBrowse(): GetClrAlterRow ( ) --> nClrAlterRow nClrAlterRow
|
---|
Retorno um objeto tipo FWBrwColumn da coluna passada.FWBrowse(): GetColumn ([nCol]) oCol
|
---|
Retorna a descrição do Browse.FWBrowse(): GetDescription ( ) --> cDescription cDescription
|
---|
Retorna o filtro padrão do BrowseFWBrowse(): GetFilterDefault ( ) --> cFilterDefault cFilterDefault
|
---|
Retorna a cor da fonte do Browse.FWBrowse(): GetForeColor ( ) --> cForeColor cForeColor
|
---|
Retorna o objeto FWMARKBROWSE utilizado na passagem de parâmetros na execução das rotinas na FWFORMBROWSE;FWBrowse(): GetObjMark ( ) --> oObjMark oObjMark
|
---|
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 Browse na rotina.FWBrowse(): GetProfileID ( ) --> cProfileID cProfileID
|
---|
Retorna a Query que esta sendo utilizada no Browse.FWBrowse(): GetQuery ( ) --> cQuery cQuery
|
---|
Posiciona no último registro do Browse.FWBrowse(): GoBottom ( [ lCallRefresh] ) --> |
---|
|
---|
Posiciona na coluna desejada.FWBrowse(): GoColumn ( [ nColumn] ) --> |
---|
|
---|
Salta uma ou mais linhas para baixo do item posicionado.FWBrowse(): GoDown ( [ nOffSet], [ lReport] ) --> |
---|
|
---|
|
---|
Posiciona em um determinado registro do Browse.FWBrowse(): GoTo ( < nGoto>, [ lRefresh] ) --> |
---|
|
---|
|
---|
Posiciona no primeiro registro do Browse.FWBrowse(): GoTop ( [ lForce] ) --> |
---|
|
---|
Salta uma ou mais linhas para cima do item posicionado.FWBrowse(): GoUp ( [ nOffSet] ) --> |
---|
|
---|
Executa o Code-Block, definido no método SetLineOk(bLineOk), para validação da linha posicionada.FWBrowse(): LineOk ( ) --> lRet lRet
|
---|
Executa a atualização das informações de uma determinada linha do Browse.FWBrowse(): LineRefresh ( [ nAt] ) --> |
---|
|
---|
Retorna a quantidade de registros disponíveis para o browse.FWBrowse(): LogicLen ( ) --> nLogicLen nLogicLen
|
---|
Retorna se a selecão de um filtro é obrigatório para a apresentação do browse.FWBrowse(): ObligateFilter ( ) --> lObligateFilter lObligateFilter
|
---|
Indica se a opção de configuração do Browse está habilitada.FWBrowse(): OptionConfig ( ) --> lOptionConfig lOptionConfig
|
---|
Indica se a opção de impressão das informações do Browse está habilitada.FWBrowse(): OptionReport ( ) --> lOptionReport lOptionReport
|
---|
Executa a atualização das informações no Browse.FWBrowse(): Refresh ( [ lGoTop] ) --> |
---|
|
---|
Indica a Code-Block executado para adicionar linha no browse.FWBrowse(): SetAddLine ( < bAdd> ) --> |
---|
|
---|
Indica o Code-Block que será executado após a inclusão de uma linha.FWBrowse(): SetAfterAddLine ( < bAfterAddLine> ) --> |
---|
|
---|
Indica o alias da tabela que será utilizada no Browse.FWBrowse(): SetAlias ( < cAlias> ) --> |
---|
|
---|
SetAllOk
Indica o Code-Block executado para validar todos itens do Browse.FWBrowse(): SetAllOk ( < bAllOk> ) --> |
---|
|
---|
Indica o array utilizado para apresentação dos dados no Browse.FWBrowse(): SetArray ( < aArray> ) --> |
---|
|
---|
Indica a cor de fundo do Browse.FWBrowse(): SetBackColor ( < nBackColor> ) --> |
---|
|
---|
Indica a cor de fundo para a linha atual.FWBrowse(): SetBlkBackColor ( < bBackColor> ) --> |
---|
|
---|
Indica a cor de fonte para a linha atual.FWBrowse(): SetBlkColor ( < bBlkColor> ) --> |
---|
|
---|
Indica a Code-Block executado após a mudança de uma linha.FWBrowse(): SetChange ( < bChange> ) --> |
---|
|
---|
Indica a cor alternada do Browse.FWBrowse(): SetClrAlterRow ( < nClrAlterRow> ) --> |
---|
|
---|
Indica que o Browse exibe dados através de uma Query, porém, a Query cria um arquivo temporário atualizando de acordo com a demanda.FWBrowse(): SetDataQuery ( ) --> |
---|
Indica que o usuário pode excluir linhas no Browse.FWBrowse(): SetDelete ( [ lDelete], [ bDelete] ) --> |
---|
|
---|
|
---|
Indica o Code-Block executado para validar a exclusão da linha.FWBrowse(): SetDelOk ( < bDelOK> ) --> |
---|
|
---|
Indica a descrição do Browse.FWBrowse(): SetDescription ( < cDescription> ) --> |
---|
|
---|
Indica o Code-Block executado no duplo clique do item no Browse.FWBrowse(): SetDoubleClick ( < bLDblClick> ) --> |
---|
|
---|
Indica que será permitido a edição da célula no Browse.Esse método só é válido para browse de tabela ou de array. Para browse de array é necessário na criação da FWBrwColumn definir as colunas como editáveis através do método SetEdit e definir o readvar da coluna (pelo método SetReadVar)FWBrowse(): SetEditCell ( [ lEditCell], [ bValidEdit] ) --> |
---|
|
---|
|
---|
Indica os campos que serão apresentados na edição de filtros.FWBrowse(): SetFieldFilter ( < aFields> ) --> |
---|
|
---|
Indica o arquivo texto que será utilizado no Browse.FWBrowse(): SetFile ( < cFile>, [ cCharSeparator] ) --> |
---|
|
---|
|
---|
Indica o limite superior e inferior de um campo respeitando a classificação das informações atual.FWBrowse(): SetFilter ( < cCpoFil>, < cTopFun>, [ cBotFun] ) --> |
---|
|
---|
|
---|
|
---|
Indica o filtro padrão do Browse.FWBrowse(): SetFilterDefault ( < cFilterDefault> ) --> |
---|
|
---|
Indica o relacionamento de filtros para o Browse.FWBrowse(): SetFilterRelation ( < aFilterRelation>, < bChgFields> ) --> |
---|
|
---|
|
---|
Indica a fonte do Browse.FWBrowse(): SetFontBrowse ( [ oFont] ) --> |
---|
|
---|
Indica a cor da fonte no Browse.FWBrowse(): SetForeColor ( < nForeColor> ) --> |
---|
|
---|
Indica que o Browse utiliza agrupamento de informações.FWBrowse(): SetGroup ( < bGroup>, [ lOpen] ) --> |
---|
|
---|
|
---|
Indica a imagem que será apresentada ao lado do título da coluna.FWBrowse(): SetHeaderImage ( < nColumn>, < cResource> ) --> |
---|
|
---|
|
---|
Indica o ID para Browses que trabalham com Left Join.FWBrowse(): SetIdAlias ( < cIdAlias> ) --> |
---|
|
---|
Indica que o usuário poderá inserir novas linhas no Browse.FWBrowse(): SetInsert ( [ lInsert] ) --> |
---|
|
---|
Indica os itens que serão disponibilizados para a configuração do duplo clique pelo usuário.FWBrowse(): SetItemDoubleClick ( < aItemDoubleClick> ) --> |
---|
|
---|
Indica os itens que serão disponibilizados para a configuração do clique no header pelo usuário.FWBrowse(): SetItemHeaderClick ( < aItemHeaderClick> ) --> |
---|
|
---|
Indica a linha do arquivo texto que deverá ser considerado para ínicio da leitura no Browse.FWBrowse(): SetLineBegin ( < nLineBegin> ) --> |
---|
|
---|
Indica a altura da linha no Browse.FWBrowse(): SetLineHeight ( [ nHeight] ) --> |
---|
|
---|
Indica o Code-Block executado na troca de linha do Browse.FWBrowse(): SetLineOk ( < bLineOk> ) --> |
---|
|
---|
Habilita a utilização do localizador de registros no Browse.FWBrowse(): SetLocate ( [ bAction] ) --> |
---|
|
---|
Indica que a legenda será representada por números.FWBrowse(): SetNumberLegend ( [ lNumber] ) --> |
---|
|
---|
Indica o objeto FWMARKBROWSE utilizado na passagem de parâmetros na execução das rotinas na FWFORMBROWSE.FWBrowse(): SetObjMark ( < oObjMark> ) --> |
---|
|
---|
Indica se a selecão de um filtro é obrigatório para a apresentação do browse.FWBrowse(): SetObligateFilter ( [ lObligateFilter], [ lCanCancel] ) --> |
---|
|
---|
|
---|
Indica o container para criação do Browse.FWBrowse(): SetOwner ( [ oOwner] ) --> |
---|
|
---|
Indica o bloco de pré-validação para a edição de celula, o bloco devera retorna .T. para abrir a edição e .F. para nao abrir.FWBrowse(): SetPreEditCell ( < bBlock> ) --> |
---|
|
---|
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 Browse na rotina.FWBrowse(): SetProfileID ( < cProfileID> ) --> |
---|
|
---|
Indica a Query que será utilizada para criação do Browse.FWBrowse(): SetQuery ( < cQuery> ) --> |
---|
|
---|
Observação: A partir da versão Lib 20161010, não deve ser informado o campo R_E_C_N_O_ na query, pois tratasse de um campo exclusivo na criação de arquivos temporários no banco de dados. |
---|
Indica os índices utilizados pela Query na criação do Browse.FWBrowse(): SetQueryIndex ( < aIndex> ) --> |
---|
|
---|
Habilita a utilização da pesquisa de registros no Browse.FWBrowse(): SetSeek ( [ bAction], [ aOrder] ) --> |
---|
|
---|
|
---|
Indica o Code-Block executado na mudança da ordem de pesquisa.FWBrowse(): SetSeekChange ( [ bSeekChange] ) --> |
---|
|
---|
Indica se apresenta somente o limite de informacoes do Browse do tipo Query quando a Query ultrapassar o limite definido.FWBrowse(): SetShowLimit ( [ lShowLimit] ) --> |
---|
|
---|
Indica o Code-Block executado ao pressionar as teclas CTRL+Del.FWBrowse(): SetSuperDel ( < bSuperDel> ) --> |
---|
|
---|
Indica o tipo de navegação do BrowseFWBrowse(): SetTypeMove ( < nTypeMove> ) --> |
---|
|
---|
Habilita a utilização do filtro case no Browse.FWBrowse(): SetUseCaseFilter ( [ nAlign] ) --> |
---|
|
---|
Habilita a utilização do filtro no Browse.FWBrowse(): SetUseFilter ( [ nAlign], [ bOnStart] ) --> |
---|
|
---|
|
---|
Define um bloco de códigos para validar se o filtro deve ser executado.FWBrowse |
---|
Nome | Tipo | Descrição | Obrigatório | Referência |
bVldExecFilter | Bloco de código | Code-Block para validar se o filtro deve ser executado. | X |
(): SetVldExecFilter ( < bVldExecFilter> ) -->
|
---|
Define os campos chave de um browse de query ou array para conseguir reposicionar posteriormente em atualizações que forcem a reconstrução do browse. Não será realizado controle de inserção em duplicidade de registros no browse.Sintaxe FWBrowse(): SetUniqueKey(aSetKey) --> Parâmetros
Lógico, indica se a definição dos campos aconteceu ou não. |
---|
Retorna a lista com os campos ou colunas definidos como chave para o browse.Sintaxe FWBrowse(): GetUniqueKey() --> Array, lista com os campos definidos como chave do browse. |
---|
Captura o conteúdo dos campos e colunas informados como chave do browse.Sintaxe FWBrowse(): SetUniqueKey(aSetKey) --> Array, com lista com os pares de campos e valores identificados. Quando browse por query: { { “CAMPO”, VALOR }, { “CAMPO”, VALOR } }. Quando browse por array: { { NUM_COLUNA, VALOR }, { NUM_COLUNA, VALOR } }. |
---|
Posiciona o browse no registro conforme a chave recebida por parâmetro.Sintaxe FWBrowse(): SetUniqueKey(aDataKey) --> Parâmetros
Lógico, indica se foi possível realizar o posicionamento no registro do browse conforme o parâmetro informado. |
---|
Bloco de código | ||||
---|---|---|---|---|
| ||||
#INCLUDE "PROTHEUS.CH" #INCLUDE "FWBROWSE.CH" User Function BrwTable() Local oBrowse Local oColumn Local oDlg //-------------------------------------------------------------------// Abertura da tabela//------------------------------------------------------------------- DbSelectArea("SX2") DbSetOrder(1) //-------------------------------------------------------------------// Define a janela do Browse//------------------------------------------------------- DEFINE DIALOG oDlg FROM 0,0 TO 600,800 PIXEL //------------------------------------------------------------------- // Define o Browse //---------------------------------------------------------------- DEFINE FWBROWSE oBrowse DATA TABLE ALIAS "SX2" OF oDlg //-------------------------------------------------------- // Cria uma coluna de marca/desmarca//---------------------------------------------- ADD MARKCOLUMN oColumn DATA { || If(.T./* Função com a regra*/,'LBOK','LBNO') }; DOUBLECLICK { |oBrowse| /* Função que atualiza a regra*/ }; HEADERCLICK { |oBrowse| /* Função executada no clique do header */ } OF oBrowse //-------------------------------------------------------- // Cria uma coluna de status //-------------------------------------------------------- ADD STATUSCOLUMN oColumn DATA { || If(.T./* Função com a regra*/,'BR_VERDE','BR_VERMELHO') }; DOUBLECLICK { |oBrowse| /* Função executada no duplo clique na coluna*/ } OF oBrowse //-------------------------------------------------------- // Adiciona legenda no Browse //-------------------------------------------------------- ADD LEGEND DATA 'X2_CHAVE $ "AA1|AA2"' COLOR "GREEN" TITLE "Chave teste 1" OF oBrowse ADD LEGEND DATA '!(X2_CHAVE $ "AA1|AA2")' COLOR "RED" TITLE "Chave teste 2" OF oBrowse //------------------------------------------------------------------- // Adiciona as colunas do Browse //------------------------------------------ ADD COLUMN oColumn DATA { || X2_CHAVE } TITLE "Chave" SIZE 3 OF oBrowse ADD COLUMN oColumn DATA { || X2_ARQUIVO } TITLE "Arquivo" SIZE 10 OF oBrowse ADD COLUMN oColumn DATA { || X2_NOME } TITLE DecodeUTF8("Descrição") SIZE 40 OF oBrowse ADD COLUMN oColumn DATA { || X2_MODO } TITLE "Modo" SIZE 1 OF oBrowse //------------------------------------------------------------------- // Ativação do Browse//---------------------------------------------------------------- ACTIVATE FWBROWSE oBrowse //-------------------------------------------------------------------// Ativação do janela//------------------------------------------------------------------- ACTIVATE DIALOG oDlg CENTERED Return |
Bloco de código | ||||
---|---|---|---|---|
| ||||
User Function BrwTable() Local oBrowse Local oColumn Local oDlg // Abertura da tabela DbSelectArea("SX2") DbSetOrder(1) //Define a janela do Browse oDlg = TDialog():New(0, 0, 600, 800,,,,,,,,,,.T.) // Define o Browse oBrowse := FWBrowse():New(oDlg) oBrowse:SetDataTable(.T.) oBrowse:SetAlias("SX2") // Cria uma coluna de marca/desmarca oColumn := oBrowse:AddMarkColumns({||If(.T./*Função de Marca/desmaca*/,'LBOK','LBNO')},{|oBrowse|/*Função de DOUBLECLICK*/},{|oBrowse|/* Função de HEADERCLICK*/}) // Cria uma coluna de status oColumn := oBrowse:AddStatusColumns({||If(.T./*Função de avaliação de status*/,'BR_VERDE','BR_VERMELHO')},{|oBrowse|/*Função de DOUBLECLICK*/}) // Adiciona legenda no Browse oBrowse:AddLegend('X2_CHAVE $ "AA1|AA2"',"GREEN","Chave teste 1") oBrowse:AddLegend('!(X2_CHAVE $ "AA1|AA2")',"RED","Chave teste 2") // Adiciona as colunas do Browse oColumn := FWBrwColumn():New() oColumn:SetData({||X2_CHAVE}) oColumn:SetTitle("Chave") oColumn:SetSize(3) oBrowse:SetColumns({oColumn}) oColumn := FWBrwColumn():New() oColumn:SetData({||X2_ARQUIVO}) oColumn:SetTitle("Arquivo") oColumn:SetSize(10) oBrowse:SetColumns({oColumn}) oColumn := FWBrwColumn():New() oColumn:SetData({||X2_NOME}) oColumn:SetTitle(DecodeUTF8("Descrição")) oColumn:SetSize(40) oBrowse:SetColumns({oColumn}) oColumn := FWBrwColumn():New() oColumn:SetData({||X2_MODO}) oColumn:SetTitle("Modo") oColumn:SetSize(1) oBrowse:SetColumns({oColumn}) // Ativação do Browse oBrowse:Activate() // Ativação da janela oDlg:Activate(,,,.T.) Return |
Todas as versões
Define os campos chave de um browse de query ou array para conseguir reposicionar posteriormente em atualizações que forcem a reconstrução do browse. Não será realizado controle de inserção em duplicidade de registros no browse.