מתודה SheetByName - מדריך מפתחים של HotXLS

מחזיר את אובייקט גליון העבודה שאת שמו תואם לשם הגיליון שסופק, או nil כאשר אין גיליון עם שם זה. חזית XLS הקלאסית משתמשת באותה התאמת שמות כמו המאפיין Index[SheetName] הקיים

תחביר

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

פרמטר החזרה

SheetName	הגיליון name to locate
Sheet	Receives the matching גיליון when `TryGetSheetByName` returns `True`; receives `nil` when no sheet matches

ראה גם

function SheetByName(AName: WideString): TXLSWorksheet;

דוגמה

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;

ראו גם

מופע TXLSWorksheet התואם, או nil אם חוברת העבודה אינה מכילה גיליון עם שם זה. TryGetSheetByName מחזיר True כאשר נמצאה התאמה ו-False אחרת