robust_excel_ole 0.6 → 0.6.1

data/Changelog

@@ -1,6 +1,16 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
+
+## [0.6.1] - 2016-04-09
+
+### Changed
+- error classes
+
+### Added
+
+- Excel#foremost_window
+
 ## [0.6] - 2016-03-08
 
 ## [0.5.2] - 2016-17-07
@@ -11,6 +21,8 @@ All notable changes to this project will be documented in this file.
   (:active, :reuse as alias)
 - Book: open: options: deleted :displayalerts
 - Excel: create, current: with options :visible, :displayalerts
+
+### Added
 - Excel: create, current, new: new options-value :displayalerts => :if_visible
 
 ## [0.5.1] - 2016-18-06

data/README.rdoc

@@ -44,11 +44,13 @@ Options are
   +:default_excel+, +:force_excel+, +:if_absent+, +:if_unsaved+, +:if_obstructed+, 
   +:read_only+, +:visible+, +:check_compatibility, and +:update_links+. 
 
-Valid values for +:default_excel+ are +:current+ (or +:active+, or +:reuse+), +:new+ or some Excel instance, for +:force_excel+ : +:current+ (or +:active+, or +:reuse+), +:new+ or some Excel instance, for +:if_unsaved+ : +:raise+, +:accept+, +:forget+, +:alert+ and +:new_excel+, for +:if_obstructed+ : +:raise+, +:save+, +:close_if_saved+, +:forget+, +:alert+ and +:new_excel+ , for +:if_absent+ : +:raise+ and +:create+. The others are Boolean.
+Valid values for +:default_excel+ are +:current+ (or +:active+, or +:reuse+), +:new+ or some Excel instance, for +:force_excel+ : +:current+ (or +:active+, or +:reuse+), +:new+ or some Excel instance, for +:if_unsaved+ : +:raise+, +:accept+, +:forget+, +:alert+ and +:new_excel+, for +:if_obstructed+ : +:raise+, +:save+, +:close_if_saved+, +:forget+, +:alert+ and +:new_excel+ , for +:if_absent+ : +:raise+ and +:create+, for +:update_links+ : +:never+, +:always+, +:alert+. The others are Boolean.
+
+Remark: Doing updating links seems to be dependent on calculation mode: updates happen, if the calcultion mode is automatic, does not happen, if calculation mode is manual.
 
 Here are a few examples:
 
-Opening a workbook in the Excel instance where it was opened before most recently, if it was opened before and this Excel instance is alive. Otherwise opening it in a running Excel, if it exists, or in a new Excel.
+Opening a workbook in the Excel instance where it was opened before most recently, if it was opened beefore and this Excel instance is alive. Otherwise opening it in a running Excel, if it exists, or in a new Excel.
 
 Opening a workbook in the Excel instance where it was opened before most recently, if it was opened before and this Excel instance is alive. Otherwise opening it in a new Excel instance.
 
@@ -428,7 +430,7 @@ Closing the Excel instance, saving unsaved workbooks and terminating the Excel p
 
   excel.close(:if_unsaved => :save, :hard => true)
 
-=== Closing all Excel instances.
+=== Closing Excel instances opened via RobustExcelOle.
 
   Excel.close_all
 

data/README_detail.rdoc

@@ -507,7 +507,7 @@ Closing the Excel instance, saving unsaved workbooks and terminating the Excel p
 
   excel.close(:if_unsaved => :save, :hard => true)
 
-=== Closing all Excel instances.
+=== Closing Excel instances opened via RobustExcelOle
 
   Excel.close_all
 

data/examples/edit_sheets/example_adding_sheets.rb

@@ -56,7 +56,7 @@ begin
   puts"adding a copy of the 2nd sheet and name it again 'second_sheet_copy'"
   begin
     @book.add_sheet(sheet, :as => 'second_sheet_copy')
-  rescue ExcelErrorSheet => msg
+  rescue NameAlreadyExists => msg
     puts "error: add_sheet: #{msg.message}"
   end    
 

data/examples/edit_sheets/example_expanding.rb

@@ -33,7 +33,7 @@ begin
       sheet_new = book.add_sheet sheet
       begin
         sheet_new.name = sheet_name
-      rescue ExcelErrorSheet => msg
+      rescue REOError => msg
         sheet_new.name = sheet_name + sheet.name if msg.message == "sheet name already exists" 
       end
       sheet_new.set_name("name", 2, 2)

data/examples/open_save_close/example_control_to_excel.rb

@@ -26,13 +26,13 @@ begin
   Excel.current.visible = true
   begin
   	book.close(:if_unsaved => :alert)                      # close the unsaved book. 
-  rescue ExcelUserCanceled => msg                          # user is asked whether the unsaved book shall be saved
+  rescue WorkbookError => msg                          # user is asked whether the unsaved book shall be saved
   	puts "#{msg.message}"                                  # if the user chooses to cancel, then an expeption is raised
   end
   if new_book then
   	begin
   	  new_book.save_as(file_name, :if_exists => :alert)    # save the new book, if it was opened
-  	rescue ExcelErrorSave => msg                           # user is asked, whether the existing file shall be overwritten
+  	rescue WorkbookError => msg                           # user is asked, whether the existing file shall be overwritten
   	  puts "save_as: #{msg.message}"                       # if the user chooses "no" or "cancel", an exception is raised
   	end 
 

data/examples/open_save_close/example_if_obstructed_closeifsaved.rb

@@ -20,7 +20,7 @@ begin
   sleep 1
   begin
     new_book = Book.open(other_file_name, :if_obstructed => :close_if_saved) # raises an exception since the file is not saved
-    rescue ExcelErrorOpen => msg                                             
+    rescue WorkbookNotSaved => msg                                             
     puts "error: open: #{msg.message}"
   end                                                        
   book.save                                                           # save the unsaved book

data/examples/open_save_close/example_if_obstructed_forget.rb

@@ -16,7 +16,7 @@ begin
   sleep 3 
   begin
     new_book = Book.open(other_file_name)        # open a book with the same file name in a different path
-  rescue ExcelErrorOpen => msg                   # by default: raises an exception 
+  rescue WorkbookBlocked => msg                   # by default: raises an exception 
   	puts "error: open: #{msg.message}"
   end
   # open a new book with the same file name in a different path. close the old book before.

data/examples/open_save_close/example_if_unsaved_accept.rb

@@ -16,7 +16,7 @@ begin
   sheet[1,1] = sheet[1,1].value == "simple" ? "complex" : "simple" # change a cell
   begin
     new_book = Book.open(file_name)                # open another book with the same file name
-  rescue ExcelErrorOpen => msg                     # by default: raises an exception:
+  rescue WorkbookBeingUsed => msg                     # by default: raises an exception:
     puts "error: open: #{msg.message}"              # a book with the same name is already open and unsaved 
   end
   new_book = Book.open(file_name, :if_unsaved => :accept) # open another book with the same file name 
@@ -29,7 +29,7 @@ begin
   end
   begin                                                                   
   	book.close                                          # close the book. by default: raises an exception:
-  rescue ExcelErrorClose => msg                         #   book is unsaved
+  rescue WorkbookNotSaved => msg                         #   book is unsaved
   	puts "close error: #{msg.message}"
   end
   book.close(:if_unsaved => :save)                      # save the book before closing it 

data/examples/open_save_close/example_read_only.rb

@@ -18,7 +18,7 @@ begin
   sleep 1
   begin
     book.save                                         # simple save. 
-  rescue ExcelErrorSave => msg                        # raises an exception because book is opened in read_only mode
+  rescue WorkbookReadOnly => msg                        # raises an exception because book is opened in read_only mode
     puts "error: save_as: #{msg.message}"
   end
   book.close                                          # close the book without saving it 

data/examples/open_save_close/example_simple.rb

@@ -25,7 +25,7 @@ begin
   book.save                                                  # simple save
   begin
   	book.save_as(other_file_name)                            # save_as :  default :if_exists => :raise 
-  rescue ExcelErrorSave => msg
+  rescue FileAlreadyExists => msg
   	puts "error: save_as: #{msg.message}"
   end
   book.save_as(other_file_name, :if_exists => :overwrite)    # save_as with :if_exists => :overwrite