CheckBox类

表示工作表中的复选框对象。

继承： CheckBox → Shape

CheckBox 类型公开以下成员：

属性

属性	描述
macro_name	获取并设置宏的名称。
is_equation	指示形状是否仅包含方程式。
is_smart_art	指示形状是否为智能艺术。
z_order_position	返回形状在 z 顺序中的位置。
name	获取并设置形状的名称。
alternative_text	返回或设置 `Shape` 对象的描述性（替代）文本字符串。
title	指定当前形状对象的标题（标题）。
line_format	返回包含指定形状的线条格式属性的 MsoLineFormat 对象。
fill_format	返回包含指定形状的填充格式属性的 MsoFillFormat 对象。
line	获取线条样式
fill	返回包含指定形状的填充格式属性的 `Shape.fill_format` 对象。
shadow_effect	表示指定图表元素或形状的阴影效果的 `ShadowEffect` 对象。
reflection	表示指定图表元素或形状的反射效果的 `ReflectionEffect` 对象。
glow	表示为图表元素或形状指定发光效果的 `GlowEffect` 对象。
soft_edges	获取并设置应用于边缘的模糊半径，以点为单位。
three_d_format	获取并设置形状的 3d 格式。
format_picture	获取和设置图片格式的选项。
is_hidden	指示对象是否可见。
is_lock_aspect_ratio	True 表示形状的纵横比被锁定。
is_aspect_ratio_locked	True 表示形状的纵横比被锁定。
rotation_angle	获取并设置形状的旋转。
hyperlink	获取形状的超链接。
id	获取此形状的标识符。
spid	指定应用程序可用于识别特定形状的可选字符串标识符。
spt	指定一个可选数字，应用程序可以使用它来将特定形状与定义的形状类型关联起来。
worksheet	获取包含此形状的 `Shape.worksheet` 对象。
is_group	指示此形状是否为组形状。
is_in_group	指示形状是否已分组。
is_word_art	指示此形状是否为艺术字。
text_effect	返回包含指定形状的文本效果格式属性的 TextEffectFormat 对象。适用于代表艺术字的 Shape 对象。
is_locked	True 表示当工作表受到保护时，对象不能被修改。请注意，仅当工作表或工作表中的对象受到保护时，此值才有意义。
is_printable	指示对象是否可打印。如果为False，则打印时不会打印此形状。
mso_drawing_type	获取绘图类型。
auto_shape_type	获取并设置自动形状类型。
anchor_type	获取和设置形状锚点占位符的类型。
placement	表示绘图对象附加到其下方单元格的方式。该属性控制对象在工作表上的位置。
upper_left_row	表示顶行索引。
upper_delta_y	获取或设置形状与其左上角行的垂直偏移量。
upper_left_column	表示左上角列索引。
upper_delta_x	获取或设置形状与其左上角列的水平偏移量。
lower_right_row	表示右下角行索引。
lower_delta_y	获取或设置形状与其右下角行的垂直偏移量。
lower_right_column	表示右下角列索引。
lower_delta_x	获取或设置形状与其右下角列的水平偏移量。
right	表示形状相对于其右下角列的水平偏移宽度，以像素为单位。
bottom	表示形状距离其下底角行垂直偏移的宽度，以像素为单位。
width	表示形状的宽度，以像素为单位。
width_inch	表示形状的宽度，以英寸为单位。
width_pt	表示形状的宽度，以点为单位。
width_cm	表示形状的宽度，以厘米为单位。
height	表示形状的高度，以像素为单位。
height_inch	表示形状的高度，以英寸为单位。
height_pt	表示形状的高度，以点为单位。
height_cm	表示形状的高度，以厘米为单位。
left	表示形状与其左列的水平偏移量，以像素为单位。
left_inch	表示形状与其左列的水平偏移量，以英寸为单位。
left_cm	表示形状与其左列的水平偏移量，以厘米为单位。
top	表示形状与其顶行的垂直偏移量，以像素为单位。
top_inch	表示形状与其顶行的垂直偏移量，以英寸为单位。
top_cm	表示形状与其顶行的垂直偏移量，以厘米为单位。
top_to_corner	获取或设置形状与工作表顶部边框的垂直偏移量，以像素为单位。
left_to_corner	获取并设置形状与工作表左边框的水平偏移量。
x	获取或设置形状距工作表左边框的水平偏移量，以像素为单位。
y	获取或设置形状距工作表顶部边框的垂直偏移量，以像素为单位。
width_scale	获取或设置宽度比例，以原始图片宽度的百分比为单位。如果形状不是图片，WidthScale属性只返回100；
height_scale	获取或设置高度比例，以原始图片高度的百分比为单位。如果形状不是图片，HeightScale属性只返回100；
top_in_shape	表示形状与父形状顶部边框的垂直偏移量，以父形状高度的 1/4000 为单位。
left_in_shape	表示形状与父形状左边界的水平偏移量，以父形状宽度的 1/4000 为单位。
width_in_shape	表示形状的宽度，以父形状的 1/4000 为单位。
height_in_shape	表示形状与父形状上边框的垂直偏移量，以父形状高度的 1/4000 为单位。
group	获取包含该形状的组形状。
type	获取自动形状类型。
has_line	获取并设置形状的线边框是否可见。
is_filled	指示填充格式是否可见。
is_flipped_horizontally	获取或设置形状是否水平翻转。
is_flipped_vertically	获取或设置形状是否垂直翻转。
actual_lower_right_row	获取实际的底行。
relative_to_original_picture_size	表示形状是否与原始图片大小相关。
linked_cell	获取或设置链接到控件值的工作表范围。
input_range	获取或设置用于填充指定组合框的工作表范围。
text_shape_type	获取并设置预设的文本形状类型。
text_body	获取并设置形状文本的设置。
font	表示形状的字体。
text_options	代表形状的文本选项。
text	获取并设置此形状的文本。
is_rich_text	文本是否为富文本。
html_text	获取并设置此文本框中包含数据和一些格式的 html 字符串。
text_vertical_overflow	获取并设置包含文本的形状的文本垂直溢出类型。
text_horizontal_overflow	获取并设置包含文本的形状的文本水平溢出类型。
is_text_wrapped	获取并设置包含文本的形状的文本环绕类型。
text_orientation_type	获取并设置形状的文本方向类型。
text_horizontal_alignment	获取并设置形状的文本水平对齐类型。
text_vertical_alignment	获取并设置形状的文本垂直对齐类型。
text_direction	获取/设置此对象的文本流方向。
text_box_options	获取形状中的文本信息
control_data	获取控件的数据。
active_x_control	获取 ActiveX 控件。
paths	获取自定义几何形状的路径。
create_id	获取并设置此形状的创建 ID。
is_decorative	指示物体是否具有装饰性。
value	指示复选框是否被选中。
check_value	获取或设置复选框的值。
checked_value	获取或设置复选框的值。
shadow	指示组合框是否具有三维阴影。

方法

方法	描述
`to_image(self, stream, image_type)`	创建形状图像并将其保存到指定格式的流中。
`to_image(self, image_file, options)`	将形状保存到文件。
`to_image(self, stream, options)`	将形状保存到流中。
`get_result_of_smart_art(self)`	将智能艺术转换为分组形状。
`to_front_or_back(self, orders)`	将形状置于前面或将形状置于后面。
`get_locked_property(self, type)`	获取锁定属性的值。
`set_locked_property(self, type, value)`	设置锁定属性。
`add_hyperlink(self, address)`	向形状添加超链接。
`remove_hyperlink(self)`	删除形状的超链接。
`move_to_range(self, upper_left_row, upper_left_column, lower_right_row, lower_right_column)`	将形状移动到指定范围。
`align_top_right_corner(self, top_row, right_column)`	将图片移动到右上角。
`get_connection_points(self)`	获取连接点
`get_linked_cell(self, is_r1c1, is_local)`	获取与控件值相关的范围。
`set_linked_cell(self, formula, is_r1c1, is_local)`	设置与控件值链接的范围。
`get_input_range(self, is_r1c1, is_local)`	获取用于填充控件的范围。
`set_input_range(self, formula, is_r1c1, is_local)`	设置用于填充控件的范围。
`update_selected_value(self)`	通过链接单元格的值更新选定的值。
`calculate_text_size(self)`	重新计算文本区域
`format_characters(self, start_index, length, font, flag)`	使用字体设置格式化一些字符。
`characters(self, start_index, length)`	返回表示文本内字符范围的 Characters 对象。
`get_characters(self)`	返回所有 Characters 对象代表文本中的字符范围。
`get_rich_formattings(self)`	返回所有 Characters 对象代表文本中的字符范围。
`remove_active_x_control(self)`	删除 activeX 控件。
`is_same_setting(self, obj)`	返回形状是否相同。
`get_actual_box(self)`	获取形状的实际位置和大小（应用旋转、翻转等之后）
`fit_to_text_size(self)`	重新计算一个适合显示所有文本内容的文本区域。

例子

from aspose.cells import Workbook

# Instantiate a new Workbook.
excel = Workbook()
index = excel.worksheets[0].check_boxes.add(15, 15, 20, 100)
checkBox = excel.worksheets[0].check_boxes[index]
checkBox.text = "Check Box 1"
# Save the excel file.
excel.save("checkBox.xlsx")

也可以看看

ChartShape类 CheckBoxCollection类