ricardoo27-writeexcel 0.6.12.1

data/examples/copyformat.rb

@@ -0,0 +1,52 @@
+#!/usr/bin/ruby -w
+# -*- coding: utf-8 -*-
+
+###############################################################################
+#
+# Example of how to use the format copying method with WriteExcel #
+# reverse('©'), March 2001, John McNamara, jmcnamara@cpan.org
+#
+# original written in Perl by John McNamara
+# converted to Ruby by Hideo Nakamura, cxn03651@msj.biglobe.ne.jp
+#
+require 'rubygems'
+require 'writeexcel'
+
+# Create workbook1
+workbook1       = WriteExcel.new("workbook1.xls")
+worksheet1      = workbook1.add_worksheet
+format1a        = workbook1.add_format
+format1b        = workbook1.add_format
+
+# Create workbook2
+workbook2       = WriteExcel.new("workbook2.xls")
+worksheet2      = workbook2.add_worksheet
+format2a        = workbook2.add_format
+format2b        = workbook2.add_format
+
+# Create a global format object that isn't tied to a workbook
+global_format   = Format.new
+
+# Set the formatting
+global_format.set_color('blue')
+global_format.set_bold
+global_format.set_italic
+
+# Create another example format
+format1b.set_color('red')
+
+# Copy the global format properties to the worksheet formats
+format1a.copy(global_format)
+format2a.copy(global_format)
+
+# Copy a format from worksheet1 to worksheet2
+format2b.copy(format1b)
+
+# Write some output
+worksheet1.write(0, 0, "Ciao", format1a)
+worksheet1.write(1, 0, "Ciao", format1b)
+
+worksheet2.write(0, 0, "Hello", format2a)
+worksheet2.write(1, 0, "Hello", format2b)
+workbook1.close
+workbook2.close

data/examples/data_validate.rb

@@ -0,0 +1,279 @@
+#!/usr/bin/ruby -w
+# -*- coding: utf-8 -*-
+
+###############################################################################
+#
+# Example of how to add data validation and dropdown lists to a
+# WriteExcel file.
+#
+# reverse('©'), August 2008, John McNamara, jmcnamara@cpan.org
+#
+# original written in Perl by John McNamara
+# converted to Ruby by Hideo Nakamura, cxn03651@msj.biglobe.ne.jp
+#
+
+require 'rubygems'
+require 'writeexcel'
+
+workbook  = WriteExcel.new('data_validate.xls')
+worksheet = workbook.add_worksheet
+
+# Add a format for the header cells.
+header_format = workbook.add_format(
+                                            :border      => 1,
+                                            :bg_color    => 43,
+                                            :bold        => 1,
+                                            :text_wrap   => 1,
+                                            :valign      => 'vcenter',
+                                            :indent      => 1
+                                         )
+
+# Set up layout of the worksheet.
+worksheet.set_column('A:A', 64)
+worksheet.set_column('B:B', 15)
+worksheet.set_column('D:D', 15)
+worksheet.set_row(0, 36)
+worksheet.set_selection('B3')
+
+
+# Write the header cells and some data that will be used in the examples.
+row = 0
+heading1 = 'Some examples of data validation in WriteExcel'
+heading2 = 'Enter values in this column'
+heading3 = 'Sample Data'
+
+worksheet.write('A1', heading1, header_format)
+worksheet.write('B1', heading2, header_format)
+worksheet.write('D1', heading3, header_format)
+
+worksheet.write('D3', ['Integers',   1, 10])
+worksheet.write('D4', ['List data', 'open', 'high', 'close'])
+worksheet.write('D5', ['Formula',   '=AND(F5=50,G5=60)', 50, 60])
+
+
+#
+# Example 1. Limiting input to an integer in a fixed range.
+#
+txt = 'Enter an integer between 1 and 10'
+row += 2
+
+worksheet.write(row, 0, txt)
+worksheet.data_validation(row, 1,
+    {
+        :validate        => 'integer',
+        :criteria        => 'between',
+        :minimum         => 1,
+        :maximum         => 10
+    })
+
+
+#
+# Example 2. Limiting input to an integer outside a fixed range.
+#
+txt = 'Enter an integer that is not between 1 and 10 (using cell references)'
+row += 2
+
+worksheet.write(row, 0, txt)
+worksheet.data_validation(row, 1,
+    {
+        :validate        => 'integer',
+        :criteria        => 'not between',
+        :minimum         => '=E3',
+        :maximum         => '=F3'
+    })
+
+
+#
+# Example 3. Limiting input to an integer greater than a fixed value.
+#
+txt = 'Enter an integer greater than 0'
+row += 2
+
+worksheet.write(row, 0, txt)
+worksheet.data_validation(row, 1,
+    {
+        :validate        => 'integer',
+        :criteria        => '>',
+        :value           => 0
+    })
+
+
+#
+# Example 4. Limiting input to an integer less than a fixed value.
+#
+txt = 'Enter an integer less than 10'
+row += 2
+
+worksheet.write(row, 0, txt)
+worksheet.data_validation(row, 1,
+    {
+        :validate        => 'integer',
+        :criteria        => '<',
+        :value           => 10
+    })
+
+
+#
+# Example 5. Limiting input to a decimal in a fixed range.
+#
+txt = 'Enter a decimal between 0.1 and 0.5'
+row += 2
+
+worksheet.write(row, 0, txt)
+worksheet.data_validation(row, 1,
+    {
+        :validate        => 'decimal',
+        :criteria        => 'between',
+        :minimum         => 0.1,
+        :maximum         => 0.5
+    })
+
+
+#
+# Example 6. Limiting input to a value in a dropdown list.
+#
+txt = 'Select a value from a drop down list'
+row += 2
+bp=1
+worksheet.write(row, 0, txt)
+worksheet.data_validation(row, 1,
+    {
+        :validate        => 'list',
+        :source          => ['open', 'high', 'close']
+    })
+
+
+#
+# Example 6. Limiting input to a value in a dropdown list.
+#
+txt = 'Select a value from a drop down list (using a cell range)'
+row += 2
+
+worksheet.write(row, 0, txt)
+worksheet.data_validation(row, 1,
+    {
+        :validate        => 'list',
+        :source          => '=E4:G4'
+    })
+
+
+#
+# Example 7. Limiting input to a date in a fixed range.
+#
+txt = 'Enter a date between 1/1/2008 and 12/12/2008'
+row += 2
+
+worksheet.write(row, 0, txt)
+worksheet.data_validation(row, 1,
+    {
+        :validate        => 'date',
+        :criteria        => 'between',
+        :minimum         => '2008-01-01T',
+        :maximum         => '2008-12-12T'
+    })
+
+
+#
+# Example 8. Limiting input to a time in a fixed range.
+#
+txt = 'Enter a time between 6:00 and 12:00'
+row += 2
+
+worksheet.write(row, 0, txt)
+worksheet.data_validation(row, 1,
+    {
+        :validate        => 'time',
+        :criteria        => 'between',
+        :minimum         => 'T06:00',
+        :maximum         => 'T12:00'
+    })
+
+
+#
+# Example 9. Limiting input to a string greater than a fixed length.
+#
+txt = 'Enter a string longer than 3 characters'
+row += 2
+
+worksheet.write(row, 0, txt)
+worksheet.data_validation(row, 1,
+    {
+        :validate        => 'length',
+        :criteria        => '>',
+        :value           => 3
+    })
+
+
+#
+# Example 10. Limiting input based on a formula.
+#
+txt = 'Enter a value if the following is true "=AND(F5=50,G5=60)"'
+row += 2
+
+worksheet.write(row, 0, txt)
+worksheet.data_validation(row, 1,
+    {
+        :validate        => 'custom',
+        :value           => '=AND(F5=50,G5=60)'
+    })
+
+
+#
+# Example 11. Displaying and modify data validation messages.
+#
+txt = 'Displays a message when you select the cell'
+row += 2
+
+worksheet.write(row, 0, txt)
+worksheet.data_validation(row, 1,
+    {
+        :validate      => 'integer',
+        :criteria      => 'between',
+        :minimum       => 1,
+        :maximum       => 100,
+        :input_title   => 'Enter an integer:',
+        :input_message => 'between 1 and 100'
+    })
+
+
+#
+# Example 12. Displaying and modify data validation messages.
+#
+txt = 'Display a custom error message when integer isn\'t between 1 and 100'
+row += 2
+
+worksheet.write(row, 0, txt)
+worksheet.data_validation(row, 1,
+    {
+        :validate      => 'integer',
+        :criteria      => 'between',
+        :minimum       => 1,
+        :maximum       => 100,
+        :input_title   => 'Enter an integer:',
+        :input_message => 'between 1 and 100',
+        :error_title   => 'Input value is not valid!',
+        :error_message => 'It should be an integer between 1 and 100'
+    })
+
+
+#
+# Example 13. Displaying and modify data validation messages.
+#
+txt = 'Display a custom information message when integer isn\'t between 1 and 100'
+row += 2
+
+worksheet.write(row, 0, txt)
+worksheet.data_validation(row, 1,
+    {
+        :validate      => 'integer',
+        :criteria      => 'between',
+        :minimum       => 1,
+        :maximum       => 100,
+        :input_title   => 'Enter an integer:',
+        :input_message => 'between 1 and 100',
+        :error_title   => 'Input value is not valid!',
+        :error_message => 'It should be an integer between 1 and 100',
+        :error_type    => 'information'
+    })
+
+workbook.close

data/examples/date_time.rb

@@ -0,0 +1,87 @@
+#!/usr/bin/ruby -w
+# -*- coding: utf-8 -*-
+
+###############################################################################
+#
+# WriteExcel example of writing dates and times using the
+# write_date_time() Worksheet method.
+#
+# reverse('©'), August 2004, John McNamara, jmcnamara@cpan.org
+#
+# original written in Perl by John McNamara
+# converted to Ruby by Hideo Nakamura, cxn03651@msj.biglobe.ne.jp
+#
+
+require 'rubygems'
+require 'writeexcel'
+
+# Create a new workbook and add a worksheet
+workbook  = WriteExcel.new("date_time.xls")
+worksheet = workbook.add_worksheet
+bold      = workbook.add_format(:bold => 1)
+
+# Expand the first column so that the date is visible.
+worksheet.set_column("A:B", 30)
+
+# Write the column headers
+worksheet.write('A1', 'Formatted date', bold)
+worksheet.write('B1', 'Format',         bold)
+
+# Examples date and time formats. In the output file compare how changing
+# the format codes change the appearance of the date.
+#
+date_formats = [
+    'dd/mm/yy',
+    'mm/dd/yy',
+    '',
+    'd mm yy',
+    'dd mm yy',
+    '',
+    'dd m yy',
+    'dd mm yy',
+    'dd mmm yy',
+    'dd mmmm yy',
+    '',
+    'dd mm y',
+    'dd mm yyy',
+    'dd mm yyyy',
+    '',
+    'd mmmm yyyy',
+    '',
+    'dd/mm/yy',
+    'dd/mm/yy hh:mm',
+    'dd/mm/yy hh:mm:ss',
+    'dd/mm/yy hh:mm:ss.000',
+    '',
+    'hh:mm',
+    'hh:mm:ss',
+    'hh:mm:ss.000',
+]
+
+# Write the same date and time using each of the above formats. The empty
+# string formats create a blank line to make the example clearer.
+#
+row = 0
+date_formats.each do |date_format|
+  row += 1
+  next if date_format == ''
+
+  # Create a format for the date or time.
+  format =  workbook.add_format(
+                              :num_format => date_format,
+                              :align      => 'left'
+                             )
+
+  # Write the same date using different formats.
+  worksheet.write_date_time(row, 0, '2004-08-01T12:30:45.123', format)
+  worksheet.write(row, 1, date_format)
+end
+
+# The following is an example of an invalid date. It is written as a string instead
+# of a number. This is also Excel's default behaviour.
+#
+row += 2
+worksheet.write_date_time(row, 0, '2004-13-01T12:30:45.123')
+worksheet.write(row, 1, 'Invalid date. Written as string.', bold)
+
+workbook.close

data/examples/defined_name.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/ruby -w
+# -*- coding: utf-8 -*-
+
+###############################################################################
+#
+# Example of how to create defined names in a WriteExcel file.
+#
+# reverse('ｩ'), September 2008, John McNamara, jmcnamara@cpan.org
+#
+# original written in Perl by John McNamara
+# converted to Ruby by Hideo Nakamura, cxn03651@msj.biglobe.ne.jp
+#
+
+require 'writeexcel'
+
+workbook   = WriteExcel.new('defined_name.xls')
+worksheet1 = workbook.add_worksheet
+worksheet2 = workbook.add_worksheet
+
+workbook.define_name('Exchange_rate', '=0.96')
+workbook.define_name('Sales',         '=Sheet1!$G$1:$H$10')
+workbook.define_name('Sheet2!Sales',  '=Sheet2!$G$1:$G$10')
+
+workbook.sheets.each do |worksheet|
+  worksheet.set_column('A:A', 45)
+  worksheet.write('A2', 'This worksheet contains some defined names,')
+  worksheet.write('A3', 'See the Insert -> Name -> Define dialog.')
+end
+
+worksheet1.write('A4', '=Exchange_rate')
+
+workbook.close