HotXLS ドキュメント

SheetByName メソッド

指定したシート名と一致する名前を持つワークシートオブジェクトを返します。その名前を持つワークシートが存在しない場合は nil を返します。従来の XLS ファサードは既存の Index[SheetName] プロパティと同じ名前マッチングを使用します

構文

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

パラメーター

SheetName ワークシート 名前 へ locate
Sheet TryGetSheetByName が True を返したときに一致する Worksheet を受け取り、一致するシートがない場合は 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;
    

関連項目

TXLSWorksheets クラス
TXLSWorksheets.Entries プロパティ
TXLSWorksheet クラス