Devolve o objecto de folha de cálculo cujo nome corresponde ao nome de folha fornecido, ou nil quando nenhuma folha de cálculo tem esse nome. A fachada XLS clássica utiliza a mesma correspondência de nomes que a propriedade existente Index[SheetName]
Sintaxe
function SheetByName(SheetName: WideString): TXLSWorksheet;
function TryGetSheetByName(SheetName: WideString; out Sheet: TXLSWorksheet): Boolean;
Parâmetros
| SheetName |
O nome da folha de cálculo a localizar |
| Sheet |
Recebe a folha de cálculo correspondente quando TryGetSheetByName devolve True; recebe nil quando nenhuma folha corresponde |
Valor de retorno
A instância
TXLSWorksheet correspondente, ou
nil se o livro não contiver uma folha com esse nome.
TryGetSheetByName devolve
True quando é encontrada uma correspondência e
False caso contrário
Exemplo
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;
Ver também