WrdParagraphFormat: Get or Set the Paragraph Format in Word
In DescTools: Tools for Descriptive Statistics

WrdParagraphFormat

R Documentation

Get or Set the Paragraph Format in Word

Description

WrdParagraphFormat can be used to get and set the font in Word for the text to be inserted.

Usage

WrdParagraphFormat(wrd = DescToolsOptions("lastWord"))
WrdParagraphFormat(wrd) <- value

Arguments

value

a list defining the paragraph format. This can contain any combination of: LeftIndent, RightIndent, SpaceBefore, SpaceBeforeAuto, SpaceAfter, SpaceAfterAuto, LineSpacingRule, Alignment, WidowControl, KeepWithNext, KeepTogether, PageBreakBefore, NoLineNumber, Hyphenation, FirstLineIndent, OutlineLevel, CharacterUnitLeftIndent, CharacterUnitRightIndent, CharacterUnitFirstLineIndent, LineUnitBefore, LineUnitAfter and/or MirrorIndents. The possible values of the arguments are found in the Word constants with the respective name.
The alignment for example can be set to wdAlignParagraphLeft, wdAlignParagraphRight, wdAlignParagraphCenter and so on.
Left alignment with indentation would be set as:
list(Alignment=wdConst$wdAlignParagraphLeft, LeftIndent=42.55).

wrd

the pointer to a word instance. Can be a new one, created by GetNewWrd() or an existing one, created by GetCurrWrd(). Default is the last created pointer stored in DescToolsOptions("lastWord").

Value

an object with the class paragraph, basically a list with the attributes of the paragraph in the current cursor position:

`LeftIndent`	left indentation in (in points) for the specified paragraphs.
`RightIndent`	right indent (in points) for the specified paragraphs.
`SpaceBefore`	spacing (in points) before the specified paragraphs.
`SpaceBeforeAuto`	`TRUE` if Microsoft Word automatically sets the amount of spacing before the specified paragraphs.
`SpaceAfter`	amount of spacing (in points) after the specified paragraph or text column.
`SpaceAfterAuto`	`TRUE` if Microsoft Word automatically sets the amount of spacing after the specified paragraphs.
`LineSpacingRule`	line spacing for the specified paragraph formatting. Use `wdLineSpaceSingle`, `wdLineSpace1pt5`, or `wdLineSpaceDouble` to set the line spacing to one of these values. To set the line spacing to an exact number of points or to a multiple number of lines, you must also set the `LineSpacing` property.
`Alignment`	`WdParagraphAlignment` constant that represents the alignment for the specified paragraphs.
`WidowControl`	`TRUE` if the first and last lines in the specified paragraph remain on the same page as the rest of the paragraph when Word repaginates the document. Can be `TRUE`, `FALSE` or `wdUndefined`.
`KeepWithNext`	`TRUE` if the specified paragraph remains on the same page as the paragraph that follows it when Microsoft Word repaginates the document. Read/write Long.
`KeepTogether`	`TRUE` if all lines in the specified paragraphs remain on the same page when Microsoft Word repaginates the document.
`PageBreakBefore`	`TRUE` if a page break is forced before the specified paragraphs. Can be `TRUE`, `FALSE`, or `wdUndefined`.
`NoLineNumber`	`TRUE` if line numbers are repressed for the specified paragraphs. Can be `TRUE`, `FALSE`, or `wdUndefined`.
`Hyphenation`	`TRUE` if the specified paragraphs are included in automatic hyphenation. `FALSE` if the specified paragraphs are to be excluded from automatic hyphenation.
`FirstLineIndent`	value (in points) for a first line or hanging indent. Use a positive value to set a first-line indent, and use a negative value to set a hanging indent.
`OutlineLevel`	outline level for the specified paragraphs.
`CharacterUnitLeftIndent`	left indent value (in characters) for the specified paragraphs.
`CharacterUnitRightIndent`	right indent value (in characters) for the specified paragraphs.
`LineUnitBefore`	amount of spacing (in gridlines) before the specified paragraphs.
`LineUnitAfter`	amount of spacing (in gridlines) after the specified paragraphs.
`MirrorIndents`	Long that represents whether left and right indents are the same width. Can be `TRUE`, `FALSE`, or `wdUndefined`.

Author(s)

Andri Signorell <andri@signorell.net>

Examples

## Not run: 
# Windows-specific example
wrd <- GetNewWrd()  # get the handle to a new word instance

WrdParagraphFormat(wrd=wrd) <- list(Alignment=wdConst$wdAlignParagraphLeft,
                                    LeftIndent=42.55)

ToWrd("Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd
gubergren, no sea takimata sanctus est.\n", wrd=wrd)

# reset
WrdParagraphFormat(wrd=wrd) <- list(LeftIndent=0)

## End(Not run)

DescTools documentation built on Sept. 26, 2024, 1:07 a.m.