Constructor argument conventions
constr_args(
kids,
cont,
lev,
iscontent,
cinfo,
labelrow,
vals,
cspan,
label_pos,
cindent_mod,
cvar,
label,
cextra_args,
child_names,
title,
subtitles,
main_footer,
prov_footer,
footnotes,
page_title,
page_prefix,
section_div,
trailing_section_div,
split_na_str,
cna_str,
inset,
table_inset,
header_section_div
)
No return value.
(list
)
list of direct children.
(ElementaryTable
)
content table.
(integer(1)
)
nesting level (roughly, indentation level in practical terms).
(flag
)
whether the TableTree
/ElementaryTable
is being constructed as the content
table for another TableTree
.
(InstantiatedColumnInfo
or NULL
)
column structure for the object being created.
(LabelRow
)
the LabelRow
object to assign to the table. Constructed from label
by default
if not specified.
(list
)
cell values for the row.
(integer
)
column span. 1
indicates no spanning.
(string
)
location where the variable label should be displayed. Accepts "hidden"
(default for non-analyze row splits), "visible"
, "topleft"
, and "default"
(for analyze splits only). For
analyze
calls, "default"
indicates that the variable should be visible if and only if multiple variables are
analyzed at the same level of nesting.
(numeric(1)
)
the indent modifier for the content tables generated by this split.
(string
)
the variable, if any, that the content function should accept. Defaults to NA
.
(string
)
a label (not to be confused with the name) for the object/structure.
(list
)
extra arguments to be passed to the content function when tabulating row group
summaries.
(character
)
names to be given to the subsplits contained by a compound split (typically
an AnalyzeMultiVars
split object).
(string
)
single string to use as main title (formatters::main_title()
). Ignored for subtables.
(character
)
a vector of strings to use as subtitles (formatters::subtitles()
), where every
element is printed on a separate line. Ignored for subtables.
(character
)
a vector of strings to use as main global (non-referential) footer materials
(formatters::main_footer()
), where every element is printed on a separate line.
(character
)
a vector of strings to use as provenance-related global footer materials
(formatters::prov_footer()
), where every element is printed on a separate line.
(list
or NULL
)
referential footnotes to be applied at current level. In post-processing,
this can be achieved with fnotes_at_path<-
.
(character
)
page-specific title(s).
(string
)
prefix to be appended with the split value when forcing pagination between
the children of a split/table.
(string
)
string which should be repeated as a section divider after each group defined
by this split instruction, or NA_character_
(the default) for no section divider.
(string
)
string which will be used as a section divider after the printing
of the last row contained in this (sub)table, unless that row is also the last table row to be printed overall,
or NA_character_
for none (the default). When generated via layouting, this would correspond to the
section_div
of the split under which this table represents a single facet.
(character
)
NA string vector for use with split_format
.
(character
)
NA string for use with cformat
for content table.
(numeric(1)
)
number of spaces to inset the table header, table body, referential footnotes, and
main_footer, as compared to alignment of title, subtitle, and provenance footer. Defaults to 0 (no inset).
(numeric(1)
)
number of spaces to inset the table header, table body, referential footnotes,
and main footer, as compared to alignment of title, subtitles, and provenance footer. Defaults to 0 (no inset).
(string
)
string which will be used to divide the header from the table. See
header_section_div()
for the associated getter and setter. Please consider changing last element of
section_div()
when concatenating tables that require a divider between them.
Other conventions:
compat_args()
,
gen_args()
,
lyt_args()
,
sf_args()