HotXLS-dokumentation

ForEachCell metode

Gennemgår de indlæste celler i et klassisk XLS-regneark og kalder et program-callback for hver celle

Syntaks

type
  TXLSCellReadEvent = procedure(
    Sender: TObject;
    SheetIndex, Row, Col: Integer;
    const Value: Variant;
    const Formula: WideString;
    var Cancel: Boolean) of object;

function ForEachCell(Callback: TXLSCellReadEvent): Integer;

Bemærkninger

ForEachCell gennemgår kun celler, der findes i den indlæste regnearksmodel. Den gennemgår ikke alle mulige rækker og kolonner i arket
Cells are visited in row-major order. SheetIndex, Row, and Col are 1-based public coordinates. Value is the current cell value. Formula indeholder formelteksten for formelceller og er tom for almindelige værdiceller
Set Cancel to True i callback'en for at stoppe gennemløbet tidligt. Returværdien er antallet af foretagne callbacks

Eksempel

procedure TForm1.ReadCell(Sender: TObject; SheetIndex, Row, Col: Integer;
  const Value: Variant; const Formula: WideString;
  var Cancel: Boolean);
begin
  Memo1.Lines.Add(Format('%d:%d = %s', [Row, Col, VarToStr(Value)]));
  if Row >= 1000 then
    Cancel := True;
end;

Visited := Workbook.Sheets[1].ForEachCell(ReadCell);

See Also