توثيق HotXLS

أسلوب SheetByName

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

البنية

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

المعاملات

SheetNameورقة عمل اسم إلى locate
Sheetيتلقى ورقة العمل المطابقة عندما يعيد TryGetSheetByName القيمة True؛ ويتلقى nil عندما لا توجد ورقة مطابقة TryGetSheetByName returns True; receives nil when no sheet matches

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

نسخة TXLSWorksheet instance, or nil إذا لم يكن المصنف يحتوي على ورقة بهذا الاسم. TryGetSheetByName returns True المُطابِقة، أو False إذا لم يحتوِ المصنف على ورقة بهذا الاسم

مثال

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
TXLSWorksheet class