PivotField صف

PivotField صف

يمثل حقلاً في تقرير PivotTable.

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

ملكيات

ملكيةوصف
pivot_itemsيحصل على العناصر المحورية للحقل المحوري
rangeيحصل على نطاق المجموعة للحقل المحوري
group_settingsيحصل على إعدادات المجموعة للحقل المحوري.
is_calculated_fieldالإشارة إلى ما إذا كان حقل PivotTable المحدد هو حقل محسوب.
base_indexيمثل فهرس PivotField في PivotFields الأساسي.
positionيمثل الرقم القياسي PivotField في المنطقة.
nameيمثل اسم PivotField.
display_nameيمثل اسم عرض PivotField.
is_auto_subtotalsالإشارة إلى ما إذا كان الحقل المحدد يعرض الإجماليات الفرعية التلقائية. الافتراضي صحيح.
drag_to_columnيشير إلى ما إذا كان يمكن سحب الحقل المحدد إلى موضع العمود.
القيمة الافتراضية هي الحقيقية.
drag_to_hideيشير إلى ما إذا كان يمكن سحب الحقل المحدد إلى موضع الإخفاء.
القيمة الافتراضية هي الحقيقية.
drag_to_rowيشير إلى ما إذا كان يمكن سحب الحقل المحدد إلى موضع الصف.
القيمة الافتراضية هي الحقيقية.
drag_to_pageيشير إلى ما إذا كان يمكن سحب الحقل المحدد إلى موضع الصفحة.
القيمة الافتراضية هي الحقيقية.
drag_to_dataيشير إلى ما إذا كان يمكن سحب الحقل المحدد إلى موضع البيانات.
القيمة الافتراضية هي الحقيقية.
is_multiple_item_selection_allowedيشير إلى ما إذا كان الحقل يمكن أن يحتوي على عناصر متعددة
المحدد في حقل الصفحة
القيمة الافتراضية هي كاذبة.
is_repeat_item_labelsيشير إلى ما إذا كان الحقل يمكنه تكرار تسميات العناصر
القيمة الافتراضية هي كاذبة.
is_include_new_items_in_filterيشير إلى ما إذا كان يمكن أن يتضمن الحقل عناصر جديدة في التصفية اليدوية
القيمة الافتراضية هي كاذبة.
is_insert_page_breaks_between_itemsيشير إلى ما إذا كان الحقل يمكنه إدراج فواصل الصفحات بين العناصر
إدراج فاصل الصفحات بعد كل عنصر
القيمة الافتراضية هي كاذبة.
show_all_itemsالإشارة إلى ما إذا كانت كافة العناصر معروضة في تقرير PivotTable أم لا،
حتى لو لم تحتوي على بيانات ملخصة.
إظهار العناصر التي لا تحتوي على بيانات
القيمة الافتراضية هي كاذبة.
non_auto_sort_defaultيشير إلى ما إذا كانت عملية الفرز التي سيتم تطبيقها على هذا الحقل المحوري هي عملية فرز تلقائي أو فرز بيانات بسيط.
is_auto_sortالإشارة إلى ما إذا كان سيتم فرز حقل PivotTable المحدد تلقائياً.
is_ascend_sortالإشارة إلى ما إذا كان حقل PivotTable المحدد قد تم فرزه تلقائياً تصاعدياً.
auto_sort_fieldيمثل فهرس حقل الفرز التلقائي.
-1 يعني PivotField نفسه، والبعض الآخر يعني موضع حقول البيانات.
is_auto_showيشير إلى ما إذا كان سيتم عرض حقل PivotTable المحدد تلقائيًا أم لا، وهو صالح فقط لـ Excel 2003.
is_ascend_showالإشارة إلى ما إذا كان سيتم عرض حقل PivotTable المحدد بشكل تصاعدي تلقائياً.
auto_show_countتمثيل عدد العناصر العلوية أو السفلية
التي يتم عرضها تلقائيًا في حقل PivotTable المحدد.
auto_show_fieldيمثل فهرس حقل العرض التلقائي. -1 يعني PivotField نفسه.
يجب أن يكون فهرس حقول البيانات.
functionيمثل الوظيفة المستخدمة لتلخيص حقل بيانات PivotTable.
data_display_formatيمثل كيفية عرض القيم الموجودة في حقل البيانات.
base_field_indexيمثل الحقل الأساسي لحساب مخصص.
base_item_positionيمثل العنصر الموجود في الحقل الأساسي لحساب مخصص.
صالحة فقط لحقول البيانات.
نظرًا لأن PivotItemPosition.Custom مخصص للقراءة فقط، إذا كنت بحاجة إلى تعيين PivotItemPosition.Custom،
الرجاء تعيين سمة PivotField.BaseItemIndex.
base_item_indexيمثل العنصر الموجود في الحقل الأساسي لحساب مخصص.
صالحة فقط لحقول البيانات.
current_page_itemيمثل عنصر الصفحة الحالي الذي يظهر لحقل الصفحة (صالح لحقول الصفحة فقط).
numberيمثل تنسيق العرض المدمج للأرقام والتواريخ.
insert_blank_rowيشير إلى ما إذا كان سيتم إدراج سطر فارغ بعد كل عنصر.
show_subtotal_at_topعندما تكون قيمة ShowInOutlineForm صحيحة، قم بعرض الإجماليات الفرعية في أعلى قائمة العناصر بدلاً من عرضها في الأسفل
show_in_outline_formيشير إلى ما إذا كان سيتم تخطيط هذا الحقل في شكل مخطط تفصيلي في طريقة عرض Pivot Table
number_formatيمثل تنسيق العرض المخصص للأرقام والتواريخ.
itemsالحصول على كافة العناصر الأساسية؛
original_itemsاحصل على العناصر الأساسية الأصلية؛
item_countالحصول على عدد العناصر الأساسية لهذا الحقل المحوري.
show_compactيشير إلى ما إذا كان سيتم عرض التسميات من الحقل التالي في نفس العمود في طريقة عرض Pivot Table

طُرق

طريقةوصف
group_byقم بتجميع الحقل تلقائيًا مع داخلي
group_byقم بتجميع الملف حسب أنواع مجموعة التاريخ.
group_byقم بتجميع الملف حسب الرقم.
group_byقم بتجميع الحقل المخصص.
hide_itemيضبط ما إذا كان عنصر PivotItem المحدد في حقل البيانات مخفيًا.
hide_itemيضبط ما إذا كان عنصر PivotItem المحدد في حقل البيانات مخفيًا.
get_pivot_filter_by_typeيحصل على عامل التصفية المحوري للحقل المحوري حسب النوع
get_pivot_filtersيحصل على المرشحات المحورية للحقل المحوري
get_filtersيحصل على جميع المرشحات المحورية لهذا الحقل المحوري.
init_pivot_itemsقم ببدء العناصر المحورية للحقل المحوري
ungroupقم بفك تجميع الحقل المحوري.
get_calculated_field_formulaالحصول على سلسلة الصيغة للحقل المحسوب المحدد.
set_subtotalsيضبط ما إذا كان الحقل المحدد يعرض تلك الإجماليات الفرعية.
get_subtotalsيشير إلى ما إذا كان سيتم إظهار الإجمالي الفرعي المحدد.
is_hidden_itemالإشارة إلى ما إذا كان عنصر PivotItem المحدد مخفيًا.
is_hidden_item_detailالإشارة إلى ما إذا كان عنصر PivotItem المحدد عبارة عن تفاصيل مخفية.
hide_item_detailيضبط ما إذا كان عنصر PivotItem المحدد في الحقل المحوري عبارة عن تفاصيل مخفية.
hide_detailيضبط ما إذا كانت عناصر PivotItems الموجودة في الحقل المحوري عبارة عن تفاصيل مخفية. وهذا يعني طي/توسيع هذا الحقل.
add_calculated_itemإضافة عنصر محسوب إلى الحقل المحوري.

مثال

from aspose.cells import Workbook
from aspose.cells.pivot import PivotFieldType, PivotTableStyleType

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"
pivot.refresh_data()
pivot.calculate_data()
# do your business
book.save("out.xlsx")

أنظر أيضا