axlsx 1.0.12 → 1.0.14

data/lib/axlsx/stylesheet/styles.rb

@@ -0,0 +1,298 @@
+# -*- coding: utf-8 -*-
+module Axlsx
+  require 'axlsx/stylesheet/border.rb'
+  require 'axlsx/stylesheet/border_pr.rb'
+  require 'axlsx/stylesheet/cell_alignment.rb'
+  require 'axlsx/stylesheet/cell_style.rb'
+  require 'axlsx/stylesheet/color.rb'
+  require 'axlsx/stylesheet/fill.rb'
+  require 'axlsx/stylesheet/font.rb'
+  require 'axlsx/stylesheet/gradient_fill.rb'
+  require 'axlsx/stylesheet/gradient_stop.rb'
+  require 'axlsx/stylesheet/num_fmt.rb'
+  require 'axlsx/stylesheet/pattern_fill.rb'
+  require 'axlsx/stylesheet/table_style.rb'
+  require 'axlsx/stylesheet/table_styles.rb'
+  require 'axlsx/stylesheet/table_style_element.rb'
+  require 'axlsx/stylesheet/xf.rb'
+  require 'axlsx/stylesheet/cell_protection.rb'
+
+  #The Styles class manages worksheet styles
+  # In addition to creating the require style objects for a valid xlsx package, this class provides the key mechanism for adding styles to your workbook, and safely applying them to the cells of your worksheet.
+  # All portions of the stylesheet are implemented here exception colors, which specify legacy and modified pallete colors, and exLst, whic is used as a future feature data storage area.
+  # @see  Office Open XML Part 1 18.8.11 for gory details on how this stuff gets put together
+  # @see  Styles#add_style
+  # @note The recommended way to manage styles is with add_style
+  class Styles
+    # numFmts for your styles.
+    #  The default styles, which change based on the system local, are as follows.
+    #  id formatCode
+    #   0 General
+    #   1 0
+    #   2 0.00
+    #   3 #,##0
+    #   4 #,##0.00
+    #   9 0%
+    #   10 0.00%
+    #   11 0.00E+00
+    #   12 #   ?/?
+    #   13 #   ??/??
+    #   14 mm-dd-yy
+    #   15 d-mmm-yy
+    #   16 d-mmm
+    #   17 mmm-yy
+    #   18 h:mm AM/PM
+    #   19 h:mm:ss AM/PM
+    #   20 h:mm
+    #   21 h:mm:ss
+    #   22 m/d/yy h:mm
+    #   37 #,##0 ;(#,##0)
+    #   38 #,##0 ;[Red](#,##0)
+    #   39 #,##0.00;(#,##0.00)
+    #   40 #,##0.00;[Red](#,##0.00)
+    #   45 mm:ss
+    #   46 [h]:mm:ss
+    #   47 mmss.0
+    #   48 ##0.0E+0
+    #   49 @
+    #  Axlsx also defines the following constants which you can use in add_style.
+    #     NUM_FMT_PERCENT formats to "0%"
+    #     NUM_FMT_YYYYMMDD formats to "yyyy/mm/dd"
+    #     NUM_FMT_YYYYMMDDHHMMSS  formats to "yyyy/mm/dd hh:mm:ss"
+    # @see Office Open XML Part 1 - 18.8.31 for more information on creating number formats
+    # @return [SimpleTypedList]
+    # @note The recommended way to manage styles is with add_style
+    # @see Styles#add_style
+    attr_reader :numFmts
+
+    # The collection of fonts used in this workbook
+    # @return [SimpleTypedList]
+    # @note The recommended way to manage styles is with add_style
+    # @see Styles#add_style
+    attr_reader :fonts
+
+    # The collection of fills used in this workbook
+    # @return [SimpleTypedList]
+    # @note The recommended way to manage styles is with add_style
+    # @see Styles#add_style
+    attr_reader :fills
+
+    # The collection of borders used in this workbook
+    # Axlsx predefines THIN_BORDER which can be used to put a border around all of your cells.
+    # @return [SimpleTypedList]
+    # @note The recommended way to manage styles is with add_style
+    # @see Styles#add_style
+    attr_reader :borders
+
+    # The collection of master formatting records for named cell styles, which means records defined in cellStyles, in the workbook
+    # @return [SimpleTypedList]
+    # @note The recommended way to manage styles is with add_style
+    # @see Styles#add_style
+    attr_reader :cellStyleXfs
+
+    # The collection of named styles, referencing cellStyleXfs items in the workbook.
+    # @return [SimpleTypedList]
+    # @note The recommended way to manage styles is with add_style
+    # @see  Styles#add_style
+    attr_reader :cellStyles
+
+    # The collection of master formatting records. This is the list that you will actually use in styling a workbook.
+    # @return [SimpleTypedList]
+    # @note The recommended way to manage styles is with add_style
+    # @see Styles#add_style
+    attr_reader :cellXfs
+
+    # The collection of non-cell formatting records used in the worksheet.
+    # @return [SimpleTypedList]
+    # @note The recommended way to manage styles is with add_style
+    # @see Styles#add_style
+    attr_reader :dxfs
+
+    # The collection of table styles that will be available to the user in the excel UI
+    # @return [SimpleTypedList]
+    # @note The recommended way to manage styles is with add_style
+    # @see Styles#add_style
+    attr_reader :tableStyles
+
+    # Creates a new Styles object and prepopulates it with the requires objects to generate a valid package style part.
+    def initialize()
+      load_default_styles
+    end
+
+    # Drastically simplifies style creation and management.
+    # @return [Integer] 
+    # @option options [String] fg_color The text color
+    # @option options [Integer] sz The text size
+    # @option options [Boolean] b Indicates if the text should be bold
+    # @option options [Boolean] i Indicates if the text should be italicised
+    # @option options [Boolean] strike Indicates if the text should be rendered with a strikethrough
+    # @option options [Boolean] strike Indicates if the text should be rendered with a shadow
+    # @option options [Integer] charset The character set to use.
+    # @option options [Integer] family The font family to use.
+    # @option options [String] name The name of the font to use
+    # @option options [Integer] num_fmt The number format to apply
+    # @option options [String] format_code The formatting to apply. If this is specified, num_fmt is ignored.
+    # @option options [Integer] border The border style to use. 
+    # @option options [String] bg_color The background color to apply to the cell
+    # @option options [Boolean] hidden Indicates if the cell should be hidden
+    # @option options [Boolean] locked Indicates if the cell should be locked
+    # @option options [Hash] alignment A hash defining any of the attributes used in CellAlignment
+    # @see CellAlignment
+    # 
+    # @example You Got Style
+    #   require "rubygems" # if that is your preferred way to manage gems!
+    #   require "axlsx"
+    #
+    #   p = Axlsx::Package.new
+    #   ws = p.workbook.add_worksheet
+    #
+    #   # black text on a white background at 14pt with thin borders!
+    #   title = ws.style.add_style(:bg_color => "FFFF0000", :fg_color=>"#FF000000", :sz=>14,  :border=>Axlsx::STYLE_THIN_BORDER
+    #
+    #   ws.add_row :values => ["Least Popular Pets"]
+    #   ws.add_row :values => ["", "Dry Skinned Reptiles", "Bald Cats", "Violent Parrots"], :style=>title
+    #   ws.add_row :values => ["Votes", 6, 4, 1], :style=>Axlsx::STYLE_THIN_BORDER
+    #   f = File.open('example_you_got_style.xlsx', 'w')
+    #   p.serialize(f)
+    #
+    # @example Styling specifically
+    #   # an example of applying specific styles to specific cells
+    #   require "rubygems" # if that is your preferred way to manage gems!
+    #   require "axlsx"
+    #
+    #   p = Axlsx::Package.new
+    #   ws = p.workbook.add_worksheet
+    #
+    #   # define your styles
+    #   title = ws.style.add_style(:bg_color => "FFFF0000", 
+    #                              :fg_color=>"#FF000000",
+    #                              :border=>Axlsx::STYLE_THIN_BORDER, 
+    #                              :alignment=>{:horizontal => :center})
+    #
+    #   date_time = ws.style.add_style(:num_fmt => Axlsx::NUM_FMT_YYYYMMDDHHMMSS,
+    #                                  :border=>Axlsx::STYLE_THIN_BORDER)
+    #
+    #   percent = ws.style.add_style(:num_fmt => Axlsx::NUM_FMT_PERCENT, 
+    #                                :border=>Axlsx::STYLE_THIN_BORDER)
+    #
+    #   currency = ws.style.add_style(:format_code=>"¥#,##0;[Red]¥-#,##0",
+    #                                 :border=>Axlsx::STYLE_THIN_BORDER)
+    #
+    #   # build your rows
+    #   ws.add_row :values => ["Genreated At:", Time.now], :styles=>[nil, date_time]
+    #   ws.add_row :values => ["Previous Year Quarterly Profits (JPY)"], :style=>title
+    #   ws.add_row :values => ["Quarter", "Profit", "% of Total"], :style=>title
+    #   ws.add_row :values => ["Q1", 4000, 40], :style=>[title, currency, percent]
+    #   ws.add_row :values => ["Q2", 3000, 30], :style=>[title, currency, percent]
+    #   ws.add_row :values => ["Q3", 1000, 10], :style=>[title, currency, percent]
+    #   ws.add_row :values => ["Q4", 2000, 20], :style=>[title, currency, percent]
+    #   f = File.open('example_you_got_style.xlsx', 'w')
+    #   p.serialize(f)
+    def add_style(options={})
+      
+      numFmtId = if options[:format_code]
+                   n = @numFmts.map{ |f| f.numFmtId }.max + 1
+                   numFmts << NumFmt.new(:numFmtId => n, :formatCode=> options[:format_code])
+                   n
+                 else
+                   options[:num_fmt] || 0
+                 end
+      
+      borderId = options[:border] || 0
+      raise ArgumentError, "Invalid borderId" unless borderId < borders.size
+      
+      fill = if options[:bg_color]
+               color = Color.new(:rgb=>options[:bg_color])
+               pattern = PatternFill.new(:patternType =>:solid, :fgColor=>color)
+               fills << Fill.new(pattern)   
+             else
+               0
+             end
+      
+      fontId = if (options.values_at(:fg_color, :sz, :b, :i, :strike, :outline, :shadow, :charset, :family, :font_name).length)
+                 font = Font.new()
+                 [:b, :i, :strike, :outline, :shadow, :charset, :family, :sz].each { |k| font.send("#{k}=", options[k]) unless options[k].nil? }
+                 font.color = Color.new(:rgb => options[:fg_color]) unless options[:fg_color].nil?
+                 font.name = options[:font_name] unless options[:font_name].nil?
+                 fonts << font
+               else
+                 0 
+               end
+      
+      applyProtection = (options[:hidden] || options[:locked]) ? 1 : 0
+      
+      xf = Xf.new(:fillId => fill, :fontId=>fontId, :applyFill=>1, :applyFont=>1, :numFmtId=>numFmtId, :borderId=>borderId, :applyProtection=>applyProtection)
+      
+      if options[:alignment]
+        xf.alignment = CellAlignment.new(options[:alignment])
+      end
+      
+      if applyProtection
+        xf.protection = CellProtection.new(options)
+      end
+      
+      cellXfs << xf
+    end
+    
+    # Serializes the styles document
+    # @return [String]
+    def to_xml()
+      builder = Nokogiri::XML::Builder.new(:encoding => ENCODING) do |xml|
+        xml.styleSheet(:xmlns => XML_NS) {
+          [:numFmts, :fonts, :fills, :borders, :cellStyleXfs, :cellXfs, :cellStyles, :dxfs, :tableStyles].each do |key|
+            self.instance_values[key.to_s].to_xml(xml) unless self.instance_values[key.to_s].nil?
+          end
+        }
+      end
+      builder.to_xml
+    end
+
+    private
+    # Creates the default set of styles the exel requires to be valid as well as setting up the 
+    # Axlsx::STYLE_THIN_BORDER
+    def load_default_styles
+      @numFmts = SimpleTypedList.new NumFmt
+      @numFmts << NumFmt.new(:numFmtId => NUM_FMT_YYYYMMDD, :formatCode=> "yyyy/mm/dd")
+      @numFmts << NumFmt.new(:numFmtId => NUM_FMT_YYYYMMDDHHMMSS, :formatCode=> "yyyy/mm/dd hh:mm:ss")
+
+      @numFmts.lock
+
+      @fonts = SimpleTypedList.new Font
+      @fonts << Font.new(:name => "Arial", :sz => 11, :family=>1)
+      @fonts.lock
+
+      @fills = SimpleTypedList.new Fill
+      @fills << Fill.new(Axlsx::PatternFill.new(:patternType=>:none))
+      @fills << Fill.new(Axlsx::PatternFill.new(:patternType=>:gray125))
+      @fills.lock
+
+      @borders = SimpleTypedList.new Border
+      @borders << Border.new
+      black_border = Border.new
+      [:left, :right, :top, :bottom].each do |item| 
+        black_border.prs << BorderPr.new(:name=>item, :style=>:thin, :color=>Color.new(:rgb=>"FF000000")) 
+      end
+      @borders << black_border
+      @borders.lock
+
+      @cellStyleXfs = SimpleTypedList.new Xf, "cellStyleXfs"
+      @cellStyleXfs << Xf.new(:borderId=>0, :numFmtId=>0, :fontId=>0, :fillId=>0)
+      @cellStyleXfs.lock
+
+      @cellStyles = SimpleTypedList.new CellStyle
+      @cellStyles << CellStyle.new(:name =>"Normal", :builtinId =>0, :xfId=>0)
+      @cellStyles.lock
+
+      @cellXfs = SimpleTypedList.new Xf, "cellXfs"
+      @cellXfs << Xf.new(:borderId=>0, :xfId=>0, :numFmtId=>0, :fontId=>0, :fillId=>0)
+      @cellXfs << Xf.new(:borderId=>1, :xfId=>0, :numFmtId=>0, :fontId=>0, :fillId=>0)
+      # default date formatting
+      @cellXfs << Xf.new(:borderId=>0, :xfId=>0, :numFmtId=>14, :fontId=>0, :fillId=>0, :applyNumberFormat=>1)
+      @cellXfs.lock
+
+      @dxfs = SimpleTypedList.new(Xf, "dxfs"); @dxfs.lock
+      @tableStyles = TableStyles.new(:defaultTableStyle => "TableStyleMedium9", :defaultPivotStyle => "PivotStyleLight16"); @tableStyles.lock
+    end
+  end
+end
+  

data/lib/axlsx/stylesheet/table_style.rb

@@ -0,0 +1,47 @@
+module Axlsx
+  # A single table style definition and is a collection for tableStyleElements
+  # @note Table are not supported in this version and only the defaults required for a valid workbook are created.
+  class TableStyle < SimpleTypedList
+
+    # The name of this table style
+    # @return [string]
+    attr_reader :name
+
+    # indicates if this style should be applied to pivot tables
+    # @return [Boolean]
+    attr_reader :pivot
+
+    # indicates if this style should be applied to tables
+    # @return [Boolean]
+    attr_reader :table
+
+    # creates a new TableStyle object
+    # @raise [ArgumentError] if name option is not provided.
+    # @param [String] name
+    # @option options [Boolean] pivot
+    # @option options [Boolean] table
+    def initialize(name, options={})
+      self.name = name
+      options.each do |o|
+        self.send("#{o[0]}=", o[1]) if self.respond_to? o[0]
+      end
+      super TableStyleElement
+    end
+
+    # @see name
+    def name=(v) Axlsx::validate_string v; @name=v end
+    # @see pivot
+    def pivot=(v) Axlsx::validate_boolean v; @pivot=v end
+    # @see table
+    def table=(v) Axlsx::validate_boolean v; @table=v end
+
+    # Serializes the table style
+    # @param [Nokogiri::XML::Builder] xml The document builder instance this objects xml will be added to.
+    # @return [String]
+    def to_xml(xml)
+      attr = self.instance_values.select { |k, v| [:name, :pivot, :table].include? k }
+      attr[:count] = self.size
+      xml.tableStyle(attr) { self.each { |table_style_el| table_style_el.to_xml(xml) } }
+    end
+  end
+end

data/lib/axlsx/stylesheet/table_style_element.rb

@@ -0,0 +1,71 @@
+module Axlsx
+  # an element of style that belongs to a table style. 
+  # @note tables and table styles are not supported in this version. This class exists in preparation for that support. 
+  class TableStyleElement
+    # The type of style element. The following type are allowed
+    #   :wholeTable
+    #   :headerRow
+    #   :totalRow
+    #   :firstColumn
+    #   :lastColumn
+    #   :firstRowStripe
+    #   :secondRowStripe
+    #   :firstColumnStripe
+    #   :secondColumnStripe
+    #   :firstHeaderCell
+    #   :lastHeaderCell
+    #   :firstTotalCell
+    #   :lastTotalCell
+    #   :firstSubtotalColumn
+    #   :secondSubtotalColumn
+    #   :thirdSubtotalColumn
+    #   :firstSubtotalRow
+    #   :secondSubtotalRow
+    #   :thirdSubtotalRow
+    #   :blankRow
+    #   :firstColumnSubheading
+    #   :secondColumnSubheading
+    #   :thirdColumnSubheading
+    #   :firstRowSubheading
+    #   :secondRowSubheading
+    #   :thirdRowSubheading
+    #   :pageFieldLabels
+    #   :pageFieldValues
+    # @return [Symbol]
+    attr_reader :type
+
+    # Number of rows or columns used in striping when the type is firstRowStripe, secondRowStripe, firstColumnStripe, or secondColumnStripe.
+    # @return [Integer]
+    attr_reader :size
+
+    # The dxfId this style element points to 
+    # @return [Integer]
+    attr_reader :dxfId
+
+    # creates a new TableStyleElement object
+    # @option options [Symbol] type
+    # @option options [Integer] size
+    # @option options [Integer] dxfId
+    def initialize(options={})
+      options.each do |o|
+        self.send("#{o[0]}=", o[1]) if self.respond_to? o[0]
+      end
+    end
+
+    # @see type
+    def type=(v) Axlsx::validate_table_element_type v; @type = v end
+
+    # @see size
+    def size=(v) Axlsx::validate_unsigned_int v; @size = v end
+
+    # @see dxfId
+    def dxfId=(v) Axlsx::validate_unsigned_int v; @dxfId = v end
+
+    # Serializes the table style element
+    # @param [Nokogiri::XML::Builder] xml The document builder instance this objects xml will be added to.
+    # @return [String]
+    def to_xml(xml)
+      xml.tableStyleElement self.instance_values
+    end
+  end
+end

data/lib/axlsx/stylesheet/table_styles.rb

@@ -0,0 +1,39 @@
+module Axlsx
+  # TableStyles represents a collection of style definitions for table styles and pivot table styles.
+  # @note Support for custom table styles does not exist in this version. Many of the classes required are defined in preparation for future release. Please do not attempt to add custom table styles.
+  class TableStyles < SimpleTypedList
+
+    # The default table style. The default value is 'TableStyleMedium9'
+    # @return [String]
+    attr_reader :defaultTableStyle
+
+    # The default pivot table style. The default value is  'PivotStyleLight6'
+    # @return [String]
+    attr_reader :defaultPivotStyle
+    
+    # Creates a new TableStyles object that is a container for TableStyle objects
+    # @option options [String] defaultTableStyle
+    # @option options [String] defaultPivotStyle
+    def initialize(options={})
+      @defaultTableStyle = options[:defaultTableStyle] || "TableStyleMedium9"
+      @defaultPivotStyle = options[:defaultPivotStyle] || "PivotStyleLight16"      
+      super TableStyle
+    end
+    # @see defaultTableStyle
+    def defaultTableStyle=(v) Axlsx::validate_string(v); @defaultTableStyle = v; end
+    # @see defaultPivotStyle
+    def defaultPivotStyle=(v) Axlsx::validate_string(v); @defaultPivotStyle = v; end
+
+    # Serializes the table styles element
+    # @param [Nokogiri::XML::Builder] xml The document builder instance this objects xml will be added to.
+    # @return [String]
+    def to_xml(xml)
+      attr = self.instance_values.reject {|k, v| ![:defaultTableStyle, :defaultPivotStyle].include?(k.to_sym) }
+      attr[:count] = self.size
+      xml.tableStyles(attr) {
+        self.each { |table_style| table_style.to_xml(xml) }
+      }
+    end
+  end
+
+end

data/lib/axlsx/stylesheet/xf.rb

@@ -0,0 +1,138 @@
+module Axlsx
+  # The Xf class defines a formatting record for use in Styles. The recommended way to manage styles for your workbook is with Styles#add_style
+  # @see Styles#add_style
+  class Xf
+    #does not support extList (ExtensionList)
+
+    # The cell alignment for this style
+    # @return [CellAlignment]
+    # @see CellAlignment
+    attr_reader :alignment
+
+    # The cell protection for this style
+    # @return [CellProtection]
+    # @see CellProtection
+    attr_reader :protection
+
+    # id of the numFmt to apply to this style
+    # @return [Integer]
+    attr_reader :numFmtId
+
+    # index (0 based) of the font to be used in this style
+    # @return [Integer]
+    attr_reader :fontId
+    
+    # index (0 based) of the fill to be used in this style
+    # @return [Integer]
+    attr_reader :fillId
+
+    # index (0 based) of the border to be used in this style
+    # @return [Integer]
+    attr_reader :borderId
+
+    # index (0 based) of cellStylesXfs item to be used in this style. Only applies to cellXfs items
+    # @return [Integer]
+    attr_reader :xfId
+
+    # indecates if text should be prefixed by a single quote in the cell
+    # @return [Boolean]
+    attr_reader :quotePrefix
+
+    # indicates if the cell has a pivot table drop down button
+    # @return [Boolean]
+    attr_reader :pivotButton
+
+    # indicates if the numFmtId should be applied
+    # @return [Boolean]
+    attr_reader :applyNumberFormat
+
+    # indicates if the fontId should be applied
+    # @return [Boolean]
+    attr_reader :applyFont
+    
+    # indicates if the fillId should be applied
+    # @return [Boolean]
+    attr_reader :applyFill
+
+    # indicates if the borderId should be applied
+    # @return [Boolean]
+    attr_reader :applyBorder
+
+    # Indicates if the alignment options should be applied
+    # @return [Boolean]
+    attr_reader :applyAlignment
+
+    # Indicates if the protection options should be applied
+    # @return [Boolean]
+    attr_reader :applyProtection
+
+    # Creates a new Xf object
+    # @option options [Integer] numFmtId
+    # @option options [Integer] fontId
+    # @option options [Integer] fillId
+    # @option options [Integer] borderId
+    # @option options [Integer] xfId
+    # @option options [Boolean] quotePrefix
+    # @option options [Boolean] pivotButton
+    # @option options [Boolean] applyNumberFormat 
+    # @option options [Boolean] applyFont
+    # @option options [Boolean] applyFill
+    # @option options [Boolean] applyBorder
+    # @option options [Boolean] applyAlignment
+    # @option options [Boolean] applyProtection
+    # @option options [CellAlignment] alignment
+    # @option options [CellProtection] protection
+    def initialize(options={})
+      options.each do |o|
+        self.send("#{o[0]}=", o[1]) if self.respond_to? "#{o[0]}="
+      end
+    end    
+    
+    # @see Xf#alignment
+    def alignment=(v) DataTypeValidator.validate "Xf.alignment", CellAlignment, v; @alignment = v end
+
+    # @see protection
+    def protection=(v) DataTypeValidator.validate "Xf.protection", CellProtection, v; @protection = v end
+
+    # @see numFmtId
+    def numFmtId=(v) Axlsx::validate_unsigned_int v; @numFmtId = v end    
+
+    # @see fontId
+    def fontId=(v) Axlsx::validate_unsigned_int v; @fontId = v end    
+    # @see fillId
+    def fillId=(v) Axlsx::validate_unsigned_int v; @fillId = v end    
+    # @see borderId
+    def borderId=(v) Axlsx::validate_unsigned_int v; @borderId = v end    
+    # @see xfId
+    def xfId=(v) Axlsx::validate_unsigned_int v; @xfId = v end    
+    # @see quotePrefix
+    def quotePrefix=(v) Axlsx::validate_boolean v; @quotePrefix = v end    
+    # @see pivotButton
+    def pivotButton=(v) Axlsx::validate_boolean v; @pivotButton = v end    
+    # @see applyNumberFormat
+    def applyNumberFormat=(v) Axlsx::validate_boolean v; @applyNumberFormat = v end    
+    # @see applyFont
+    def applyFont=(v) Axlsx::validate_boolean v; @applyFont = v end    
+    # @see applyFill
+    def applyFill=(v) Axlsx::validate_boolean v; @applyFill = v end    
+
+    # @see applyBorder
+    def applyBorder=(v) Axlsx::validate_boolean v; @applyBorder = v end    
+
+    # @see applyAlignment
+    def applyAlignment=(v) Axlsx::validate_boolean v; @applyAlignment = v end    
+
+    # @see applyProtection
+    def applyProtection=(v) Axlsx::validate_boolean v; @applyProtection = v end    
+
+    # Serializes the xf elemen
+    # @param [Nokogiri::XML::Builder] xml The document builder instance this objects xml will be added to.
+    # @return [String]
+    def to_xml(xml)
+      xml.xf(self.instance_values.reject { |k, v| [:alignment, :protection, :extList, :name].include? k.to_sym}) {
+        alignment.to_xml(xml) if self.alignment
+        protection.to_xml(xml) if self.protection
+      }
+    end
+  end
+end