توثيق HotXLS

أسلوب SheetByName

يُرجع كائن ورقة العمل الذي يطابق اسمه اسم الورقة المُوفَّر، أو nil إذا لم تكن هناك ورقة عمل بهذا الاسم. يكون البحث غير حساس لحالة الأحرف في تنسيق XLS الكلاسيكي

البنية

function SheetByName(SheetName: WideString): TXLSWorksheet;
function TryGetSheetByName(SheetName: WideString; out Sheet: TXLSWorksheet): Boolean;
    

المعاملات

SheetName ورقة عمل اسم إلى locate
Sheet يتلقى ورقة العمل المطابقة عندما يعيد TryGetSheetByName القيمة True؛ ويتلقى nil عندما لا توجد ورقة مطابقة

القيمة المُرجَعة

نسخة TXLSWorksheet المُطابِقة، أو nil إذا لم يحتوِ المصنف على ورقة بهذا الاسم

مثال

var
  Sheet: TXLSWorksheet;
begin
  Sheet := Workbook.Worksheets.SheetByName('Summary');
  if Sheet <> nil then
    Sheet.Range['A1', 'A1'].Value := 'Ready';

  if Workbook.Worksheets.TryGetSheetByName('Review', Sheet) then
    Sheet.Range['A1', 'A1'].Value := 'Found';
end;
    

انظر أيضاً

الفئة TXLSWorksheets
خاصية TXLSWorksheets.Entries