इस पेज का अनुवाद Cloud Translation API से किया गया है.

Class Position

दस्तावेज़ टैब में किसी खास एलिमेंट के आधार पर, किसी जगह का रेफ़रंस. उपयोगकर्ता का कर्सर को अन्य इस्तेमाल के साथ, Position के तौर पर दिखाया जाता है. स्क्रिप्ट केवल वह उपयोगकर्ता जो स्क्रिप्ट चला रहा है और सिर्फ़ तब, जब स्क्रिप्ट दस्तावेज़ से बाउंड हो.

// Insert some text at the cursor position and make it bold.
var cursor = DocumentApp.getActiveDocument().getCursor();
if (cursor) {
  // Attempt to insert text at the cursor position. If the insertion returns null, the cursor's
  // containing element doesn't allow insertions, so show the user an error message.
  var element = cursor.insertText('ಠ‿ಠ');
  if (element) {
    element.setBold(true);
  } else {
    DocumentApp.getUi().alert('Cannot insert text here.');
  }
} else {
  DocumentApp.getUi().alert('Cannot find a cursor.');
}

तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
`getElement()`	`Element`	इससे वह एलिमेंट मिलता है जिसमें यह `Position` शामिल होता है.
`getOffset()`	`Integer`	इस `Position` की मिलती-जुलती जगह की जानकारी, उस एलिमेंट में हासिल करता है जिसमें यह मौजूद है.
`getSurroundingText()`	`Text`	एक आर्टिफ़िशियल `Text` एलिमेंट बनाता है, जो `Paragraph` या `ListItem`, जिनमें सीधे तौर पर या चाइल्ड एलिमेंट की चेन के ज़रिए `Position` शामिल है.
`getSurroundingTextOffset()`	`Integer`	`getSurroundingText()` से लौटाए गए `Text` एलिमेंट में, इस `Position` का ऑफ़सेट हासिल करता है.
`insertBookmark()`	`Bookmark`	इस `Position` पर नया `Bookmark` बनाता और जोड़ता है.
`insertInlineImage(image)`	`InlineImage`	तय की गई इमेज से, इस `Position` पर नया `InlineImage` बनाता है और उसे शामिल करता है ब्लॉब.
`insertText(text)`	`Text`	बताए गए टेक्स्ट को इस `Position` पर डालता है.

विस्तृत दस्तावेज़

`getElement()`

इससे वह एलिमेंट मिलता है जिसमें यह Position शामिल होता है. यह Text एलिमेंट या Paragraph जैसा कोई कंटेनर एलिमेंट. दोनों ही मामलों में, संबंधित एलिमेंट के अंदर की पोज़िशन getOffset() की मदद से तय की जा सकती है.

वापसी का टिकट

Element — कंटेनर या Text एलिमेंट, जिसमें यह Position ऑब्जेक्ट मौजूद है

`getOffset()`

इस Position की मिलती-जुलती जगह की जानकारी, उस एलिमेंट में हासिल करता है जिसमें यह मौजूद है. अगर एलिमेंट एक Text एलिमेंट है, ऑफ़सेट Position से पहले के वर्णों की संख्या है (यानी, इस Position के बाद वर्ण का इंडेक्स); किसी और के लिए एलिमेंट के लिए, ऑफ़सेटPosition एक ही कंटेनर एलिमेंट (यानी, Position के बाद चाइल्ड एलिमेंट का इंडेक्स).

वापसी का टिकट

Integer — Text एलिमेंट के लिए, इस Position से पहले के वर्णों की संख्या; इसके लिए अन्य एलिमेंट, उसी में इस Position से पहले चाइल्ड एलिमेंट की संख्या कंटेनर एलिमेंट

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, यहां दिए गए एक या एक से ज़्यादा स्कोप की अनुमति होनी चाहिए:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getSurroundingText()`

एक आर्टिफ़िशियल Text एलिमेंट बनाता है, जो Paragraph या ListItem, जिनमें सीधे तौर पर या चाइल्ड एलिमेंट की चेन के ज़रिए Position शामिल है. दिखाए गए Text एलिमेंट में, Position का ऑफ़सेट तय करने के लिए getSurroundingTextOffset() का इस्तेमाल करें.

वापसी का टिकट

Text — editAsText() को कॉल करने के नतीजे के बराबर एलिमेंट Paragraph या ListItem पर, जिसमें Position शामिल है, सीधे तौर पर या चाइल्ड एलिमेंट की चेन के ज़रिए

अनुमति देना

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getSurroundingTextOffset()`

getSurroundingText() से लौटाए गए Text एलिमेंट में, इस Position का ऑफ़सेट हासिल करता है. ऑफ़सेट, Position से पहले के वर्णों की संख्या है (यानी, इस Position के बाद वर्ण का इंडेक्स).

वापसी का टिकट

Integer — Paragraph या ListItem में इस Position से पहले के वर्णों की संख्या, जिनमें सीधे तौर पर या चाइल्ड एलिमेंट की चेन से Position मौजूद होता है

अनुमति देना

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertBookmark()`

इस Position पर नया Bookmark बनाता और जोड़ता है.

वापसी का टिकट

Bookmark — नया बुकमार्क

अनुमति देना

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertInlineImage(image)`

तय की गई इमेज से, इस Position पर नया InlineImage बनाता है और उसे शामिल करता है ब्लॉब.

पैरामीटर

नाम	टाइप	ब्यौरा
`image`	`BlobSource`	इस `Position` में शामिल किया जाने वाला इमेज डेटा

वापसी का टिकट

InlineImage — नया इमेज एलिमेंट या null, अगर वह एलिमेंट जिसमें यह Position है 'जगह' से जुड़ी जानकारी, इमेज को शामिल करने की अनुमति नहीं देती

अनुमति देना

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`insertText(text)`

बताए गए टेक्स्ट को इस Position पर डालता है. इस तरीके से नया Text बनता है एलिमेंट, भले ही स्ट्रिंग किसी मौजूदा Text एलिमेंट में डाली गई हो, ताकि यह नए एलिमेंट को शैली देना आसान है.

पैरामीटर

नाम	टाइप	ब्यौरा
`text`	`String`	इस `Position` में डाली जाने वाली स्ट्रिंग

वापसी का टिकट

Text — नया टेक्स्ट एलिमेंट या null, अगर वह एलिमेंट जिसमें यह Position है स्थित है, टेक्स्ट डाले जाने की अनुमति नहीं देता

अनुमति देना

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents