ph_location
create a location for a placeholder
The function will return a list that complies with
expected format for argument location of functions ph_with_*
and ph_with methods.
Usage
ph_location(left = 1, top = 1, width = 4, height = 3, label = "",
ph = "", bg = NULL, rotation = NULL, ...) Arguments
- left, top, width, height
place holder coordinates in inches.
- label
a label for the placeholder. See section details.
- ph
openxml string value for tag. This is not meant to be used by end users (unless they understand openxml placeholder and
p:phtag).- bg
background color
- rotation
rotation angle
- ...
unused arguments
Details
The location of the bounding box associated to a placeholder within a presentation slide is specified with the left top coordinate, the width and the height. These are defined in inches:
- left
left coordinate of the bounding box
- top
top coordinate of the bounding box
- width
width of the bounding box
- height
height of the bounding box
In addition to these attributes, there is attribute ph_label
associated with the shape (shapes, text boxes, images and other objects
will be identified with that label in the Selection Pane of PowerPoint).
This label can then be reused by other functions such as ph_add_fpar,
or ph_add_text.
See Also
Other functions for placeholder location: ph_location_fullsize,
ph_location_label,
ph_location_left,
ph_location_right,
ph_location_type
Examples
# NOT RUN {
library(magrittr)
read_pptx() %>%
add_slide(layout = "Title and Content", master = "Office Theme") %>%
ph_with("Hello world",
location = ph_location(width = 4, height = 3, label = "hello") ) %>%
print(target = tempfile(fileext = ".pptx") )
# }