Picture صف

يقوم بتغليف الكائن الذي يمثل صورة واحدة في جدول بيانات.

ميراث: Picture → Shape

يكشف النوع Picture عن الأعضاء التاليين:

ملكيات

ملكية	وصف
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	الحصول على التنسيق الثلاثي الأبعاد للشكل وتعيينه.
text_frame	تقوم بإرجاع كائن TextFrame الذي يحتوي على خصائص المحاذاة والتثبيت للشكل المحدد.
format_picture	الحصول على خيارات تنسيق الصورة وتعيينها.
is_hidden	يشير إلى ما إذا كان الكائن مرئيًا.
is_lock_aspect_ratio	صحيح يعني أنه لا يسمح بإجراء تغييرات في نسبة العرض إلى الارتفاع.
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	صحيح إذا كان الكائن قابلاً للطباعة
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	يحصل ويحدد معرفًا لهذا الشكل.
original_height	الحصول على الارتفاع الأصلي للصورة.
original_width	الحصول على العرض الأصلي للصورة.
border_line_color	يمثل لون الخط الحدودي للصورة.
border_weight	الحصول على أو تعيين وزن الخط الحدودي للصورة بوحدات pt.
data	يحصل على بيانات الصورة.
source_full_name	الحصول على أو تعيين مسار واسم الملف المصدر للصورة المرتبطة.
formula	الحصول على بيانات الصيغة وتعيينها.
is_auto_size	يشير True إلى أن حجم كائن ole سيتم تغييره تلقائيًا مثل حجم لقطة المحتوى المضمن عندما يتم تنشيط كائن ole.
is_link	يُرجع صحيحًا إذا كانت الصورة مرتبطة بملف.
is_dynamic_data_exchange	يحصل أو يحدد ما إذا كان تبادل البيانات الديناميكي
display_as_icon	صحيح إذا تم عرض الكائن المحدد كرمز ولن يتم تغيير الصورة تلقائيًا.
image_type	يحصل على تنسيق الصورة للصورة.
original_height_cm	الحصول على الارتفاع الأصلي للصورة بوحدة السنتيمتر.
original_width_cm	الحصول على العرض الأصلي للصورة بوحدة السنتيمتر.
original_height_inch	الحصول على الارتفاع الأصلي للصورة بوحدة البوصة.
original_width_inch	الحصول على العرض الأصلي للصورة بوحدة البوصة.
signature_line	يحصل ويحدد خط التوقيع

طُرق

طريقة	وصف
to_image	يقوم بإنشاء صورة الشكل وحفظها في دفق بالتنسيق المحدد.
to_image	يحفظ الشكل في ملف.
to_image	يحفظ الشكل في دفق.
format_characters	تنسيق بعض الأحرف باستخدام إعداد الخط.
format_characters	تنسيق بعض الأحرف باستخدام إعداد الخط.
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	تقوم بإرجاع كائن الأحرف الذي يمثل نطاقًا من الأحرف داخل النص.
get_characters	إرجاع كافة كائنات الأحرف الذي يمثل مجموعة من الأحرف داخل النص.
get_rich_formattings	إرجاع كافة كائنات الأحرف الذي يمثل مجموعة من الأحرف داخل النص.
remove_active_x_control	قم بإزالة عنصر التحكم ActiveX.
is_same_setting	إرجاع ما إذا كان الشكل هو نفسه.
get_actual_box	احصل على الموضع والحجم الفعليين للشكل (بعد تطبيق التدوير والقلب وما إلى ذلك)
copy	انسخ الصورة.
move	ينقل الصورة إلى موقع محدد.

مثال

from aspose.cells import SaveFormat, Workbook

# Instantiating a Workbook object
workbook = Workbook()
# Adding a new worksheet to the Workbook object
sheetIndex = workbook.worksheets.add()
# Obtaining the reference of the newly added worksheet by passing its sheet index
worksheet = workbook.worksheets[sheetIndex]
# Adding a picture at the location of a cell whose row and column indices
# are 5 in the worksheet. It is "F6" cell
worksheet.pictures.add(5, 5, "image.gif")
# Saving the Excel file
workbook.save("book1.xls", SaveFormat.EXCEL_97_TO_2003)

أنظر أيضا

PicFormatOption الدرجة PictureCollection الدرجة