PivotField صف

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

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

ملكيات

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

طُرق

طريقة	وصف
`group_by(self, interval, new_field)`	تجميع الحقل تلقائيًا مع البيانات الداخلية
`group_by(self, start, end, groups, interval, first_as_new_field)`	قم بتجميع الملف حسب أنواع مجموعة التاريخ.
`group_by(self, start, end, interval, new_field)`	تجميع الملف حسب الرقم.
`group_by(self, custom_group_items, new_field)`	مجموعة مخصصة للحقل.
`sort_by(self, sort_type, field_sorted_by)`	فرز حقل المحور هذا.
`sort_by(self, sort_type, field_sorted_by, data_type, cell_name)`	فرز حقل المحور هذا.
`hide_item(self, index, is_hidden)`	يحدد ما إذا كان العنصر المحوري المحدد في حقل البيانات مخفيًا.
`hide_item(self, item_value, is_hidden)`	يحدد ما إذا كان العنصر المحوري المحدد في حقل البيانات مخفيًا.
`init_pivot_items(self)`	قم ببدء عناصر المحور في حقل المحور
`ungroup(self)`	إلغاء تجميع حقل المحور.
`get_pivot_filter_by_type(self, type)`	يحصل على مرشح المحور لحقل المحور حسب النوع
`get_pivot_filters(self)`	يحصل على مرشحات المحور لحقل المحور
`get_filters(self)`	يحصل على جميع مرشحات المحور لهذا الحقل المحوري.
`clear_filter(self)`	مسح إعدادات الفلتر في حقل المحور هذا.
`filter_top10(self, value_field_index, type, is_top, item_count)`	التصفية حسب قيم حقل البيانات المحورية.
`filter_by_value(self, value_field_index, type, value1, value2)`	التصفية حسب قيم حقل البيانات المحورية.
`filter_by_label(self, type, label1, label2)`	تصفية حسب تسميات حقل المحور الصف أو العمود.
`filter_by_date(self, type, date_time1, date_time2)`	تصفية حسب إعداد التاريخ لحقل المحور الصف أو العمود.
`get_calculated_field_formula(self)`	احصل على سلسلة الصيغة للحقل المحسوب المحدد.
`get_formula(self)`	يحصل على صيغة الحقل المحسوب.
`set_subtotals(self, subtotal_type, shown)`	يحدد ما إذا كان الحقل المحدد يعرض تلك المجاميع الفرعية.
`get_subtotals(self, subtotal_type)`	يشير إلى ما إذا كان يتم عرض المجموع الفرعي المحدد.
`show_values_as(self, display_format, base_field, base_item_position_type, base_item)`	إظهار قيم حقل البيانات بتنسيق عرض مختلف عند استخدام حساب ShowDataAs.
`is_hidden_item(self, index)`	يحصل على ما إذا كان PivotItem المحدد مخفيًا.
`is_hidden_item_detail(self, index)`	يحصل على ما إذا كان يتم إخفاء تفاصيل PivotItem المحدد.
`hide_item_detail(self, index, is_hidden_detail)`	يحدد ما إذا كان العنصر المحوري المحدد في حقل المحور مخفيًا أم لا.
`hide_detail(self, is_hidden_detail)`	يحدد ما إذا كانت العناصر المحورية في حقل المحور مخفية أم لا. وهذا يعني انهيار/توسيع هذا الحقل.
`add_calculated_item(self, name, formula)`	أضف عنصر صيغة محسوبة إلى حقل المحور.

مثال

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

أنظر أيضا

الوحدة aspose.cells.pivot
فئة PivotField

PivotDiscreteGroupSettings صف PivotFieldCollection صف