Retorna o objeto de planilha cujo nome corresponde ao nome de planilha fornecido, ou nil quando nenhuma planilha tem esse nome. A fachada XLS clássica usa a mesma correspondência de nomes que a propriedade Index[SheetName] existente
Sintaxe
function SheetByName(SheetName: WideString): TXLSWorksheet;
function TryGetSheetByName(SheetName: WideString; out Sheet: TXLSWorksheet): Boolean;
Parâmetros
| SheetName |
planilha nome para locate |
| Sheet |
Receives matching planilha quando TryGetSheetByName retorna True; receives nil quando no planilha matches |
Valor de retorno
A instância
TXLSWorksheet correspondente, ou
nil se a pasta de trabalho não contiver uma planilha com esse nome.
TryGetSheetByName retorna
True quando uma correspondência é encontrada 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;
Veja também