module RubyXL::WorksheetConvenienceMethods

Constants

BOLD
COLOR
ITALICS
NAME
SIZE
STRIKETHROUGH
UNDERLINE

Public Instance Methods

change_column_alignment(column_index, &block) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 789
def change_column_alignment(column_index, &block)
  validate_workbook
  ensure_cell_exists(0, column_index)

  cols.get_range(column_index).style_index = @workbook.modify_alignment(get_col_style(column_index), &block)
  # Excel gets confused if width is not explicitly set for a column that had alignment changes
  change_column_width(column_index) if get_column_width_raw(column_index).nil?

  sheet_data.rows.each { |row|
    c = row[column_index]
    next if c.nil?
    c.style_index = @workbook.modify_alignment(c.style_index, &block)
  }
end
change_column_bold(column_index, bolded = false) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 722
def change_column_bold(column_index, bolded = false)
  xf = get_col_xf(column_index)
  font = @workbook.fonts[xf.font_id].dup
  font.set_bold(bolded)
  change_column_font(column_index, Worksheet::BOLD, bolded, font, xf)
end
change_column_border(column_index, direction, weight) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 751
def change_column_border(column_index, direction, weight)
  validate_workbook
  ensure_cell_exists(0, column_index)

  cols.get_range(column_index).style_index = @workbook.modify_border(get_col_style(column_index), direction, weight)

  sheet_data.rows.each { |row|
    c = row.cells[column_index]
    c.change_border(direction, weight) unless c.nil?
  }
end
change_column_border_color(column_index, direction, color) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 763
def change_column_border_color(column_index, direction, color)
  validate_workbook
  ensure_cell_exists(0, column_index)
  Color.validate_color(color)

  cols.get_range(column_index).style_index = @workbook.modify_border_color(get_col_style(column_index), direction, color)

  sheet_data.rows.each { |row|
    c = row.cells[column_index]
    c.change_border_color(direction, color) unless c.nil?
  }
end
change_column_fill(column_index, color_code = 'ffffff') click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 519
def change_column_fill(column_index, color_code = 'ffffff')
  validate_workbook
  RubyXL::Color.validate_color(color_code)
  ensure_cell_exists(0, column_index)

  cols.get_range(column_index).style_index = @workbook.modify_fill(get_col_style(column_index), color_code)

  sheet_data.rows.each { |row|
    c = row[column_index]
    c.change_fill(color_code) if c
  }
end
change_column_font(column_index, change_type, arg, font, xf) click to toggle source

Helper method to update the fonts and cell styles array main method to change font, called from each separate font mutator method

# File lib/rubyXL/convenience_methods.rb, line 679
def change_column_font(column_index, change_type, arg, font, xf)
  validate_workbook
  ensure_cell_exists(0, column_index)

  xf = workbook.register_new_font(font, xf)
  cols.get_range(column_index).style_index = workbook.register_new_xf(xf)

  sheet_data.rows.each { |row|
    c = row && row[column_index]
    c.font_switch(change_type, arg) unless c.nil?
  }
end
change_column_font_color(column_index, font_color='000000') click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 706
def change_column_font_color(column_index, font_color='000000')
  Color.validate_color(font_color)

  xf = get_col_xf(column_index)
  font = @workbook.fonts[xf.font_id].dup
  font.set_rgb_color(font_color)
  change_column_font(column_index, Worksheet::COLOR, font_color, font, xf)
end
change_column_font_name(column_index = 0, font_name = 'Verdana') click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 692
def change_column_font_name(column_index = 0, font_name = 'Verdana')
  xf = get_col_xf(column_index)
  font = @workbook.fonts[xf.font_id].dup
  font.set_name(font_name)
  change_column_font(column_index, Worksheet::NAME, font_name, font, xf)
end
change_column_font_size(column_index, font_size=10) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 699
def change_column_font_size(column_index, font_size=10)
  xf = get_col_xf(column_index)
  font = @workbook.fonts[xf.font_id].dup
  font.set_size(font_size)
  change_column_font(column_index, Worksheet::SIZE, font_size, font, xf)
end
change_column_horizontal_alignment(column_index, alignment = 'center') click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 743
def change_column_horizontal_alignment(column_index, alignment = 'center')
  change_column_alignment(column_index) { |a| a.horizontal = alignment }
end
change_column_italics(column_index, italicized = false) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 715
def change_column_italics(column_index, italicized = false)
  xf = get_col_xf(column_index)
  font = @workbook.fonts[xf.font_id].dup
  font.set_italic(italicized)
  change_column_font(column_index, Worksheet::ITALICS, italicized, font, xf)
end
change_column_strikethrough(column_index, struckthrough=false) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 736
def change_column_strikethrough(column_index, struckthrough=false)
  xf = get_col_xf(column_index)
  font = @workbook.fonts[xf.font_id].dup
  font.set_strikethrough(struckthrough)
  change_column_font(column_index, Worksheet::STRIKETHROUGH, struckthrough, font, xf)
end
change_column_underline(column_index, underlined = false) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 729
def change_column_underline(column_index, underlined = false)
  xf = get_col_xf(column_index)
  font = @workbook.fonts[xf.font_id].dup
  font.set_underline(underlined)
  change_column_font(column_index, Worksheet::UNDERLINE, underlined, font, xf)
end
change_column_vertical_alignment(column_index, alignment = 'center') click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 747
def change_column_vertical_alignment(column_index, alignment = 'center')
  change_column_alignment(column_index) { |a| a.vertical = alignment }
end
change_column_width(column_index, width_in_chars = RubyXL::ColumnRange::DEFAULT_WIDTH) click to toggle source

Get column width measured in number of digits, as per msdn.microsoft.com/en-us/library/documentformat.openxml.spreadsheet.column%28v=office.14%29.aspx

# File lib/rubyXL/convenience_methods.rb, line 502
def change_column_width(column_index, width_in_chars = RubyXL::ColumnRange::DEFAULT_WIDTH)
  change_column_width_raw(column_index, ((width_in_chars + (5.0 / RubyXL::Font::MAX_DIGIT_WIDTH)) * 256).to_i / 256.0)
end
change_column_width_raw(column_index, width) click to toggle source

Set raw column width value

# File lib/rubyXL/convenience_methods.rb, line 492
def change_column_width_raw(column_index, width)
  validate_workbook
  ensure_cell_exists(0, column_index)
  range = cols.get_range(column_index)
  range.width = width
  range.custom_width = true
end
change_row_alignment(row, &block) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 776
def change_row_alignment(row, &block)
  validate_workbook
  validate_nonnegative(row)
  ensure_cell_exists(row)

  sheet_data.rows[row].style_index = @workbook.modify_alignment(get_row_style(row), &block)

  sheet_data[row].cells.each { |c|
    next if c.nil?
    c.style_index = @workbook.modify_alignment(c.style_index, &block)
  }
end
change_row_bold(row = 0, bolded = false) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 647
def change_row_bold(row = 0, bolded = false)
  ensure_cell_exists(row)
  font = row_font(row).dup
  font.set_bold(bolded)
  change_row_font(row, Worksheet::BOLD, bolded, font)
end
change_row_border(row, direction, weight) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 573
def change_row_border(row, direction, weight)
  validate_workbook
  ensure_cell_exists(row)

  sheet_data.rows[row].style_index = @workbook.modify_border(get_row_style(row), direction, weight)

  sheet_data[row].cells.each { |c|
    c.change_border(direction, weight) unless c.nil?
  }
end
change_row_border_color(row, direction, color = '000000') click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 584
def change_row_border_color(row, direction, color = '000000')
  validate_workbook
  ensure_cell_exists(row)
  Color.validate_color(color)

  sheet_data.rows[row].style_index = @workbook.modify_border_color(get_row_style(row), direction, color)

  sheet_data[row].cells.each { |c|
    c.change_border_color(direction, color) unless c.nil?
  }
end
change_row_fill(row_index = 0, rgb = 'ffffff') click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 596
def change_row_fill(row_index = 0, rgb = 'ffffff')
  validate_workbook
  ensure_cell_exists(row_index)
  Color.validate_color(rgb)

  sheet_data.rows[row_index].style_index = @workbook.modify_fill(get_row_style(row_index), rgb)
  sheet_data[row_index].cells.each { |c| c.change_fill(rgb) unless c.nil? }
end
change_row_font(row_index, change_type, arg, font) click to toggle source

Helper method to update the row styles array change_type - NAME or SIZE or COLOR etc main method to change font, called from each separate font mutator method

# File lib/rubyXL/convenience_methods.rb, line 608
def change_row_font(row_index, change_type, arg, font)
  validate_workbook
  ensure_cell_exists(row_index)

  xf = workbook.register_new_font(font, get_row_xf(row_index))
  row = sheet_data[row_index]
  row.style_index = workbook.register_new_xf(xf)
  row.cells.each { |c| c.font_switch(change_type, arg) unless c.nil? }
end
change_row_font_color(row = 0, font_color = '000000') click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 632
def change_row_font_color(row = 0, font_color = '000000')
  ensure_cell_exists(row)
  Color.validate_color(font_color)
  font = row_font(row).dup
  font.set_rgb_color(font_color)
  change_row_font(row, Worksheet::COLOR, font_color, font)
end
change_row_font_name(row = 0, font_name = 'Verdana') click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 618
def change_row_font_name(row = 0, font_name = 'Verdana')
  ensure_cell_exists(row)
  font = row_font(row).dup
  font.set_name(font_name)
  change_row_font(row, Worksheet::NAME, font_name, font)
end
change_row_font_size(row = 0, font_size=10) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 625
def change_row_font_size(row = 0, font_size=10)
  ensure_cell_exists(row)
  font = row_font(row).dup
  font.set_size(font_size)
  change_row_font(row, Worksheet::SIZE, font_size, font)
end
change_row_height(row = 0, height = 10) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 668
def change_row_height(row = 0, height = 10)
  validate_workbook
  ensure_cell_exists(row)

  c = sheet_data.rows[row]
  c.ht = height
  c.custom_height = true
end
change_row_horizontal_alignment(row = 0, alignment = 'center') click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 561
def change_row_horizontal_alignment(row = 0, alignment = 'center')
  validate_workbook
  validate_nonnegative(row)
  change_row_alignment(row) { |a| a.horizontal = alignment }
end
change_row_italics(row = 0, italicized = false) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 640
def change_row_italics(row = 0, italicized = false)
  ensure_cell_exists(row)
  font = row_font(row).dup
  font.set_italic(italicized)
  change_row_font(row, Worksheet::ITALICS, italicized, font)
end
change_row_strikethrough(row = 0, struckthrough=false) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 661
def change_row_strikethrough(row = 0, struckthrough=false)
  ensure_cell_exists(row)
  font = row_font(row).dup
  font.set_strikethrough(struckthrough)
  change_row_font(row, Worksheet::STRIKETHROUGH, struckthrough, font)
end
change_row_underline(row = 0, underlined=false) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 654
def change_row_underline(row = 0, underlined=false)
  ensure_cell_exists(row)
  font = row_font(row).dup
  font.set_underline(underlined)
  change_row_font(row, Worksheet::UNDERLINE, underlined, font)
end
change_row_vertical_alignment(row = 0, alignment = 'center') click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 567
def change_row_vertical_alignment(row = 0, alignment = 'center')
  validate_workbook
  validate_nonnegative(row)
  change_row_alignment(row) { |a| a.vertical = alignment }
end
column_font(col) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 548
def column_font(col)
  validate_workbook

  @workbook.fonts[@workbook.cell_xfs[get_cols_style_index(col)].font_id]
end
delete_cell(row_index = 0, column_index=0, shift=nil) click to toggle source

by default, only sets cell to nil if :left is specified, method will shift row contents to the right of the deleted cell to the left if :up is specified, method will shift column contents below the deleted cell upward

# File lib/rubyXL/convenience_methods.rb, line 232
def delete_cell(row_index = 0, column_index=0, shift=nil)
  validate_workbook
  validate_nonnegative(row_index)
  validate_nonnegative(column_index)

  row = sheet_data[row_index]
  old_cell = row && row[column_index]

  case shift
  when nil then
    row.cells[column_index] = nil if row
  when :left then
    row.delete_cell_shift_left(column_index) if row
  when :up then
    (row_index...(sheet_data.size - 1)).each { |index|
      c = sheet_data.rows[index].cells[column_index] = sheet_data.rows[index + 1].cells[column_index]
      c.row -= 1 if c.is_a?(Cell)
    }
  else
    raise 'invalid shift option'
  end

  return old_cell
end
delete_column(column_index = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 341
def delete_column(column_index = 0)
  validate_workbook
  validate_nonnegative(column_index)

  # Delete column
  sheet_data.rows.each { |row| row.cells.delete_at(column_index) }

  # Update column numbers for cells to the right of the deleted column
  sheet_data.rows.each_with_index { |row, row_index|
    row.cells.each_with_index { |c, ci|
      c.column = ci if c.is_a?(Cell)
    }
  }

  cols.each { |range| range.delete_column(column_index) }
end
delete_row(row_index=0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 297
def delete_row(row_index=0)
  validate_workbook
  validate_nonnegative(row_index)

  deleted = sheet_data.rows.delete_at(row_index)

  # Update row number of each cell
  row_index.upto(sheet_data.size - 1) { |index|
    row = sheet_data[index]
    row && row.cells.each{ |c| c.row -= 1 unless c.nil? }
  }

  return deleted
end
get_col_style(column_index) click to toggle source

Helper method to get the style index for a column

# File lib/rubyXL/convenience_methods.rb, line 507
def get_col_style(column_index)
  range = cols.locate_range(column_index)
  (range && range.style_index) || 0
end
get_cols_style_index(column_index) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 433
def get_cols_style_index(column_index)
  validate_nonnegative(column_index)
  range = cols.locate_range(column_index)
  (range && range.style_index) || 0
end
get_column_alignment(col, type) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 554
def get_column_alignment(col, type)
  validate_workbook

  xf = @workbook.cell_xfs[get_cols_style_index(col)]
  xf.alignment && xf.alignment.send(type)
end
get_column_border(col, border_direction) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 532
def get_column_border(col, border_direction)
  validate_workbook

  xf = @workbook.cell_xfs[get_cols_style_index(col)]
  border = @workbook.borders[xf.border_id]
  border && border.get_edge_style(border_direction)
end
get_column_border_color(col, border_direction) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 540
def get_column_border_color(col, border_direction)
  validate_workbook

  xf = @workbook.cell_xfs[get_cols_style_index(col)]
  border = @workbook.borders[xf.border_id]
  border && border.get_edge_color(border_direction)
end
get_column_fill(col=0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 512
def get_column_fill(col=0)
  validate_workbook
  validate_nonnegative(col)

  @workbook.get_fill_color(get_col_xf(col))
end
get_column_font_color(col = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 449
def get_column_font_color(col = 0)
  font = column_font(col)
  font && (font.get_rgb_color || '000000')
end
get_column_font_name(col = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 439
def get_column_font_name(col = 0)
  font = column_font(col)
  font && font.get_name
end
get_column_font_size(col = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 444
def get_column_font_size(col = 0)
  font = column_font(col)
  font && font.get_size
end
get_column_width(column_index = 0) click to toggle source

Get column width measured in number of digits, as per msdn.microsoft.com/en-us/library/documentformat.openxml.spreadsheet.column%28v=office.14%29.aspx

# File lib/rubyXL/convenience_methods.rb, line 485
def get_column_width(column_index = 0)
  width = get_column_width_raw(column_index)
  return RubyXL::ColumnRange::DEFAULT_WIDTH if width.nil?
  (width - (5.0 / RubyXL::Font::MAX_DIGIT_WIDTH)).round
end
get_column_width_raw(column_index = 0) click to toggle source

Get raw column width value as stored in the file

# File lib/rubyXL/convenience_methods.rb, line 475
def get_column_width_raw(column_index = 0)
  validate_workbook
  validate_nonnegative(column_index)

  range = cols.locate_range(column_index)
  range && range.width
end
get_row_alignment(row, is_horizontal) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 422
def get_row_alignment(row, is_horizontal)
  validate_workbook

  xf_obj = get_row_xf(row)
  return nil if xf_obj.alignment.nil?

  if is_horizontal then return xf_obj.alignment.horizontal
  else                  return xf_obj.alignment.vertical
  end
end
get_row_border(row, border_direction) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 404
def get_row_border(row, border_direction)
  validate_workbook

  border = @workbook.borders[get_row_xf(row).border_id]
  border && border.get_edge_style(border_direction)
end
get_row_border_color(row, border_direction) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 411
def get_row_border_color(row, border_direction)
  validate_workbook

  border = @workbook.borders[get_row_xf(row).border_id]
  border && border.get_edge_color(border_direction)
end
get_row_fill(row = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 363
def get_row_fill(row = 0)
  (row = sheet_data.rows[row]) && row.get_fill_color
end
get_row_font_color(row = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 375
def get_row_font_color(row = 0)
  font = row_font(row)
  color = font && font.color
  color && (color.rgb || '000000')
end
get_row_font_name(row = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 367
def get_row_font_name(row = 0)
  (font = row_font(row)) && font.get_name
end
get_row_font_size(row = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 371
def get_row_font_size(row = 0)
  (font = row_font(row)) && font.get_size
end
get_row_height(row = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 397
def get_row_height(row = 0)
  validate_workbook
  validate_nonnegative(row)
  row = sheet_data.rows[row]
  row && row.ht || RubyXL::Row::DEFAULT_HEIGHT
end
get_row_style(row_index) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 358
def get_row_style(row_index)
  row = sheet_data.rows[row_index]
  (row && row.style_index) || 0
end
insert_cell(row = 0, col = 0, data = nil, formula = nil, shift = nil) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 209
def insert_cell(row = 0, col = 0, data = nil, formula = nil, shift = nil)
  validate_workbook
  ensure_cell_exists(row, col)

  case shift
  when nil then # No shifting at all
  when :right then
    sheet_data.rows[row].insert_cell_shift_right(nil, col)
  when :down then
    add_row(sheet_data.size, :cells => Array.new(sheet_data.rows[row].size))
    (sheet_data.size - 1).downto(row+1) { |index|
      sheet_data.rows[index].cells[col] = sheet_data.rows[index-1].cells[col]
    }
  else
    raise 'invalid shift option'
  end

  return add_cell(row, col, data, formula)
end
insert_column(column_index = 0) click to toggle source

Inserts column at column_index, pushes everything right, takes styles from column to left NOTE: use of this method will break formulas which reference cells which are being “pushed right”

# File lib/rubyXL/convenience_methods.rb, line 314
def insert_column(column_index = 0)
  validate_workbook
  ensure_cell_exists(0, column_index)

  old_range = cols.get_range(column_index)

  #go through each cell in column
  sheet_data.rows.each_with_index { |row, row_index|
    old_cell = row[column_index]
    c = nil

    if old_cell && old_cell.style_index != 0 &&
         old_range && old_range.style_index != old_cell.style_index then

      c = RubyXL::Cell.new(:style_index => old_cell.style_index, :worksheet => self,
                           :row => row_index, :column => column_index,
                           :datatype => RubyXL::DataType::SHARED_STRING)
    end

    row.insert_cell_shift_right(c, column_index)
  }

  cols.insert_column(column_index)

  # TODO: update column numbers
end
insert_row(row_index = 0) click to toggle source

Inserts row at row_index, pushes down, copies style from the row above (that's what Excel 2013 does!) NOTE: use of this method will break formulas which reference cells which are being “pushed down”

# File lib/rubyXL/convenience_methods.rb, line 259
def insert_row(row_index = 0)
  validate_workbook
  ensure_cell_exists(row_index)

  old_row = new_cells = nil

  if row_index > 0 then
    old_row = sheet_data.rows[row_index - 1]
    if old_row then
      new_cells = old_row.cells.collect { |c|
                    if c.nil? then nil
                    else nc = RubyXL::Cell.new(:style_index => c.style_index)
                         nc.worksheet = self
                         nc
                    end
                  }
    end
  end

  row0 = sheet_data.rows[0]
  new_cells ||= Array.new((row0 && row0.cells.size) || 0)

  sheet_data.rows.insert(row_index, nil)
  new_row = add_row(row_index, :cells => new_cells, :style_index => old_row && old_row.style_index)

  # Update row values for all rows below
  row_index.upto(sheet_data.rows.size - 1) { |r|
    row = sheet_data.rows[r]
    next if row.nil?
    row.cells.each_with_index { |cell, c|
      next if cell.nil?
      cell.r = RubyXL::Reference.new(r, c)
    }
  }

  return new_row
end
is_column_bolded(col = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 459
def is_column_bolded(col = 0)
  font = column_font(col)
  font && font.is_bold
end
is_column_italicized(col = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 454
def is_column_italicized(col = 0)
  font = column_font(col)
  font && font.is_italic
end
is_column_struckthrough(col = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 469
def is_column_struckthrough(col = 0)
  font = column_font(col)
  font && font.is_strikethrough
end
is_column_underlined(col = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 464
def is_column_underlined(col = 0)
  font = column_font(col)
  font && font.is_underlined
end
is_row_bolded(row = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 385
def is_row_bolded(row = 0)
  (font = row_font(row)) && font.is_bold
end
is_row_italicized(row = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 381
def is_row_italicized(row = 0)
  (font = row_font(row)) && font.is_italic
end
is_row_struckthrough(row = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 393
def is_row_struckthrough(row = 0)
  (font = row_font(row)) && font.is_strikethrough
end
is_row_underlined(row = 0) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 389
def is_row_underlined(row = 0)
  (font = row_font(row)) && font.is_underlined
end
merge_cells(start_row, start_col, end_row, end_col) click to toggle source

Merges cells within a rectangular area

# File lib/rubyXL/convenience_methods.rb, line 805
def merge_cells(start_row, start_col, end_row, end_col)
  validate_workbook

  self.merged_cells ||= RubyXL::MergedCells.new
  # TODO: add validation to make sure ranges are not intersecting with existing ones
  merged_cells << RubyXL::MergedCell.new(:ref => RubyXL::Reference.new(start_row, end_row, start_col, end_col))
end
row_font(row) click to toggle source
# File lib/rubyXL/convenience_methods.rb, line 418
def row_font(row)
  (row = sheet_data.rows[row]) && row.get_font
end