Class: Prawn::Document::ColumnBox

Inherits:
BoundingBox show all
Defined in:
lib/prawn/document/column_box.rb

Overview

Implements the necessary functionality to allow Document#column_box to work.

Instance Attribute Summary

Attributes inherited from BoundingBox

#document, #parent, #total_left_padding, #total_right_padding

Instance Method Summary collapse

Methods inherited from BoundingBox

#absolute_bottom, #absolute_bottom_left, #absolute_bottom_right, #absolute_left, #absolute_right, #absolute_top, #absolute_top_left, #absolute_top_right, #anchor, #bottom, #bottom_left, #bottom_right, #deep_copy, #height, #indent, #reference_bounds, restore_deep_copy, #stretchy?, #top, #top_left, #top_right

Constructor Details

#initialize(document, parent, point, options = {}) ⇒ ColumnBox

:nodoc:



53
54
55
56
57
58
59
 
# File 'lib/prawn/document/column_box.rb', line 53

def initialize(document, parent, point, options={}) #:nodoc:
  super
  @columns = options[:columns] || 3
  @spacer  = options[:spacer]  || @document.font_size
  @current_column = 0
  @reflow_margins = options[:reflow_margins]
end

Instance Method Details

#add_left_padding(left_padding) ⇒ Object

Override the padding functions so as not to split the padding amount between all columns on the page.



121
122
123
124
 
# File 'lib/prawn/document/column_box.rb', line 121

def add_left_padding(left_padding)
  @total_left_padding += left_padding
  @x += left_padding
end

#add_right_padding(right_padding) ⇒ Object 



131
132
133
 
# File 'lib/prawn/document/column_box.rb', line 131

def add_right_padding(right_padding)
  @total_right_padding += right_padding
end

#bare_column_width ⇒ Object

The column width, not the width of the whole box, before left and/or right padding



63
64
65
 
# File 'lib/prawn/document/column_box.rb', line 63

def bare_column_width
  (@width - @spacer * (@columns - 1)) / @columns
end

#left ⇒ Object

Relative position of the left edge of the current column



88
89
90
 
# File 'lib/prawn/document/column_box.rb', line 88

def left
  width_of_column * @current_column
end

#left_side ⇒ Object

x coordinate of the left edge of the current column



82
83
84
 
# File 'lib/prawn/document/column_box.rb', line 82

def left_side
  absolute_left + (width_of_column * @current_column)
end

#move_past_bottom ⇒ Object

Moves to the next column or starts a new page if currently positioned at the rightmost column.



107
108
109
110
111
112
113
114
115
116
 
# File 'lib/prawn/document/column_box.rb', line 107

def move_past_bottom
  @current_column = (@current_column + 1) % @columns
  @document.y = @y
  if 0 == @current_column
    if @reflow_margins
      @y = @parent.absolute_top
    end
    @document.start_new_page
  end
end

#right ⇒ Object

Relative position of the right edge of the current column.



101
102
103
 
# File 'lib/prawn/document/column_box.rb', line 101

def right
  left + width
end

#right_side ⇒ Object

x co-orordinate of the right edge of the current column



94
95
96
97
 
# File 'lib/prawn/document/column_box.rb', line 94

def right_side
  columns_from_right = @columns - (1 + @current_column)
  absolute_right - (width_of_column * columns_from_right)
end

#subtract_left_padding(left_padding) ⇒ Object 



126
127
128
129
 
# File 'lib/prawn/document/column_box.rb', line 126

def subtract_left_padding(left_padding)
  @total_left_padding -= left_padding
  @x -= left_padding
end

#subtract_right_padding(right_padding) ⇒ Object 



135
136
137
 
# File 'lib/prawn/document/column_box.rb', line 135

def subtract_right_padding(right_padding)
  @total_right_padding -= right_padding
end

#width ⇒ Object

The column width after padding. Used to calculate how long a line of text can be.



70
71
72
 
# File 'lib/prawn/document/column_box.rb', line 70

def width
  bare_column_width - (@total_left_padding + @total_right_padding)
end

#width_of_column ⇒ Object

Column width including the spacer.



76
77
78
 
# File 'lib/prawn/document/column_box.rb', line 76

def width_of_column
  bare_column_width + @spacer
end