Class: Axlsx::Workbook

Inherits:
Object
  • Object
show all
Defined in:
lib/axlsx/workbook/workbook.rb

Overview

The Workbook class is an xlsx workbook that manages worksheets, charts, drawings and styles. The following parts of the Office Open XML spreadsheet specification are not implimented in this version.

  bookViews
  calcPr
  customWorkbookViews
  definedNames
  externalReferences
  extLst
  fileRecoveryPr
  fileSharing
  fileVersion
  functionGroups
  oleSize
  pivotCaches
  smartTagPr
  smartTagTypes
  webPublishing
  webPublishObjects
  workbookProtection
  workbookPr*

  *workbookPr is only supported to the extend of date1904

Constant Summary

@@date1904 =

Indicates if the epoc date for serialization should be 1904. If false, 1900 is used.

false

Instance Attribute Summary (collapse)

Class Method Summary (collapse)

Instance Method Summary (collapse)

Constructor Details

- (Workbook) initialize(options = {}) {|_self| ... }

Creates a new Workbook

Parameters:

  • options (Hash) (defaults to: {})

    a customizable set of options

Options Hash (options):

  • date1904 (Boolean)

Yields:

  • (_self)

Yield Parameters:



77
78
79
80
81
82
83
84
85
# File 'lib/axlsx/workbook/workbook.rb', line 77

def initialize(options={})
  @styles = Styles.new
  @worksheets = SimpleTypedList.new Worksheet
  @drawings = SimpleTypedList.new Drawing
  @charts = SimpleTypedList.new Chart
  @images = SimpleTypedList.new Pic
  self.date1904= options[:date1904] unless options[:date1904].nil?
  yield self if block_given?      
end

Instance Attribute Details

- (SimpleTypedList) charts (readonly)

Note:

The recommended way to manage charts is Worksheet#add_chart

A colllection of charts associated with this workbook



45
46
47
# File 'lib/axlsx/workbook/workbook.rb', line 45

def charts
  @charts
end

- (SimpleTypedList) drawings (readonly)

Note:

The recommended way to manage drawings is Worksheet#add_chart

A colllection of drawings associated with this workbook



59
60
61
# File 'lib/axlsx/workbook/workbook.rb', line 59

def drawings
  @drawings
end

- (SimpleTypedList) images (readonly)

Note:

The recommended way to manage images is Worksheet#add_image

A colllection of images associated with this workbook



52
53
54
# File 'lib/axlsx/workbook/workbook.rb', line 52

def images
  @images
end

- (SimpleTypedList) worksheets (readonly)

Note:

The recommended way to manage worksheets is add_worksheet

A collection of worksheets associated with this workbook.



38
39
40
# File 'lib/axlsx/workbook/workbook.rb', line 38

def worksheets
  @worksheets
end

Class Method Details

+ (Boolean) date1904

retrieves the date1904 attribute

Returns:

  • (Boolean)


100
# File 'lib/axlsx/workbook/workbook.rb', line 100

def self.date1904() @@date1904; end

+ (Boolean) date1904=(v)

Sets the date1904 attribute to the provided boolean

Returns:

  • (Boolean)


96
# File 'lib/axlsx/workbook/workbook.rb', line 96

def self.date1904=(v) Axlsx::validate_boolean v; @@date1904 = v end

Instance Method Details

- (Worksheet) add_worksheet(options = {}) {|worksheet| ... }

Adds a worksheet to this workbook

Parameters:

  • options (Hash) (defaults to: {})

    a customizable set of options

Options Hash (options):

  • name (String)

    The name of the worksheet.

Yields:

  • (worksheet)

Returns:

See Also:



106
107
108
109
110
# File 'lib/axlsx/workbook/workbook.rb', line 106

def add_worksheet(options={})
  worksheet = Worksheet.new(self, options)
  yield worksheet if block_given?
  worksheet
end

- (Boolean) date1904

Instance level access to the class variable 1904

Returns:

  • (Boolean)


89
# File 'lib/axlsx/workbook/workbook.rb', line 89

def date1904() @@date1904; end

- (Object) date1904=(v)

see @date1904



92
# File 'lib/axlsx/workbook/workbook.rb', line 92

def date1904=(v) Axlsx::validate_boolean v; @@date1904 = v end

- (Relationships) relationships

The workbook relationships. This is managed automatically by the workbook

Returns:



114
115
116
117
118
119
120
121
# File 'lib/axlsx/workbook/workbook.rb', line 114

def relationships
  r = Relationships.new
  @worksheets.each do |sheet|
    r << Relationship.new(WORKSHEET_R, WORKSHEET_PN % (r.size+1))
  end 
  r << Relationship.new(STYLES_R,  STYLES_PN)
  r
end

- (Styles) styles {|@styles| ... }

Note:

The recommended way to manage styles is Styles#add_style

The styles associated with this workbook

Yields:

  • (@styles)

Returns:

See Also:

  • Style#add_style
  • Style


66
67
68
69
# File 'lib/axlsx/workbook/workbook.rb', line 66

def styles
  yield @styles if block_given?
  @styles
end

- (String) to_xml

Serializes the workbook document

Returns:

  • (String)


125
126
127
128
129
130
131
132
133
134
135
136
137
138
# File 'lib/axlsx/workbook/workbook.rb', line 125

def to_xml()
  add_worksheet unless worksheets.size > 0
  builder = Nokogiri::XML::Builder.new(:encoding => ENCODING) do |xml|
    xml.workbook(:xmlns => XML_NS, :'xmlns:r' => XML_NS_R) {
      xml.workbookPr(:date1904=>@@date1904)
      xml.sheets {
        @worksheets.each_with_index do |sheet, index|              
          xml.sheet(:name=>sheet.name, :sheetId=>index+1, :"r:id"=>sheet.rId)
        end
      }
    }
  end      
  builder.to_xml(:indent=>0)
end