Возвращает объект листа, имя которого совпадает с указанным именем листа, или nil, если ни один лист не имеет такого имени. Фасад классического XLS использует то же сопоставление имён, что и существующее свойство Index[SheetName]
Синтаксис
function SheetByName(SheetName: WideString): TXLSWorksheet;
function TryGetSheetByName(SheetName: WideString; out Sheet: TXLSWorksheet): Boolean;
Параметры
| SheetName |
лист имя к locate |
| Sheet |
Получает соответствующий Worksheet, когда TryGetSheetByName возвращает True; получает nil, когда совпадающего листа нет |
Возвращаемое значение
Соответствующий экземпляр
TXLSWorksheet, или
nil, если рабочая книга не содержит листа с таким именем.
TryGetSheetByName возвращает
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;
См. также