OleObject صف

يمثل OleObject في ورقة العمل.

الميراث: OleObject → Shape

يكشف النوع 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	يحصل على تنسيق ثلاثي الأبعاد للشكل ويحدده.
format_picture	يحصل على خيارات تنسيق الصورة ويقوم بتعيينها.
is_hidden	يشير إلى ما إذا كان الكائن مرئيًا.
is_lock_aspect_ratio	صحيح يعني أن نسبة العرض إلى الارتفاع للشكل مقفلة.
is_aspect_ratio_locked	صحيح يعني أن نسبة العرض إلى الارتفاع للشكل مقفلة.
rotation_angle	يحصل على دوران الشكل ويحدده.
hyperlink	يحصل على ارتباط تشعبي للشكل.
id	يحصل على معرف هذا الشكل.
spid	يقوم بتحديد معرف سلسلة اختياري يمكن للتطبيق استخدامه لتحديد الشكل المحدد.
spt	يقوم بتحديد رقم اختياري يمكن للتطبيق استخدامه لربط الشكل المحدد بنوع الشكل المحدد.
worksheet	يحصل على الكائن `Shape.worksheet` الذي يحتوي على هذا الشكل.
is_group	يشير إلى ما إذا كان هذا الشكل هو شكل مجموعة.
is_in_group	يشير إلى ما إذا كان الشكل مجمعًا.
is_word_art	يشير إلى ما إذا كان هذا الشكل عبارة عن فن كلمة.
text_effect	يقوم بإرجاع كائن TextEffectFormat الذي يحتوي على خصائص تنسيق تأثير النص للشكل المحدد. ينطبق على كائنات الشكل التي تمثل WordArt.
is_locked	صحيح يعني أنه لا يمكن تعديل الكائن عندما تكون الورقة محمية. لاحظ أن هذه القيمة لها معنى فقط إذا كانت ورقة العمل أو الكائنات الموجودة في ورقة العمل محمية.
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_size	يشير “صحيح” إلى أن حجم الكائن الأصلي سيتم تغييره تلقائيًا مع حجم لقطة المحتوى المضمن عندما يتم تنشيط الكائن القديم.
is_link	يعود صحيحًا إذا كان OleObject مرتبطًا بالملف.
display_as_icon	صحيح إذا تم عرض الكائن المحدد كأيقونة ولن يتم تغيير الصورة تلقائيًا.
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)`	يقوم بإرجاع كائن الأحرف الذي يمثل نطاقًا من الأحرف داخل النص.
`get_characters(self)`	إرجاع جميع كائنات الأحرف الذي يمثل مجموعة من الأحرف داخل النص.
`get_rich_formattings(self)`	إرجاع جميع كائنات الأحرف الذي يمثل مجموعة من الأحرف داخل النص.
`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")

أنظر أيضا

NoneFill صف OleObjectCollection صف