python官网api文档-Python API

返回一个区域对象，可以代表一个单元格，也可以是一个区域。

参数:cell1 (strortupleorRange) – 区域左上角的名字，可以是A1表示法、坐标元组、名字或者是xw.Range对象。也可用用区域操作符号(例如 "A1:B2’ )来表示。

cell2 (strortupleorRange,default None) – 区域右下角角的名字，可以是A1表示法、坐标元组、名字或者是 xw.Range 对象。

示例

活动工作表:

import xlwings as xw

xw.Range("A1")

xw.Range("A1:C3")

xw.Range((1,1))

xw.Range((1,1), (3,3))

xw.Range("NamedRange")

xw.Range(xw.Range("A1"), xw.Range("B2"))

指定的工作表:

xw.books["MyBook.xlsx"].sheets[0].range("A1")

add_hyperlink(address, text_to_display=None, screen_tip=None)¶

在指定的区域(单个单元格)中加一个超链接

参数:address (str) – 超链接地址。

text_to_display (str,default None) – 超链接的显示字符串，缺省为超链接地址本身。

screen_tip (str,default None) – 当鼠标停留在超链接上方是显示的屏幕提示。缺省情况下设置为’

- 单击一次可跟踪超链接，单击并按住不放选择此单元格。’

0.3.0 新版功能.

address¶

返回一个表示区域引用的字符串，用 get_address() 可以使用参数来指定更多的细节。

0.9.0 新版功能.

api¶

返回正在使用的引擎的原生对象( pywin32 或 appscript 对象)。

0.9.0 新版功能.

autofit()¶

使得区域内所有单元格的宽度和高度进行自适应。

只进行宽度自适应，用 xw.Range("A1:B2").columns.autofit()

只进行高度自适应时，使用 xw.Range("A1:B2").rows.autofit()

在 0.9.0 版更改.

clear()¶

清除区域的内容和格式。

clear_contents()¶

清除区域的内容，保留格式。

color¶

获取指定区域的背景色。

设背景色时，用RGB元组(0, 0, 0)或者颜色代码。去除背景颜色的时候，只需要把颜色设置为 None , 参考示例。

返回:RGB

返回类型:tuple

示例

>>>import xlwings as xw

>>>wb = xw.Book()

>>>xw.Range("A1").color = (255,255,255)

>>>xw.Range("A2").color

(255, 255, 255)

>>>xw.Range("A2").color = None

>>>xw.Range("A2").color is None

True

0.3.0 新版功能.

column¶

返回指定区域的第一列的值，只读。

返回:

返回类型:Integer

0.3.5 新版功能.

column_width¶

获取或者设置区域的宽