Documentație HotXLS

Metoda SheetByName

Returnează obiectul foaie de lucru al cărui nume corespunde numelui de foaie furnizat, sau nil când nicio foaie de lucru nu are acel nume. Fațada XLS clasică utilizează aceeași potrivire de nume ca și proprietatea Entries indexată

Sintaxă

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

Parametri

SheetName Numele foii de calcul care trebuie localizat
Sheet Primește foaia de calcul care se potrivește când TryGetSheetByName returnează True; primește nil când nu există nicio foaie potrivită

Valoare returnată

Instanța TXLSWorksheet care se potrivește, sau nil dacă registrul de lucru nu conține o foaie cu acel nume. TryGetSheetByName returnează aceeași valoare

Exemplu

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;
    

Vezi și

Clasa TXLSWorksheets
Proprietatea TXLSWorksheets.Entries
Clasa TXLSWorksheet