वर्कशीट कॉपी करना

इस लेख में Office Scripts का उपयोग करके किसी खास वर्कशीट को कॉपी करने का तरीका समझाया गया है।

इस्तेमाल होने वाला मेथड

Worksheet ऑब्जेक्ट में मौजूद copy मेथड का उपयोग करें।

मेथड का विवरण

/**
 * @param positionType कॉपी की गई शीट को किस स्थान पर रखना है (ExcelScript.WorksheetPositionType में से चुनें)
 * @param relativeTo positionType में before या after चुनने पर, आधार के रूप में इस्तेमाल होने वाली वर्कशीट
 * @return कॉपी की गई वर्कशीट का ऑब्जेक्ट
 */
ExcelScript.Worksheet.copy(
  positionType?: WorksheetPositionType,
  relativeTo?: Worksheet
): ExcelScript.Worksheet;

दोनों आर्ग्युमेंट वैकल्पिक हैं। positionType की डिफ़ॉल्ट वैल्यू none है, और आर्ग्युमेंट छोड़ देने पर कॉपी की गई शीट वर्कबुक की शुरुआत में रखी जाती है।

positionType में none, before, after, beginning या end में से कोई एक दें। before या after देने पर, relativeTo में आधार के रूप में इस्तेमाल होने वाली वर्कशीट दें।

सैंपल कोड

यह सैंपल कोड कॉपी की जाने वाली शीट का नाम बताकर, कॉपी की गई शीट को उसी वर्कशीट के ठीक बाद रखता है।

बताई गई शीट न मिलने पर यह एरर थ्रो करता है।

वर्कशीट कॉपी करने का सैंपल

function main(workbook: ExcelScript.Workbook) {
  /** लक्षित शीट का नाम */
  const sheetname = 'Sheet1';

  /** लक्षित वर्कशीट */
  const sheet = workbook.getWorksheet(sheetname);

  if (!sheet) {
    throw `${sheetname} नाम की कोई वर्कशीट मौजूद नहीं है`;
  }

  const copied = sheet.copy(ExcelScript.WorksheetPositionType.after, sheet);

  console.log(`${sheetname} कॉपी हो गई।`, `कॉपी के बाद शीट का नाम: ${copied.getName()}`);
}