Learn R Programming

forestplot (version 2.0.1)

prFpDrawLegend: Draw the forestplot legend

Description

Takes the grobs and outputs the legend inside the current viewport.

Usage

prFpDrawLegend(
  lGrobs,
  col,
  shapes_gp,
  colgap,
  pos,
  gp,
  r,
  padding,
  fn.legend,
  ...
)

Value

void

Arguments

lGrobs

A list with all the grobs, see prFpGetLegendGrobs

col

The colors of the legends.

shapes_gp

Sets graphical parameters (squares and lines widths, styles, etc.) of all shapes drawn (squares, lines, diamonds, etc.). This overrides col, lwd.xaxis, lwd.zero, lwd.ci and lty.ci.

colgap

The gap between the box and the text

pos

The position of the legend, either at the "top" or the "right" unless positioned inside the plot. If you want the legend to be positioned inside the plot then you have to provide a list with the same x & y qualities as legend. For instance if you want the legend to be positioned at the top right corner then use pos = list("topright") - this is equivalent to pos = list(x = 1, y = 1). If you want to have a distance from the edge of the graph then add a inset to the list, e.g. pos = list("topright", "inset" = .1) - the inset should be either a unit element or a value between 0 and 1. The default is to have the boxes aligned vertical, if you want them to be in a line then you can specify the "align" option, e.g. pos = list("topright", "inset" = .1, "align" = "horizontal")

gp

The gpar options for the legend. If you want the background color to be light grey then use gp = gpar(fill = "lightgrey"). If you want a border then set the col argument: gp = gpar(fill = "lightgrey", col = "black"). You can also use the lwd and lty argument as usual, gp = gpar(lwd = 2, lty = 1), will result in a black border box of line type 1 and line width 2.

r

The box can have rounded edges, check out grid.roundrect. The r option should be a unit object. This is by default unit(0, "snpc") but you can choose any value that you want. The "snpc" unit is the preferred option.

padding

The padding for the legend box, only used if box is drawn. This is the distance from the border to the text/boxes of the legend.

fn.legend

The function for drawing the marker

...

Passed to the legend fn.legend