Class PageBreak

पेज ब्रेक

पेज ब्रेक दिखाने वाला एलिमेंट. PageBreak को ListItem या Paragraph के अंदर रखा जा सकता है. हालांकि, अगर ListItem या Paragraph को Table, HeaderSection, FooterSection या FootnoteSection में शामिल किया गया है, तो ऐसा नहीं किया जा सकता. PageBreak में खुद कोई दूसरा एलिमेंट नहीं हो सकता. दस्तावेज़ के स्ट्रक्चर के बारे में ज़्यादा जानकारी के लिए, Google Docs का विस्तार करने के लिए गाइड देखें.

माटिंग में इस्तेमाल हुए तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
copy()PageBreakयह मौजूदा एलिमेंट की अलग से डीप कॉपी दिखाता है.
getAttributes()Objectएलिमेंट (&3) की विशेषताएं वापस लाता है.
getNextSibling()Elementएलिमेंट और उससे मिलते-जुलते एलिमेंट को वापस लाता है.
getParent()ContainerElementएलिमेंट के पैरंट एलिमेंट को वापस लाता है.
getPreviousSibling()Elementएलिमेंट और उससे मेल खाने वाले पिछले एलिमेंट को वापस लाता है.
getType()ElementTypeElementType के एलिमेंट को वापस लाता है.
isAtDocumentEnd()Booleanयह तय करता है कि एलिमेंट, Document के आखिर में है या नहीं.
removeFromParent()PageBreakएलिमेंट को उसके पैरंट से हटाता है.
setAttributes(attributes)PageBreakएलिमेंट की विशेषताएं सेट करता है.

ज़्यादा जानकारी वाले दस्तावेज़

copy()

यह मौजूदा एलिमेंट की अलग से डीप कॉपी दिखाता है.

एलिमेंट में मौजूद चाइल्ड एलिमेंट भी कॉपी हो जाते हैं. नए एलिमेंट में पैरंट नहीं है.

रिटर्न टिकट

PageBreak — नई कॉपी.

अनुमति देना

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

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

getAttributes()

एलिमेंट (&3) की विशेषताएं वापस लाता है.

नतीजा एक ऐसा ऑब्जेक्ट होता है जिसमें हर मान्य एलिमेंट एट्रिब्यूट के लिए एक प्रॉपर्टी होती है, जहां हर प्रॉपर्टी का नाम, DocumentApp.Attribute इन्यूमरेशन के एक आइटम से मेल खाता है.

var body = DocumentApp.getActiveDocument().getBody();

// Append a styled paragraph.
var par = body.appendParagraph('A bold, italicized paragraph.');
par.setBold(true);
par.setItalic(true);

// Retrieve the paragraph's attributes.
var atts = par.getAttributes();

// Log the paragraph attributes.
for (var att in atts) {
  Logger.log(att + ":" + atts[att]);
}

रिटर्न टिकट

Object — एलिमेंट और एट्रिब्यूट.

अनुमति देना

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

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

getNextSibling()

एलिमेंट और उससे मिलते-जुलते एलिमेंट को वापस लाता है.

अगले भाई-बहन का एक ही अभिभावक है और वह मौजूदा एलिमेंट को फ़ॉलो करता है.

रिटर्न टिकट

Element — सिबलिंग का अगला एलिमेंट.

अनुमति देना

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

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

getParent()

एलिमेंट के पैरंट एलिमेंट को वापस लाता है.

पैरंट एलिमेंट में मौजूदा एलिमेंट शामिल है.

रिटर्न टिकट

ContainerElement — पैरंट एलिमेंट.

अनुमति देना

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

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

getPreviousSibling()

एलिमेंट और उससे मेल खाने वाले पिछले एलिमेंट को वापस लाता है.

पिछले भाई-बहन का एक ही अभिभावक है और वह मौजूदा एलिमेंट से पहले है.

रिटर्न टिकट

Element — पिछला सिबलिंग एलिमेंट.

अनुमति देना

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

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

getType()

ElementType के एलिमेंट को वापस लाता है.

दिए गए एलिमेंट का सही टाइप तय करने के लिए, getType() का इस्तेमाल करें.

var body = DocumentApp.getActiveDocument().getBody();

// Obtain the first element in the document body.

var firstChild = body.getChild(0);

// Use getType() to determine the element's type.
if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) {
  Logger.log('The first element is a paragraph.');
} else {
  Logger.log('The first element is not a paragraph.');
}

रिटर्न टिकट

ElementType — एलिमेंट किस तरह का है.

अनुमति देना

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

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

isAtDocumentEnd()

यह तय करता है कि एलिमेंट, Document के आखिर में है या नहीं.

रिटर्न टिकट

Boolean — एलिमेंट, दस्तावेज़ के आखिर में है.

अनुमति देना

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

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

removeFromParent()

एलिमेंट को उसके पैरंट से हटाता है.

var body = DocumentApp.getActiveDocument().getBody();

// Remove all images in the document body.
var imgs = body.getImages();
for (var i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

रिटर्न टिकट

PageBreak — हटाया गया एलिमेंट.

अनुमति देना

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

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

setAttributes(attributes)

एलिमेंट की विशेषताएं सेट करता है.

बताया गया एट्रिब्यूट पैरामीटर एक ऐसा ऑब्जेक्ट होना चाहिए जिसमें हर प्रॉपर्टी का नाम, DocumentApp.Attribute इन्यूमरेशन में एक आइटम हो और हर प्रॉपर्टी वैल्यू लागू किए जाने के लिए नई वैल्यू हो.

var body = DocumentApp.getActiveDocument().getBody();

// Define a custom paragraph style.
var style = {};
style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] =
    DocumentApp.HorizontalAlignment.RIGHT;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri';
style[DocumentApp.Attribute.FONT_SIZE] = 18;
style[DocumentApp.Attribute.BOLD] = true;

// Append a plain paragraph.
var par = body.appendParagraph('A paragraph with custom style.');

// Apply the custom style.
par.setAttributes(style);

पैरामीटर

नामटाइपब्यौरा
attributesObjectएलिमेंट और एट्रिब्यूट.

रिटर्न टिकट

PageBreak — मौजूदा एलिमेंट.

अनुमति देना

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

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