grid.place               package:grid               R Documentation

_P_l_a_c_e _a_n _O_b_j_e_c_t _w_i_t_h_i_n _a _F_r_a_m_e

_D_e_s_c_r_i_p_t_i_o_n:

     These functions provide a simpler (and faster) alternative to the
     'grid.pack()' and 'packGrob' functions.  They can be used to place
     objects within the existing rows and columns of a frame layout. 
     They do not provide the ability to add new rows and columns nor do
     they affect the heights and widths of the rows and columns.

_U_s_a_g_e:

     grid.place(gPath, grob, row = 1, col = 1, redraw = TRUE)
     placeGrob(frame, grob, row = NULL, col = NULL)

_A_r_g_u_m_e_n_t_s:

   gPath: A gPath object, which specifies a frame on the display list.

   frame: An object of class 'frame', typically the output from a call
          to 'grid.frame'. 

    grob: An object of class 'grob'.  The object to be placed. 

     row: Which row to add the object to.  Must be between 1 and
          the-number-of-rows-currently-in-the-frame. 

     col: Which col to add the object to.  Must be between 1 and
          the-number-of-cols-currently-in-the-frame.  

  redraw: A boolean indicating whether the output should be updated. 

_D_e_t_a_i_l_s:

     'placeGrob' modifies the given frame grob and returns the modified
     frame grob.

     'grid.place' destructively modifies a frame grob on the display
     list (and redraws the display list if 'redraw' is 'TRUE').

_V_a_l_u_e:

     'placeGrob' returns a frame grob, but 'grid.place' returns 'NULL'.

_A_u_t_h_o_r(_s):

     Paul Murrell

_S_e_e _A_l_s_o:

     'grid.frame', 'grid.pack', 'grid.edit', and 'gPath'.

