Paragraph पर ऐंकर की गई फ़िक्स्ड पोज़िशन की इमेज. InlineImage से अलग, PositionedImage
एक Element नहीं होता. इसमें माता-पिता या भाई-बहन Element नहीं है. इसके बजाय,
इसे Paragraph या ListItem पर ऐंकर किया जाता है और इसे उस ऐंकर से ऑफ़सेट के ज़रिए रखा जाता है. PositionedImage में एक आईडी होता है, जिसका इस्तेमाल रेफ़रंस के लिए किया जा सकता है.
var body = DocumentApp.getActiveDocument().getBody();
// Append a new paragraph.
var paragraph = body.appendParagraph("New paragraph to anchor the image to.");
// Get an image in Drive from its ID.
var image = DriveApp.getFileById('ENTER_IMAGE_FILE_ID_HERE').getBlob();
// Add the PositionedImage with offsets (in points).
var posImage = paragraph.addPositionedImage(image)
.setTopOffset(60)
.setLeftOffset(40);
तरीके
| तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
|---|---|---|
getAs(contentType) | Blob | इस ऑब्जेक्ट के अंदर डेटा को, बताए गए कॉन्टेंट टाइप में बदले गए ब्लॉब के तौर पर दिखाएं. |
getBlob() | Blob | इस ऑब्जेक्ट के अंदर का डेटा, ब्लॉब के तौर पर दें. |
getHeight() | Integer | पिक्सल में इमेज की ऊंचाई लाता है. |
getId() | String | इमेज के आईडी की जानकारी मिलती है. |
getLayout() | PositionedLayout | इससे एक Enum वैल्यू मिलती है. इससे यह पता चलता है कि इमेज को किस तरह दिखाया गया है. |
getLeftOffset() | Number | पैराग्राफ़ के बाईं ओर से, पॉइंट में इमेज के ऑफ़सेट को दिखाता है. |
getParagraph() | Paragraph | इससे पता चलता है कि इमेज को किस Paragraph पर ऐंकर किया गया है. |
getTopOffset() | Number | पैराग्राफ़ के ऊपर से, पॉइंट में इमेज के ऑफ़सेट की जानकारी देता है. |
getWidth() | Integer | पिक्सल में इमेज की चौड़ाई लाता है. |
setHeight(height) | PositionedImage | इमेज की ऊंचाई को पिक्सल में सेट करता है. |
setLayout(layout) | PositionedImage | इमेज कैसे बनाई गई है, इसकी परिभाषा सेट करता है. |
setLeftOffset(offset) | PositionedImage | पैराग्राफ़ के बाएं हिस्से से, इमेज के ऑफ़सेट को पॉइंट में सेट करता है. |
setTopOffset(offset) | PositionedImage | पैराग्राफ़ के ऊपर से, इमेज के ऑफ़सेट को पॉइंट में सेट करता है. |
setWidth(width) | PositionedImage | इमेज की चौड़ाई को पिक्सल में सेट करता है. |
ज़्यादा जानकारी के साथ दस्तावेज़
getAs(contentType)
इस ऑब्जेक्ट के अंदर डेटा को, बताए गए कॉन्टेंट टाइप में बदले गए ब्लॉब के तौर पर दिखाएं. इस तरीका से फ़ाइल नाम में सही एक्सटेंशन जोड़ा जा सकता है—उदाहरण के लिए, "myfile.pdf". हालांकि, यह माना जाता है कि फ़ाइल नाम का वह हिस्सा जो पिछली अवधि (अगर कोई है) के बाद आता है, तो वह मौजूदा एक्सटेंशन है जिसे बदला जाना चाहिए. इस वजह से, "ShoppingList.12.25.2014", "ShoppingList.12.25.pdf" हो जाता है.
कन्वर्ज़न के रोज़ के कोटा देखने के लिए, Google Services के लिए कोटा देखें. हाल ही में बनाए गए Google Workspace डोमेन पर, कुछ समय के लिए सख्त कोटे लागू हो सकते हैं.
पैरामीटर
| नाम | Type | ब्यौरा |
|---|---|---|
contentType | String | वह MIME टाइप जिसमें बदलना है. ज़्यादातर ब्लॉब के लिए, सिर्फ़ 'application/pdf' ही मान्य विकल्प है. BMP, GIF, JPEG या PNG फ़ॉर्मैट में मौजूद इमेज के लिए, 'image/bmp', 'image/gif', 'image/jpeg' या 'image/png' में से कोई भी मान्य है. |
रिटर्न
Blob — ब्लॉब के तौर पर डेटा.
getBlob()
getHeight()
पिक्सल में इमेज की ऊंचाई लाता है.
रिटर्न
Integer — इमेज की ऊंचाई, पिक्सल में
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getId()
इमेज के आईडी की जानकारी मिलती है.
रिटर्न
String — इमेज आईडी
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getLayout()
इससे एक Enum वैल्यू मिलती है. इससे यह पता चलता है कि इमेज को किस तरह दिखाया गया है.
रिटर्न
PositionedLayout — इमेज का लेआउट
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getLeftOffset()
पैराग्राफ़ के बाईं ओर से, पॉइंट में इमेज के ऑफ़सेट को दिखाता है.
रिटर्न
Number — इमेज का ऑफ़सेट बाएं पैराग्राफ़ के बाईं ओर से
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getParagraph()
इससे पता चलता है कि इमेज को किस Paragraph पर ऐंकर किया गया है.
रिटर्न
Paragraph — पैरंट पैराग्राफ़
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getTopOffset()
पैराग्राफ़ के ऊपर से, पॉइंट में इमेज के ऑफ़सेट की जानकारी देता है.
रिटर्न
Number — इमेज का ऑफ़सेट बाएं पैराग्राफ़ के सबसे ऊपर से
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getWidth()
पिक्सल में इमेज की चौड़ाई लाता है.
रिटर्न
Integer — इमेज की चौड़ाई, पिक्सल में
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setHeight(height)
इमेज की ऊंचाई को पिक्सल में सेट करता है.
पैरामीटर
| नाम | Type | ब्यौरा |
|---|---|---|
height | Integer | इमेज की ऊंचाई, पिक्सल में |
रिटर्न
PositionedImage — मौजूदा ऑब्जेक्ट
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setLayout(layout)
इमेज कैसे बनाई गई है, इसकी परिभाषा सेट करता है.
पैरामीटर
| नाम | Type | ब्यौरा |
|---|---|---|
layout | PositionedLayout | लेआउट मोड को दिखाने वाला एनम |
रिटर्न
PositionedImage — यह ऑब्जेक्ट चेन बनाने के लिए है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setLeftOffset(offset)
पैराग्राफ़ के बाएं हिस्से से, इमेज के ऑफ़सेट को पॉइंट में सेट करता है.
पैरामीटर
| नाम | Type | ब्यौरा |
|---|---|---|
offset | Number | पैराग्राफ़ के बाईं ओर से ऑफ़सेट |
रिटर्न
PositionedImage — यह ऑब्जेक्ट चेन बनाने के लिए है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setTopOffset(offset)
पैराग्राफ़ के ऊपर से, इमेज के ऑफ़सेट को पॉइंट में सेट करता है.
पैरामीटर
| नाम | Type | ब्यौरा |
|---|---|---|
offset | Number | पैराग्राफ़ के ऊपर से ऑफ़सेट करना |
रिटर्न
PositionedImage — यह ऑब्जेक्ट चेन बनाने के लिए है
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setWidth(width)
इमेज की चौड़ाई को पिक्सल में सेट करता है.
पैरामीटर
| नाम | Type | ब्यौरा |
|---|---|---|
width | Integer | इमेज की चौड़ाई, पिक्सल में |
रिटर्न
PositionedImage — मौजूदा ऑब्जेक्ट
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents