תיעוד HotXLS

מתודה ForEachCell

מנמר את התאים הטעונים בגליון עבודה XLS קלאסי וקורא ל-callback של יישום עבור כל תא

תחביר

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;

הערות

function ForEachCell(Callback: TXLSForEachCellEvent): Integer;
ForEachCell עובר רק על תאים הקיימים במודל גליון העבודה הטעון. הוא אינו סורק כל שורה ועמודה אפשריים בגיליון
התאים מבוקרים בסדר שורות ראשיות. SheetIndex, Row ו-Col הם קואורדינטות ציבוריות מבוססות-1. Value הוא ערך התא הנוכחי. Formula מכיל את טקסט הנוסחה עבור תאי נוסחאות וריק עבור תאי ערך רגילים

ראה גם

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);

ראו גם

הגדר את Cancel ל-True ב-callback להפסקת הסריקה מוקדם. ערך ההחזרה הוא מספר ה-callbacks שבוצעו