robust_excel_ole 1.35 → 1.38

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 80365f36774968b6f55052177932c00dbe57b7fb3bee76762474a0b21637440b
-  data.tar.gz: a352fd270609529688869edf581bc2d1c20eee9c0b9b8ec61198dcfafc82fd2b
+  metadata.gz: f2639b34c270ac16732d4de9ff06be54e2ba33cf5c1cf9d7842ed7a639044b4c
+  data.tar.gz: 3533deb112141e2221b00479d6f4207891b7977c0ac1cf6ff37b40ade580fea1
 SHA512:
-  metadata.gz: 5246534fa3c3767e9fe4c8081d37aac6d54070238b6008d1ea289792cc3fa2bbf3b855b36eab4959b16103af6e5f8a83d7d326dc82923ff25c82ab8b9f61ae1e
-  data.tar.gz: '070856a21a1786fa7f9fd3de02edaa6bf661e936329c02afb78e9d5ddbd8623b95a49ec1f22be64e4d205c47e4c7e7c2bf964a00d2928a2d4dbe4a6640bf3a40'
+  metadata.gz: 19071fbe4d293f73f02081c9cb23f706d2102a97d3a038324551e912a6b17929282e0fff738b98f30a2377bf7f2f48b9fb5eaa699a4439b989f2e174a1ff9a63
+  data.tar.gz: 8da4acac7393db1c62b352842aa6b8944b0ecb1fc410077b62d9b0f618a82e07df69612afb0077c0fedfedb824d1962e97c90041a762e4cbadd6691534f1d3f7

data/.gitignore

@@ -9,5 +9,6 @@ doc/*
 *.sublime-workspace
 .yardoc
 TodoList.md
+spec/data/*.xls
 spec/data/*.xls*
 spec/data/workbook_listobjects.xlsx

data/Changelog

@@ -1,6 +1,29 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
+## [1.37] 2021-30-11
+
+### Added
+  - Excel#visible,displayalerts
+
+## [1.36] 2021-29-10
+
+### Added
+  - Workbook.open: option if_blocked: :accept
+  - ListRow#methods, respond_to?, alive?
+  - Range#workbook, ListObject#workbook, ListRow#workbook
+  - Workbook#writable=
+
+### Changed
+  - Workbook#open instead of Workbook#reopen
+
+
+## [1.35] 2021-24-07
+
+## [1.34] 2021-21-06
+
+## [1.34] 2021-15-06
+
 ## [1.33] 2021-01-06
 
 ## [1.32] 2021-23-04
@@ -125,14 +148,14 @@ All notable changes to this project will be documented in this file.
    - Workbook#save, save_as: removed parameter :discoloring
    - RangeOwners#set_namevalue, set_namevalue_glob, Worksheet#set_cellval: 
      removed optional parameter for color 
-   - Workbook#open: removed option :excel => :reserved_new  
+   - Workbook.open: removed option :excel => :reserved_new  
 
 
 ## [1.11]
 
 ### Added
   - Range#==, Worksheet#== 
-  - Workbook#open: options :if_blocked is synonym to :if_obstructed
+  - Workbook.open: options :if_blocked is synonym to :if_obstructed
   - Simplified Code
 
 ## [1.10]

data/README.rdoc

@@ -2,17 +2,18 @@
 
 RobustExcelOle helps controlling Excel. 
 This obviously includes standard tasks like reading and writing Excel workbooks.
+
+RobustExcelOle objects wrap WIN32OLE objects, like workbooks, worksheets and ranges. 
+All applicable VBA methods can be sent to those objects. 
+For solving complex tasks, convenient methods are added.
+
 The gem is designed to manage simultaneously running Excel instances, even with simultanously happening user interactions. 
+It supports handling workbooks across those Excel instances by keeping track of workbooks and instances. Conflicts are managed before Excel notices.
 
 RobustExcelOle deals with various cases of Excel (and user) behaviour, and
 supplies workarounds for some Excel and JRuby bugs. 
 
-It supports handling workbooks across Excel instances by keeping track of workbooks and instances. Conflicts are managed before Excel notices.
-
-Library references are supported.
-
-RobustExcelOle works by sending VBA methods via WIN32OlE. 
-Therefore, it runs on Windows only.
+Because it uses VBA methods, RobustExcelOle runs on Windows only.
 
 == Features
 
@@ -101,27 +102,24 @@ Now we want to write a new value into this cell.
 
   workbook['firstcell'] = "new"
 
-Then we'll save the workbook.
+Then we'll save and close the workbook.
 
   workbook.save
+  workbook.close
 
 === Unobtrusively opening workbooks
 
 RobustExcelOle allows unobtrusively reading and modifying workbooks, i.e. accessing workbooks without changing their "status". The status comprises whether the workbook is open or closed, saved or unsaved, read-only or writable, visible or invisible, whether the calculation mode is manual or automatic, and checking compatibility is done or not done.
 
-  Workbook.unobtrusively('spec/data/workbook.xls') do |workbook|
-    # do something
-  end
-
   Workbook.for_modifying('spec/data/workbook.xls') do |workbook|
-    # do something
+    workbook.sheet(1)[1,1] = "bar"
   end
 
   Workbook.for_reading('spec/data/workbook.xls') do |workbook|
-    # do something
+    value = workbook.sheet(1)[1,1]
   end
 
-=== More featrues about creating, opening, saving and closing workbooks 
+=== More features about creating and opening workbooks 
 
 We can create a new, empty workbook. 
 
@@ -133,73 +131,25 @@ Moreover, we can open the workbook using a block, similar to, e.g., +File.open+.
     # do something
   end
 
-Once we have a workbook, we can set some options, e.g.
-
-  workbook.for_this_workbook(visible: true, read_only: false)
-
-We can also open the workbook and provide the options in one step, e.g.
-
-  workbook = Workbook.open('spec/data/workbook.xls', visible: true)
-
-or, using abbreviations,
-
-  workbook = Workbook.open('spec/data/workbook.xls', v: true)
-
 Note that +Workbook.open+ can also connect to workbooks which were not opened via RobustExcelOle (but had been opened before by some user).
 
-For more details about opening workbooks see {README_open}[https://github.com/Thomas008/robust_excel_ole/blob/master/docs/README_open.rdoc]
- 
-We can do a simple save
-
-  workbook.save
-
-or save the workbook under a different name.
-
-  workbook.save_as('spec/data/new_workbook.xls')
-
-Finally we can close the workbook
-
-  workbook.close
-
-or save and close the workbook in one step.
-
-  workbook.close(if_unsaved: :save)
-
-For more details about saving and closing workbooks see
-{README_save_close}[https://github.com/Thomas008/robust_excel_ole/blob/master/docs/README_save_close.rdoc]
-
-
-=== Using Excel instances
-
-We can start a new Excel instance with
-
-  excel1 = Excel.create
-
-or
+For more details about opening workbooks see {README_open}[https://github.com/Thomas008/robust_excel_ole/blob/master/docs/README_open.rdoc].
+For saving and closing workbooks see
+{README_save_close}[https://github.com/Thomas008/robust_excel_ole/blob/master/docs/README_save_close.rdoc].
 
-  excel1 = Excel.new(reuse: false)
-
-We can also obtain an Excel object by connecting to the already running Excel instance.
-
-  excel2 = Excel.current
-
-or 
-
-  excel2 = Excel.new(reuse: true)  
-
-We close the Excel instance using
-
-  excel1.close
+=== Managing conflicts with unsaved and blocking workbooks
 
-Closing all Excel instances is done by
+RobustExcelOle enables processing workbooks, while supporting user's interactions: The commands enable to open, close, reopen, read, modify, write and save Excel workbooks, without the need of the user's interaction, and even without the user noticing. Thus, while running a script containing RobustExcelOle commands, the user can open and process workbooks in any Excel instances at any time. RobustExcelOle manages the complex cases of conflicts that might occur such that the user does not need to interfere and the script can continue.
 
-  Excel.close_all(if_unsaved: :forget)
+For example, suppose we want to process a list of workbooks. RobustExcelOle allows to rapidly open, manipulate, close and save these workbooks. Now assume, the workbook "workbook.xls" is being processed, while the user has already opened this workbook, has modified but not saved it yet. Excel would prompt a message and ask the user what to do. RobustExcelOle solves this conflict by using an option that states whether the changes of the user should be saved (accepted) or discarded (forgotten) before opening the workbook, e.g.
 
-For hard terminating all Excel processes we can use
+  workbook = Workbook.open('workbook.xls', if_unsaved: :accept)
 
-  Excel.kill_all
+Similarly, if the user has opened a workbook that has the same name but a different path, the conflict can be solved via an option.
 
-For more details about opening Excel instances see {README_excel}[https://github.com/Thomas008/robust_excel_ole/blob/master/docs/README_excel.rdoc]
+  workbook1 = Workbook.open('spec/data/workbook.xls')
+  # do something
+  workbook2 = Workbook.open('spec/data/more/workbook.xls', if_blocked: :forget)
 
 
 === Opening workbooks in several Excel instances
@@ -223,25 +173,11 @@ If the Excel instance is damaged or closed, then options control whether the wor
 
   workbook1 = Workbook.open('spec/data/workbook.xls', default: {excel: new})
 
-Without the option +:default+, the workbook can be forced to be opened in the current, new or given Excel instance, no matter if and where it was opened before, e.g.
+Without the option +:default+, the workbook can be forced to be opened in the current, a new or a given Excel instance, no matter if and where it was opened before, e.g.
 
   workbook2 = Workbook.open('spec/data/workbook.xls', excel: new)
 
-=== Managing conflicts with unsaved and blocking workbooks
-
-RobustExcelOle enables processing workbooks, while supporting user's interactions: The commands enable to open, close, reopen, read, modify, write and save Excel workbooks, without the need of the user's interaction, and even without the user noticing. Thus, while running a script containing RobustExcelOle commands, the user can open and process workbooks in any Excel instances at any time. RobustExcelOle manages the complex cases of conflicts that might occur such that the user does not need to interfere and the script can continue.
-
-For example, suppose we want to process a list of workbooks. RobustExcelOle allows to rapidly open, manipulate, close and save these workbooks. Now assume, the workbook "workbook.xls" is being processed, while the user has already opened this workbook, has modified but not saved it yet. Excel would prompt a message and ask the user what to do. RobustExcelOle solves this conflict by using an option that states whether the changes of the user should be saved (accepted) or discarded (forgotten) before opening the workbook, e.g.
-
-  workbook = Workbook.open('workbook.xls', if_unsaved: :accept)
-
-Similarly, if the user has opened a workbook that has the same name but a different path, the conflict can be solved via an option.
-
-  workbook1 = Workbook.open('spec/data/workbook.xls')
-  # do something
-  workbook2 = Workbook.open('spec/data/more/workbook.xls', if_blocked: :forget)
-
-For more details about opening and closing workbooks in Excel instances see {README_open}[https://github.com/Thomas008/robust_excel_ole/blob/master/docs/README_open.rdoc]
+For more details about opening Excel instances see {README_open}[https://github.com/Thomas008/robust_excel_ole/blob/master/docs/README_open.rdoc] and {README_excel}[https://github.com/Thomas008/robust_excel_ole/blob/master/docs/README_excel.rdoc]. 
 
 === Operating on worksheets
 
@@ -264,7 +200,7 @@ We can copy the first worksheet, name it and add it before the third worksheet.
 
   workbook.add_or_copy_sheet(sheet, as: "copied_name, before: workbook.last_sheet)
 
-For more details about processing worksheets see {README_sheet}[https://github.com/Thomas008/robust_excel_ole/blob/master/docs/README_sheet.rdoc]
+For more details about processing worksheets see {README_sheet}[https://github.com/Thomas008/robust_excel_ole/blob/master/docs/README_sheet.rdoc].
 
 === Reading and writing ranges in worksheets
 
@@ -290,13 +226,13 @@ For more details about reading and writing contents of cells and ranges see {REA
 
 === List Objects (Tables)
 
-We can define a list object (or table) from scratch
+We obtain a given list object in a worksheet given its table number or name.
 
-  table = ListObject.new(worksheet, "table 1", [1,1], 3, ["Person","AmountSales"])
+  table = worksheet.table(1) 
 
-or get a given list object in a worksheet given its table number or name.
+We can also define a list object from scratch
 
-  table = worksheet.table(1) 
+  table = ListObject.new(worksheet, "table 1", [1,1], 3, ["Person","AmountSales"])
 
 A list row can be accessed by providing either the row number or a key, i.e. hash of column name - value pairs, e.g.
 
@@ -325,7 +261,7 @@ We can also read all values in a row.
   table[1].to_h
   # => {"Person": "John", "AmountSales": 40}
 
-For more details about using and processing list objects see {README_listobjects}[https://github.com/Thomas008/robust_excel_ole/blob/master/docs/README_listobjects.rdoc]
+For more details about using and processing list objects see {README_listobjects}[https://github.com/Thomas008/robust_excel_ole/blob/master/docs/README_listobjects.rdoc].
 
 === More features
 

data/docs/README_excel.rdoc

@@ -1,10 +1,11 @@
-= RobustExcelOle
+== Managing Excel instances
 
-== Creating, using and closing Excel instances
+Details are essentially covered in the ruby documentation of the class
+Excel[https://www.rubydoc.info/gems/robust_excel_ole/RobustExcelOle/Excel].
 
-RobustExcelOle enables simultanously running Excel instances. An Excel application is represented by an Excel object.
+=== Creating, using and closing Excel instances
 
-=== Creating and reusing an Excel instance.
+RobustExcelOle enables simultanously running Excel instances. An Excel application is represented by an Excel object.
 
 You can create a new Excel instance by
 
@@ -168,6 +169,4 @@ This method has the option +:if_unsaved+ as described above. For example, if you
 
 This method kills all Excel instances no matter whether they contain unsaved workbooks.  
 
-== Code
 
-excel.rb[https://github.com/Thomas008/robust_excel_ole/blob/master/lib/robust_excel_ole/excel.rb]

data/docs/README_listobjects.rdoc

@@ -1,7 +1,9 @@
-= RobustExcelOle
-
 == List Objects
 
+A List object in a worksheet represents a table.
+The details are essentially covered in the ruby docmentation of the class
+ListObject[https://www.rubydoc.info/gems/robust_excel_ole/RobustExcelOle/ListObject].
+
 === Creating List Objects
 
 We can define a list object (or table) from scratch.
@@ -54,20 +56,14 @@ or
 or
 
   row1["AmountSales"] = 40
-  
-Similarly you can get the values.
-
-  row1.AmountSales
-  # => 40
 
 or
 
-  row1.amount_sales
-  # => 40
-
-or
+  row1[:AmountSales] = 40
+  
+Similarly you can get the values, e.g.
 
-  row1["AmountSales"]
+  row1.amount_sales
   # => 40
 
 We can also read the values in a whole row.
@@ -170,7 +166,4 @@ You can sort a table according to a given column and sort order, e.g.
 
   table.sort("Person", :ascending)
 
-== Code
-
-listobjects.rb[https://github.com/Thomas008/robust_excel_ole/blob/master/lib/robust_excel_ole/listobjects.rb]
 

data/docs/README_open.rdoc

@@ -1,6 +1,9 @@
-= RobustExcelOle
+== Opening workbooks
 
-=== Opening a workbook.
+The details are essentially covered in the ruby documentation of the 
+class Workbook[https://www.rubydoc.info/gems/robust_excel_ole/RobustExcelOle/Workbook].
+
+=== How to open a workbook
 
 If you want to open a workbook, you can use the methods +open+ or +new+.
   
@@ -36,12 +39,12 @@ The options are the following:
 
 +:if_unsaved+::        specifies behaviour if the workbook was unsaved (default: +:raise+)
 
-+:if_blocked::         specifies behaviour if the workbook is blocked by another book (default: +:raise+)
++:if_blocked+::         specifies behaviour if the workbook is blocked by another book (default: +:raise+)
 
 
-+:read_only+::          opens in read-only mode (default: +false+)
++:read_only+::          opens in read-only (+true+) or read-write mode (+false+) (default: +false+)
 
-+:check_compatibility:: checks compatibility when saving
++:check_compatibility+:: checks compatibility when saving
 
 +:calculation+::        forces the calculation mode to be manual (:manual) or automatic (:automatic)
 
@@ -49,39 +52,40 @@ The options are the following:
 
 You can use the following abbreviations or synonyms: +:f+ for  +:force+, +:d+ for +:default+, +:e+ for +:excel+, and +:v+ for +:visible+, +:if_obstructed+ for +:if_blocked+. Finally you can leave out the option +:force+ or +:f+.
 
-The option +:excel+ :
+=== The option +:excel+ :
 
 Valid values are : +:current+ (or +:active+ or +:reuse+), +:new+, or a given Excel instance (default: +:current).
 
-The option +:if_unsaved+  : 
+=== The option +:if_unsaved+  : 
 
-If a workbook contains unsaved changes and a new workbook with the same file name shall be opened, then
+If a workbook contains unsaved changes and the workbook shall be re-opened, then
 
-+:raise+::   Raise an exeption. Don't open the workbook.
-+:accept+::  Let the unsaved workbook open.
++:raise+::   Raise an exeption. Leave the unsaved workbook open.
++:accept+::  Leave the unsaved workbook open.
 +:forget+::  Discard any changes and reopen the workbook.
 +:save+::    Save any changes and reopen the workbook
-+:new_excel+:: Open the new workbook in a new Excel instance
++:new_excel+:: Open the workbook in a new Excel instance
 +:alert+::   Give control to Excel.
 
-The option +:if_blocked+ : 
+=== The option +:if_blocked+ : 
 
-If a workbook is open and a new workbook with same name and a different path is open, then
+If a workbook is open and a workbook with same base name but in a different path shall be opened, then the first workbook blocks opening the latter one. In this case:
 
-+:raise+::          Raise an exception. Don't open the workbook.
-+:forget+::         Close the old workbook, open the new workbook.
-+:save+::           Save the old workbook, close it, open the new workbook
-+:close_if_saved+:: Close the old workbook and open the new workbook, if the old workbook is saved, otherwise raise an exception.
++:raise+::          Raise an exception. Don't open the workbook. Leave the blocking workbook open.
++:forget+::         Close the blocking workbook, open the new workbook.
++:accept+::         Leave the blocking workbook open.
++:save+::           Save the blocking workbook, close it, open the new workbook
++:close_if_saved+:: Close the blocking workbook and open the new workbook, if the blocking workbook is saved, otherwise raise an exception.
 +:new_excel+::      Open the new workbook in a new Excel instance.
 
-The option +:if_absent  :
+=== The option +:if_absent+ :
 
 If the Excel file does not exists, then
 
 +:create+::   Create a new Excel file
 +:raise+::    Raise an exception.
   
-Here are a few examples:
+=== Examples:
 
 If you want to open a workbook that was not opened before, or reopen a workbook that was open in an Excel instance that is now closed, in the current (active) Excel instance, then use
 
@@ -129,21 +133,23 @@ If a workbook is open and a workbook with the same name but in different path sh
 
   workbook = Workbook.open('path/workbook.xls', if_blocked: :forget)
 
-Remarks:
+=== Remarks
 
 The methods +open+ and +new+ connect to workbooks opened outside of RobustExcelOle as well.
 
-Opening linked workbooks for EXCEL 2007 is supported
+Opening linked workbooks for EXCEL 2007 is supported. Changing linked, unsaved workbooks from read-only to read-write causes a query whether to save the changes. This case cannot be
+controlled (e.g. with help of some options) so far.
 
 Doing updating links seems to be dependent on calculation mode: updates happen, if the calcultion mode is automatic, and does not happen, if calculation mode is manual.
 
-=== Reopening a workbook.
+
+=== Reopening a workbook
 
 A special feature of RobustExcelOle is that it allows to reopen workbooks after closing them.
 
   workbook = Workbook.open('spec/data/workbook.xls')
   workbook.close
-  workbook.reopen
+  workbook.open
 
 The closed workbook is now alive again, i.e. is open and responds to Excel methods.
 
@@ -176,7 +182,7 @@ You can also supply a workbook and options, e.g.
 
    new_workbook = Workbook.new(workbook, visible: true)
 
-=== Identity transperence ===
+=== Identity transperence
 
 A RobustExcelOle Workbook object is a proxy of an Excel WIN32OLE workbook. A Workbook object is defined by the full workbook name and the Excel instance in which it is opened. RobustExcelOle ensures identity transparency which means that identical Workbook objects refer to identical Excel workbooks, and vice versa. Identity transperence ensures that, no matter how a Workbook object was created - by filename or by type-lifting an Excel workbook - two Workbook objects are identical, if and only if the Excel workbooks, they are referring to, are identical. 
 
@@ -245,13 +251,33 @@ This method ensures keeping the save status of the workbook
     # some reading or modifying
   end
 
-=== Checking whether the workbook is alive.
+=== Changing ReadOnly-mode
+
+When you want to change the read-only mode, you can use the method +writable=+. 
+
+  workbook = Workbook('spec/data/workbook.xls')
+  workbook.writable = false
+  workbook.writable
+  # => false
+  workbook.ReadOnly
+  # => true
+  workbook.writable = true
+
+If the workbook is unsaved, use the option +if_unsaved+ as desribed above.
+
+  workbook.writable = false, {if_unsaved: :forget}
+
+Changing from read-only to read-write for linked, unsaved workbooks is not being supported yet.
+
+=== Checking whether the workbook is alive
 
 The method +alive?+ finds out whether the Excel workbook that is referenced by the Workbook object responds to methods. For example
 
   workbook.alive?
   # => true
 
-== Code
+=== Setting options
+
+Once we have a workbook, we can set some options, e.g.
 
-workbook.rb[https://github.com/Thomas008/robust_excel_ole/blob/master/lib/robust_excel_ole/workbook.rb]
+  workbook.for_this_workbook(visible: true, read_only: false)

data/docs/README_ranges.rdoc

@@ -1,9 +1,10 @@
-= RobustExcelOle
-
-== Reading and writing the contents of ranges and cells
+== Ranges and cells
 
 RobustExcelOle enables to read and write the contents of ranges and cells in workbooks. This can be done from a Worksheet, a Workbook or an Excel object representing a Worksheet, Workbook, or Application object, respectively. You can use VBA methods or methods provided by RobustExcelOle.
 
+The details are essentially covered in ruby documentation of the classes Range[https://www.rubydoc.info/gems/robust_excel_ole/RobustExcelOle/Range] and 
+Worksheet[https://www.rubydoc.info/gems/robust_excel_ole/RobustExcelOle/Worksheet].
+
 === Introducing Example
 
 Suppose you have opened a workbook.
@@ -26,6 +27,9 @@ or, using the A1-format,
 
   range = worksheet.range("B1")
 
+Once you have got an Range object, you can apply all VBA methods that you would apply to a VBA Range object
+(see https://docs.microsoft.com/en-us/office/vba/api/excel.range#methods).
+
 Similarly you can access a rectangular range. Using VBA methods we provide the row and column of the top left cell and the row and column of the bottum right cell. 
 
   range = worksheet.Range(sheet.Cells(1,1), sheet.Cells(3,4))
@@ -414,10 +418,3 @@ Similarly, you can write a cell.
 or
 
   worksheet.set_cellval(1,1,"new_value")
-
-
-== Code
-
-range.rb[https://github.com/Thomas008/robust_excel_ole/blob/master/lib/robust_excel_ole/range.rb]
-
-worksheet.rb[https://github.com/Thomas008/robust_excel_ole/blob/master/lib/robust_excel_ole/worksheet.rb]

data/docs/README_save_close.rdoc

@@ -1,7 +1,9 @@
-= RobustExcelOle
-
 == Saving and closing workbooks
 
+RobustExcelOle helps to control the saving and the closing of workbooks.
+The details are essentially covered in the ruby documentation of the class
+Workbook[https://www.rubydoc.info/gems/robust_excel_ole/RobustExcelOle/Workbook].
+
 === Saving a workbook.
 
 Imagine, you have opened a workbook with
@@ -76,6 +78,3 @@ Finally the workbook can be closed with a given filename.
 
   Workbook.close('spec/data/workbook.xls')
 
-== Code
-
-workbook.rb[https://github.com/Thomas008/robust_excel_ole/blob/master/lib/robust_excel_ole/workbook.rb]

data/docs/README_sheet.rdoc

@@ -1,15 +1,14 @@
-= RobustExcelOle
+== Opening and modifying worksheets
 
-== Accessing and processing worksheets
+Details are essentially covered in the ruby documentation of the class
+Worksheet[https://www.rubydoc.info/gems/robust_excel_ole/RobustExcelOle/Worksheet].
 
-Worksheets are represented by Worksheet objects.
+=== Accessing a worksheet.
 
 Assume you have opened a workbook
 
   workbook = Workbook.open('spec/data/workbook.xls', visible: true)
 
-=== Accessing a worksheet.
-
 You can access a worksheet by giving the number
 
   worksheet = book.sheet(1)
@@ -147,6 +146,3 @@ Here are some examples:
   row1.VerticalAlignment = XlVAlignCenter
   row1.HorizontalAlignment = XlHAlignLeft
 
-== Code
-
-worksheet.rb[https://github.com/Thomas008/robust_excel_ole/blob/master/lib/robust_excel_ole/worksheet.rb]

data/examples/introductory_examples/example_introductory.rb

@@ -29,7 +29,7 @@ puts "close the workbook"
 workbook.close
 # reopening the workbook
 puts "reopen the workbook"
-workbook.reopen
+workbook.open
 # further operations
 workbook['firstcell'] = "another_value"
 # saved status of the workbook

data/examples/introductory_examples/example_open.rb

@@ -46,7 +46,7 @@ puts "close the first workbook"
 book.close
 # reopen the workbook
 puts "reopen the workbook"
-book4 = book.reopen
+book4 = book.open
 puts "book4: #{book4}"
 # unobtrusively opening a workbook
 puts "unobtrusively opening the workbook"

data/examples/modifying_sheets/example_access_sheets_and_cells.rb

@@ -7,7 +7,7 @@ require "fileutils"
 
 include RobustExcelOle
 
-Excel.close_all
+Excel.close_all(if_unsaved: :forget)
 begin
   dir = create_tmpdir
   simple_file = dir + 'workbook.xls'

data/examples/modifying_sheets/example_add_names.rb

@@ -26,7 +26,7 @@ begin
 
   def define_columns sheet, columns_ids
     puts "define_columns:"
-    first_column = sheet.range("A")
+    first_column = sheet.range("A:A")
     puts "first_column: #{first_column}"
 
     columns_ids.each_with_index do |id,idx|

data/examples/modifying_sheets/example_listobjects.rb

@@ -9,7 +9,7 @@ include RobustExcelOle
 
 using StringRefinement
 
-Excel.close_all
+Excel.close_all(if_unsaved: :forget)
 begin
   dir = create_tmpdir
   table_file = dir + 'workbook_listobjects.xlsx'
@@ -79,7 +79,7 @@ begin
   book.close(:if_unsaved => :forget)
   
 ensure
-  Excel.close_all
+  Excel.close_all(if_unsaved: forget)
   rm_tmp(dir)
 end
 

data/examples/modifying_sheets/example_ranges.rb

@@ -7,7 +7,7 @@ require "fileutils"
 
 include RobustExcelOle
 
-Excel.close_all
+Excel.close_all(if_unsaved: :forget)
 begin
   dir = create_tmpdir
   simple_file = dir + 'workbook.xls'