PivotTable صف

PivotTable صف

وصف موجز لـ PivotTable.

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

ملكيات

ملكيةوصف
is_excel_2003_compatibleيحدد ما إذا كان الجدول المحوري متوافقًا مع Excel2003 عند تحديث الجدول المحوري،
إذا كانت القيمة صحيحة، فيجب أن يكون طول السلسلة أقل من أو يساوي 255 حرفًا، لذا إذا كانت السلسلة أكبر من 255 حرفًا،
سيتم اقتطاعه. إذا كان false، فلن يكون للسلسلة القيد المذكور أعلاه.
القيمة الافتراضية هي true.
refreshed_by_whoيحصل على اسم آخر مستخدم قام بتحديث جدول البيانات المحوري هذا
refresh_dateيحصل على تاريخ الوقت الأخير الذي تم فيه تحديث الجدول المحوري.
pivot_table_style_nameيحصل على اسم نمط الجدول المحوري ويقوم بتعيينه.
pivot_table_style_typeيحصل على نمط جدول المحور المدمج ويقوم بتعيينه.
column_fieldsيقوم بإرجاع كائن PivotFields الذي يتم عرضه حاليًا كحقول أعمدة.
row_fieldsيقوم بإرجاع كائن PivotFields الذي يتم عرضه حاليًا كحقول صف.
page_fieldsيقوم بإرجاع كائن PivotFields الذي يتم عرضه حاليًا كحقول صفحة.
data_fieldsيحصل على كائن PivotField الذي يمثل جميع حقول البيانات في PivotTable.
للقراءة فقط. سيكون init فقط عندما يكون هناك حقلين أو أكثر من البيانات في DataPiovtFiels.
يُستخدم فقط لإضافة حقل DataPivotField إلى منطقة الصفوف/الأعمدة في جدول PivotTable. الإعداد الافتراضي هو منطقة الصفوف.
data_fieldيحصل على الكائن PivotField الذي يمثل كافة حقول البيانات في جدول محوري.
للقراءة فقط.
سيتم إنشاؤه فقط عندما يكون هناك حقلين أو أكثر من البيانات في منطقة البيانات.
افتراضيًا، يكون في منطقة الصف. يمكنك سحبه إلى منطقة الصف/العمود باستخدام دالة PivotTable.AddFieldToArea().
base_fieldsإرجاع كافة حقول المحور الأساسية في جدول المحور.
pivot_filtersإرجاع جميع مرشحات حقول المحور في جدول المحور.
column_rangeإرجاع كائن CellArea الذي يمثل النطاق
الذي يحتوي على منطقة العمود في تقرير PivotTable. للقراءة فقط.
row_rangeإرجاع كائن CellArea الذي يمثل النطاق
الذي يحتوي على منطقة الصف في تقرير PivotTable. للقراءة فقط.
data_body_rangeإرجاع كائن CellArea الذي يمثل النطاق الذي يحتوي على منطقة البيانات
في القائمة بين صف الرأس وصف الإدراج. للقراءة فقط.
table_range1إرجاع كائن CellArea الذي يمثل النطاق الذي يحتوي على تقرير PivotTable بأكمله،
لكن لا يتضمن حقول الصفحة. للقراءة فقط.
table_range2إرجاع كائن CellArea الذي يمثل النطاق الذي يحتوي على تقرير PivotTable بأكمله،
يتضمن حقول الصفحة. للقراءة فقط.
is_grid_drop_zonesيشير إلى ما إذا كان تقرير PivotTable يعرض تخطيط PivotTable الكلاسيكي.
(يتيح سحب الحقول في الشبكة)
show_column_grand_totalsيشير إلى ما إذا كان سيتم عرض الإجماليات الكلية لأعمدة جدول المحور هذا.
show_row_grand_totalsيشير إلى ما إذا كان سيتم عرض الإجماليات الكلية لصفوف جدول المحور.
column_grandيشير إلى ما إذا كان تقرير PivotTable يعرض الإجماليات الكلية للأعمدة.
row_grandيشير إلى ما إذا كان سيتم عرض الإجماليات الكبرى لصفوف جدول المحور هذا.
display_null_stringيشير إلى ما إذا كان تقرير PivotTable يعرض سلسلة مخصصة إذا كانت القيمة فارغة.
null_stringيحصل على السلسلة المعروضة في الخلايا التي تحتوي على قيم فارغة
عندما تكون خاصية DisplayNullString صحيحة. القيمة الافتراضية هي سلسلة فارغة.
display_error_stringيشير إلى ما إذا كان تقرير PivotTable يعرض سلسلة مخصصة في الخلايا التي تحتوي على أخطاء.
data_field_header_nameيحصل على اسم رأس حقل منطقة القيمة في الجدول المحوري ويقوم بتعيينه.
error_stringيحصل على السلسلة المعروضة في الخلايا التي تحتوي على أخطاء
عندما تكون خاصية DisplayErrorString صحيحة. القيمة الافتراضية هي سلسلة فارغة.
is_auto_formatيشير إلى ما إذا كان يتم تنسيق تقرير PivotTable تلقائيًا.
مربع الاختيار “تنسيق الجدول تلقائيًا” الموجود في خيار Pivottable لبرنامج Excel 2003
autofit_column_width_on_updateيشير إلى ما إذا كان يتم ضبط عرض العمود تلقائيًا عند التحديث
auto_format_typeيحصل على نوع التنسيق التلقائي لجدول PivotTable ويقوم بتعيينه.
has_blank_rowsيشير إلى ما إذا كان سيتم إضافة صفوف فارغة.
تنطبق هذه الخاصية فقط على أنواع التنسيق التلقائي لـ PivotTable والتي تحتاج إلى إضافة صفوف فارغة.
merge_labelsصحيح إذا كانت تسميات عنصر الصف الخارجي وعنصر العمود والمجموع الفرعي والمجموع الكلي لتقرير PivotTable المحدد تستخدم خلايا مدمجة.
preserve_formattingيشير إلى ما إذا كان يتم الحفاظ على التنسيق عند تحديث الجدول المحوري أو إعادة حسابه.
show_drillيحصل ويحدد ما إذا كان سيتم عرض أزرار التوسيع/الطي.
enable_drilldownيحصل على ما إذا كان التنقيب ممكّنًا.
enable_field_dialogيشير إلى ما إذا كان مربع حوار حقل الجدول المحوري متاحًا
عندما يقوم المستخدم بالنقر المزدوج فوق حقل PivotTable.
enable_field_listيشير إلى ما إذا كانت قائمة الحقول الخاصة بجدول البيانات المحوري متوفرة في عرض Excel.
enable_wizardيشير إلى ما إذا كان معالج PivotTable متاحًا.
subtotal_hidden_page_itemsيشير إلى ما إذا كانت عناصر حقل الصفحة مخفية في تقرير PivotTable
يتم تضمينها في إجماليات الصفوف والأعمدة، وإجماليات الكتل، والإجماليات الكلية.
القيمة الافتراضية هي False.
grand_total_nameإرجاع الملصق الذي يتم عرضه في عنوان عمود الإجمالي الكلي أو الصف.
القيمة الافتراضية هي السلسلة “الإجمالي الكلي”.
manual_updateيشير إلى ما إذا كان سيتم إعادة حساب تقرير PivotTable فقط بناءً على طلب المستخدم.
is_multiple_field_filtersيحدد قيمة منطقية تشير إلى ما إذا كان من الممكن تعيين عدة مرشحات على حقول جدول محوري.
allow_multiple_filters_per_fieldيحدد قيمة منطقية تشير إلى ما إذا كان من الممكن تعيين عدة مرشحات على حقول جدول محوري.
missing_items_limitيحدد قيمة منطقية تشير إلى ما إذا كان من الممكن تعيين عدة مرشحات على حقول جدول محوري.
enable_data_value_editingيحدد قيمة منطقية تشير إلى ما إذا كان يُسمح للمستخدم بتحرير الخلايا في منطقة البيانات في الجدول المحوري.
تمكين تحرير الخلايا في منطقة القيم
show_data_tipsيقوم بتحديد قيمة منطقية تشير إلى ما إذا كان يجب عرض تلميحات الأدوات لخلايا بيانات الجدول المحوري.
show_member_property_tipsيحدد قيمة منطقية تشير إلى ما إذا كان ينبغي حذف معلومات خصائص العضو من تلميحات أدوات PivotTable.
show_values_rowيشير إلى ما إذا كان يتم عرض صف القيم.
show_empty_colيشير إلى ما إذا كان سيتم تضمين الأعمدة الفارغة في الجدول
show_empty_rowيشير إلى ما إذا كان سيتم تضمين الصفوف الفارغة في الجدول.
field_list_sort_ascendingيشير إلى ما إذا كانت الحقول في الجدول المحوري مرتبة بترتيب غير افتراضي في قائمة الحقول.
print_drillيحدد قيمة منطقية تشير إلى ما إذا كان يجب طباعة مؤشرات الحفر.
طباعة أزرار التوسيع/الطي عند عرضها على الجدول المحوري.
alt_text_titleيحصل على عنوان النص البديل ويحدده.
alt_text_descriptionيحصل على وصف النص البديل.
nameيحصل على اسم الجدول المحوري
column_header_captionيحصل على عنوان رأس العمود للجدول المحوري.
indentيقوم بتحديد زيادة المسافة البادئة للمحور المضغوط ويمكن استخدامه لتعيين تخطيط التقرير إلى نموذج مضغوط.
row_header_captionيحصل على تسمية توضيحية لرأس الصف في جدول البيانات المحوري.
show_row_header_captionيشير إلى ما إذا كان سيتم عرض عنوان رأس الصف في تقرير PivotTable
يشير إلى ما إذا كان سيتم عرض عناوين الحقول وقوائم التصفية المنسدلة
custom_list_sortيشير إلى ما إذا كان سيتم أخذ القائمة المخصصة المضمنة في الاعتبار عند فرز البيانات
pivot_format_conditionsيحصل على شروط التنسيق للجدول المحوري.
conditional_formatsيحصل على التنسيقات الشرطية لجدول المحور.
page_field_orderيحصل على الترتيب الذي تتم به إضافة حقول الصفحة إلى تخطيط تقرير PivotTable ويقوم بتعيينه.
page_field_wrap_countيحصل على عدد حقول الصفحة في كل عمود أو صف في تقرير PivotTable.
tagيحصل على سلسلة محفوظة مع تقرير PivotTable.
save_dataيشير إلى ما إذا كان يتم حفظ البيانات الخاصة بتقرير PivotTable مع المصنف.
refresh_data_on_opening_fileيشير إلى ما إذا كان سيتم تحديث البيانات عند فتح الملف.
refresh_data_flagيشير إلى ما إذا كان يتم تحديث البيانات أم لا.
source_typeيحصل على نوع مصدر البيانات للجدول المحوري.
external_connection_data_sourceيحصل على مصدر بيانات الاتصال الخارجي.
data_sourceيحصل على مصدر البيانات للجدول المحوري ويقوم بتعيينه.
pivot_formatsيحصل على مجموعة التنسيقات المطبقة على PivotTable.
item_print_titlesيشير إلى ما إذا كان يجب تكرار أسماء PivotItem في الجزء العلوي من كل صفحة مطبوعة.
repeat_items_on_each_printed_pageيشير إلى ما إذا كانت تسميات العناصر المحورية في منطقة الصف تتكرر في كل صفحة مطبوعة لحقول المحور في شكل جدول.
print_titlesيشير إلى ما إذا كانت عناوين الطباعة لورقة العمل محددة بناءً على
في تقرير الجدول المحوري. القيمة الافتراضية هي خطأ.
display_immediate_itemsيشير إلى ما إذا كانت العناصر الموجودة في مناطق الصفوف والأعمدة مرئية
عندما تكون منطقة بيانات الجدول المحوري فارغة. القيمة الافتراضية هي “صحيح”.
is_selectedيشير إلى ما إذا كان تم تحديد جدول المحور هذا.
show_pivot_style_row_headerيشير إلى ما إذا كان يجب تطبيق النمط على رأس الصف في جدول المحور.
show_pivot_style_column_headerيشير إلى ما إذا كان يجب تطبيق النمط على رأس العمود في جدول المحور.
show_pivot_style_row_stripesيشير إلى ما إذا كان يتم تطبيق تنسيق شريط الصف.
show_pivot_style_column_stripesيشير إلى ما إذا كان يتم تطبيق تنسيق الشريط على العمود.
show_pivot_style_last_columnيشير إلى ما إذا كان يتم تطبيق تنسيق العمود.

طُرق

طريقةوصف
remove_field(self, field_type, field_name)إزالة حقل من منطقة حقل محددة
remove_field(self, field_type, base_field_index)إزالة حقل من منطقة حقل محددة
remove_field(self, field_type, pivot_field)إزالة الحقل من منطقة الحقل المحددة
add_field_to_area(self, field_type, field_name)يضيف الحقل إلى المنطقة المحددة.
add_field_to_area(self, field_type, base_field_index)يضيف الحقل إلى المنطقة المحددة.
add_field_to_area(self, field_type, pivot_field)يضيف الحقل إلى المنطقة المحددة.
add_calculated_field(self, name, formula, drag_to_data_area)إضافة حقل محسوب إلى حقل المحور.
add_calculated_field(self, name, formula)إضافة حقل محسوب إلى حقل المحور وسحبه إلى منطقة البيانات.
move(self, row, column)نقل الجدول المحوري إلى موقع مختلف في ورقة العمل.
move(self, dest_cell_name)نقل الجدول المحوري إلى موقع مختلف في ورقة العمل.
move_to(self, row, column)نقل الجدول المحوري إلى موقع مختلف في ورقة العمل.
move_to(self, dest_cell_name)نقل الجدول المحوري إلى موقع مختلف في ورقة العمل.
get_source(self)احصل على بيانات المصدر الخاصة بـ Pivotable.
get_source(self, is_original)احصل على بيانات المصدر الخاصة بـ Pivotable.
refresh_data(self)يقوم بتحديث بيانات الجدول المحوري وإعداداته من مصدر البيانات الخاص به.
refresh_data(self, option)يقوم بتحديث بيانات الجدول المحوري وإعداداته من مصدر البيانات الخاص به باستخدام الخيارات.
calculate_data(self)حساب بيانات الجدول المحوري للخلايا.
calculate_data(self, option)حساب جداول المحور مع الخيارات
format(self, pivot_area, style)تنسيق المنطقة المحددة من الجدول المحوري.
format(self, ca, style)تنسيق المنطقة المحددة من الجدول المحوري.
format(self, row, column, style)تنسيق الخلية في منطقة الجدول المحوري
set_auto_group_field(self, base_field_index)تعيين مجموعة الحقول التلقائية حسب جدول البيانات المحوري.
set_auto_group_field(self, pivot_field)تعيين مجموعة الحقول التلقائية حسب جدول البيانات المحوري.
set_manual_group_field(self, base_field_index, start_val, end_val, group_by_list, interval_num)تعيين مجموعة الحقول اليدوية حسب جدول البيانات المحوري.
set_manual_group_field(self, pivot_field, start_val, end_val, group_by_list, interval_num)تعيين مجموعة الحقول اليدوية حسب جدول البيانات المحوري.
set_manual_group_field(self, base_field_index, start_val, end_val, group_by_list, interval_num)تعيين مجموعة الحقول اليدوية حسب جدول البيانات المحوري.
set_manual_group_field(self, pivot_field, start_val, end_val, group_by_list, interval_num)تعيين مجموعة الحقول اليدوية حسب جدول البيانات المحوري.
set_ungroup(self, base_field_index)تعيين إلغاء التجميع حسب جدول البيانات المحوري
set_ungroup(self, pivot_field)تعيين إلغاء التجميع حسب جدول البيانات المحوري
copy_style(self, pivot_table)نسخ النمط المسمى من جدول محوري آخر.
show_report_filter_page(self, page_field)إظهار جميع صفحات مرشح التقرير وفقًا لـ PivotField، ويجب أن يكون PivotField موجودًا في PageFields.
show_report_filter_page_by_name(self, field_name)إظهار جميع صفحات مرشح التقرير وفقًا لاسم PivotField، ويجب أن يكون PivotField موجودًا في PageFields.
show_report_filter_page_by_index(self, pos_index)إظهار جميع صفحات مرشح التقرير وفقًا لمؤشر الموضع في PageFields
get_fields(self, field_type)يحصل على قائمة حقول المحور المحددة حسب المنطقة.
fields(self, field_type)يحصل على الحقول المحددة حسب نوع الحقل.
get_source_data_connections(self)يحصل على مصادر بيانات الاتصال الخارجية.
get_names_of_source_data_connections(self)يحصل على اسم اتصالات البيانات المصدرية الخارجية.
change_data_source(self, source)تعيين بيانات المصدر لجدول محوري.
clear_data(self)مسح بيانات وتنسيق PivotTable
calculate_range(self)يحسب نطاق الجدول المحوري.
format_all(self, style)تنسيق كافة الخلايا في منطقة الجدول المحوري
format_row(self, row, style)تنسيق بيانات الصف في منطقة الجدول المحوري
select_area(self, ca)حدد منطقة عرض جدول المحور.
show_detail(self, row_offset, column_offset, new_sheet, dest_row, dest_column)إظهار تفاصيل عنصر واحد في منطقة البيانات في جدول جديد.
get_horizontal_page_breaks(self)يحصل على فواصل الصفحات الأفقية لهذا الجدول المحوري.
get_horizontal_breaks(self)يحصل على قائمة فهرس الصفوف في جدول محوري لفواصل الصفحات الأفقية
show_in_compact_form(self)تخطيط جدول البيانات المحوري في شكل مضغوط.
show_in_outline_form(self)تخطيط جدول البيانات المحوري في شكل مخطط تفصيلي.
show_in_tabular_form(self)تخطيط الجدول المحوري في شكل جدول.
get_cell_by_display_name(self, display_name)يحصل على الكائن Cell حسب اسم العرض PivotField.
get_children(self)يحصل على جداول البيانات المحورية للأطفال التي تستخدم بيانات جدول البيانات المحوري هذا كمصدر للبيانات.

مثال

from aspose.cells import FormatConditionType, OperatorType, Workbook
from aspose.cells.pivot import PivotFieldType, PivotFilterType, PivotTableStyleType
from aspose.pydrawing import Color

book = Workbook()
sheet = book.worksheets[0]
cells = sheet.cells
cells.get(0, 0).value = "fruit"
cells.get(1, 0).value = "grape"
cells.get(2, 0).value = "blueberry"
cells.get(3, 0).value = "kiwi"
cells.get(4, 0).value = "cherry"
cells.get(5, 0).value = "grape"
cells.get(6, 0).value = "blueberry"
cells.get(7, 0).value = "kiwi"
cells.get(8, 0).value = "cherry"
cells.get(0, 1).value = "year"
cells.get(1, 1).value = 2020
cells.get(2, 1).value = 2020
cells.get(3, 1).value = 2020
cells.get(4, 1).value = 2020
cells.get(5, 1).value = 2021
cells.get(6, 1).value = 2021
cells.get(7, 1).value = 2021
cells.get(8, 1).value = 2021
cells.get(0, 2).value = "amount"
cells.get(1, 2).value = 50
cells.get(2, 2).value = 60
cells.get(3, 2).value = 70
cells.get(4, 2).value = 80
cells.get(5, 2).value = 90
cells.get(6, 2).value = 100
cells.get(7, 2).value = 110
cells.get(8, 2).value = 120
pivots = sheet.pivot_tables
pivotIndex = pivots.add("=Sheet1!A1:C9", "A12", "TestPivotTable")
pivot = pivots[pivotIndex]
pivot.add_field_to_area(PivotFieldType.ROW, "fruit")
pivot.add_field_to_area(PivotFieldType.COLUMN, "year")
pivot.add_field_to_area(PivotFieldType.DATA, "amount")
pivot.pivot_table_style_type = PivotTableStyleType.PIVOT_TABLE_STYLE_MEDIUM10
# Change PivotField's attributes
rowField = pivot.row_fields[0]
rowField.display_name = "custom display name"
# Add PivotFilter
index = pivot.pivot_filters.add(0, PivotFilterType.COUNT)
filter = pivot.pivot_filters[index]
filter.auto_filter.filter_top10(0, False, False, 2)
# Add PivotFormatCondition
formatIndex = pivot.pivot_format_conditions.add()
pfc = pivot.pivot_format_conditions[formatIndex]
fcc = pfc.format_conditions
fcc.add_area(pivot.data_body_range)
idx = fcc.add_condition(FormatConditionType.CELL_VALUE)
fc = fcc[idx]
fc.formula1 = "100"
fc.operator = OperatorType.GREATER_OR_EQUAL
fc.style.background_color = Color.red
pivot.refresh_data()
pivot.calculate_data()
# do your business
book.save("out.xlsx")

أنظر أيضا