OleObject класс

OleObject класс

Представляет число OleObject на рабочем листе.

Наследование: OleObjectShape

Тип 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-формат фигуры.
format_pictureПолучает и задает параметры формата изображения.
is_hiddenУказывает, виден ли объект.
is_lock_aspect_ratioTrue означает, что соотношение сторон фигуры зафиксировано.
is_aspect_ratio_lockedTrue означает, что соотношение сторон фигуры зафиксировано.
rotation_angleПолучает и задает поворот фигуры.
hyperlinkПолучает гиперссылку формы.
idПолучает идентификатор этой формы.
spidУказывает необязательный строковый идентификатор, который приложение может использовать для идентификации конкретной фигуры.
sptУказывает необязательное число, которое приложение может использовать для связи конкретной фигуры с определенным типом фигуры.
worksheetПолучает объект Shape.worksheet, содержащий эту форму.
is_groupУказывает, является ли данная фигура групповой фигурой.
is_in_groupУказывает, сгруппирована ли фигура.
is_word_artУказывает, является ли данная форма произведением искусства.
text_effectВозвращает объект TextEffectFormat, содержащий свойства форматирования текста для указанной фигуры.
Применяется к объектам Shape, представляющим WordArt.
is_lockedTrue означает, что объект не может быть изменен, если лист защищен.
Обратите внимание, что это значение имеет смысл только в том случае, если рабочий лист или объекты на нем защищены.
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Получает и задает идентификатор создания для этой формы.
is_decorativeУказывает, является ли объект декоративным.
is_auto_sizeTrue указывает, что размер OLE-объекта будет автоматически изменен в соответствии с размером снимка встроенного содержимого.
когда активируется старый объект.
is_linkВозвращает true, если OleObject ссылается на файл.
display_as_iconTrue, если указанный объект отображается как значок
и изображение не будет автоматически изменено.
image_dataПредставляет изображение объекта OLE в виде массива байтов.
object_dataПредставляет встроенные данные OLE-объекта в виде массива байтов.
full_object_binПолучает полные встроенные двоичные данные OLE-объекта в файле шаблона.
image_source_full_nameВозвращает или задает путь и имя исходного файла для связанного изображения.
prog_idПолучает или задает ProgID объекта OLE.
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(self, stream, image_type)Создает изображение фигуры и сохраняет его в потоке в указанном формате.
to_image(self, image_file, options)Сохраняет форму в файле.
to_image(self, stream, options)Сохраняет форму в потоке.
set_embedded_object(self, link_to_file, object_data, source_file_name, display_as_icon, label)Устанавливает данные встроенного объекта.
set_embedded_object(self, link_to_file, object_data, source_file_name, display_as_icon, label, update_icon)Устанавливает данные встроенного объекта.
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)Пересчитать текстовую область, подходящую для отображения всего текстового содержимого.
set_native_source_full_name(self, source_full_name)Задает полное имя исходного файла с путем к нему.

Пример

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")

Смотрите также