Class ParagraphStyle
Page Summary
ParagraphStyle applies text styles to entire paragraphs.
Reading methods for ParagraphStyle return null if the TextRange spans paragraphs with different styles.
To avoid issues with reading styles across multiple paragraphs, query using the TextRange returned by Paragraph.getRange().
Editing text fit within a shape deactivates any autofit settings on paragraph styles.
ParagraphStyle provides methods to get and set indentation, line spacing, alignment, spacing above and below, spacing mode, and text direction.
The styles of text that apply to entire paragraphs.
Read methods in this class returnnull if the correspondingText spansmultiple paragraphs, and those paragraphs have different values for the read method being called.To avoid this, query for paragraph styles using theText returned by theParagraph.getRange() method.
If you use methods that edit how text fits within a shape, any autofit settings applied to theparagraph styles are deactivated.
Methods
| Method | Return type | Brief description |
|---|---|---|
get | Number|null | Returns the text end indentation for paragraphs in theText in points, ornull if there are multiple paragraph styles on the given text. |
get | Number|null | Returns the indentation for the first line of paragraphs in theText in points, ornull if there are multiple paragraph styles on the given text. |
get | Number|null | Returns the text start indentation for paragraphs in theText in points, ornull if there are multiple paragraph styles on the given text. |
get | Number|null | Returns the line spacing, ornull if there are multiple paragraph styles on the giventext. |
get | Paragraph | Returns theParagraph of paragraphs in theText, ornullif there are multiple paragraph styles on the given text. |
get | Number|null | Returns the extra space above paragraphs in theText in points, ornull ifthere are multiple paragraph styles on the given text. |
get | Number|null | Returns the extra space below paragraphs in theText in points, ornull ifthere are multiple paragraph styles on the given text. |
get | Spacing | Returns theSpacing for paragraphs in theText, ornull ifthere are multiple paragraph styles on the given text. |
get | Text | Returns theText for paragraphs in theText, ornull ifthere are multiple paragraph styles on the given text. |
set | Paragraph | Sets the text end indentation for paragraphs in theText in points. |
set | Paragraph | Sets the indentation for the first line of paragraphs in theText in points. |
set | Paragraph | Sets the text start indentation for paragraphs in theText in points. |
set | Paragraph | Sets the line spacing. |
set | Paragraph | Sets theParagraph of paragraphs in theText. |
set | Paragraph | Sets the extra space above paragraphs in theText in points. |
set | Paragraph | Sets the extra space below paragraphs in theText in points. |
set | Paragraph | Sets theSpacing for paragraphs in theText. |
set | Paragraph | Sets theText for paragraphs in theText. |
Detailed documentation
getIndentEnd()
Returns the text end indentation for paragraphs in theText in points, ornull if there are multiple paragraph styles on the given text.
The side that corresponds to the end of the text is based on the current text direction.
Return
Number|null
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
getIndentFirstLine()
Returns the indentation for the first line of paragraphs in theText in points, ornull if there are multiple paragraph styles on the given text.
Return
Number|null
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
getIndentStart()
Returns the text start indentation for paragraphs in theText in points, ornull if there are multiple paragraph styles on the given text.
The side that corresponds to the start of the text is based on the current text direction.
Return
Number|null
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
getLineSpacing()
Returns the line spacing, ornull if there are multiple paragraph styles on the giventext.
This is a value that corresponds to the space between lines, as a percentage of normal.Normal is represented as 100.0.
Return
Number|null
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
getParagraphAlignment()
Returns theParagraph of paragraphs in theText, ornullif there are multiple paragraph styles on the given text.
Return
Paragraph
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
getSpaceAbove()
Returns the extra space above paragraphs in theText in points, ornull ifthere are multiple paragraph styles on the given text.
Return
Number|null
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
getSpaceBelow()
Returns the extra space below paragraphs in theText in points, ornull ifthere are multiple paragraph styles on the given text.
Return
Number|null
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
getSpacingMode()
Returns theSpacing for paragraphs in theText, ornull ifthere are multiple paragraph styles on the given text.
Return
Spacing
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
getTextDirection()
Returns theText for paragraphs in theText, ornull ifthere are multiple paragraph styles on the given text.
Return
Text
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
setIndentEnd(indent)
Sets the text end indentation for paragraphs in theText in points.
The side that corresponds to the end of the text is based on the current text direction.
Parameters
| Name | Type | Description |
|---|---|---|
indent | Number |
Return
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
setIndentFirstLine(indent)
Sets the indentation for the first line of paragraphs in theText in points.
Parameters
| Name | Type | Description |
|---|---|---|
indent | Number |
Return
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
setIndentStart(indent)
Sets the text start indentation for paragraphs in theText in points.
The side that corresponds to the start of the text is based on the current text direction.
Parameters
| Name | Type | Description |
|---|---|---|
indent | Number |
Return
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
setLineSpacing(spacing)
Sets the line spacing.
This is a value that corresponds to the space between lines, as a percentage of normal.Normal is represented as 100.0.
Parameters
| Name | Type | Description |
|---|---|---|
spacing | Number |
Return
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
setParagraphAlignment(alignment)
Sets theParagraph of paragraphs in theText.
Parameters
| Name | Type | Description |
|---|---|---|
alignment | Paragraph |
Return
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
setSpaceAbove(space)
Sets the extra space above paragraphs in theText in points.
Parameters
| Name | Type | Description |
|---|---|---|
space | Number |
Return
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
setSpaceBelow(space)
Sets the extra space below paragraphs in theText in points.
Parameters
| Name | Type | Description |
|---|---|---|
space | Number |
Return
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
setSpacingMode(mode)
Sets theSpacing for paragraphs in theText.
Parameters
| Name | Type | Description |
|---|---|---|
mode | Spacing |
Return
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
setTextDirection(direction)
Sets theText for paragraphs in theText.
Parameters
| Name | Type | Description |
|---|---|---|
direction | Text |
Return
Authorization
Scripts that use this method require authorization with one or more of the followingscopes:
https://www.googleapis.com/auth/presentations.currentonlyhttps://www.googleapis.com/auth/presentations
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-11 UTC.