PivotField

PivotField class

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

public class PivotField

الخصائص

اسم وصف
AutoShowCount { get; set; } يمثل عدد العناصر العلوية أو السفلية التي تظهر تلقائيًا في حقل PivotTable المحدد.
AutoShowField { get; set; } يمثل فهرس حقل العرض التلقائي. -1 تعني PivotField نفسها. يجب أن يكون فهرس حقول البيانات.
AutoSortField { get; set; } يمثل فهرس حقل الفرز التلقائي. -1 تعني PivotField نفسها ، والبعض الآخر يعني موضع حقول البيانات.
BaseFieldIndex { get; set; } يمثل الحقل الأساسي لحساب مخصص.
BaseIndex { get; set; } يمثل فهرس PivotField في PivotField الأساسية.
BaseItemIndex { get; set; } يمثل العنصر في الحقل الأساسي لحساب مخصص . صالح فقط لحقول البيانات.
BaseItemPosition { get; set; } يمثل العنصر في الحقل الأساسي لحساب مخصص . صالح فقط لحقول البيانات. نظرًا لأن PivotItemPosition.Custom للقراءة فقط ، إذا كنت بحاجة إلى تعيين PivotItemPosition.Custom ، يرجى تعيين PivotField.BaseItemIndex السمة.
CurrentPageItem { get; set; } يمثل عنصر الصفحة الحالي المعروض لحقل الصفحة (صالح فقط لحقول الصفحة).
DataDisplayFormat { get; set; } يمثل كيفية عرض القيم الموجودة في حقل البيانات.
DisplayName { get; set; } يمثل اسم عرض PivotField .
DragToColumn { get; set; } يشير إلى ما إذا كان الحقل المحدد يمكن سحبه إلى موضع العمود. القيمة الافتراضية هي true .
DragToData { get; set; } يشير إلى إمكانية سحب الحقل المحدد إلى موضع البيانات. القيمة الافتراضية صحيحة.
DragToHide { get; set; } يشير إلى إمكانية سحب الحقل المحدد إلى موضع الإخفاء. القيمة الافتراضية هي true .
DragToPage { get; set; } يشير إلى إمكانية سحب الحقل المحدد إلى موضع الصفحة. القيمة الافتراضية صحيحة.
DragToRow { get; set; } يشير إلى إمكانية سحب الحقل المحدد إلى موضع الصف . القيمة الافتراضية هي “true”.
Function { get; set; } يمثل الوظيفة المستخدمة لتلخيص حقل بيانات PivotTable.
InsertBlankRow { get; set; } يشير إلى ما إذا كان يتم إدخال سطر فارغ بعد كل عنصر.
IsAscendShow { get; set; } يشير إلى ما إذا كان حقل PivotTable المحدد يتم عرضه تلقائيًا بشكل تصاعدي.
IsAscendSort { get; set; } يشير إلى ما إذا كان حقل PivotTable المحدد يتم فرزه تلقائيًا تصاعديًا.
IsAutoShow { get; set; } يشير إلى ما إذا كان حقل PivotTable المحدد معروضًا تلقائيًا ، وصالح فقط لـ Excel 2003.
IsAutoSort { get; set; } يشير إلى ما إذا كان سيتم فرز حقل PivotTable المحدد تلقائيًا.
IsAutoSubtotals { get; set; } يشير إلى ما إذا كان الحقل المحدد يعرض الإجماليات الفرعية التلقائية. الافتراضي هو الصحيح.
IsCalculatedField { get; } يشير إلى ما إذا كان حقل PivotTable المحدد محسوبًا أم لا.
IsIncludeNewItemsInFilter { get; set; } يشير إلى ما إذا كان الحقل يمكن أن يتضمن عناصر جديدة في filter اليدوي القيمة الافتراضية هي false.
IsInsertPageBreaksBetweenItems { get; set; } يشير إلى ما إذا كان الحقل يمكنه إدراج فواصل صفحات بين items إدراج فاصل صفحة بعد كل item القيمة الافتراضية هي false.
IsMultipleItemSelectionAllowed { get; set; } يشير إلى ما إذا كان الحقل يمكن أن يحتوي على عدة عناصر محددة في حقل الصفحة القيمة الافتراضية هي “خطأ”.
IsRepeatItemLabels { get; set; } يشير إلى ما إذا كان الحقل يمكنه تكرار تسميات العناصر القيمة الافتراضية هي false.
ItemCount { get; } الحصول على عدد العناصر الأساسية لهذا الحقل المحوري.
Items { get; } الحصول على كافة العناصر الأساسية ؛
Name { get; } يمثل اسم PivotField .
Number { get; set; } يمثل تنسيق العرض المضمن للأرقام والتواريخ.
NumberFormat { get; set; } يمثل تنسيق العرض المخصص للأرقام والتواريخ.
OriginalItems { get; } احصل على العناصر الأساسية الأصلية ؛
PivotItems { get; } الحصول على العناصر المحورية للحقل المحوري
Position { get; } يمثل فهرس PivotField في PivotFields.
Range { get; } الحصول على نطاق المجموعة للحقل المحوري
ShowAllItems { get; set; } يشير إلى ما إذا كانت كافة العناصر في تقرير PivotTable معروضة أم لا ، حتى إذا لم تكن تحتوي على بيانات موجزة. إظهار العناصر التي لا تحتوي على بيانات القيمة الافتراضية خاطئة.
ShowCompact { get; set; } يشير إلى ما إذا كان عرض التسميات من الحقل التالي في نفس العمود في طريقة عرض Pivot Table
ShowInOutlineForm { get; set; } يشير إلى ما إذا كان تخطيط هذا الحقل في نموذج المخطط التفصيلي في طريقة عرض Pivot Table
ShowSubtotalAtTop { get; set; } عندما يكون ShowInOutlineForm صحيحًا ، قم بعرض المجاميع الفرعية أعلى قائمة العناصر بدلاً من عرضها في الأسفل

طُرق

اسم وصف
AddCalculatedItem(string, string) أضف عنصرًا محسوبًا إلى الحقل المحوري.
GetCalculatedFieldFormula() احصل على سلسلة الصيغة للحقل المحسوب المحدد .
GetPivotFilterByType(PivotFilterType) يحصل على عامل التصفية المحوري للحقل المحوري حسب النوع
GetPivotFilters() الحصول على عوامل التصفية المحورية للحقل المحوري
GetSubtotals(PivotFieldSubtotalType) تحديد ما إذا كان الحقل المحدد يعرض هذه المجاميع الفرعية.
HideDetail(bool) يحدد ما إذا كانت العناصر المحورية في الحقل المحوري هي تفاصيل مخفية. وهذا يعني طي / توسيع هذا الحقل .
HideItem(int, bool) تعيين ما إذا كان PivotItem المحدد في حقل بيانات مخفيًا.
HideItem(string, bool) تعيين ما إذا كان PivotItem المحدد في حقل بيانات مخفيًا.
HideItemDetail(int, bool) تعيين ما إذا كان PivotItem المحدد في حقل محوري هو تفاصيل مخفية.
InitPivotItems() بدء العناصر المحورية للحقل المحوري
IsHiddenItem(int) يشير إلى ما إذا كان PivotItem المحدد مخفيًا.
IsHiddenItemDetail(int) يشير إلى ما إذا كان PivotItem المحدد هو تفاصيل مخفية.
SetSubtotals(PivotFieldSubtotalType, bool) يحدد ما إذا كان الحقل المحدد يعرض هذه المجاميع الفرعية.

أمثلة


[C#]

Workbook book = new Workbook();
Worksheet sheet = book.Worksheets[0];
Cells cells = sheet.Cells;
cells[0, 0].Value = "fruit";
cells[1, 0].Value = "grape";
cells[2, 0].Value = "blueberry";
cells[3, 0].Value = "kiwi";
cells[4, 0].Value = "cherry";
cells[5, 0].Value = "grape";
cells[6, 0].Value = "blueberry";
cells[7, 0].Value = "kiwi";
cells[8, 0].Value = "cherry";

cells[0, 1].Value = "year";
cells[1, 1].Value = 2020;
cells[2, 1].Value = 2020;
cells[3, 1].Value = 2020;
cells[4, 1].Value = 2020;
cells[5, 1].Value = 2021;
cells[6, 1].Value = 2021;
cells[7, 1].Value = 2021;
cells[8, 1].Value = 2021;

cells[0, 2].Value = "amount";
cells[1, 2].Value = 50;
cells[2, 2].Value = 60;
cells[3, 2].Value = 70;
cells[4, 2].Value = 80;
cells[5, 2].Value = 90;
cells[6, 2].Value = 100;
cells[7, 2].Value = 110;
cells[8, 2].Value = 120;

PivotTableCollection pivots = sheet.PivotTables;

int pivotIndex = pivots.Add("=Sheet1!A1:C9", "A12", "TestPivotTable");
PivotTable pivot = pivots[pivotIndex];
pivot.AddFieldToArea(PivotFieldType.Row, "fruit");
pivot.AddFieldToArea(PivotFieldType.Column, "year");
pivot.AddFieldToArea(PivotFieldType.Data, "amount");

pivot.PivotTableStyleType = PivotTableStyleType.PivotTableStyleMedium10;

// تغيير سمات PivotField
PivotField rowField = pivot.RowFields[0];
rowField.DisplayName = "custom display name";

pivot.RefreshData();
pivot.CalculateData();

// قم بعملك

book.Save("out.xlsx");

[Visual Basic]

Dim book As Workbook = New Workbook()
Dim sheet As Worksheet = book.Worksheets(0)
Dim cells As Cells = sheet.Cells

cells(0, 0).Value = "fruit"
cells(1, 0).Value = "grape"
cells(2, 0).Value = "blueberry"
cells(3, 0).Value = "kiwi"
cells(4, 0).Value = "cherry"
cells(5, 0).Value = "grape"
cells(6, 0).Value = "blueberry"
cells(7, 0).Value = "kiwi"
cells(8, 0).Value = "cherry"

cells(0, 1).Value = "year"
cells(1, 1).Value = 2020
cells(2, 1).Value = 2020
cells(3, 1).Value = 2020
cells(4, 1).Value = 2020
cells(5, 1).Value = 2021
cells(6, 1).Value = 2021
cells(7, 1).Value = 2021
cells(8, 1).Value = 2021

cells(0, 2).Value = "amount"
cells(1, 2).Value = 50
cells(2, 2).Value = 60
cells(3, 2).Value = 70
cells(4, 2).Value = 80
cells(5, 2).Value = 90
cells(6, 2).Value = 100
cells(7, 2).Value = 110
cells(8, 2).Value = 120

Dim pivots As PivotTableCollection = sheet.PivotTables
Dim pivotIndex As Int32 = pivots.Add("=Sheet1!A1:C9", "A12", "TestPivotTable")
Dim pivot As PivotTable = pivots(pivotIndex)
pivot.AddFieldToArea(PivotFieldType.Row, "fruit")
Pivot.AddFieldToArea(PivotFieldType.Column, "year")
Pivot.AddFieldToArea(PivotFieldType.Data, "amount")

pivot.PivotTableStyleType = PivotTableStyleType.PivotTableStyleMedium10

'Change PivotField's attributes
Dim rowField As PivotField = pivot.RowFields(0)
rowField.DisplayName = "custom display name"

pivot.RefreshData()
pivot.CalculateData()

book.Save("out_vb.xlsx")

أنظر أيضا