OleObject类
OleObject类
代表工作表中的 OleObject。
OleObject 类型公开以下成员:
特性
属性 | 描述 |
---|---|
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 格式。 |
text_frame | 返回一个 TextFrame 对象,其中包含指定形状的对齐和锚定属性。 |
format_picture | 获取和设置图片格式选项。 |
is_hidden | 指示对象是否可见。 |
is_lock_aspect_ratio | True 表示不允许更改纵横比。 |
rotation_angle | 获取和设置形状的旋转。 |
hyperlink | 获取形状的超链接。 |
id | 获取该形状的标识符。 |
spid | 指定应用程序可用于识别特定形状的可选字符串。 |
spt | 指定应用程序可用于将特定形状与定义的形状类型相关联的可选数字。 |
worksheet | 获取包含此形状的 Shape.worksheet 对象。 |
is_group | 指示形状是否是一个组。 |
is_in_group | 指示形状是否分组。 |
is_word_art | 指示该形状是否为艺术字。 |
text_effect | 返回一个 TextEffectFormat 对象,其中包含指定形状的文本效果格式设置属性。 适用于表示艺术字的形状对象。 |
is_locked | 如果对象被锁定,则为 True;如果在工作表受保护时可以修改对象,则为 False。 |
is_printable | 如果对象可打印则为 True |
mso_drawing_type | 获取 mso 绘图类型。 |
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 | 获取实际的底行。 |
connection_points | 获取连接点 |
relative_to_original_picture_size | 指示形状是否相对于原始图片尺寸。 |
linked_cell | 获取或设置链接到控件值的工作表范围。 |
input_range | 获取或设置用于填充指定组合框的工作表范围。 |
text_shape_type | 获取和设置预设文本形状类型。 |
text_body | 获取和设置形状文本的设置。 |
font | 代表形状的字体。 |
text_options | 代表形状的文本选项。 |
text | 表示此 TextBox 对象中的字符串。 |
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 | 获取/设置该对象的文本流方向。 |
control_data | 获取控制数据。 |
active_x_control | 获取 ActiveX 控件。 |
paths | 获取自定义几何形状的路径。 |
geometry | 获取几何图形 |
create_id | 获取并设置该形状的创建 ID。 |
is_auto_size | True 表示 ole 对象的大小将自动更改为嵌入内容的快照的大小 当 ole 对象被激活时。 |
is_link | 如果 OleObject 链接到文件,则返回 true。 |
display_as_icon | 如果指定对象显示为图标,则为 true 并且图像不会自动更改。 |
image_data | 将 ole 对象的图像表示为字节数组。 |
object_data | 将嵌入的 ole 对象数据表示为字节数组。 |
full_object_bin | 获取模板文件中完整嵌入的 ole 对象二进制数据。 |
image_source_full_name | 获取或设置链接图像的源文件的路径和名称。 |
prog_id | 获取或设置 OLE 对象的 ProgID。 |
file_format_type | 获取和设置嵌入 ole 对象数据的文件类型 |
object_source_full_name | 返回链接 OLE 对象的源文件的源全名。 |
label | 获取和设置链接的 ole 对象的显示标签。 |
source_full_name | 返回链接 OLE 对象的源文件的源全名。 |
auto_update | 指定是否自动更新 OleObject 的链接。 |
auto_load | 指定是否应调用嵌入对象的主机应用程序来加载 打开父工作簿时自动获取对象数据。 |
class_identifier | 获取和设置嵌入对象的类标识符。 这意味着哪个应用程序打开嵌入的文件。 |
image_type | 获取ole对象的图像格式。 |
方法
方法 | 描述 |
---|---|
to_image | 创建形状图像并将其以指定格式保存到流中。 |
to_image | 将形状保存到文件中。 |
to_image | 将形状保存到流中。 |
format_characters | 使用字体设置格式化一些字符。 |
format_characters | 使用字体设置格式化一些字符。 |
set_embedded_object | 设置嵌入对象数据。 |
set_embedded_object | 设置嵌入对象数据。 |
get_result_of_smart_art | 将智能艺术转换为分组形状。 |
to_front_or_back | 将形状置于前面或将形状置于后面。 |
get_locked_property | 获取锁定属性的值。 |
set_locked_property | 设置锁定属性。 |
add_hyperlink | 添加到形状的超链接。 |
remove_hyperlink | 删除形状的超链接。 |
move_to_range | 将形状移动到指定范围。 |
align_top_right_corner | 将图片移动到右上角。 |
get_connection_points | 获取连接点 |
get_linked_cell | 获取链接到控件值的范围。 |
set_linked_cell | 设置链接到控件值的范围。 |
get_input_range | 获取用于填充控件的范围。 |
set_input_range | 设置用于填充控件的范围。 |
update_selected_value | 用链接单元格的值更新所选值。 |
calculate_text_size | 重新计算文本区域 |
characters | 返回一个 Characters 对象,该对象表示文本中的一系列字符。 |
get_characters | 返回所有字符对象 表示文本中的一系列字符。 |
get_rich_formattings | 返回所有字符对象 表示文本中的一系列字符。 |
remove_active_x_control | 删除 ActiveX 控件。 |
is_same_setting | 返回形状是否相同。 |
get_actual_box | 获取形状的实际位置和大小(应用旋转、翻转等后) |
set_native_source_full_name | 设置 ole 本机源完整文件名和路径。 |
例子
from aspose.cells import Workbook
import bytearray
# Instantiate a new Workbook.
workbook = Workbook()
# Get the first worksheet.
sheet = workbook.worksheets[0]
# Define a string variable to store the image path.
ImageUrl = "school.jpg"
# Get the picture into the streams.
fs = open(ImageUrl, "rb")
# Define a byte array.
imageData = bytearray(utils.filesize(fs))
# Obtain the picture into the array of bytes from streams.
fs.readinto(imageData)
# Close the stream.
fs.close()
# Get an excel file path in a variable.
path = "Book1.xls"
# Get the file into the streams.
fs = open(path, "rb")
# Define an array of bytes.
objectData = bytearray(utils.filesize(fs))
# Store the file from streams.
fs.readinto(objectData)
# Close the stream.
fs.close()
# Add an Ole object into the worksheet with the image
# shown in MS Excel.
sheet.ole_objects.add(14, 3, 200, 220, imageData)
# Set embedded ole object data.
sheet.ole_objects[0].object_data = objectData
# Save the excel file
workbook.save(r"oleobjects.xls")