write_xlsx 0.0.2 → 0.0.3

data/README.rdoc

@@ -60,6 +60,9 @@ in an Excel XMLX spreadsheet called ruby.xlsx:
 
 == Recent change
 
+2012-01-25 v0.0.3
+ alignment format support. see examples/formats.rb
+
 2012-01-20 v0.0.1
  initial release
 

data/Rakefile

@@ -40,7 +40,7 @@ The WriteXLSX supports the following features:
 
 write_xlsx uses the same interface as writeexcel gem.
 
-documentation is not completed, but writeexcel’s documentation will help you. See writeexcel.web.fc2.com/
+documentation is not completed, but writeexcel’s documentation will help you. See http://writeexcel.web.fc2.com/
 
 And you can find many examples in this gem.
 EOS

data/VERSION

@@ -1 +1 @@
-0.0.2
+0.0.3

data/examples/formats.rb

@@ -0,0 +1,498 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+
+###############################################################################
+#
+# Examples of formatting using the Excel::Writer::XLSX module.
+#
+# This program demonstrates almost all possible formatting options. It is worth
+# running this program and viewing the output Excel file if you are interested
+# in the various formatting possibilities.
+#
+# reverse('ｩ'), September 2002, John McNamara, jmcnamara@cpan.org
+# convert to Ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
+#
+
+require 'rubygems'
+require 'write_xlsx'
+
+workbook = WriteXLSX.new('formats.xlsx')
+
+# Some common formats
+center = workbook.add_format(:align => 'center')
+heading = workbook.add_format(:align => 'center', :bold => 1)
+
+# The named colors
+colors = {
+  0x08 => 'black',
+  0x0C => 'blue',
+  0x10 => 'brown',
+  0x0F => 'cyan',
+  0x17 => 'gray',
+  0x11 => 'green',
+  0x0B => 'lime',
+  0x0E => 'magenta',
+  0x12 => 'navy',
+  0x35 => 'orange',
+  0x21 => 'pink',
+  0x14 => 'purple',
+  0x0A => 'red',
+  0x16 => 'silver',
+  0x09 => 'white',
+  0x0D => 'yellow'
+}
+
+######################################################################
+#
+# Intro.
+#
+def intro(workbook, center, heading, colors)
+  worksheet = workbook.add_worksheet('Introduction')
+
+  worksheet.set_column(0, 0, 60)
+
+  format = workbook.add_format
+  format.set_bold
+  format.set_size(14)
+  format.set_color('blue')
+  format.set_align('center')
+
+  format2 = workbook.add_format
+  format2.set_bold
+  format2.set_color('blue')
+
+  format3 = workbook.add_format(
+                                :color     => 'blue',
+                                :underline => 1,
+                               )
+
+  worksheet.write(2, 0, 'This workbook demonstrates some of', format)
+  worksheet.write(3, 0, 'the formatting options provided by', format)
+  worksheet.write(4, 0, 'the Excel::Writer::XLSX module.',    format)
+  worksheet.write('A7', 'Sections:', format2)
+
+  worksheet.write('A8', "internal:Fonts!A1", 'Fonts', format3)
+
+  worksheet.write('A9', "internal:'Named colors'!A1",
+                   'Named colors', format3)
+
+  worksheet.write(
+                  'A10',
+                  "internal:'Standard colors'!A1",
+                  'Standard colors', format3
+                 )
+
+  worksheet.write(
+                  'A11',
+                  "internal:'Numeric formats'!A1",
+                  'Numeric formats', format3
+                 )
+
+  worksheet.write('A12', "internal:Borders!A1", 'Borders', format3)
+  worksheet.write('A13', "internal:Patterns!A1", 'Patterns', format3)
+  worksheet.write('A14', "internal:Alignment!A1", 'Alignment', format3)
+  worksheet.write('A15', "internal:Miscellaneous!A1", 'Miscellaneous',
+                   format3)
+
+end
+
+######################################################################
+#
+# Demonstrate the named colors.
+#
+def named_colors(workbook, center, heading, colors)
+
+  worksheet = workbook.add_worksheet('Named colors')
+
+  worksheet.set_column(0, 3, 15)
+
+  worksheet.write(0, 0, "Index", heading)
+  worksheet.write(0, 1, "Index", heading)
+  worksheet.write(0, 2, "Name",  heading)
+  worksheet.write(0, 3, "Color", heading)
+
+  i = 1
+
+  [33, 11, 53, 17, 22, 18, 13, 16, 23, 9, 12, 15, 14, 20, 8, 10].each do |index|
+    color = colors[index]
+    format = workbook.add_format(
+                                 :bg_color => color,
+                                 :pattern  => 1,
+                                 :border   => 1
+                                )
+
+    worksheet.write(i + 1, 0, index, center)
+    worksheet.write(i + 1, 1, sprintf("0x%02X", index), center)
+    worksheet.write(i + 1, 2, color, center)
+    worksheet.write(i + 1, 3, '',     format)
+    i += 1
+  end
+end
+
+######################################################################
+#
+# Demonstrate the standard Excel colors in the range 8..63.
+#
+def standard_colors(workbook, center, heading, colors)
+
+  worksheet = workbook.add_worksheet('Standard colors')
+
+  worksheet.set_column(0, 3, 15)
+
+  worksheet.write(0, 0, "Index", heading)
+  worksheet.write(0, 1, "Index", heading)
+  worksheet.write(0, 2, "Color", heading)
+  worksheet.write(0, 3, "Name",  heading)
+
+  (8 .. 63).each do |i|
+    format = workbook.add_format(
+                                 :bg_color => i,
+                                 :pattern  => 1,
+                                 :border   => 1
+                                )
+
+    worksheet.write((i - 7), 0, i, center)
+    worksheet.write((i - 7), 1, sprintf("0x%02X", i), center)
+    worksheet.write((i - 7), 2, '', format)
+
+    # Add the  color names
+    if colors[i]
+      worksheet.write((i - 7), 3, colors[i], center)
+    end
+  end
+end
+
+######################################################################
+#
+# Demonstrate the standard numeric formats.
+#
+def numeric_formats(workbook, center, heading, colors)
+
+  worksheet = workbook.add_worksheet('Numeric formats')
+
+  worksheet.set_column(0, 4, 15)
+  worksheet.set_column(5, 5, 45)
+
+  worksheet.write(0, 0, "Index",       heading)
+  worksheet.write(0, 1, "Index",       heading)
+  worksheet.write(0, 2, "Unformatted", heading)
+  worksheet.write(0, 3, "Formatted",   heading)
+  worksheet.write(0, 4, "Negative",    heading)
+  worksheet.write(0, 5, "Format",      heading)
+
+  formats = []
+  formats << [ 0x00, 1234.567,   0,         'General' ]
+  formats << [ 0x01, 1234.567,   0,         '0' ]
+  formats << [ 0x02, 1234.567,   0,         '0.00' ]
+  formats << [ 0x03, 1234.567,   0,         '#,##0' ]
+  formats << [ 0x04, 1234.567,   0,         '#,##0.00' ]
+  formats << [ 0x05, 1234.567,   -1234.567, '($#,##0_);($#,##0)' ]
+  formats << [ 0x06, 1234.567,   -1234.567, '($#,##0_);[Red]($#,##0)' ]
+  formats << [ 0x07, 1234.567,   -1234.567, '($#,##0.00_);($#,##0.00)' ]
+  formats << [ 0x08, 1234.567,   -1234.567, '($#,##0.00_);[Red]($#,##0.00)' ]
+  formats << [ 0x09, 0.567,      0,         '0%' ]
+  formats << [ 0x0a, 0.567,      0,         '0.00%' ]
+  formats << [ 0x0b, 1234.567,   0,         '0.00E+00' ]
+  formats << [ 0x0c, 0.75,       0,         '# ?/?' ]
+  formats << [ 0x0d, 0.3125,     0,         '# ??/??' ]
+  formats << [ 0x0e, 36892.521,  0,         'm/d/yy' ]
+  formats << [ 0x0f, 36892.521,  0,         'd-mmm-yy' ]
+  formats << [ 0x10, 36892.521,  0,         'd-mmm' ]
+  formats << [ 0x11, 36892.521,  0,         'mmm-yy' ]
+  formats << [ 0x12, 36892.521,  0,         'h:mm AM/PM' ]
+  formats << [ 0x13, 36892.521,  0,         'h:mm:ss AM/PM' ]
+  formats << [ 0x14, 36892.521,  0,         'h:mm' ]
+  formats << [ 0x15, 36892.521,  0,         'h:mm:ss' ]
+  formats << [ 0x16, 36892.521,  0,         'm/d/yy h:mm' ]
+  formats << [ 0x25, 1234.567,   -1234.567, '(#,##0_);(#,##0)' ]
+  formats << [ 0x26, 1234.567,   -1234.567, '(#,##0_);[Red](#,##0)' ]
+  formats << [ 0x27, 1234.567,   -1234.567, '(#,##0.00_);(#,##0.00)' ]
+  formats << [ 0x28, 1234.567,   -1234.567, '(#,##0.00_);[Red](#,##0.00)' ]
+  formats << [ 0x29, 1234.567,   -1234.567, '_(* #,##0_);_(* (#,##0);_(* "-"_);_(@_)' ]
+  formats << [ 0x2a, 1234.567,   -1234.567, '_($* #,##0_);_($* (#,##0);_($* "-"_);_(@_)' ]
+  formats << [ 0x2b, 1234.567,   -1234.567, '_(* #,##0.00_);_(* (#,##0.00);_(* "-"??_);_(@_)' ]
+  formats << [ 0x2c, 1234.567,   -1234.567, '_($* #,##0.00_);_($* (#,##0.00);_($* "-"??_);_(@_)' ]
+  formats << [ 0x2d, 36892.521,  0,         'mm:ss' ]
+  formats << [ 0x2e, 3.0153,     0,         '[h]:mm:ss' ]
+  formats << [ 0x2f, 36892.521,  0,         'mm:ss.0' ]
+  formats << [ 0x30, 1234.567,   0,         '##0.0E+0' ]
+  formats << [ 0x31, 1234.567,   0,         '@' ]
+
+  i = 0
+  formats.each do |format|
+    style = workbook.add_format
+    style.set_num_format(format[0])
+
+    i += 1
+    worksheet.write(i, 0, format[0], center)
+    worksheet.write(i, 1, sprintf("0x%02X", format[0]), center)
+    worksheet.write(i, 2, format[1], center)
+    worksheet.write(i, 3, format[1], style)
+
+    if format[2] != 0
+      worksheet.write(i, 4, format[2], style)
+    end
+
+    worksheet.write_string(i, 5, format[3])
+  end
+end
+
+######################################################################
+#
+# Demonstrate the font options.
+#
+def fonts(workbook, center, heading, colors)
+
+  worksheet = workbook.add_worksheet('Fonts')
+
+  worksheet.set_column(0, 0, 30)
+  worksheet.set_column(1, 1, 10)
+
+  worksheet.write(0, 0, "Font name", heading)
+  worksheet.write(0, 1, "Font size", heading)
+
+  fonts = []
+  fonts << [ 10, 'Arial' ]
+  fonts << [ 12, 'Arial' ]
+  fonts << [ 14, 'Arial' ]
+  fonts << [ 12, 'Arial Black' ]
+  fonts << [ 12, 'Arial Narrow' ]
+  fonts << [ 12, 'Century Schoolbook' ]
+  fonts << [ 12, 'Courier' ]
+  fonts << [ 12, 'Courier New' ]
+  fonts << [ 12, 'Garamond' ]
+  fonts << [ 12, 'Impact' ]
+  fonts << [ 12, 'Lucida Handwriting' ]
+  fonts << [ 12, 'Times New Roman' ]
+  fonts << [ 12, 'Symbol' ]
+  fonts << [ 12, 'Wingdings' ]
+  fonts << [ 12, 'A font that doesn\'t exist' ]
+
+  i = 0
+  fonts.each do |font|
+    format = workbook.add_format
+
+    format.set_size(font[0])
+    format.set_font(font[1])
+
+    i += 1
+    worksheet.write(i, 0, font[1], format)
+    worksheet.write(i, 1, font[0], format)
+  end
+end
+
+######################################################################
+#
+# Demonstrate the standard Excel border styles.
+#
+def borders(workbook, center, heading, colors)
+  worksheet = workbook.add_worksheet('Borders')
+
+  worksheet.set_column(0, 4, 10)
+  worksheet.set_column(5, 5, 40)
+
+  worksheet.write(0, 0, "Index",                                heading)
+  worksheet.write(0, 1, "Index",                                heading)
+  worksheet.write(0, 3, "Style",                                heading)
+  worksheet.write(0, 5, "The style is highlighted in red for ", heading)
+  worksheet.write(1, 5, "emphasis, the default color is black.",
+                   heading)
+
+  (0 .. 13).each do |i|
+
+    format = workbook.add_format
+    format.set_border(i)
+    format.set_border_color('red')
+    format.set_align('center')
+
+    worksheet.write((2 * (i + 1)), 0, i, center)
+    worksheet.write((2 * (i + 1)),
+                     1, sprintf("0x%02X", i), center)
+
+    worksheet.write((2 * (i + 1)), 3, "Border", format)
+  end
+
+  worksheet.write(30, 0, "Diag type",             heading)
+  worksheet.write(30, 1, "Index",                 heading)
+  worksheet.write(30, 3, "Style",                 heading)
+  worksheet.write(30, 5, "Diagonal Boder styles", heading)
+
+  (1 .. 3).each do |i|
+    format = workbook.add_format
+    format.set_diag_type(i)
+    format.set_diag_border(1)
+    format.set_diag_color('red')
+    format.set_align('center')
+
+    worksheet.write((2 * (i + 15)), 0, i, center)
+    worksheet.write((2 * (i + 15)),
+                     1, sprintf("0x%02X", i), center)
+
+    worksheet.write((2 * (i + 15)), 3, "Border", format)
+  end
+end
+
+######################################################################
+#
+# Demonstrate the standard Excel cell patterns.
+#
+def patterns(workbook, center, heading, colors)
+  worksheet = workbook.add_worksheet('Patterns')
+
+  worksheet.set_column(0, 4, 10)
+  worksheet.set_column(5, 5, 50)
+
+  worksheet.write(0, 0, "Index",   heading)
+  worksheet.write(0, 1, "Index",   heading)
+  worksheet.write(0, 3, "Pattern", heading)
+
+  worksheet.write(0, 5, "The background colour has been set to silver.",
+                   heading)
+  worksheet.write(1, 5, "The foreground colour has been set to green.",
+                   heading)
+
+  (0 .. 18).each do |i|
+    format = workbook.add_format
+
+    format.set_pattern(i)
+    format.set_bg_color('silver')
+    format.set_fg_color('green')
+    format.set_align('center')
+
+    worksheet.write((2 * (i + 1)), 0, i, center)
+    worksheet.write((2 * (i + 1)),
+                     1, sprintf("0x%02X", i), center)
+
+    worksheet.write((2 * (i + 1)), 3, "Pattern", format)
+
+    if i == 1
+      worksheet.write((2 * (i + 1)),
+                       5, "This is solid colour, the most useful pattern.", heading)
+    end
+  end
+end
+
+######################################################################
+#
+# Demonstrate the standard Excel cell alignments.
+#
+def alignment(workbook, center, heading, colors)
+  worksheet = workbook.add_worksheet('Alignment')
+
+  worksheet.set_column(0, 7, 12)
+  worksheet.set_row(0, 40)
+  worksheet.set_selection(7, 0)
+
+  format01 = workbook.add_format
+  format02 = workbook.add_format
+  format03 = workbook.add_format
+  format04 = workbook.add_format
+  format05 = workbook.add_format
+  format06 = workbook.add_format
+  format07 = workbook.add_format
+  format08 = workbook.add_format
+  format09 = workbook.add_format
+  format10 = workbook.add_format
+  format11 = workbook.add_format
+  format12 = workbook.add_format
+  format13 = workbook.add_format
+  format14 = workbook.add_format
+  format15 = workbook.add_format
+  format16 = workbook.add_format
+  format17 = workbook.add_format
+
+  format02.set_align('top')
+  format03.set_align('bottom')
+  format04.set_align('vcenter')
+  format05.set_align('vjustify')
+  format06.set_text_wrap
+
+  format07.set_align('left')
+  format08.set_align('right')
+  format09.set_align('center')
+  format10.set_align('fill')
+  format11.set_align('justify')
+  format12.set_merge
+
+  format13.set_rotation(45)
+  format14.set_rotation(-45)
+  format15.set_rotation(270)
+
+  format16.set_shrink
+  format17.set_indent(1)
+
+  worksheet.write(0, 0, 'Vertical',   heading)
+  worksheet.write(0, 1, 'top',        format02)
+  worksheet.write(0, 2, 'bottom',     format03)
+  worksheet.write(0, 3, 'vcenter',    format04)
+  worksheet.write(0, 4, 'vjustify',   format05)
+  worksheet.write(0, 5, "text\nwrap", format06)
+
+  worksheet.write(2, 0, 'Horizontal', heading)
+  worksheet.write(2, 1, 'left',       format07)
+  worksheet.write(2, 2, 'right',      format08)
+  worksheet.write(2, 3, 'center',     format09)
+  worksheet.write(2, 4, 'fill',       format10)
+  worksheet.write(2, 5, 'justify',    format11)
+
+  worksheet.write(3, 1, 'merge', format12)
+  worksheet.write(3, 2, '',      format12)
+
+  worksheet.write(3, 3, 'Shrink ' * 3, format16)
+  worksheet.write(3, 4, 'Indent',      format17)
+
+
+  worksheet.write(5, 0, 'Rotation',   heading)
+  worksheet.write(5, 1, 'Rotate 45',  format13)
+  worksheet.write(6, 1, 'Rotate -45', format14)
+  worksheet.write(7, 1, 'Rotate 270', format15)
+end
+
+######################################################################
+#
+# Demonstrate other miscellaneous features.
+#
+def misc(workbook, center, heading, colors)
+  worksheet = workbook.add_worksheet('Miscellaneous')
+
+  worksheet.set_column(2, 2, 25)
+
+  format01 = workbook.add_format
+  format02 = workbook.add_format
+  format03 = workbook.add_format
+  format04 = workbook.add_format
+  format05 = workbook.add_format
+  format06 = workbook.add_format
+  format07 = workbook.add_format
+
+  format01.set_underline(0x01)
+  format02.set_underline(0x02)
+  format03.set_underline(0x21)
+  format04.set_underline(0x22)
+  format05.set_font_strikeout
+  format06.set_font_outline
+  format07.set_font_shadow
+
+  worksheet.write(1,  2, 'Underline  0x01',          format01)
+  worksheet.write(3,  2, 'Underline  0x02',          format02)
+  worksheet.write(5,  2, 'Underline  0x21',          format03)
+  worksheet.write(7,  2, 'Underline  0x22',          format04)
+  worksheet.write(9,  2, 'Strikeout',                format05)
+  worksheet.write(11, 2, 'Outline (Macintosh only)', format06)
+  worksheet.write(13, 2, 'Shadow (Macintosh only)',  format07)
+end
+
+# Call these subroutines to demonstrate different formatting options
+intro(workbook, center, heading, colors)
+fonts(workbook, center, heading, colors)
+named_colors(workbook, center, heading, colors)
+standard_colors(workbook, center, heading, colors)
+numeric_formats(workbook, center, heading, colors)
+borders(workbook, center, heading, colors)
+patterns(workbook, center, heading, colors)
+alignment(workbook, center, heading, colors)
+misc(workbook, center, heading, colors)
+
+# Note: this is required
+workbook.close
+

data/lib/write_xlsx/chart.rb

@@ -3,7 +3,7 @@ require 'write_xlsx/package/xml_writer_simple'
 require 'write_xlsx/utility'
 
 module Writexlsx
-  # ==SYNOPSIS 
+  # ==SYNOPSIS
   #
   # To create a simple Excel file with a chart using WriteXLSX:
   #
@@ -32,7 +32,7 @@ module Writexlsx
   #
   #     workbook.close
   #
-  # ==DESCRIPTION 
+  # ==DESCRIPTION
   #
   # The Chart module is an abstract base class for modules that implement
   # charts in WriteXLSX. The information below is applicable to all of
@@ -66,10 +66,10 @@ module Writexlsx
   # ===stock
   # Creates an Stock style chart. See Writexlsx::Chart::Stock.
   #
-  # ==CHART FORMATTING 
+  # ==CHART FORMATTING
   #
   # The following chart formatting properties can be set for any chart object
-  # that they apply to (and that are supported by Excel::Writer::XLSX) such
+  # that they apply to (and that are supported by WriteXLSX) such
   # as chart lines, column fill areas, plot area borders, markers and other
   # chart elements documented above.
   #
@@ -570,7 +570,7 @@ module Writexlsx
     # You can add more than one series to a chart. In fact, some chart
     # types such as stock require it. The series numbering and order in
     # the Excel chart will be the same as the order in which that are added
-    # in Excel::Writer::XLSX.
+    # in WriteXLSX.
     #
     #     # Add the first series.
     #     chart.add_series(
@@ -1715,7 +1715,7 @@ module Writexlsx
       horiz    = @horiz_cat_axis
       x_axis   = @x_axis
       y_axis   = @y_axis
-      
+
       # Overwrite the default axis position with a user supplied value.
       position = x_axis[:_position] || position
 
@@ -1823,10 +1823,10 @@ module Writexlsx
 
       # Write the c:majorUnit element.
       write_c_major_unit(y_axis[:_major_unit])
-      
+
       # Write the c:minorUnit element.
       write_c_minor_unit(y_axis[:_minor_unit])
-      
+
       @writer.end_tag('c:valAx')
     end
 
@@ -1945,15 +1945,15 @@ module Writexlsx
 
       # Write the c:majorUnit element.
       write_c_major_unit(x_axis[:_major_unit])
-      
+
       # Write the c:majorTimeUnit element.
       if !x_axis[:_major_unit].nil?
         write_c_major_time_unit(x_axis[:_major_unit_type])
       end
-      
+
       # Write the c:minorUnit element.
       write_c_minor_unit(x_axis[:_minor_unit])
-      
+
       # Write the c:minorTimeUnit element.
       if !x_axis[:_minor_unit].nil?
         write_c_minor_time_unit(x_axis[:_minor_unit_type])
@@ -1967,7 +1967,7 @@ module Writexlsx
     #
     def write_scaling(reverse, min = nil, max = nil, log_base = nil) # :nodoc:
       @writer.start_tag('c:scaling')
-      
+
       # Write the c:logBase element.
       write_c_log_base(log_base)
 
@@ -1976,7 +1976,7 @@ module Writexlsx
 
       # Write the c:max element.
       write_c_max(max)
-      
+
       # Write the c:min element.
       write_c_min(min)
 
@@ -2001,7 +2001,7 @@ module Writexlsx
       return if val == 0 || val.nil?
 
       attributes = ['val', val]
-      
+
       @writer.empty_tag('c:logBase', attributes)
     end
 
@@ -2096,7 +2096,7 @@ module Writexlsx
     #
     def write_crosses(val) # :nodoc:
       val ||= 'autoZero'
-      
+
       attributes = ['val', val]
 
       @writer.empty_tag('c:crosses', attributes)

data/lib/write_xlsx/chartsheet.rb

@@ -123,7 +123,7 @@ module Writexlsx
     #
     def prepare_chart(index, chart_id, drawing_id) # :nodoc:
       drawing = Drawing.new
-      @drawing = $drawing
+      @drawing = drawing
       @drawing.orientation = @orientation
 
       @external_drawing_links << [ '/drawing', '../drawings/drawing' << drawing_id << '.xml' ]

data/lib/write_xlsx/format.rb

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 module Writexlsx
-  # ==CELL FORMATTING 
+  # ==CELL FORMATTING
   #
   # This section describes the methods and properties that are available
   # for formatting cells in Excel. The properties of a cell that can be
@@ -131,7 +131,7 @@ module Writexlsx
   #
   # The default format is Arial 10 with all other properties off.
   #
-  # Each unique format in Excel::Writer::XLSX must have a corresponding Format
+  # Each unique format in WriteXLSX must have a corresponding Format
   # object. It isn't possible to use a Format with a write() method and then
   # redefine the Format for use at a later stage. This is because a Format
   # is applied to a cell not in its current state but in its final state.
@@ -364,7 +364,7 @@ module Writexlsx
     # Returns a unique hash key for the Format object.
     #
     def get_format_key
-      [get_font_key, get_border_key, get_fill_key, @num_format].join(':')
+      [get_font_key, get_border_key, get_fill_key, @num_format, get_alignment_key].join(':')
     end
 
     #
@@ -417,6 +417,13 @@ module Writexlsx
       ].join(':')
     end
 
+    #
+    # Returns a unique hash key for alignment formats.
+    #
+    def get_alignment_key
+      [@text_h_align, @text_v_align, @indent, @rotation, @text_wrap, @shrink, @reading_order].join(':')
+    end
+
     #
     # Returns the index used by Worksheet->_XF()
     #