टेक्स्ट फ़ॉर्मैट करें

इस पेज में आपको Google Docs API का इस्तेमाल करके, टेक्स्ट फ़ॉर्मैट करने का तरीका बताया गया है.

फ़ॉर्मैटिंग के बारे में जानकारी

टेक्स्ट पर दो अलग-अलग तरह की फ़ॉर्मैटिंग लागू की जा सकती हैं आपके दस्तावेज़ की सामग्री:

  • आप वर्ण की फ़ॉर्मैटिंग बदल सकते हैं, जैसे कि फ़ॉन्ट, रंग या अंडरलाइन करना.
  • पैराग्राफ़ की फ़ॉर्मैटिंग को बदला जा सकता है, जैसे कि इंडेंट या लाइन के बीच की दूरी.

वर्ण की फ़ॉर्मैटिंग बदलना

कैरेक्टर फ़ॉर्मैटिंग की मदद से, यह तय किया जाता है कि दस्तावेज़.

लागू की गई कोई भी फ़ॉर्मैटिंग यहां से इनहेरिट की गई डिफ़ॉल्ट फ़ॉर्मैटिंग को बदल देती है दिए गए पैराग्राफ़ का TextStyle. इसके उलट, जिस वर्ण की फ़ॉर्मैटिंग को आपने सेट नहीं किया है वह इनहेरिट होता रहेगा पैराग्राफ़ की स्टाइल से अलग करें.

टेक्स्ट की वर्ण फ़ॉर्मेटिंग बदलने के लिए, batchUpdate का उपयोग करें UpdateTextStyleRequest. आपको एक range की जानकारी देनी होगी ऑब्जेक्ट के बारे में बताएं जिसमें नीचे दी गई जानकारी शामिल है:

  • segmentId, जो यह पहचान करता है कि कौनसा हेडर, फ़ुटर, फ़ुटनोट—या अगर जो जानकारी नहीं है, उसमें टेक्स्ट मौजूद है.
  • startIndex और endIndex, जो सेगमेंट को फ़ॉर्मैट करना है.
  • एक tabId, जो यह पहचान करता है कि किस टैब में टेक्स्ट है.

नीचे दिए गए उदाहरण में टेक्स्ट पर कई टेक्स्ट स्टाइलिंग कार्रवाइयां की गई हैं जो हेडर में मौजूद होता है:

  • वर्णों के फ़ॉन्ट को 1-5 से बोल्ड इटैलिक पर सेट करता है.
  • वर्णों के रंग को 6-10 से blue 14-पॉइंट टाइम्स न्यू रोमन फ़ॉन्ट पर सेट करता है.
  • 11-15 से www.example.com तक के वर्णों को हाइपरलिंक करता है.

इसका आसान तरीका यह है कि आप अनुरोधों की एक सूची बनाएं और फिर एक batchUpdate का इस्तेमाल करके कॉल:

Java

List<Request> requests = new ArrayList<>();
requests.add(new Request().setUpdateTextStyle(new UpdateTextStyleRequest()
        .setTextStyle(new TextStyle()
                .setBold(true)
                .setItalic(true))
        .setRange(new Range()
                .setStartIndex(1)
                .setEndIndex(5)
                .setTabId(TAB_ID))
        .setFields("bold")));

requests.add(new Request()
        .setUpdateTextStyle(new UpdateTextStyleRequest()
                .setRange(new Range()
                        .setStartIndex(6)
                        .setEndIndex(10)
                        .setTabId(TAB_ID))
                .setTextStyle(new TextStyle()
                        .setWeightedFontFamily(new WeightedFontFamily()
                                .setFontFamily("Times New Roman"))
                        .setFontSize(new Dimension()
                                .setMagnitude(14.0)
                                .setUnit("PT"))
                        .setForegroundColor(new OptionalColor()
                                .setColor(new Color().setRgbColor(new RgbColor()
                                        .setBlue(1.0F)
                                        .setGreen(0.0F)
                                        .setRed(0.0F)))))
                .setFields("foregroundColor,weightedFontFamily,fontSize")));

requests.add(new Request()
        .setUpdateTextStyle(new UpdateTextStyleRequest()
                .setRange(new Range()
                        .setStartIndex(11)
                        .setEndIndex(15)
                        .setTabId(TAB_ID))
                .setTextStyle(new TextStyle()
                        .setLink(new Link()
                                .setUrl("www.example.com")))
                .setFields("link")));


BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests);
BatchUpdateDocumentResponse response = docsService.documents()
        .batchUpdate(DOCUMENT_ID, body).execute();

Python

requests = [
    {
        'updateTextStyle': {
            'range': {
                'startIndex': 1,
                'endIndex': 5,
                'tabId': TAB_ID
            },
            'textStyle': {
                'bold': True,
                'italic': True
            },
            'fields': 'bold,italic'
        }
    },
    {
        'updateTextStyle': {
            'range': {
                'startIndex': 6,
                'endIndex': 10,
                'tabId': TAB_ID
            },
            'textStyle': {
                'weightedFontFamily': {
                    'fontFamily': 'Times New Roman'
                },
                'fontSize': {
                    'magnitude': 14,
                    'unit': 'PT'
                },
                'foregroundColor': {
                    'color': {
                        'rgbColor': {
                            'blue': 1.0,
                            'green': 0.0,
                            'red': 0.0
                        }
                    }
                }
            },
            'fields': 'foregroundColor,weightedFontFamily,fontSize'
        }
    },
    {
        'updateTextStyle': {
            'range': {
                'startIndex': 11,
                'endIndex': 15,
                'tabId': TAB_ID
            },
            'textStyle': {
                'link': {
                    'url': 'www.example.com'
                }
            },
            'fields': 'link'
        }
    }
]

result = service.documents().batchUpdate(
    documentId=DOCUMENT_ID, body={'requests': requests}).execute()

पैराग्राफ़ की फ़ॉर्मैटिंग बदलना

Google Docs API की मदद से, पैराग्राफ़ की फ़ॉर्मैटिंग अपडेट की जा सकती है, जिससे यह तय होता है कि आपके दस्तावेज़ में टेक्स्ट के ब्लॉक रेंडर किए जाते हैं. इसमें अलाइनमेंट जैसी सुविधाएं भी शामिल हैं दिखाई देता है.

लागू की गई कोई भी फ़ॉर्मैटिंग यहां से इनहेरिट की गई डिफ़ॉल्ट फ़ॉर्मैटिंग को बदल देती है शामिल कर सकते हैं. इसके उलट, फ़ॉर्मैट की ऐसी कोई भी सुविधा जिसे सेट न करें, पैराग्राफ़ शैली से इनहेरिट करना जारी रखें. पैराग्राफ़ के बारे में ज़्यादा जानकारी के लिए शैली और इनहेरिटेंस, देखें ParagraphStyle.

नीचे दिए गए उदाहरण में किसी पैराग्राफ़ के लिए नीचे दी गई फ़ॉर्मैटिंग के बारे में बताया गया है:

  • नाम वाली स्टाइल के तौर पर हेडिंग
  • ऊपर पसंद के मुताबिक दूरी
  • नीचे पसंद के मुताबिक दूरी
  • कस्टम बायां बॉर्डर

पैराग्राफ़ की बाकी सभी फ़ॉर्मैटिंग सुविधाएं, नाम वाली स्टाइल.

Java

List<Request> requests = new ArrayList<>();
requests.add(new Request().setUpdateParagraphStyle(new UpdateParagraphStyleRequest()
        .setRange(new Range()
                .setStartIndex(1)
                .setEndIndex(10)
                .setTabId(TAB_ID))
        .setParagraphStyle(new ParagraphStyle()
                .setNamedStyleType("HEADING_1")
                .setSpaceAbove(new Dimension()
                        .setMagnitude(10.0)
                        .setUnit("PT"))
                .setSpaceBelow(new Dimension()
                        .setMagnitude(10.0)
                        .setUnit("PT")))
        .setFields("namedStyleType,spaceAbove,spaceBelow")
));

requests.add(new Request().setUpdateParagraphStyle(new UpdateParagraphStyleRequest()
        .setRange(new Range()
                .setStartIndex(10)
                .setEndIndex(20)
                .setTabId(TAB_ID))
        .setParagraphStyle(new ParagraphStyle()
                .setBorderLeft(new ParagraphBorder()
                        .setColor(new OptionalColor()
                                .setColor(new Color()
                                        .setRgbColor(new RgbColor()
                                                .setBlue(1.0F)
                                                .setGreen(0.0F)
                                                .setRed(0.0F)
                                        )
                                )
                        )
                        .setDashStyle("DASH")
                        .setPadding(new Dimension()
                                .setMagnitude(20.0)
                                .setUnit("PT"))
                        .setWidth(new Dimension()
                                .setMagnitude(15.0)
                                .setUnit("PT")
                        )
                )
        )
        .setFields("borderLeft")
));

BatchUpdateDocumentRequest body = new BatchUpdateDocumentRequest().setRequests(requests);
BatchUpdateDocumentResponse response = docsService.documents()
        .batchUpdate(DOCUMENT_ID, body).execute();

Python

requests = [
    {
        'updateParagraphStyle': {
            'range': {
                'startIndex': 1,
                'endIndex':  10,
                'tabId': TAB_ID
            },
            'paragraphStyle': {
                'namedStyleType': 'HEADING_1',
                'spaceAbove': {
                    'magnitude': 10.0,
                    'unit': 'PT'
                },
                'spaceBelow': {
                    'magnitude': 10.0,
                    'unit': 'PT'
                }
            },
            'fields': 'namedStyleType,spaceAbove,spaceBelow'
        }
    },
    {
        'updateParagraphStyle': {
            'range': {
                'startIndex': 10,
                'endIndex':  20,
                'tabId': TAB_ID
            },
            'paragraphStyle': {
                'borderLeft': {
                    'color': {
                        'color': {
                            'rgbColor': {
                                'blue': 1.0,
                                'green': 0.0,
                                'red': 0.0
                            }
                        }
                    },
                    'dashStyle': 'DASH',
                    'padding': {
                        'magnitude': 20.0,
                        'unit': 'PT'
                    },
                    'width': {
                        'magnitude': 15.0,
                        'unit': 'PT'
                    },
                }
            },
            'fields': 'borderLeft'
        }
    }
]

result = service.documents().batchUpdate(
    documentId=DOCUMENT_ID, body={'requests': requests}).execute()