Devuelve el objeto de hoja de cálculo cuyo nombre coincide con el nombre de hoja proporcionado, o nil cuando ninguna hoja de cálculo tiene ese nombre. La fachada XLS clásica usa la misma coincidencia de nombres que la propiedad Index[SheetName] existente
Sintaxis
function SheetByName(SheetName: WideString): TXLSWorksheet;
function TryGetSheetByName(SheetName: WideString; out Sheet: TXLSWorksheet): Boolean;
Parámetros
| SheetName |
hoja de cálculo nombre locate |
| Sheet |
Receives matching hoja de cálculo cuando TryGetSheetByName devuelve True; receives nil cuando no hoja matches |
Valor de retorno
Ejemplo
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;
Véase también
La instancia
TXLSWorksheet que coincide, o
nil si el libro de trabajo no contiene una hoja con ese nombre.
TryGetSheetByName devuelve
True cuando se encuentra una coincidencia