Legend صف

Legend صف

يقوم بتغليف الكائن الذي يمثل وسيلة إيضاح المخطط.

ميراث: LegendChartTextFrameChartFrame

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

ملكيات

ملكيةوصف
is_inner_modeالإشارة إلى ما إذا كان حجم مساحة الرسم يتضمن علامات التجزئة وتسميات المحاور.
يحدد False أن الحجم يجب أن يحدد حجم منطقة الرسم وعلامات التجزئة وتسميات المحاور.
borderيحصل على Line.
areaيحصل على ChartFrame.area.
text_fontيحصل على كائن ChartFrame.font من كائن ChartFrame المحدد.
text_optionsالحصول على خيارات النص وتعيينها.
fontيحصل على كائن ChartFrame.font من كائن ChartFrame المحدد.
auto_scale_fontصحيح إذا تغير حجم الخط النص الموجود في الكائن عندما يتغير حجم الكائن. القيمة الافتراضية هي الحقيقية.
background_modeالحصول على وضع عرض الخلفية وتعيينه
backgroundالحصول على وضع عرض الخلفية وتعيينه
is_automatic_sizeيشير إلى ما إذا كان إطار المخطط ذو حجم تلقائي.
xالحصول على إحداثي x للزاوية العلوية اليسرى أو تعيينه بوحدات 1/4000 من منطقة المخطط.
yالحصول على أو تعيين إحداثي y للزاوية اليسرى العليا بوحدات 1/4000 من منطقة المخطط.
heightالحصول على ارتفاع الإطار أو تعيينه بوحدات 1/4000 من منطقة المخطط.
widthالحصول على أو تعيين عرض الإطار بوحدات 1/4000 من منطقة المخطط.
shadowصحيح إذا كان الإطار يحتوي على ظل.
shape_propertiesيحصل على الكائن ChartFrame.shape_properties.
is_default_pos_be_setيشير إلى ما إذا كان قد تم تعيين الموضع الافتراضي (DefaultX وDefaultY وDefaultWidth وDefaultHeight).
default_xيمثل x من الموضع الافتراضي
default_yيمثل y للموضع الافتراضي
default_widthيمثل عرض الموضع الافتراضي
default_heightيمثل ارتفاع الموضع الافتراضي
is_auto_textيشير إلى أن النص تم إنشاؤه تلقائيًا.
is_deletedيشير إلى ما إذا تم حذف تسميات البيانات هذه.
text_horizontal_alignmentالحصول على المحاذاة الأفقية للنص وتعيينها.
text_vertical_alignmentالحصول على أو تعيين المحاذاة العمودية للنص.
rotation_angleيمثل زاوية دوران النص.
is_automatic_rotationيشير إلى ما إذا كان سيتم تدوير نص المخطط تلقائيًا.
textالحصول على نص عنوان الإطار أو تعيينه.
linked_sourceالحصول على مرجع إلى ورقة العمل وتعيينه.
text_directionيمثل ترتيب قراءة النص.
reading_orderيمثل ترتيب قراءة النص.
direction_typeيحصل على ويحدد اتجاه النص.
is_text_wrappedالحصول على قيمة أو تعيينها تشير إلى ما إذا كان النص ملتفًا أم لا.
is_resize_shape_to_fit_textالحصول على أو تعيين ما إذا كان الشكل يجب أن يتم احتواؤه تلقائيًا ليحتوي على النص الموصوف بداخله بالكامل. التركيب التلقائي هو
عندما يتم تغيير حجم النص داخل الشكل ليحتوي على النص بأكمله بداخله.
positionالحصول على نوع موضع وسيلة الإيضاح أو تعيينه.
legend_entriesالحصول على مجموعة من كافة كائنات LegendEntry في وسيلة إيضاح المخطط المحدد.
لا يتم دعم تعيين إدخالات وسيلة الإيضاح للمخطط السطحي.
لذلك سيعود فارغًا إذا كان نوع المخطط هو نوع المخطط السطحي.
legend_entries_labelsيحصل على تسميات إدخالات وسيلة الإيضاح بعد استدعاء أسلوب Chart.Calculate().
is_over_layالحصول على أو تعيين ما إذا كان سيتم السماح لعناصر المخطط الأخرى بالتداخل مع عنصر المخطط هذا.

طُرق

طريقةوصف
set_position_autoاضبط موضع الإطار على الوضع التلقائي
charactersتقوم بإرجاع كائن الأحرف الذي يمثل نطاقًا من الأحرف داخل النص.
get_legend_labelsيحصل على تسميات إدخالات وسيلة الإيضاح بعد استدعاء أسلوب Chart.Calculate().

مثال

from aspose.cells import Workbook
from aspose.cells.charts import ChartType, LegendPositionType

workbook = Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells
cells.get(0, 1).put_value("Income")
cells.get(1, 0).put_value("Company A")
cells.get(2, 0).put_value("Company B")
cells.get(3, 0).put_value("Company C")
cells.get(1, 1).put_value(10000)
cells.get(2, 1).put_value(20000)
cells.get(3, 1).put_value(30000)
chartIndex = sheet.charts.add(ChartType.COLUMN, 9, 9, 21, 15)
chart = sheet.charts[chartIndex]
chart.set_chart_data_range("A1:B4", True)
# Set Legend's width and height
legend = chart.legend
# Legend is at right side of chart by default.
# If the legend is at left or right side of the chart, setting Legend.X property will not take effect.
# If the legend is at top or bottom side of the chart, setting Legend.Y property will not take effect.
legend.y = 1500
legend.width = 50
legend.height = 50
# Set legend's position
legend.position = LegendPositionType.LEFT

أنظر أيضا