DataNitro学习笔记（09） #WorkSheet讲解

jerryxjr1220

Worksheets
Active Sheet 活动工作表
当你没有指定工作表而创建了一个新的单元格或者单元格范围时，它将默认放置与活动工作表中。默认活动工作表是当你打开Excel时或启动Python Shell时默认可见的表单。
调用active_sheet（）功能时，如果不传入参数，则返回当前的活动工作表；如果传入参数，则改变当前活动工作表为指定的工作表。
例如: Sheet1处于活动状态, 执行active_sheet() 会返回“Sheet1”.
执行active_sheet(“Sheet2”) 将会设置Sheet2为活动工作表.

Display Sheet 显示工作表
调用display_sheet（）功能时，如果不传入参数，则返回当前的显示工作表；如果传入参数，则改变当前显示工作表为指定的工作表。
例如: Sheet1处于显示状态, 执行display_sheet() 会返回“Sheet1”.
执行display_sheet(“Sheet2”) 将会设置Sheet2为显示工作表.

Clear/Delete row/column 清除/删除 行/列
clear_row, clear_col, del_row, del_col 将会清除或删除某行或某列. 行用数字表示，列可以用数字也可以用字母表示. 你可以传入单元格、单元格范围、工作表，或者以列表、或者元组的形式指定范围，来清除或删除它。
例如: clear_row(1) and clear_row(Cell(“A1”)) will clear the first row. del_col(3), del_col(“C”), and del_col(Cell(3,3)) will delete the third column. clear_col([1, 2, 3], “Sheet2”) and clear_col(CellRange(“A1:C1”), “Sheet2”) will clear the first three columns on Sheet2.

注意: 调用del_row([1, 2]) 和调用 del_row(1) 再del_row(2)是不同的，del_row([1,2]) 会直接删除2行, 而 del_row(1) 会先删除第一行, 剩下的行会上移. del_row(2) 会删除新的第二行（原本的第三行）.

Hiding rows or columns 隐藏行或列
hide_row(row[, hidden, sheet])
隐藏行，hidden为True是默认参数.
>>> hide_row(3)
## hides row 3 on the active sheet
>>> hide_row([4, 5])
## hides rows 4 and 5 on the active sheet
>>> hide_row([3, 4, 5], False, "Sheet2")
## unhides rows 3, 4, and 5 on Sheet2

hide_col(col[, hidden, sheet])
隐藏列，hidden为True是默认参数.
>>> hide_col(2)
## hides column 2 on the active sheet
>>> hide_col([3, "D", "E"], False, "Sheet2")
## unhides rows 3, 4, and 5 on Sheet2

row_is_hidden(row[, sheet])
如果行是隐藏的则返回True.
>>> row_is_hidden(3)
True ## row 3 on the active sheet is hidden

col_is_hidden(col[, sheet])
如果列是隐藏的则返回True.
>>> col_is_hidden("A", "Sheet2")
False ## column A on Sheet2 is visible

Insert row/column 插入行或列

insert_row 和 insert_col 分别用作插入行和列，它们会插入一个空白的行或者列。
例如: insert_row(1) and insert_row(Cell(“A1”)) will insert a new first row. insert_col(3), insert_col(“C”), and insert_col(Cell(3,3)) will insert a new third column. insert_col([1, 2, 3], “Sheet2”) will insert columns before columns ‘A’, ‘B’ and ‘C’. (The result is new_col, A, new_col, B, new_col, C...)