Class: PDF::SimpleTable

Inherits:

Object

Object
PDF::SimpleTable

show all

Includes:: Transaction::Simple

Defined in:: lib/pdf/simpletable.rb

Overview

This class will create tables with a relatively simple API and internal implementation.

Defined Under Namespace

Classes: Column

Constant Summary collapse

WIDTH_FACTOR =

1.01

Instance Attribute Summary collapse

#bold_headings ⇒ Object

Makes the heading text bold if true.
#column_gap ⇒ Object

The space, in PDF user units, on the left and right sides of each cell.
#column_order ⇒ Object

An array that defines the order of the columns in the table.
#columns ⇒ Object

An array that defines columns and column options for the table.
#data ⇒ Object

An array of Hash entries.
#font_size ⇒ Object

The font size of the data cells, in points.
#header_gap ⇒ Object

The number of PDF user units to leave open at the top of a page after a page break.
#heading_color ⇒ Object

The text colour of the heading.
#heading_font_size ⇒ Object

The font size of the heading cells, in points.
#inner_line_style ⇒ Object

Defines the inner line style.
#line_color ⇒ Object

The colour of the table lines.
#maximum_width ⇒ Object

Specifies the maximum width of the table.
#minimum_space ⇒ Object

The minimum space between the bottom of each row and the bottom margin.
#orientation ⇒ Object

The orientation of the table relative to #position.
#outer_line_style ⇒ Object

Defines the outer line style.
#position ⇒ Object

The x position of the table.
#protect_rows ⇒ Object

The number of rows to hold with the heading on the page.
#row_gap ⇒ Object

The space, in PDF user units, added to the top and bottom of each row between the text and the lines of the cell.
#shade_color ⇒ Object

The main row shading colour.
#shade_color2 ⇒ Object

The alternate row shading colour, used with #shade_rows of :striped.
#shade_heading_color ⇒ Object

Defines the colour of the background shading for the heading if #shade_headings is true.
#shade_headings ⇒ Object

Places a background colour in the heading if true.
#shade_rows ⇒ Object

Controls row shading.
#show_headings ⇒ Object

Displays the headings for the table if true.
#show_lines ⇒ Object

Whether to display the lines on the table or not.
#split_rows ⇒ Object

Allows a table’s rows to be split across page boundaries if true.
#text_color ⇒ Object

The text colour of the body cells.
#title ⇒ Object

The title to be put on the top of the table.
#title_color ⇒ Object

The text colour of the title.
#title_font_size ⇒ Object

The font size of the title, in points.
#title_gap ⇒ Object

The gap, in PDF units, between the title and the table.
#width ⇒ Object

Specifies the width of the table.

Instance Method Summary collapse

#initialize {|_self| ... } ⇒ SimpleTable constructor

A new instance of SimpleTable.
#render_on(pdf) ⇒ Object

Render the table on the PDF::Writer document provided.

Constructor Details

#initialize {|_self| ... } ⇒ `SimpleTable`

Returns a new instance of SimpleTable.

Yields:

(_self)

Yield Parameters:

_self (PDF::SimpleTable) —

the object that the method was called on

# File 'lib/pdf/simpletable.rb', line 69

def initialize
  @column_order = []
  @data         = []
  @columns      = {}

  @show_lines           = :outer
  @show_headings        = true
  @shade_rows           = :shaded
  @shade_color          = Color::RGB::Grey80
  @shade_color2         = Color::RGB::Grey70
  @shade_headings       = false
  @shade_heading_color  = Color::RGB::Grey90
  @font_size            = 10
  @heading_font_size    = 12
  @title_font_size      = 12
  @title_gap            = 5
  @title_color          = Color::RGB::Black
  @heading_color        = Color::RGB::Black
  @text_color           = Color::RGB::Black
  @line_color           = Color::RGB::Black
  @position             = :center
  @orientation          = :center
  @bold_headings        = false

  @cols                 = PDF::Writer::OHash.new
  @width                = 0
  @maximum_width        = 0

  @gap                  = 5
  @row_gap              = 2
  @column_gap           = 5
  @header_gap           = 0

  @minimum_space        = 0
  @protect_rows         = 1
  @split_rows           = false

  @inner_line_style     = PDF::Writer::StrokeStyle.new(1)
  @outer_line_style     = PDF::Writer::StrokeStyle.new(1)

  yield self if block_given?
end

Instance Attribute Details

#bold_headings ⇒ `Object`

Makes the heading text bold if true. Defaults to false.



192
193
194

# File 'lib/pdf/simpletable.rb', line 192

def bold_headings
  @bold_headings
end

#column_gap ⇒ `Object`

The space, in PDF user units, on the left and right sides of each cell. Default 5 units.



213
214
215

# File 'lib/pdf/simpletable.rb', line 213

def column_gap
  @column_gap
end

#column_order ⇒ `Object`

An array that defines the order of the columns in the table. The values in this array are the column names in #data. The columns will be presented in the order defined here.



119
120
121

# File 'lib/pdf/simpletable.rb', line 119

def column_order
  @column_order
end

#columns ⇒ `Object`

An array that defines columns and column options for the table. The entries should be PDF::SimpleTable::Column objects.



122
123
124

# File 'lib/pdf/simpletable.rb', line 122

def columns
  @columns
end

#data ⇒ `Object`

An array of Hash entries. Each row is a Hash where the keys are the names of the columns as specified in #column_order and the values are the values of the cell.



115
116
117

# File 'lib/pdf/simpletable.rb', line 115

def data
  @data
end

#font_size ⇒ `Object`

The font size of the data cells, in points. Defaults to 10 points.



160
161
162

# File 'lib/pdf/simpletable.rb', line 160

def font_size
  @font_size
end

#header_gap ⇒ `Object`

The number of PDF user units to leave open at the top of a page after a page break. This is typically used for a repeating page header, etc. Defaults to zero units.



229
230
231

# File 'lib/pdf/simpletable.rb', line 229

def header_gap
  @header_gap
end

#heading_color ⇒ `Object`

The text colour of the heading. Defaults to Color::RGB::Black.



171
172
173

# File 'lib/pdf/simpletable.rb', line 171

def heading_color
  @heading_color
end

#heading_font_size ⇒ `Object`

The font size of the heading cells, in points. Defaults to 12 points.



162
163
164

# File 'lib/pdf/simpletable.rb', line 162

def heading_font_size
  @heading_font_size
end

#inner_line_style ⇒ `Object`

Defines the inner line style. The default style is a solid line with a thickness of 1 unit.



232
233
234

# File 'lib/pdf/simpletable.rb', line 232

def inner_line_style
  @inner_line_style
end

#line_color ⇒ `Object`

The colour of the table lines. Defaults to Color::RGB::Black.



175
176
177

# File 'lib/pdf/simpletable.rb', line 175

def line_color
  @line_color
end

#maximum_width ⇒ `Object`

Specifies the maximum width of the table. The table will not grow larger than this width under any circumstances.

Defaults to zero, which indicates that there is no maximum width (aside from the margin size).



207
208
209

# File 'lib/pdf/simpletable.rb', line 207

def maximum_width
  @maximum_width
end

#minimum_space ⇒ `Object`

The minimum space between the bottom of each row and the bottom margin. If the amount of space is less than this, a new page will be started. Default is 100 PDF user units.



218
219
220

# File 'lib/pdf/simpletable.rb', line 218

def minimum_space
  @minimum_space
end

#orientation ⇒ `Object`

The orientation of the table relative to #position.

:left: The table is to the left of #position.
:right: The table is to the right of #position.
:center: The table is centred at #position.
offset: The left of the table is offset from #position.



190
191
192

# File 'lib/pdf/simpletable.rb', line 190

def orientation
  @orientation
end

#outer_line_style ⇒ `Object`

Defines the outer line style. The default style is a solid line with a thickness of 1 unit.



235
236
237

# File 'lib/pdf/simpletable.rb', line 235

def outer_line_style
  @outer_line_style
end

#position ⇒ `Object`

The x position of the table. This will be one of:

:left: Aligned with the left margin.
:right: Aligned with the right margin.
:center: Centered between the margins. Default.
offset: The absolute position of the table, relative from the left margin.



183
184
185

# File 'lib/pdf/simpletable.rb', line 183

def position
  @position
end

#protect_rows ⇒ `Object`

The number of rows to hold with the heading on the page. If there are less than this number of rows on the page, then move the whole lot onto the next page. Default is one row.



222
223
224

# File 'lib/pdf/simpletable.rb', line 222

def protect_rows
  @protect_rows
end

#row_gap ⇒ `Object`

The space, in PDF user units, added to the top and bottom of each row between the text and the lines of the cell. Default 2 units.



210
211
212

# File 'lib/pdf/simpletable.rb', line 210

def row_gap
  @row_gap
end

#shade_color ⇒ `Object`

The main row shading colour. Defaults to Color::RGB::Grey80. Used with #shade_rows of :shaded and :striped.



150
151
152

# File 'lib/pdf/simpletable.rb', line 150

def shade_color
  @shade_color
end

#shade_color2 ⇒ `Object`

The alternate row shading colour, used with #shade_rows of :striped. Defaults to Color::RGB::Grey70.



153
154
155

# File 'lib/pdf/simpletable.rb', line 153

def shade_color2
  @shade_color2
end

#shade_heading_color ⇒ `Object`

Defines the colour of the background shading for the heading if #shade_headings is true. Default is Color::RGB::Grey90.



158
159
160

# File 'lib/pdf/simpletable.rb', line 158

def shade_heading_color
  @shade_heading_color
end

#shade_headings ⇒ `Object`

Places a background colour in the heading if true.



155
156
157

# File 'lib/pdf/simpletable.rb', line 155

def shade_headings
  @shade_headings
end

#shade_rows ⇒ `Object`

Controls row shading.

:none: No row shading; all rows are the standard background colour.
:shaded: Alternate lines will be shaded; half of the rows will be the standard background colour; the rest of the rows will be shaded with #shade_color. Default
:striped: Alternate lines will be shaded; half of the rows will be shaded with #shade_color; the rest of the rows will be shaded with #shade_color2.



147
148
149

# File 'lib/pdf/simpletable.rb', line 147

def shade_rows
  @shade_rows
end

#show_headings ⇒ `Object`

Displays the headings for the table if true. The default is true.



135
136
137

# File 'lib/pdf/simpletable.rb', line 135

def show_headings
  @show_headings
end

#show_lines ⇒ `Object`

Whether to display the lines on the table or not. Valid values are:

:none: Displays no lines.
:outer: Displays outer lines only. Default
:inner: Displays inner lines only.
:all: Displays all lines, inner and outer.



133
134
135

# File 'lib/pdf/simpletable.rb', line 133

def show_lines
  @show_lines
end

#split_rows ⇒ `Object`

Allows a table’s rows to be split across page boundaries if true. This defaults to false.



225
226
227

# File 'lib/pdf/simpletable.rb', line 225

def split_rows
  @split_rows
end

#text_color ⇒ `Object`

The text colour of the body cells. Defaults to Color::RGB::Black.



173
174
175

# File 'lib/pdf/simpletable.rb', line 173

def text_color
  @text_color
end

#title ⇒ `Object`

The title to be put on the top of the table.



125
126
127

# File 'lib/pdf/simpletable.rb', line 125

def title
  @title
end

#title_color ⇒ `Object`

The text colour of the title. Defaults to Color::RGB::Black.



169
170
171

# File 'lib/pdf/simpletable.rb', line 169

def title_color
  @title_color
end

#title_font_size ⇒ `Object`

The font size of the title, in points. Defaults to 12 points.



164
165
166

# File 'lib/pdf/simpletable.rb', line 164

def title_font_size
  @title_font_size
end

#title_gap ⇒ `Object`

The gap, in PDF units, between the title and the table. Defaults to 5 units.



167
168
169

# File 'lib/pdf/simpletable.rb', line 167

def title_gap
  @title_gap
end

#width ⇒ `Object`

Specifies the width of the table. If the table is smaller than the provided width, columns are proportionally stretched to fit the width of the table. If the table is wider than the provided width, columns are proportionally shrunk to fit the width of the table. Content may need to wrap in this case.

Defaults to zero, which indicates that the size whould be determined automatically based on the content and the margins.



201
202
203

# File 'lib/pdf/simpletable.rb', line 201

def width
  @width
end

Instance Method Details

#render_on(pdf) ⇒ `Object`

Render the table on the PDF::Writer document provided.

# File 'lib/pdf/simpletable.rb', line 238

def render_on(pdf)
  if @column_order.empty?
    raise TypeError, PDF::Writer::Lang[:simpletable_columns_undefined]
  end
  if @data.empty?
    raise TypeError, PDF::Writer::Lang[:simpletable_data_empty]
  end

  low_y = descender = y0 = y1 = y = nil

  @cols = PDF::Writer::OHash.new
  @column_order.each do |name|
    col = @columns[name]
    if col
      @cols[name] = col
    else
      @cols[name] = PDF::SimpleTable::Column.new(name)
    end
  end

  @gap = 2 * @column_gap

  max_width = __find_table_max_width__(pdf)
  pos, t, x, adjustment_width, set_width = __find_table_positions__(pdf, max_width)

  # if max_width is specified, and the table is too wide, and the width
  # has not been set, then set the width.
  if @width.zero? and @maximum_width.nonzero? and ((t - x) > @maximum_width)
    @width = @maximum_width
  end

  if @width and (adjustment_width > 0) and (set_width < @width)
      # First find the current widths of the columns involved in this
      # mystery
    cols0 = PDF::Writer::OHash.new
    cols1 = PDF::Writer::OHash.new

    xq = presentWidth = 0
    last = nil

    pos.each do |name, colpos|
      if @cols[last].nil? or
        @cols[last].width.nil? or
        @cols[last].width <= 0
        unless last.nil? or last.empty?
          cols0[last] = colpos - xq - @gap
          presentWidth += (colpos - xq - @gap)
        end
      else
        cols1[last] = colpos - xq
      end
      last = name
      xq = colpos
    end

    # cols0 contains the widths of all the columns which are not set
    needed_width = @width - set_width

      # If needed width is negative then add it equally to each column,
      # else get more tricky.
    if presentWidth < needed_width
      diff = (needed_width - presentWidth) / cols0.size.to_f
      cols0.each_key { |name| cols0[name] += diff }
    else
      cnt = 0
      loop do
        break if (presentWidth <= needed_width) or (cnt >= 100)
        cnt += 1 # insurance policy
          # Find the widest columns and the next to widest width
        aWidest = []
        nWidest = widest = 0
        cols0.each do |name, w|
          if w > widest
            aWidest = [ name ]
            nWidest = widest
            widest = w
          elsif w == widest
            aWidest << name
          end
        end

        # Then figure out what the width of the widest columns would
        # have to be to take up all the slack.
        newWidestWidth = widest - (presentWidth - needed_width) / aWidest.size.to_f
        if newWidestWidth > nWidest
          aWidest.each { |name| cols0[name] = newWidestWidth }
          presentWidth = needed_width
        else
          # There is no space, reduce the size of the widest ones down
          # to the next size down, and we will go round again
          aWidest.each { |name| cols0[name] = nWidest }
          presentWidth -= (widest - nWidest) * aWidest.size
        end
      end
    end

      # cols0 now contains the new widths of the constrained columns. now
      # need to update the pos and max_width arrays
    xq = 0
    pos.each do |name, colpos|
      pos[name] = xq

      if @cols[name].nil? or
        @cols[name].width.nil? or
        @cols[name].width <= 0
        if not cols0[name].nil?
          xq += cols0[name] + @gap
          max_width[name] = cols0[name]
        end
      else
        xq += cols1[name] unless cols1[name].nil?
      end
    end

    t = x + @width
    pos[:__last_column__] = t
  end

  # now adjust the table to the correct location across the page
  case @position
  when :left
    xref = pdf.absolute_left_margin
  when :right
    xref = pdf.absolute_right_margin
  when :center
    xref = pdf.margin_x_middle
  else
    xref = @position
  end

  case @orientation
  when :left
    dx = xref - t
  when :right
    dx = xref
  when :center
    dx = xref - (t / 2.0)
  else
    dx = xref + @orientation
  end

  pos.each { |k, v| pos[k] = v + dx }

  base_x0 = x0 = x + dx
  base_x1 = x1 = t + dx

  base_left_margin = pdf.absolute_left_margin
  base_pos = pos.dup

    # Ok, just about ready to make me a table.
  pdf.fill_color @text_color
  pdf.stroke_color @shade_color 

  middle = (x0 + x1) / 2.0

    # Start a transaction. This transaction will be used to regress the
    # table if there are not enough rows protected. 
  tg = Transaction::Simple::Group.new(pdf, self)
  tg.start_transaction(:table)
  moved_once = false if @protect_rows.nonzero?

  abortTable = true
  loop do # while abortTable
    break unless abortTable
    abortTable = false

    dm = pdf.absolute_left_margin - base_left_margin
    base_pos.each { |k, v| pos[k] = v + dm }
    x0 = base_x0 + dm
    x1 = base_x1 + dm
    middle = (x0 + x1) / 2.0

      # If the title is set, then render it.
    unless @title.nil? or @title.empty?
      w = pdf.text_width(@title, @title_font_size)
      _y = pdf.y - pdf.font_height(@title_font_size)
      if _y < pdf.absolute_bottom_margin
        pdf.start_new_page

          # margins may have changed on the new page
        dm = pdf.absolute_left_margin - base_left_margin
        base_pos.each { |k, v| pos[k] = v + dm }
        x0 = base_x0 + dm
        x1 = base_x1 + dm
        middle = (x0 + x1) / 2.0
      end

      pdf.y -= pdf.font_height(@title_font_size)
      pdf.fill_color @title_color
      pdf.add_text(middle - w / 2.0, pdf.y, title, @title_font_size)
      pdf.y -= @title_gap
    end

      # Margins may have changed on the new_page.
    dm = pdf.absolute_left_margin - base_left_margin
    base_pos.each { |k, v| pos[k] = v + dm }
    x0 = base_x0 + dm
    x1 = base_x1 + dm
    middle = (x0 + x1) / 2.0

    y = pdf.y  # simplifies the code a bit
    low_y = y if low_y.nil? or y < low_y 

      # Make the table
    height = pdf.font_height @font_size
    descender = pdf.font_descender @font_size

    y0 = y + descender
    dy = 0

    if @show_headings
      # This function will move the start of the table to a new page if
      # it does not fit on this one.
      hOID = __open_new_object__(pdf) if @shade_headings
      pdf.fill_color @heading_color
      _height, y = __table_column_headings__(pdf, pos, max_width, height,
        descender, @row_gap, @heading_font_size, y)
      pdf.fill_color @text_color
      y0 = y + _height
      y1 = y

      if @shade_headings
        pdf.close_object
        pdf.fill_color! @shade_heading_color
        pdf.rectangle(x0 - @gap / 2.0, y, x1 - x0, _height).fill
        pdf.reopen_object(hOID)
        pdf.close_object
        pdf.restore_state
      end

        # Margins may have changed on the new_page
      dm = pdf.absolute_left_margin - base_left_margin
      base_pos.each { |k, v| pos[k] = v + dm }
      x0 = base_x0 + dm
      x1 = base_x1 + dm
      middle = (x0 + x1) / 2.0
    else
      y1 = y0
    end

    first_line = true

    # open an object here so that the text can be put in over the
    # shading
    tOID = __open_new_object__(pdf) unless :none == @shade_rows

    cnt = 0
    cnt = 1 unless @shade_headings
    newPage = false
    @data.each do |row|
      cnt += 1
        # Start a transaction that will be used for this row to prevent it
        # from being split.
      unless @split_rows
        pageStart = pdf.pageset.size

        columnStart = pdf.column_number if pdf.columns?

        tg.start_transaction(:row)
        row_orig = row
        y_orig = y
        y0_orig = y0
        y1_orig = y1
      end # unless @split_rows

      ok = false
      second_turn = false
      loop do # while !abortTable and !ok
        break if abortTable or ok

        mx = 0
        newRow = true

        loop do # while !abortTable and (newPage or newRow)
          break if abortTable or not (newPage or newRow)

          y -= height
          low_y = y if low_y.nil? or y < low_y 

          if newPage or y < (pdf.absolute_bottom_margin + @minimum_space)
              # check that enough rows are with the heading
            moved_once = abortTable = true if @protect_rows.nonzero? and not moved_once and cnt <= @protect_rows

            y2 = y - mx + (2 * height) + descender - (newRow ? 1 : 0) * height

            unless :none == @show_lines
              y0 = y1 unless @show_headings

              __table_draw_lines__(pdf, pos, @gap, x0, x1, y0, y1, y2,
                @line_color, @inner_line_style, @outer_line_style,
                @show_lines)
            end

            unless :none == @shade_rows
              pdf.close_object
              pdf.restore_state
            end

            pdf.start_new_page
            pdf.save_state

              # and the margins may have changed, this is due to the
              # possibility of the columns being turned on as the columns are
              # managed by manipulating the margins
            dm = pdf.absolute_left_margin - base_left_margin
            base_pos.each { |k, v| pos[k] = v + dm }
            x0 = base_x0 + dm
            x1 = base_x1 + dm

            tOID = __open_new_object__(pdf) unless :none == @shade_rows

            pdf.fill_color! @text_color

            y = pdf.absolute_top_margin - @header_gap
            low_y = y
            y0 = y + descender
            mx = 0

            if @show_headings
              old_y = y

              pdf.fill_color @heading_color
              _height, y = __table_column_headings__(pdf, pos, max_width,
                height, descender, @row_gap, @heading_font_size, y)
              pdf.fill_color @text_color

              y0 = y + _height
              y1 = y

              if @shade_headings
                pdf.fill_color! @shade_heading_color
                pdf.rectangle(x0 - @gap / 2, y, x1 - x0, _height).fill
                pdf.fill_color @heading_color
                __table_column_headings__(pdf, pos, max_width, height,
                                          descender, @row_gap,
                                          @heading_font_size, old_y)
                pdf.fill_color @text_color
              end

              dm = pdf.absolute_left_margin - base_left_margin
              base_pos.each { |k, v| pos[k] = v + dm }
              x0 = base_x0 + dm
              x1 = base_x1 + dm
              middle = (x0 + x1) / 2.0
            else
              y1 = y0
            end

            first_line = true
            y -= height
            low_y = y if low_y.nil? or y < low_y 
          end

          newRow = false

            # Write the actual data. If these cells need to be split over
            # a page, then newPage will be set, and the remaining text
            # will be placed in leftOvers
          newPage = false
          leftOvers = PDF::Writer::OHash.new

          @cols.each do |name, column|
            pdf.pointer = y + height
            colNewPage = false

            unless row[name].nil?
              lines = row[name].to_s.split(/\n/)
              if column and column.link_name
                lines.map! do |kk|
                  link = row[column.link_name]
                  if link
                    "<c:alink uri='#{link}'>#{kk}</c:alink>"
                  else
                    kk
                  end
                end
              end
            else
              lines = []
            end

            pdf.y -= @row_gap

            lines.each do |line|
              pdf.send(:preprocess_text, line)
              start = true

              loop do
                break if (line.nil? or line.empty?) and not start
                start = false

                _y = pdf.y - height if not colNewPage

                  # a new page is required
                newPage = colNewPage = true if _y < pdf.absolute_bottom_margin

                if colNewPage
                  if leftOvers[name].nil?
                    leftOvers[name] = [line]
                  else
                    leftOvers[name] << "\n#{line}"
                  end
                  line = nil
                else
                  if column and column.justification
                    just = column.justification
                  end
                  just ||= :left

                  pdf.y = _y
                  line = pdf.add_text_wrap(pos[name], pdf.y,
                                           max_width[name], line,
                                           @font_size, just)
                end
              end
            end

            dy = y + height - pdf.y + @row_gap
            mx = dy - height * (newPage ? 1 : 0) if (dy - height * (newPage ? 1 : 0)) > mx
          end

            # Set row to leftOvers so that they will be processed onto the
            # new page
          row = leftOvers

          # Now add the shading underneath
          unless :none == @shade_rows
            pdf.close_object

            if (cnt % 2).zero?
              pdf.fill_color!(@shade_color)
              pdf.rectangle(x0 - @gap / 2.0, y + descender + height - mx, x1 - x0, mx).fill
            elsif (cnt % 2).nonzero? and :striped == @shade_rows
              pdf.fill_color!(@shade_color2)
              pdf.rectangle(x0 - @gap / 2.0, y + descender + height - mx, x1 - x0, mx).fill
            end
            pdf.reopen_object(tOID)
          end

          if :inner == @show_lines or :all == @show_lines
            # draw a line on the top of the block
            pdf.save_state
            pdf.stroke_color! @line_color
            if first_line
              pdf.stroke_style @outer_line_style
              first_line = false
            else
              pdf.stroke_style @inner_line_style
            end
            pdf.line(x0 - @gap / 2.0, y + descender + height, x1 - @gap / 2.0, y + descender + height).stroke
            pdf.restore_state
          end
        end

        y = y - mx + height
        pdf.y = y
        low_y = y if low_y.nil? or y < low_y 

          # checking row split over pages
        unless @split_rows
          if (((pdf.pageset.size != pageStart) or (pdf.columns? and columnStart != pdf.column_number)) and not second_turn)
            # then we need to go back and try that again!
            newPage = second_turn = true
            tg.rewind_transaction(:row)
            row = row_orig
            low_y = y = y_orig
            y0 = y0_orig
            y1 = y1_orig
            ok = false

            dm = pdf.absolute_left_margin - base_left_margin
            base_pos.each { |k, v| pos[k] = v + dm }
            x0 = base_x0 + dm
            x1 = base_x1 + dm
          else
            tg.commit_transaction(:row)
            ok = true
          end
        else
          ok = true # don't go 'round the loop if splitting rows is allowed
        end
      end

      if abortTable
          # abort_transaction if not ok only the outer transaction should
          # be operational.
        tg.rewind_transaction(:table)
        pdf.start_new_page
          # fix a bug where a moved table will take up the whole page.
        low_y = nil
        pdf.save_state
        break
      end
    end
  end

  if low_y <= y
    y2 = low_y + descender
  else
    y2 = y + descender
  end

  unless :none == @show_lines
    y0 = y1 unless @show_headings

    __table_draw_lines__(pdf, pos, @gap, x0, x1, y0, y1, y2, @line_color,
      @inner_line_style, @outer_line_style, @show_lines)
  end

  # close the object for drawing the text on top
  unless :none == @shade_rows
    pdf.close_object
    pdf.restore_state
  end

  pdf.y = low_y

    # Table has been put on the page, the rows guarded as required; commit.
  tg.commit_transaction(:table)

  y
rescue Exception => ex
  begin
    tg.abort_transaction(:table) if tg.transaction_open?
  rescue
    nil
  end
  raise ex
end

Class: PDF::SimpleTable

Overview

Defined Under Namespace

Constant Summary collapse

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize {|_self| ... } ⇒ SimpleTable

Instance Attribute Details

#bold_headings ⇒ Object

#column_gap ⇒ Object

#column_order ⇒ Object

#columns ⇒ Object

#data ⇒ Object

#font_size ⇒ Object

#header_gap ⇒ Object

#heading_color ⇒ Object

#heading_font_size ⇒ Object

#inner_line_style ⇒ Object

#line_color ⇒ Object

#maximum_width ⇒ Object

#minimum_space ⇒ Object

#orientation ⇒ Object

#outer_line_style ⇒ Object

#position ⇒ Object

#protect_rows ⇒ Object

#row_gap ⇒ Object

#shade_color ⇒ Object

#shade_color2 ⇒ Object

#shade_heading_color ⇒ Object

#shade_headings ⇒ Object

#shade_rows ⇒ Object

#show_headings ⇒ Object

#show_lines ⇒ Object

#split_rows ⇒ Object

#text_color ⇒ Object

#title ⇒ Object

#title_color ⇒ Object

#title_font_size ⇒ Object

#title_gap ⇒ Object

#width ⇒ Object