เอกสาร HotXLS

เมธอด SheetByName

คืนค่าออบเจ็กต์ worksheet ที่มีชื่อตรงกับชื่อแผ่นที่ระบุ หรือ nil เมื่อไม่มี worksheet ใดมีชื่อนั้น interface XLS แบบคลาสสิก ใช้การจับคู่ชื่อเดียวกับคุณสมบัติ Index[SheetName] ที่มีอยู่

ไวยากรณ์

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

พารามิเตอร์

SheetName เวิร์กชีต name to locate
Sheet Receives ที่ตรงกัน เวิร์กชีต เมื่อTryGetSheetByNameส่งกลับTrue; receivesnilเมื่อ no sheet matches

ค่าที่คืน

instance TXLSWorksheet ที่ตรงกัน หรือ nil หาก workbook ไม่มีแผ่นที่มีชื่อนั้น 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