addBlock {tablesgg} | R Documentation |
Define a New Block of Cells in a Table
Description
Define a new block (rectangular set of cells) in a table. The location and graphical properties of the block are specified explicitly, rather than being generated automatically from the logical structure of the table and a style.
Usage
addBlock(x, arows, acols, id, props=NULL, enabled=FALSE)
Arguments
x |
A plotted table ( |
arows , acols |
Numeric vectors specifying the cells contained in the block, with respect
to the augmented row-column grid of the table. The block includes the
cells in row numbers from |
id |
Optional character string giving the ID to be assigned to the new block.
It is an error if there is already a block with this ID in |
props |
Optional |
enabled |
Logical scalar, whether the new block is to be enabled for display. The default is FALSE. |
Details
Normally blocks are defined automatically, based on the logical structure of the table and the style selected by the user. This function allows additional blocks to be defined "manually", explicitly specifying their position and span in terms of row and column numbers.
There are two typical situations in which one would want to define a new
block. The first is to highlight a specific set of cells in the table
visually, by shading or a border. For that purpose one should specify
enabled=TRUE
(so the block will be displayed) and perhaps
props
(for non-default graphical properties).
The second reason to define a new block is to use its ID as a quick way to
refer to the entries within it, for example to set their graphical
properties using props<-
. In that case enabled
for the
block should be FALSE, since the block itself is not to be displayed.
Row and column numbers are with respect to the augmented row-column grid
of the table. See ?adim
for more more information about this grid.
The helper functions arow
and acol
can be used to specify
arguments arows
and acols
in terms of table parts or
previously defined blocks.
Graphical properties for blocks defined by this function will not be
changed if a new block style is applied to the plotted table. Use one of
the props<-
functions instead.
There is no way to remove or undefine a block, other than recreating the
plotted table object from scratch. However they can be disabled using a
props<-
function, and then will not be displayed.
Value
A plotted table object like x
, with the new block defined.
See Also
arow
, acol
, adim
,
element_block
Examples
plt <- plot(iris2_tab, title="The iris data",
subtitle="Summary statistics by species")
plt <- addBlock(plt, arows=c(8, 9), acols=c(3, 4), id="new_block",
props=element_block(border_color="red", border_size=1.0),
enabled=TRUE)
plt
# Can refer to the new block by its ID:
props(plt, id="new_block") <- element_entry(fontface=3) # italics
plt