Mudanças entre as edições de "TPHExcel"

(Procedimentos)
Linha 22: Linha 22:
 
* '''Importar(pArquivoExcel:String)''': Realizar importação do arquivo com extensão xlsx informado no parâmetro do pArquivoExcel do procedimento;  
 
* '''Importar(pArquivoExcel:String)''': Realizar importação do arquivo com extensão xlsx informado no parâmetro do pArquivoExcel do procedimento;  
 
* '''RetornaCSV''': Após a importação do arquivo xlsx, é possível retornar o texto correspondente no formado CSV (Seperado por ponto e virgura);
 
* '''RetornaCSV''': Após a importação do arquivo xlsx, é possível retornar o texto correspondente no formado CSV (Seperado por ponto e virgura);
 +
*'''RetornaCelula(const pColuna:Integer;const pLinha:Integer):String''': Retorna o texto correspondente a célula da coluna e linha informados nos parâmetros do procedimento;
 +
*'''AtribuirCelula(const pColuna:Integer;const pLinha:Integer;pTexto:String)''': Atribuir o texto informado no parâmetro pTexto, na célula correspondente a coluna e linha informada;
 +
*'''Limpar''': Limpar propriedades do objeto da classe TPHExcel, quando houver um arquivo que já foi impostado.
  
 
===Exemplo Conversão para CSV===
 
===Exemplo Conversão para CSV===

Edição das 18h33min de 20 de agosto de 2023

A classe TPHExcel serve para realizar a importação de arquivos do excel com a extensão xlsx. A classe TPHExcel suporta execução no cliente e no servidor e o ambiente escolhido requer a aplicação do Excel do office instalada. Para execução no servidor deve-se realizar implementação em um script especifico, e a chamada do script no cliente deverá ocorrer através do classe TPHProcScript.

Propriedades

Nome Tipo Descrição
QtdLinhas Integer Quantidade de linhas do arquivo.
QtdColunas Integer Quantidade de colunas do arquivo.

Criação do Objeto

  • NewPHExcel: Cria o objeto, espera como parâmetro o nome do cadastro.

Procedimentos

  • Importar(pArquivoExcel:String): Realizar importação do arquivo com extensão xlsx informado no parâmetro do pArquivoExcel do procedimento;
  • RetornaCSV: Após a importação do arquivo xlsx, é possível retornar o texto correspondente no formado CSV (Seperado por ponto e virgura);
  • RetornaCelula(const pColuna:Integer;const pLinha:Integer):String: Retorna o texto correspondente a célula da coluna e linha informados nos parâmetros do procedimento;
  • AtribuirCelula(const pColuna:Integer;const pLinha:Integer;pTexto:String): Atribuir o texto informado no parâmetro pTexto, na célula correspondente a coluna e linha informada;
  • Limpar: Limpar propriedades do objeto da classe TPHExcel, quando houver um arquivo que já foi impostado.

Exemplo Conversão para CSV

{ Retornar CSV da planilha }                                                                    
function RetornarCSV:String;
var
  Excel:TPHExcel;                                           
begin
  Excel := NewPHExcel;
  try
    Excel.Importar('C:\teste.xlsx');                                  
    Result := Excel.RetornaCSV;    
  finally
    Excel.Free;                        
  end;            
end;          
begin
  Informacao(RetornarCSV);                       
end.