Format a chunk of text with text formatting properties (bold, color, ...). The function allows you to create pieces of text formatted the way you want.
Arguments
- text
text value, a single character value
- prop
formatting text properties returned by fp_text. It also can be NULL in which case, no formatting is defined (the default is applied).
usage
You can use this function in conjunction with fpar to create paragraphs consisting of differently formatted text parts. You can also use this function as an r chunk in an R Markdown document made with package officedown.
See also
Other run functions for reporting:
external_img(),
hyperlink_ftext(),
run_autonum(),
run_bookmark(),
run_columnbreak(),
run_footnoteref(),
run_footnote(),
run_linebreak(),
run_pagebreak(),
run_reference(),
run_word_field(),
run_wordtext()
Examples
ftext("hello", fp_text())
#> text: hello
#> format:
#> font.size italic bold underlined color shading fontname fontname_cs
#> 1 10 FALSE FALSE FALSE black transparent Arial Arial
#> fontname_eastasia fontname.hansi vertical_align
#> 1 Arial Arial baseline
properties1 <- fp_text(color = "red")
properties2 <- fp_text(bold = TRUE, shading.color = "yellow")
ftext1 <- ftext("hello", properties1)
ftext2 <- ftext("World", properties2)
paragraph <- fpar(ftext1, " ", ftext2)
x <- read_docx()
x <- body_add(x, paragraph)
print(x, target = tempfile(fileext = ".docx"))