توثيق HotXLS

أسلوب ForEachCell

يُعدِّد الخلايا المُحمَّلة في ورقة العمل الكلاسيكية XLS ويستدعي معاودة اتصال التطبيق لكل خلية

البنية

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;

ملاحظات

يزور ForEachCell فقط الخلايا الموجودة في نموذج ورقة العمل المُحمَّل. لا يمسح كل صف وعمود ممكن في الورقة
تُزار الخلايا بترتيب الصفوف أولاً. SheetIndex وRow وCol إحداثيات عامة قائمة على 1. Value هي قيمة الخلية الأولية
اضبط Cancel على True في معاودة الاتصال لإيقاف المسح مبكراً. القيمة المُرجَعة هي عدد معاودات الاتصال التي تمت

مثال

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

انظر أيضاً