वर्कशीट जोड़ना

इस लेख में Office Scripts से वर्कशीट जोड़ने का तरीका सैंपल कोड के साथ समझाया गया है।

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

Workbook ऑब्जेक्ट में उपलब्ध addWorksheet मेथड का उपयोग करें।

addWorksheet की टाइप डेफ़िनिशन

/**
 * @param name जोड़ी जाने वाली शीट का नाम (वैकल्पिक)
 * @return जोड़ी गई वर्कशीट
 */
ExcelScript.Workbook.addWorksheet(name?: string): Worksheet;

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

आर्ग्युमेंट छोड़ देने पर Excel अपने-आप शीट का नाम तय करता है।

अगर जोड़ी गई वर्कशीट को स्क्रीन पर दिखाना हो, तो रिटर्न वैल्यू में मिली वर्कशीट पर activate मेथड चलाएँ।

सैंपल कोड

यह सैंपल शीट का नाम बताकर वर्कशीट बनाता है।

addWorksheet का उपयोग करने वाला सैंपल

function main(workbook: ExcelScript.Workbook) {
  /** जोड़ी जाने वाली शीट का नाम */
  const sheetname = 'created-by-office-script';

  if (workbook.getWorksheet(sheetname)) {
    throw `${sheetname} नाम की वर्कशीट पहले से मौजूद है`;
  }

  /** बनाई गई वर्कशीट */
  const created = workbook.addWorksheet(sheetname);
}

संकेत

वर्कबुक के अंदर शीट का नाम यूनिक होना ज़रूरी है, इसलिए अगर उसी नाम की वर्कशीट पहले से मौजूद हो, तो उस स्थिति से निपटने के लिए getWorksheet मेथड से डुप्लिकेट की जाँच की गई है।