PivotTable صف

PivotTable صف

وصف موجز لPivotTable.

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

ملكيات

ملكيةوصف
is_excel_2003_compatibleتحديد ما إذا كان PivotTable متوافقًا مع Excel2003 عند تحديث PivotTable،
إذا كان صحيحًا، فيجب أن تكون السلسلة أقل من أو تساوي 255 حرفًا، لذلك إذا كانت السلسلة أكبر من 255 حرفًا،
سيتم اقتطاعها. إذا كانت القيمة false، فلن تحتوي السلسلة على القيد المذكور أعلاه.
القيمة الافتراضية هي الحقيقية.
refreshed_by_whoالحصول على اسم المستخدم الذي قام بتحديث PivotTable آخر مرة
refresh_dateالحصول على تاريخ آخر تحديث لـ PivotTable.
pivot_table_style_nameالحصول على اسم النمط المحوري وتعيينه.
pivot_table_style_typeالحصول على نمط الجدول المحوري المدمج وتعيينه.
column_fieldsتقوم بإرجاع كائن PivotFields الذي يتم عرضه حاليًا كحقول أعمدة.
row_fieldsإرجاع كائن PivotFields الذي يتم عرضه حاليًا كحقول صف.
page_fieldsتقوم بإرجاع كائن PivotFields الذي يتم عرضه حاليًا كحقول صفحة.
data_fieldsالحصول على كائن PivotField الذي يمثل كافة حقول البيانات في PivotTable.
للقراءة فقط. سيكون الحرف الأول فقط عندما يكون هناك حقلان أو أكثر من حقول البيانات في DataPiovtFiels.
يُستخدم فقط لإضافة DataPivotField إلى منطقة الصف/العمود PivotTable. الافتراضي في منطقة الصف.
data_fieldالحصول على كائن PivotField الذي يمثل كافة حقول البيانات في PivotTable.
للقراءة فقط. سيكون الحرف الأول فقط عندما يكون هناك حقلان أو أكثر من حقول البيانات في DataPiovtFiels.
يُستخدم فقط لإضافة DataPivotField إلى منطقة الصف/العمود PivotTable. الافتراضي في منطقة الصف.
base_fieldsإرجاع كائن PivotFields يتضمن كافة الحقول في تقرير PivotTable
pivot_filtersإرجاع كائن PivotFilterCollection.
column_rangeإرجاع كائن CellArea الذي يمثل النطاق
الذي يحتوي على منطقة العمود في تقرير PivotTable. يقرأ فقط.
row_rangeإرجاع كائن CellArea الذي يمثل النطاق
الذي يحتوي على منطقة الصف في تقرير PivotTable. يقرأ فقط.
data_body_rangeإرجاع كائن CellArea الذي يمثل النطاق الذي يحتوي على منطقة البيانات
في القائمة بين صف الرأس وصف الإدراج. يقرأ فقط.
table_range1إرجاع كائن CellArea الذي يمثل النطاق الذي يحتوي على تقرير PivotTable بأكمله،
ولكن لا يتضمن حقول الصفحة. يقرأ فقط.
table_range2إرجاع كائن CellArea الذي يمثل النطاق الذي يحتوي على تقرير PivotTable بأكمله،
يتضمن حقول الصفحة. يقرأ فقط.
column_grandالإشارة إلى ما إذا كان تقرير PivotTable يعرض الإجماليات الكلية للأعمدة.
is_grid_drop_zonesيشير إلى ما إذا كان تقرير PivotTable يعرض تخطيطًا كلاسيكيًا قابلاً للمحور أم لا.
(يتيح سحب الحقول في الشبكة)
row_grandالإشارة إلى ما إذا كان تقرير PivotTable يعرض الإجماليات الكلية للصفوف.
display_null_stringالإشارة إلى ما إذا كان تقرير PivotTable يعرض سلسلة مخصصة
في الخلايا التي تحتوي على قيم فارغة.
null_stringالحصول على السلسلة المعروضة في الخلايا التي تحتوي على قيم فارغة
عندما تكون الخاصية DisplayNullString صحيحة. القيمة الافتراضية هي سلسلة فارغة.
display_error_stringالإشارة إلى ما إذا كان تقرير PivotTable يعرض سلسلة مخصصة في الخلايا التي تحتوي على أخطاء.
data_field_header_nameالحصول على اسم رأس حقل منطقة القيمة وتعيينه في PivotTable.
error_stringالحصول على السلسلة المعروضة في الخلايا التي تحتوي على أخطاء
عندما تكون الخاصية DisplayErrorString صحيحة. القيمة الافتراضية هي سلسلة فارغة.
is_auto_formatالإشارة إلى ما إذا كان تقرير PivotTable قد تم تنسيقه تلقائياً.
حدد خانة الاختيار “جدول التنسيق التلقائي” الموجود في الخيار المحوري لبرنامج Excel 2003
autofit_column_width_on_updateيشير إلى ما إذا كان سيتم ضبط عرض العمود تلقائيًا عند التحديث
auto_format_typeالحصول على نوع التنسيق التلقائي لـ PivotTable.
has_blank_rowsيشير إلى ما إذا كان سيتم إضافة صفوف فارغة.
تنطبق هذه الخاصية فقط على أنواع التنسيقات التلقائية لـ PivotTable والتي تحتاج إلى إضافة صفوف فارغة.
merge_labelsالإشارة إلى ما إذا كان عنصر الصف الخارجي لتقرير PivotTable المحدد، أو عنصر العمود، أو الإجمالي الفرعي،
وتستخدم التسميات الإجمالية الخلايا المدمجة.
preserve_formattingالإشارة إلى ما إذا كان سيتم الاحتفاظ بالتنسيق عند تحديث PivotTable أو إعادة حسابه.
show_drillمعرفة ما إذا كانت أزرار التوسيع/الطي معروضة أم لا.
enable_drilldownمعرفة ما إذا كان التصفح ممكّنًا أم لا.
enable_field_dialogالإشارة إلى ما إذا كان مربع الحوار حقل PivotTable متوفراً أم لا
عندما ينقر المستخدم نقرًا مزدوجًا فوق حقل PivotTable.
enable_field_listالحصول على ما إذا كان سيتم تمكين قائمة الحقول لـ PivotTable.
enable_wizardالإشارة إلى ما إذا كان معالج PivotTable متوفراً أم لا.
subtotal_hidden_page_itemsالإشارة إلى ما إذا كانت عناصر حقل الصفحة مخفية في تقرير PivotTable
يتم تضمينها في الإجماليات الفرعية للصفوف والأعمدة، وإجماليات الكتلة، والإجماليات الكلية.
القيمة الافتراضية هي كاذبة.
grand_total_nameإرجاع تسمية السلسلة النصية التي يتم عرضها في عمود الإجمالي الكلي أو عنوان الصف.
القيمة الافتراضية هي السلسلة “الإجمالي الإجمالي”.
manual_updateالإشارة إلى ما إذا كان سيتم إعادة حساب تقرير PivotTable بناءً على طلب المستخدم فقط.
is_multiple_field_filtersيحدد قيمة منطقية تشير إلى ما إذا كان يمكن تعيين عوامل تصفية متعددة لحقول PivotTable.
missing_items_limitيحدد قيمة منطقية تشير إلى ما إذا كان يمكن تعيين عوامل تصفية متعددة لحقول PivotTable.
enable_data_value_editingيحدد قيمة منطقية تشير إلى ما إذا كان مسموحًا للمستخدم بتحرير الخلايا في منطقة البيانات بالجدول المحوري.
تمكين تحرير الخلايا في منطقة القيم
show_data_tipsيحدد قيمة منطقية تشير إلى ما إذا كان يجب عرض تلميحات الأدوات لخلايا بيانات PivotTable.
show_member_property_tipsيحدد قيمة منطقية تشير إلى ما إذا كان يجب حذف معلومات خاصية العضو من تلميحات أدوات PivotTable.
show_values_rowيحدد قيمة منطقية تشير إلى ما إذا كان سيتم عرض صف القيم أم لا.
إظهار صف القيم
show_empty_colيحدد قيمة منطقية تشير إلى ما إذا كان سيتم تضمين أعمدة فارغة في الجدول أم لا
show_empty_rowيحدد قيمة منطقية تشير إلى ما إذا كان سيتم تضمين صفوف فارغة في الجدول أم لا.
field_list_sort_ascendingيحدد قيمة منطقية تشير إلى ما إذا كانت الحقول الموجودة في PivotTable قد تم فرزها بترتيب غير افتراضي في قائمة الحقول.
print_drillيحدد قيمة منطقية تشير إلى ما إذا كان يجب طباعة مؤشرات الحفر.
طباعة أزرار التوسيع/الطي عند عرضها على المحور.
alt_text_titleيحصل على عنوان النص البديل
alt_text_descriptionالحصول على وصف النص البديل
nameالحصول على اسم PivotTable
column_header_captionالحصول على تسمية توضيحية لرأس العمود في PivotTable.
indentيحدد زيادة المسافة البادئة للمحور المضغوط ويمكن استخدامه لتعيين تخطيط التقرير إلى نموذج مضغوط.
row_header_captionالحصول على تسمية توضيحية لرأس الصف لـ PivotTable.
show_row_header_captionالإشارة إلى ما إذا كان سيتم عرض التسمية التوضيحية لرأس الصف في تقرير PivotTable
يشير إلى ما إذا كان سيتم عرض التسميات التوضيحية للحقول والقوائم المنسدلة للتصفية
custom_list_sortيشير إلى ما إذا كان يجب مراعاة القائمة المخصصة المضمنة عند فرز البيانات
pivot_format_conditionsالحصول على شروط التنسيق للجدول المحوري.
page_field_orderالحصول على الترتيب الذي تتم به إضافة حقول الصفحة إلى تخطيط تقرير PivotTable.
page_field_wrap_countالحصول على عدد حقول الصفحة في كل عمود أو صف في تقرير PivotTable.
tagالحصول على سلسلة محفوظة في تقرير PivotTable.
save_dataالإشارة إلى ما إذا كان سيتم حفظ بيانات تقرير PivotTable مع المصنف.
refresh_data_on_opening_fileيشير إلى ما إذا كان تحديث البيانات عند فتح الملف.
refresh_data_flagيشير إلى ما إذا كان تحديث البيانات أم لا.
external_connection_data_sourceيحصل على مصدر بيانات الاتصال الخارجي.
data_sourceالحصول على مصدر بيانات الجدول المحوري وتعيينه.
pivot_formatsالحصول على مجموعة التنسيقات المطبقة على PivotTable.
item_print_titlesبت يحدد ما إذا كانت التسميات التوضيحية للعنصر المحوري موجودة على محور الصف
تتكرر في كل صفحة مطبوعة للحقول المحورية في شكل جدول.
print_titlesيشير إلى ما إذا كانت عناوين الطباعة لورقة العمل قد تم تعيينها بناءً على ذلك
في تقرير PivotTable. القيمة الافتراضية هي كاذبة.
display_immediate_itemsيشير إلى ما إذا كانت العناصر الموجودة في مناطق الصفوف والأعمدة مرئية أم لا
عندما تكون منطقة البيانات في PivotTable فارغة. القيمة الافتراضية هي الحقيقية.
is_selectedالإشارة إلى ما إذا كان PivotTable محددًا أم لا.
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إزالة حقل من منطقة حقل محددة
remove_fieldإزالة حقل من منطقة حقل محددة
remove_fieldإزالة الحقل من منطقة حقل محددة
add_field_to_areaإضافة الحقل إلى المنطقة المحددة.
add_field_to_areaإضافة الحقل إلى المنطقة المحددة.
add_field_to_areaإضافة الحقل إلى المنطقة المحددة.
add_calculated_fieldإضافة حقل محسوب إلى الحقل المحوري.
add_calculated_fieldيضيف حقلاً محسوبًا إلى الحقل المحوري ويسحبه إلى منطقة البيانات.
moveنقل PivotTable إلى موقع مختلف في ورقة العمل.
moveنقل PivotTable إلى موقع مختلف في ورقة العمل.
formatتنسيقات المنطقة المحددة من PivotTable.
formatقم بتنسيق الخلية في منطقة المحور
set_auto_group_fieldيقوم بتعيين مجموعة الحقول التلقائية بواسطة PivotTable.
set_auto_group_fieldيقوم بتعيين مجموعة الحقول التلقائية بواسطة PivotTable.
set_manual_group_fieldتعيين مجموعة الحقول اليدوية بواسطة PivotTable.
set_manual_group_fieldتعيين مجموعة الحقول اليدوية بواسطة PivotTable.
set_manual_group_fieldتعيين مجموعة الحقول اليدوية بواسطة PivotTable.
set_manual_group_fieldتعيين مجموعة الحقول اليدوية بواسطة PivotTable.
set_ungroupيقوم بتعيين فك التجميع بواسطة PivotTable
set_ungroupيقوم بتعيين فك التجميع بواسطة PivotTable
copy_styleنسخ النمط المسمى من جدول محوري آخر.
show_report_filter_pageإظهار جميع صفحات تصفية التقرير وفقًا لـ PivotField، ويجب أن يكون PivotField موجودًا في PageFields.
show_report_filter_page_by_nameإظهار كافة صفحات تصفية التقرير وفقًا لاسم PivotField، ويجب أن يكون PivotField موجودًا في PageFields.
show_report_filter_page_by_indexإظهار جميع صفحات تصفية التقرير وفقًا لفهرس الموضع الموجود في PageFields
fieldsيحصل على الحقول المحددة حسب نوع الحقل.
change_data_sourceقم بتعيين البيانات المصدر للجدول المحوري.
الورقة 1!$A$1:$C$3
get_sourceاحصل على بيانات المصدر الخاصة بالجدول المحوري.
refresh_dataيقوم بتحديث بيانات المحور المحوري وإعداداته من مصدر بياناته.
calculate_dataحساب بيانات المحور المحوري إلى الخلايا.
clear_dataامسح بيانات وتنسيقات PivotTable
calculate_rangeيحسب نطاق المحوري.
format_allقم بتنسيق كافة الخلايا في منطقة المحور
format_rowقم بتنسيق بيانات الصف في منطقة المحور
get_horizontal_breaksالحصول على قائمة فهرس صف الجدول المحوري لفواصل الصفحات الأفقية
show_in_compact_formتخطيطات PivotTable في شكل مضغوط.
show_in_outline_formتخطيطات PivotTable في نموذج المخطط التفصيلي.
show_in_tabular_formتخطيطات PivotTable في شكل جدول.
get_cell_by_display_nameيحصل على الكائن Cell بواسطة اسم عرض PivotField.
get_childrenالحصول على الجداول المحورية التابعة التي تستخدم بيانات PivotTable هذه كمصدر للبيانات.

مثال

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

أنظر أيضا

PivotPageFields صف PivotTableCollection صف