write_xlsx 0.0.2
Sign up to get free protection for your applications and to get access to all the features.
- data/.document +5 -0
- data/.gitattributes +1 -0
- data/Gemfile +12 -0
- data/LICENSE.txt +20 -0
- data/README.rdoc +82 -0
- data/Rakefile +78 -0
- data/VERSION +1 -0
- data/examples/a_simple.rb +45 -0
- data/examples/array_formula.rb +33 -0
- data/examples/autofilter.rb +235 -0
- data/examples/chart_area.rb +59 -0
- data/examples/chart_bar.rb +59 -0
- data/examples/chart_column.rb +58 -0
- data/examples/chart_line.rb +59 -0
- data/examples/chart_pie.rb +49 -0
- data/examples/chart_scatter.rb +59 -0
- data/examples/chart_stock.rb +65 -0
- data/examples/colors.rb +130 -0
- data/examples/comments1.rb +12 -0
- data/examples/comments2.rb +335 -0
- data/examples/conditional_format.rb +67 -0
- data/examples/data_validate.rb +279 -0
- data/examples/defined_name.rb +28 -0
- data/examples/demo.rb +104 -0
- data/examples/diag_border.rb +26 -0
- data/examples/headers.rb +119 -0
- data/examples/hide_sheet.rb +30 -0
- data/examples/hyperlink1.rb +58 -0
- data/examples/indent.rb +28 -0
- data/examples/merge1.rb +38 -0
- data/examples/merge2.rb +48 -0
- data/examples/merge3.rb +43 -0
- data/examples/merge4.rb +82 -0
- data/examples/merge5.rb +70 -0
- data/examples/merge6.rb +48 -0
- data/examples/outline.rb +252 -0
- data/examples/properties.rb +33 -0
- data/examples/protection.rb +34 -0
- data/examples/rich_strings.rb +42 -0
- data/examples/right_to_left.rb +24 -0
- data/examples/tab_colors.rb +26 -0
- data/lib/write_xlsx.rb +77 -0
- data/lib/write_xlsx/chart.rb +3027 -0
- data/lib/write_xlsx/chart/area.rb +52 -0
- data/lib/write_xlsx/chart/bar.rb +126 -0
- data/lib/write_xlsx/chart/column.rb +132 -0
- data/lib/write_xlsx/chart/line.rb +51 -0
- data/lib/write_xlsx/chart/pie.rb +210 -0
- data/lib/write_xlsx/chart/scatter.rb +252 -0
- data/lib/write_xlsx/chart/stock.rb +134 -0
- data/lib/write_xlsx/chartsheet.rb +173 -0
- data/lib/write_xlsx/colors.rb +65 -0
- data/lib/write_xlsx/compatibility.rb +71 -0
- data/lib/write_xlsx/drawing.rb +547 -0
- data/lib/write_xlsx/format.rb +683 -0
- data/lib/write_xlsx/package/app.rb +218 -0
- data/lib/write_xlsx/package/comments.rb +221 -0
- data/lib/write_xlsx/package/content_types.rb +189 -0
- data/lib/write_xlsx/package/core.rb +196 -0
- data/lib/write_xlsx/package/packager.rb +510 -0
- data/lib/write_xlsx/package/relationships.rb +98 -0
- data/lib/write_xlsx/package/shared_strings.rb +96 -0
- data/lib/write_xlsx/package/styles.rb +705 -0
- data/lib/write_xlsx/package/theme.rb +45 -0
- data/lib/write_xlsx/package/vml.rb +386 -0
- data/lib/write_xlsx/package/xml_writer_simple.rb +90 -0
- data/lib/write_xlsx/utility.rb +113 -0
- data/lib/write_xlsx/workbook.rb +1488 -0
- data/lib/write_xlsx/worksheet.rb +6578 -0
- data/lib/write_xlsx/zip_file_utils.rb +98 -0
- data/test/chart/test_add_series.rb +113 -0
- data/test/chart/test_process_names.rb +27 -0
- data/test/chart/test_write_auto.rb +15 -0
- data/test/chart/test_write_ax_id.rb +15 -0
- data/test/chart/test_write_ax_pos.rb +15 -0
- data/test/chart/test_write_chart_space.rb +15 -0
- data/test/chart/test_write_cross_ax.rb +15 -0
- data/test/chart/test_write_crosses.rb +15 -0
- data/test/chart/test_write_format_code.rb +15 -0
- data/test/chart/test_write_idx.rb +15 -0
- data/test/chart/test_write_label_align.rb +15 -0
- data/test/chart/test_write_label_offset.rb +15 -0
- data/test/chart/test_write_lang.rb +15 -0
- data/test/chart/test_write_layout.rb +15 -0
- data/test/chart/test_write_legend.rb +16 -0
- data/test/chart/test_write_legend_pos.rb +15 -0
- data/test/chart/test_write_major_gridlines.rb +15 -0
- data/test/chart/test_write_marker.rb +17 -0
- data/test/chart/test_write_marker_size.rb +15 -0
- data/test/chart/test_write_marker_value.rb +16 -0
- data/test/chart/test_write_num_cache.rb +16 -0
- data/test/chart/test_write_num_fmt.rb +16 -0
- data/test/chart/test_write_number_format.rb +15 -0
- data/test/chart/test_write_order.rb +15 -0
- data/test/chart/test_write_orientation.rb +15 -0
- data/test/chart/test_write_page_margins.rb +15 -0
- data/test/chart/test_write_page_setup.rb +15 -0
- data/test/chart/test_write_plot_vis_only.rb +15 -0
- data/test/chart/test_write_pt.rb +16 -0
- data/test/chart/test_write_pt_count.rb +16 -0
- data/test/chart/test_write_series_formula.rb +16 -0
- data/test/chart/test_write_style.rb +41 -0
- data/test/chart/test_write_symbol.rb +16 -0
- data/test/chart/test_write_tick_lbl_pos.rb +16 -0
- data/test/chart/test_write_v.rb +16 -0
- data/test/drawing/test_drawing_chart_01.rb +50 -0
- data/test/drawing/test_drawing_image_01.rb +59 -0
- data/test/helper.rb +90 -0
- data/test/package/app/test_app01.rb +44 -0
- data/test/package/app/test_app02.rb +46 -0
- data/test/package/app/test_app03.rb +53 -0
- data/test/package/comments/test_comments01.rb +36 -0
- data/test/package/comments/test_write_text_t.rb +44 -0
- data/test/package/content_types/test_content_types.rb +35 -0
- data/test/package/content_types/test_write_default.rb +13 -0
- data/test/package/content_types/test_write_override.rb +13 -0
- data/test/package/core/test_core01.rb +28 -0
- data/test/package/core/test_core02.rb +42 -0
- data/test/package/relationships/test_relationships.rb +28 -0
- data/test/package/relationships/test_sheet_rels.rb +22 -0
- data/test/package/shared_strings/test_shared_strings01.rb +30 -0
- data/test/package/shared_strings/test_shared_strings02.rb +30 -0
- data/test/package/shared_strings/test_write_si.rb +13 -0
- data/test/package/shared_strings/test_write_sst.rb +15 -0
- data/test/package/styles/test_styles_01.rb +69 -0
- data/test/package/styles/test_styles_02.rb +104 -0
- data/test/package/styles/test_styles_03.rb +90 -0
- data/test/package/styles/test_styles_04.rb +216 -0
- data/test/package/styles/test_styles_05.rb +150 -0
- data/test/package/styles/test_styles_06.rb +104 -0
- data/test/package/styles/test_styles_07.rb +104 -0
- data/test/package/styles/test_styles_08.rb +109 -0
- data/test/package/styles/test_styles_09.rb +95 -0
- data/test/package/vml/test_vml_01.rb +42 -0
- data/test/package/vml/test_write_anchor.rb +14 -0
- data/test/package/vml/test_write_auto_fill.rb +14 -0
- data/test/package/vml/test_write_column.rb +14 -0
- data/test/package/vml/test_write_div.rb +14 -0
- data/test/package/vml/test_write_fill.rb +14 -0
- data/test/package/vml/test_write_idmap.rb +14 -0
- data/test/package/vml/test_write_move_with_cells.rb +14 -0
- data/test/package/vml/test_write_path.rb +22 -0
- data/test/package/vml/test_write_row.rb +14 -0
- data/test/package/vml/test_write_shadow.rb +14 -0
- data/test/package/vml/test_write_shapelayout.rb +14 -0
- data/test/package/vml/test_write_shapetype.rb +14 -0
- data/test/package/vml/test_write_size_with_cells.rb +14 -0
- data/test/package/vml/test_write_stroke.rb +14 -0
- data/test/package/vml/test_write_textbox.rb +14 -0
- data/test/perl_output/a_simple.xlsx +0 -0
- data/test/perl_output/array_formula.xlsx +0 -0
- data/test/perl_output/autofilter.xlsx +0 -0
- data/test/perl_output/chart_area.xlsx +0 -0
- data/test/perl_output/chart_bar.xlsx +0 -0
- data/test/perl_output/chart_column.xlsx +0 -0
- data/test/perl_output/chart_line.xlsx +0 -0
- data/test/perl_output/chart_pie.xlsx +0 -0
- data/test/perl_output/chart_scatter.xlsx +0 -0
- data/test/perl_output/chart_stock.xlsx +0 -0
- data/test/perl_output/comments1.xlsx +0 -0
- data/test/perl_output/comments2.xlsx +0 -0
- data/test/perl_output/conditional_format.xlsx +0 -0
- data/test/perl_output/data_validate.xlsx +0 -0
- data/test/perl_output/defined_name.xlsx +0 -0
- data/test/perl_output/demo.xlsx +0 -0
- data/test/perl_output/diag_border.xlsx +0 -0
- data/test/perl_output/fit_to_pages.xlsx +0 -0
- data/test/perl_output/headers.xlsx +0 -0
- data/test/perl_output/hide_sheet.xlsx +0 -0
- data/test/perl_output/hyperlink.xlsx +0 -0
- data/test/perl_output/indent.xlsx +0 -0
- data/test/perl_output/merge1.xlsx +0 -0
- data/test/perl_output/merge2.xlsx +0 -0
- data/test/perl_output/merge3.xlsx +0 -0
- data/test/perl_output/merge4.xlsx +0 -0
- data/test/perl_output/merge5.xlsx +0 -0
- data/test/perl_output/merge6.xlsx +0 -0
- data/test/perl_output/outline.xlsx +0 -0
- data/test/perl_output/print_scale.xlsx +0 -0
- data/test/perl_output/properties.xlsx +0 -0
- data/test/perl_output/protection.xlsx +0 -0
- data/test/perl_output/rich_strings.xlsx +0 -0
- data/test/perl_output/right_to_left.xlsx +0 -0
- data/test/perl_output/tab_colors.xlsx +0 -0
- data/test/test_delete_files.rb +37 -0
- data/test/test_example_match.rb +2281 -0
- data/test/test_xml_writer_simple.rb +63 -0
- data/test/workbook/test_get_chart_range.rb +59 -0
- data/test/workbook/test_sort_defined_names.rb +77 -0
- data/test/workbook/test_workbook_01.rb +29 -0
- data/test/workbook/test_workbook_02.rb +31 -0
- data/test/workbook/test_workbook_03.rb +31 -0
- data/test/workbook/test_workbook_new.rb +18 -0
- data/test/workbook/test_write_defined_name.rb +17 -0
- data/test/workbook/test_write_defined_names.rb +41 -0
- data/test/worksheet/test_calculate_spans.rb +58 -0
- data/test/worksheet/test_convert_date_time_01.rb +439 -0
- data/test/worksheet/test_convert_date_time_02.rb +478 -0
- data/test/worksheet/test_convert_date_time_03.rb +435 -0
- data/test/worksheet/test_extract_filter_tokens.rb +109 -0
- data/test/worksheet/test_parse_filter_expression.rb +143 -0
- data/test/worksheet/test_position_object.rb +50 -0
- data/test/worksheet/test_repeat_formula.rb +55 -0
- data/test/worksheet/test_worksheet_01.rb +32 -0
- data/test/worksheet/test_worksheet_02.rb +38 -0
- data/test/worksheet/test_worksheet_03.rb +44 -0
- data/test/worksheet/test_worksheet_04.rb +45 -0
- data/test/worksheet/test_write_array_formula_01.rb +99 -0
- data/test/worksheet/test_write_autofilter.rb +260 -0
- data/test/worksheet/test_write_brk.rb +18 -0
- data/test/worksheet/test_write_cell.rb +49 -0
- data/test/worksheet/test_write_cell_value.rb +33 -0
- data/test/worksheet/test_write_col_breaks.rb +27 -0
- data/test/worksheet/test_write_col_info.rb +95 -0
- data/test/worksheet/test_write_conditional_formatting.rb +72 -0
- data/test/worksheet/test_write_custom_filter.rb +18 -0
- data/test/worksheet/test_write_custom_filters.rb +25 -0
- data/test/worksheet/test_write_data_validation_01.rb +113 -0
- data/test/worksheet/test_write_data_validation_02.rb +528 -0
- data/test/worksheet/test_write_dimension.rb +94 -0
- data/test/worksheet/test_write_ext.rb +18 -0
- data/test/worksheet/test_write_ext_lst.rb +18 -0
- data/test/worksheet/test_write_filter.rb +18 -0
- data/test/worksheet/test_write_filter_column.rb +18 -0
- data/test/worksheet/test_write_filters.rb +32 -0
- data/test/worksheet/test_write_header_footer.rb +53 -0
- data/test/worksheet/test_write_hyperlink.rb +39 -0
- data/test/worksheet/test_write_hyperlinks.rb +27 -0
- data/test/worksheet/test_write_legacy_drawing.rb +19 -0
- data/test/worksheet/test_write_merge_cell.rb +18 -0
- data/test/worksheet/test_write_merge_cells.rb +192 -0
- data/test/worksheet/test_write_methods.rb +353 -0
- data/test/worksheet/test_write_mx_plv.rb +19 -0
- data/test/worksheet/test_write_page_margins.rb +98 -0
- data/test/worksheet/test_write_page_set_up_pr.rb +19 -0
- data/test/worksheet/test_write_page_setup.rb +54 -0
- data/test/worksheet/test_write_pane.rb +123 -0
- data/test/worksheet/test_write_phonetic_pr.rb +19 -0
- data/test/worksheet/test_write_print_options.rb +77 -0
- data/test/worksheet/test_write_row_breaks.rb +27 -0
- data/test/worksheet/test_write_row_element.rb +69 -0
- data/test/worksheet/test_write_selection.rb +18 -0
- data/test/worksheet/test_write_sheet_calc_pr.rb +18 -0
- data/test/worksheet/test_write_sheet_data.rb +18 -0
- data/test/worksheet/test_write_sheet_format_pr.rb +18 -0
- data/test/worksheet/test_write_sheet_pr.rb +36 -0
- data/test/worksheet/test_write_sheet_protection.rb +174 -0
- data/test/worksheet/test_write_sheet_view.rb +62 -0
- data/test/worksheet/test_write_sheet_view1.rb +64 -0
- data/test/worksheet/test_write_sheet_view2.rb +56 -0
- data/test/worksheet/test_write_sheet_view3.rb +83 -0
- data/test/worksheet/test_write_sheet_view4.rb +83 -0
- data/test/worksheet/test_write_sheet_view5.rb +74 -0
- data/test/worksheet/test_write_sheet_view6.rb +51 -0
- data/test/worksheet/test_write_sheet_view7.rb +71 -0
- data/test/worksheet/test_write_sheet_view8.rb +51 -0
- data/test/worksheet/test_write_sheet_view9.rb +51 -0
- data/test/worksheet/test_write_tab_color.rb +23 -0
- data/test/worksheet/test_write_worksheet.rb +19 -0
- data/write_xlsx.gemspec +308 -0
- metadata +363 -0
data/examples/merge3.rb
ADDED
@@ -0,0 +1,43 @@
|
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
# -*- coding: utf-8 -*-
|
3
|
+
|
4
|
+
###############################################################################
|
5
|
+
#
|
6
|
+
# Example of how to use Excel::Writer::XLSX to write a hyperlink in a
|
7
|
+
# merged cell.
|
8
|
+
#
|
9
|
+
# reverse(c), September 2002, John McNamara, jmcnamara@cpan.org
|
10
|
+
# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
|
11
|
+
#
|
12
|
+
|
13
|
+
require 'rubygems'
|
14
|
+
require 'write_xlsx'
|
15
|
+
|
16
|
+
# Create a new workbook and add a worksheet
|
17
|
+
workbook = WriteXLSX.new('merge3.xlsx')
|
18
|
+
worksheet = workbook.add_worksheet()
|
19
|
+
|
20
|
+
# Increase the cell size of the merged cells to highlight the formatting.
|
21
|
+
[3, 6, 7].each { |row| worksheet.set_row(row, 30) }
|
22
|
+
worksheet.set_column('B:D', 20)
|
23
|
+
|
24
|
+
###############################################################################
|
25
|
+
#
|
26
|
+
# Example: Merge cells containing a hyperlink using merge_range().
|
27
|
+
#
|
28
|
+
format = workbook.add_format(
|
29
|
+
:border => 1,
|
30
|
+
:underline => 1,
|
31
|
+
:color => 'blue',
|
32
|
+
:align => 'center',
|
33
|
+
:valign => 'vcenter'
|
34
|
+
)
|
35
|
+
|
36
|
+
# Merge 3 cells
|
37
|
+
worksheet.merge_range('B4:D4', 'http://www.perl.com', format)
|
38
|
+
|
39
|
+
|
40
|
+
# Merge 3 cells over two rows
|
41
|
+
worksheet.merge_range('B7:D8', 'http://www.perl.com', format)
|
42
|
+
|
43
|
+
workbook.close
|
data/examples/merge4.rb
ADDED
@@ -0,0 +1,82 @@
|
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
# -*- coding: utf-8 -*-
|
3
|
+
|
4
|
+
###############################################################################
|
5
|
+
#
|
6
|
+
# Example of how to use the Excel::Writer::XLSX merge_range workbook
|
7
|
+
# method with complex formatting.
|
8
|
+
#
|
9
|
+
# reverse(c), September 2002, John McNamara, jmcnamara@cpan.org
|
10
|
+
# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
|
11
|
+
#
|
12
|
+
|
13
|
+
require 'rubygems'
|
14
|
+
require 'write_xlsx'
|
15
|
+
|
16
|
+
# Create a new workbook and add a worksheet
|
17
|
+
workbook = WriteXLSX.new('merge4.xlsx')
|
18
|
+
worksheet = workbook.add_worksheet
|
19
|
+
|
20
|
+
|
21
|
+
# Increase the cell size of the merged cells to highlight the formatting.
|
22
|
+
(1 .. 11).each { |i| worksheet.set_row(i, 30) }
|
23
|
+
worksheet.set_column('B:D', 20)
|
24
|
+
|
25
|
+
|
26
|
+
###############################################################################
|
27
|
+
#
|
28
|
+
# Example 1: Text centered vertically and horizontally
|
29
|
+
#
|
30
|
+
format1 = workbook.add_format(
|
31
|
+
:border => 6,
|
32
|
+
:bold => 1,
|
33
|
+
:color => 'red',
|
34
|
+
:valign => 'vcenter',
|
35
|
+
:align => 'center'
|
36
|
+
)
|
37
|
+
|
38
|
+
worksheet.merge_range('B2:D3', 'Vertical and horizontal', format1)
|
39
|
+
|
40
|
+
###############################################################################
|
41
|
+
#
|
42
|
+
# Example 2: Text aligned to the top and left
|
43
|
+
#
|
44
|
+
format2 = workbook.add_format(
|
45
|
+
:border => 6,
|
46
|
+
:bold => 1,
|
47
|
+
:color => 'red',
|
48
|
+
:valign => 'top',
|
49
|
+
:align => 'left'
|
50
|
+
)
|
51
|
+
|
52
|
+
worksheet.merge_range('B5:D6', 'Aligned to the top and left', format2)
|
53
|
+
|
54
|
+
###############################################################################
|
55
|
+
#
|
56
|
+
# Example 3: Text aligned to the bottom and right
|
57
|
+
#
|
58
|
+
format3 = workbook.add_format(
|
59
|
+
:border => 6,
|
60
|
+
:bold => 1,
|
61
|
+
:color => 'red',
|
62
|
+
:valign => 'bottom',
|
63
|
+
:align => 'right'
|
64
|
+
)
|
65
|
+
|
66
|
+
worksheet.merge_range('B8:D9', 'Aligned to the bottom and right', format3)
|
67
|
+
|
68
|
+
###############################################################################
|
69
|
+
#
|
70
|
+
# Example 4: Text justified (i.e. wrapped) in the cell
|
71
|
+
#
|
72
|
+
format4 = workbook.add_format(
|
73
|
+
:border => 6,
|
74
|
+
:bold => 1,
|
75
|
+
:color => 'red',
|
76
|
+
:valign => 'top',
|
77
|
+
:align => 'justify'
|
78
|
+
)
|
79
|
+
|
80
|
+
worksheet.merge_range('B11:D12', 'Justified: ' << 'so on and ' * 18, format4)
|
81
|
+
|
82
|
+
workbook.close
|
data/examples/merge5.rb
ADDED
@@ -0,0 +1,70 @@
|
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
# -*- coding: utf-8 -*-
|
3
|
+
|
4
|
+
###############################################################################
|
5
|
+
#
|
6
|
+
# Example of how to use the Excel::Writer::XLSX merge_cells workbook
|
7
|
+
# method with complex formatting and rotation.
|
8
|
+
#
|
9
|
+
#
|
10
|
+
# reverse(c), September 2002, John McNamara, jmcnamara@cpan.org
|
11
|
+
# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
|
12
|
+
#
|
13
|
+
|
14
|
+
require 'rubygems'
|
15
|
+
require 'write_xlsx'
|
16
|
+
|
17
|
+
# Create a new workbook and add a worksheet
|
18
|
+
workbook = WriteXLSX.new( 'merge5.xlsx' )
|
19
|
+
worksheet = workbook.add_worksheet
|
20
|
+
|
21
|
+
# Increase the cell size of the merged cells to highlight the formatting.
|
22
|
+
(3 .. 8).each { |row| worksheet.set_row(row, 36 ) }
|
23
|
+
[1, 3, 5].each { |col| worksheet.set_column( col, col, 15 ) }
|
24
|
+
|
25
|
+
###############################################################################
|
26
|
+
#
|
27
|
+
# Rotation 1, letters run from top to bottom
|
28
|
+
#
|
29
|
+
format1 = workbook.add_format(
|
30
|
+
:border => 6,
|
31
|
+
:bold => 1,
|
32
|
+
:color => 'red',
|
33
|
+
:valign => 'vcentre',
|
34
|
+
:align => 'centre',
|
35
|
+
:rotation => 270
|
36
|
+
)
|
37
|
+
|
38
|
+
worksheet.merge_range( 'B4:B9', 'Rotation 270', format1 )
|
39
|
+
|
40
|
+
###############################################################################
|
41
|
+
#
|
42
|
+
# Rotation 2, 90ー anticlockwise
|
43
|
+
#
|
44
|
+
format2 = workbook.add_format(
|
45
|
+
:border => 6,
|
46
|
+
:bold => 1,
|
47
|
+
:color => 'red',
|
48
|
+
:valign => 'vcentre',
|
49
|
+
:align => 'centre',
|
50
|
+
:rotation => 90
|
51
|
+
)
|
52
|
+
|
53
|
+
worksheet.merge_range( 'D4:D9', 'Rotation 90', format2 )
|
54
|
+
|
55
|
+
###############################################################################
|
56
|
+
#
|
57
|
+
# Rotation 3, 90ー clockwise
|
58
|
+
#
|
59
|
+
format3 = workbook.add_format(
|
60
|
+
:border => 6,
|
61
|
+
:bold => 1,
|
62
|
+
:color => 'red',
|
63
|
+
:valign => 'vcentre',
|
64
|
+
:align => 'centre',
|
65
|
+
:rotation => -90
|
66
|
+
)
|
67
|
+
|
68
|
+
worksheet.merge_range( 'F4:F9', 'Rotation -90', format3 )
|
69
|
+
|
70
|
+
workbook.close
|
data/examples/merge6.rb
ADDED
@@ -0,0 +1,48 @@
|
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
# -*- coding: utf-8 -*-
|
3
|
+
|
4
|
+
###############################################################################
|
5
|
+
#
|
6
|
+
# Example of how to use the Excel::Writer::XLSX merge_cells workbook
|
7
|
+
# method with Unicode strings.
|
8
|
+
#
|
9
|
+
# reverse(c), December 2005, John McNamara, jmcnamara@cpan.org
|
10
|
+
# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
|
11
|
+
#
|
12
|
+
|
13
|
+
require 'rubygems'
|
14
|
+
require 'write_xlsx'
|
15
|
+
|
16
|
+
# Create a new workbook and add a worksheet
|
17
|
+
workbook = WriteXLSX.new('merge6.xlsx')
|
18
|
+
worksheet = workbook.add_worksheet
|
19
|
+
|
20
|
+
# Increase the cell size of the merged cells to highlight the formatting.
|
21
|
+
(2 .. 9).each { |row| worksheet.set_row(row, 36) }
|
22
|
+
worksheet.set_column('B:D', 25)
|
23
|
+
|
24
|
+
# Format for the merged cells.
|
25
|
+
format = workbook.add_format(
|
26
|
+
:border => 6,
|
27
|
+
:bold => 1,
|
28
|
+
:color => 'red',
|
29
|
+
:size => 20,
|
30
|
+
:valign => 'vcentre',
|
31
|
+
:align => 'left',
|
32
|
+
:indent => 1
|
33
|
+
)
|
34
|
+
|
35
|
+
###############################################################################
|
36
|
+
#
|
37
|
+
# Write an Ascii string.
|
38
|
+
#
|
39
|
+
worksheet.merge_range('B3:D4', 'ASCII: A simple string', format)
|
40
|
+
|
41
|
+
###############################################################################
|
42
|
+
#
|
43
|
+
# Write a UTF-8 Unicode string.
|
44
|
+
#
|
45
|
+
smiley = '☺'
|
46
|
+
worksheet.merge_range('B6:D7', "UTF-8: A Unicode smiley #{smiley}", format)
|
47
|
+
|
48
|
+
workbook.close
|
data/examples/outline.rb
ADDED
@@ -0,0 +1,252 @@
|
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
# -*- coding: utf-8 -*-
|
3
|
+
|
4
|
+
###############################################################################
|
5
|
+
#
|
6
|
+
# Example of how use Excel::Writer::XLSX to generate Excel outlines and
|
7
|
+
# grouping.
|
8
|
+
#
|
9
|
+
#
|
10
|
+
# Excel allows you to group rows or columns so that they can be hidden or
|
11
|
+
# displayed with a single mouse click. This feature is referred to as outlines.
|
12
|
+
#
|
13
|
+
# Outlines can reduce complex data down to a few salient sub-totals or
|
14
|
+
# summaries.
|
15
|
+
#
|
16
|
+
# This feature is best viewed in Excel but the following is an ASCII
|
17
|
+
# representation of what a worksheet with three outlines might look like.
|
18
|
+
# Rows 3-4 and rows 7-8 are grouped at level 2. Rows 2-9 are grouped at
|
19
|
+
# level 1. The lines at the left hand side are called outline level bars.
|
20
|
+
#
|
21
|
+
#
|
22
|
+
# ------------------------------------------
|
23
|
+
# 1 2 3 | | A | B | C | D | ...
|
24
|
+
# ------------------------------------------
|
25
|
+
# _ | 1 | A | | | | ...
|
26
|
+
# | _ | 2 | B | | | | ...
|
27
|
+
# | | | 3 | (C) | | | | ...
|
28
|
+
# | | | 4 | (D) | | | | ...
|
29
|
+
# | - | 5 | E | | | | ...
|
30
|
+
# | _ | 6 | F | | | | ...
|
31
|
+
# | | | 7 | (G) | | | | ...
|
32
|
+
# | | | 8 | (H) | | | | ...
|
33
|
+
# | - | 9 | I | | | | ...
|
34
|
+
# - | . | ... | ... | ... | ... | ...
|
35
|
+
#
|
36
|
+
#
|
37
|
+
# Clicking the minus sign on each of the level 2 outlines will collapse and
|
38
|
+
# hide the data as shown in the next figure. The minus sign changes to a plus
|
39
|
+
# sign to indicate that the data in the outline is hidden.
|
40
|
+
#
|
41
|
+
# ------------------------------------------
|
42
|
+
# 1 2 3 | | A | B | C | D | ...
|
43
|
+
# ------------------------------------------
|
44
|
+
# _ | 1 | A | | | | ...
|
45
|
+
# | | 2 | B | | | | ...
|
46
|
+
# | + | 5 | E | | | | ...
|
47
|
+
# | | 6 | F | | | | ...
|
48
|
+
# | + | 9 | I | | | | ...
|
49
|
+
# - | . | ... | ... | ... | ... | ...
|
50
|
+
#
|
51
|
+
#
|
52
|
+
# Clicking on the minus sign on the level 1 outline will collapse the remaining
|
53
|
+
# rows as follows:
|
54
|
+
#
|
55
|
+
# ------------------------------------------
|
56
|
+
# 1 2 3 | | A | B | C | D | ...
|
57
|
+
# ------------------------------------------
|
58
|
+
# | 1 | A | | | | ...
|
59
|
+
# + | . | ... | ... | ... | ... | ...
|
60
|
+
#
|
61
|
+
# See the main Excel::Writer::XLSX documentation for more information.
|
62
|
+
#
|
63
|
+
# reverse(c), April 2003, John McNamara, jmcnamara@cpan.org
|
64
|
+
# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
|
65
|
+
#
|
66
|
+
|
67
|
+
require 'rubygems'
|
68
|
+
require 'write_xlsx'
|
69
|
+
|
70
|
+
# Create a new workbook and add some worksheets
|
71
|
+
workbook = WriteXLSX.new('outline.xlsx')
|
72
|
+
worksheet1 = workbook.add_worksheet('Outlined Rows')
|
73
|
+
worksheet2 = workbook.add_worksheet('Collapsed Rows')
|
74
|
+
worksheet3 = workbook.add_worksheet('Outline Columns')
|
75
|
+
worksheet4 = workbook.add_worksheet('Outline levels')
|
76
|
+
|
77
|
+
# Add a general format
|
78
|
+
bold = workbook.add_format(:bold => 1)
|
79
|
+
|
80
|
+
|
81
|
+
###############################################################################
|
82
|
+
#
|
83
|
+
# Example 1: Create a worksheet with outlined rows. It also includes SUBTOTAL()
|
84
|
+
# functions so that it looks like the type of automatic outlines that are
|
85
|
+
# generated when you use the Excel Data.SubTotals menu item.
|
86
|
+
#
|
87
|
+
|
88
|
+
|
89
|
+
# For outlines the important parameters are $hidden and $level. Rows with the
|
90
|
+
# same $level are grouped together. The group will be collapsed if $hidden is
|
91
|
+
# non-zero. $height and $XF are assigned default values if they are nil.
|
92
|
+
#
|
93
|
+
# The syntax is: set_row($row, $height, $XF, $hidden, $level, $collapsed)
|
94
|
+
#
|
95
|
+
worksheet1.set_row(1, nil, nil, 0, 2)
|
96
|
+
worksheet1.set_row(2, nil, nil, 0, 2)
|
97
|
+
worksheet1.set_row(3, nil, nil, 0, 2)
|
98
|
+
worksheet1.set_row(4, nil, nil, 0, 2)
|
99
|
+
worksheet1.set_row(5, nil, nil, 0, 1)
|
100
|
+
|
101
|
+
worksheet1.set_row(6, nil, nil, 0, 2)
|
102
|
+
worksheet1.set_row(7, nil, nil, 0, 2)
|
103
|
+
worksheet1.set_row(8, nil, nil, 0, 2)
|
104
|
+
worksheet1.set_row(9, nil, nil, 0, 2)
|
105
|
+
worksheet1.set_row(10, nil, nil, 0, 1)
|
106
|
+
|
107
|
+
|
108
|
+
# Add a column format for clarity
|
109
|
+
worksheet1.set_column('A:A', 20)
|
110
|
+
|
111
|
+
# Add the data, labels and formulas
|
112
|
+
worksheet1.write('A1', 'Region', bold)
|
113
|
+
worksheet1.write('A2', 'North')
|
114
|
+
worksheet1.write('A3', 'North')
|
115
|
+
worksheet1.write('A4', 'North')
|
116
|
+
worksheet1.write('A5', 'North')
|
117
|
+
worksheet1.write('A6', 'North Total', bold)
|
118
|
+
|
119
|
+
worksheet1.write('B1', 'Sales', bold)
|
120
|
+
worksheet1.write('B2', 1000)
|
121
|
+
worksheet1.write('B3', 1200)
|
122
|
+
worksheet1.write('B4', 900)
|
123
|
+
worksheet1.write('B5', 1200)
|
124
|
+
worksheet1.write('B6', '=SUBTOTAL(9,B2:B5)', bold)
|
125
|
+
|
126
|
+
worksheet1.write('A7', 'South')
|
127
|
+
worksheet1.write('A8', 'South')
|
128
|
+
worksheet1.write('A9', 'South')
|
129
|
+
worksheet1.write('A10', 'South')
|
130
|
+
worksheet1.write('A11', 'South Total', bold)
|
131
|
+
|
132
|
+
worksheet1.write('B7', 400)
|
133
|
+
worksheet1.write('B8', 600)
|
134
|
+
worksheet1.write('B9', 500)
|
135
|
+
worksheet1.write('B10', 600)
|
136
|
+
worksheet1.write('B11', '=SUBTOTAL(9,B7:B10)', bold)
|
137
|
+
|
138
|
+
worksheet1.write('A12', 'Grand Total', bold)
|
139
|
+
worksheet1.write('B12', '=SUBTOTAL(9,B2:B10)', bold)
|
140
|
+
|
141
|
+
|
142
|
+
###############################################################################
|
143
|
+
#
|
144
|
+
# Example 2: Create a worksheet with outlined rows. This is the same as the
|
145
|
+
# previous example except that the rows are collapsed.
|
146
|
+
# Note: We need to indicate the row that contains the collapsed symbol '+'
|
147
|
+
# with the optional parameter, $collapsed.
|
148
|
+
|
149
|
+
# The group will be collapsed if $hidden is non-zero.
|
150
|
+
# The syntax is: set_row($row, $height, $XF, $hidden, $level, $collapsed)
|
151
|
+
#
|
152
|
+
worksheet2.set_row(1, nil, nil, 1, 2)
|
153
|
+
worksheet2.set_row(2, nil, nil, 1, 2)
|
154
|
+
worksheet2.set_row(3, nil, nil, 1, 2)
|
155
|
+
worksheet2.set_row(4, nil, nil, 1, 2)
|
156
|
+
worksheet2.set_row(5, nil, nil, 1, 1)
|
157
|
+
|
158
|
+
worksheet2.set_row(6, nil, nil, 1, 2)
|
159
|
+
worksheet2.set_row(7, nil, nil, 1, 2)
|
160
|
+
worksheet2.set_row(8, nil, nil, 1, 2)
|
161
|
+
worksheet2.set_row(9, nil, nil, 1, 2)
|
162
|
+
worksheet2.set_row(10, nil, nil, 1, 1)
|
163
|
+
worksheet2.set_row(11, nil, nil, 0, 0, 1)
|
164
|
+
|
165
|
+
|
166
|
+
# Add a column format for clarity
|
167
|
+
worksheet2.set_column('A:A', 20)
|
168
|
+
|
169
|
+
# Add the data, labels and formulas
|
170
|
+
worksheet2.write('A1', 'Region', bold)
|
171
|
+
worksheet2.write('A2', 'North')
|
172
|
+
worksheet2.write('A3', 'North')
|
173
|
+
worksheet2.write('A4', 'North')
|
174
|
+
worksheet2.write('A5', 'North')
|
175
|
+
worksheet2.write('A6', 'North Total', bold)
|
176
|
+
|
177
|
+
worksheet2.write('B1', 'Sales', bold)
|
178
|
+
worksheet2.write('B2', 1000)
|
179
|
+
worksheet2.write('B3', 1200)
|
180
|
+
worksheet2.write('B4', 900)
|
181
|
+
worksheet2.write('B5', 1200)
|
182
|
+
worksheet2.write('B6', '=SUBTOTAL(9,B2:B5)', bold)
|
183
|
+
|
184
|
+
worksheet2.write('A7', 'South')
|
185
|
+
worksheet2.write('A8', 'South')
|
186
|
+
worksheet2.write('A9', 'South')
|
187
|
+
worksheet2.write('A10', 'South')
|
188
|
+
worksheet2.write('A11', 'South Total', bold)
|
189
|
+
|
190
|
+
worksheet2.write('B7', 400)
|
191
|
+
worksheet2.write('B8', 600)
|
192
|
+
worksheet2.write('B9', 500)
|
193
|
+
worksheet2.write('B10', 600)
|
194
|
+
worksheet2.write('B11', '=SUBTOTAL(9,B7:B10)', bold)
|
195
|
+
|
196
|
+
worksheet2.write('A12', 'Grand Total', bold)
|
197
|
+
worksheet2.write('B12', '=SUBTOTAL(9,B2:B10)', bold)
|
198
|
+
|
199
|
+
|
200
|
+
###############################################################################
|
201
|
+
#
|
202
|
+
# Example 3: Create a worksheet with outlined columns.
|
203
|
+
#
|
204
|
+
data = [
|
205
|
+
[ 'Month', 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', ' Total' ],
|
206
|
+
[ 'North', 50, 20, 15, 25, 65, 80, '=SUM(B2:G2)' ],
|
207
|
+
[ 'South', 10, 20, 30, 50, 50, 50, '=SUM(B3:G3)' ],
|
208
|
+
[ 'East', 45, 75, 50, 15, 75, 100, '=SUM(B4:G4)' ],
|
209
|
+
[ 'West', 15, 15, 55, 35, 20, 50, '=SUM(B5:G5)' ],
|
210
|
+
]
|
211
|
+
|
212
|
+
# Add bold format to the first row
|
213
|
+
worksheet3.set_row(0, nil, bold)
|
214
|
+
|
215
|
+
# Syntax: set_column($col1, $col2, $width, $XF, $hidden, $level, $collapsed)
|
216
|
+
worksheet3.set_column('A:A', 10, bold)
|
217
|
+
worksheet3.set_column('B:G', 5, nil, 0, 1)
|
218
|
+
worksheet3.set_column('H:H', 10)
|
219
|
+
|
220
|
+
# Write the data and a formula
|
221
|
+
worksheet3.write_col('A1', data)
|
222
|
+
worksheet3.write('H6', '=SUM(H2:H5)', bold)
|
223
|
+
|
224
|
+
|
225
|
+
###############################################################################
|
226
|
+
#
|
227
|
+
# Example 4: Show all possible outline levels.
|
228
|
+
#
|
229
|
+
levels = [
|
230
|
+
"Level 1", "Level 2", "Level 3", "Level 4", "Level 5", "Level 6",
|
231
|
+
"Level 7", "Level 6", "Level 5", "Level 4", "Level 3", "Level 2",
|
232
|
+
"Level 1"
|
233
|
+
]
|
234
|
+
|
235
|
+
|
236
|
+
worksheet4.write_col('A1', levels)
|
237
|
+
|
238
|
+
worksheet4.set_row(0, nil, nil, nil, 1)
|
239
|
+
worksheet4.set_row(1, nil, nil, nil, 2)
|
240
|
+
worksheet4.set_row(2, nil, nil, nil, 3)
|
241
|
+
worksheet4.set_row(3, nil, nil, nil, 4)
|
242
|
+
worksheet4.set_row(4, nil, nil, nil, 5)
|
243
|
+
worksheet4.set_row(5, nil, nil, nil, 6)
|
244
|
+
worksheet4.set_row(6, nil, nil, nil, 7)
|
245
|
+
worksheet4.set_row(7, nil, nil, nil, 6)
|
246
|
+
worksheet4.set_row(8, nil, nil, nil, 5)
|
247
|
+
worksheet4.set_row(9, nil, nil, nil, 4)
|
248
|
+
worksheet4.set_row(10, nil, nil, nil, 3)
|
249
|
+
worksheet4.set_row(11, nil, nil, nil, 2)
|
250
|
+
worksheet4.set_row(12, nil, nil, nil, 1)
|
251
|
+
|
252
|
+
workbook.close
|