This related for qax-os/excelize#2340, support set and get show value as of pivot table data fields

- Add new exported PivotTableShowValuesAs data type
- Add new exported PivotTableShowValuesAsType enumeration
- Add new field ShowValuesAs in the PivotTableField data type
- Upgrade GitHub Action packages version

Author: xuri

.github/workflows/build.yml

@@ -22,10 +22,10 @@ jobs:
           cache: false
 
       - name: Checkout code
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Checkout excelize-py
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           repository: xuri/excelize-py
           path: excelize-py
@@ -104,7 +104,7 @@ jobs:
           cache: false
 
       - name: Checkout excelize-py
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           repository: xuri/excelize-py
           path: .
@@ -208,7 +208,7 @@ jobs:
     if: github.event_name == 'release' && github.event.action == 'published'
     steps:
       - name: Checkout code
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Setup dotnet
         uses: actions/setup-dotnet@v5

Excelize/TypesC.cs

@@ -544,6 +544,14 @@ public unsafe struct Chart
         public int* Overlap;
     }
 
+    [StructLayout(LayoutKind.Sequential)]
+    public unsafe struct PivotTableShowValuesAs
+    {
+        public byte Type;
+        public sbyte* BaseField;
+        public sbyte* BaseItem;
+    }
+
     [StructLayout(LayoutKind.Sequential)]
     public unsafe struct PivotTableField
     {
@@ -567,6 +575,7 @@ public unsafe struct PivotTableField
         public int NumFmt;
         public int SelectedItemsLen;
         public sbyte** SelectedItems;
+        public PivotTableShowValuesAs ShowValuesAs;
     }
 
     [StructLayout(LayoutKind.Sequential)]

Excelize/TypesCs.cs

@@ -223,6 +223,28 @@ public enum PictureInsertType : byte
         PictureInsertTypeDISPIMG = 3,
     }
 
+    /// <summary>
+    /// PivotTableShowValuesAsType defines the calculation type enumeration.
+    /// </summary>
+    public enum PivotTableShowValuesAsType : byte
+    {
+        PivotTableShowValuesAsNoCalculation = 0,
+        PivotTableShowValuesAsPercentOfGrandTotal = 1,
+        PivotTableShowValuesAsPercentOfColumnTotal = 2,
+        PivotTableShowValuesAsPercentOfRowTotal = 3,
+        PivotTableShowValuesAsPercentOf = 4,
+        PivotTableShowValuesAsPercentOfParentRowTotal = 5,
+        PivotTableShowValuesAsPercentOfParentColumnTotal = 6,
+        PivotTableShowValuesAsPercentOfParentTotal = 7,
+        PivotTableShowValuesAsDifferenceFrom = 8,
+        PivotTableShowValuesAsPercentDifferenceFrom = 9,
+        PivotTableShowValuesAsRunningTotalIn = 10,
+        PivotTableShowValuesAsPercentRunningTotalIn = 11,
+        PivotTableShowValuesAsRankSmallestToLargest = 12,
+        PivotTableShowValuesAsRankLargestToSmallest = 13,
+        PivotTableShowValuesAsIndex = 14,
+    }
+
     /// <summary>
     /// Interface is a struct that can be used to represent any of the supported
     /// value types in the library, including int, string, double, bool,
@@ -769,6 +791,7 @@ public struct PivotTableField
         public bool DefaultSubtotal;
         public int NumFmt;
         public string[]? SelectedItems;
+        public PivotTableShowValuesAs ShowValuesAs;
     }
 
     /// <summary>
@@ -875,6 +898,17 @@ public struct SheetProtectionOptions
         public bool Sort;
     }
 
+    /// <summary>
+    /// PivotTableShowValuesAs directly maps the show value as settings of the
+    /// pivot table.
+    /// </summary>
+    public struct PivotTableShowValuesAs
+    {
+        public PivotTableShowValuesAsType Type;
+        public string BaseField;
+        public string BaseItem;
+    }
+
     /// <summary>
     /// Represents the settings of the slicer.
     /// </summary>
@@ -911,6 +945,46 @@ public struct SheetProtectionOptions
     /// <c>AddPivotTable</c> function, the same field must also have its
     /// selected item range specified at the time the pivot table is created.
     /// </para>
+    /// <para><b>ShowValuesAs</b> specifies the calculation type for showing
+    /// values in a pivot table values fields. The possible values for the
+    /// <c>Type</c> field of <c>ShowValuesAs</c> are:
+    /// <list type="bullet">
+    /// <item><description><c>PivotTableShowValuesAsNoCalculation</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsPercentOfGrandTotal</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsPercentOfColumnTotal</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsPercentOfRowTotal</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsPercentOf</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsPercentOfParentRowTotal</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsPercentOfParentColumnTotal</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsPercentOfParentTotal</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsDifferenceFrom</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsPercentDifferenceFrom</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsRunningTotalIn</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsPercentRunningTotalIn</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsRankSmallestToLargest</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsRankLargestToSmallest</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsIndex</c></description></item>
+    /// </list>
+    /// Note that the base field and base item settings of <c>ShowValuesAs</c>
+    /// are only required for some calculation types, the calculation types
+    /// requires base field settings are:
+    /// <list type="bullet">
+    /// <item><description><c>PivotTableShowValuesAsPercentOf</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsPercentOfParentTotal</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsDifferenceFrom</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsPercentDifferenceFrom</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsRunningTotalIn</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsPercentRunningTotalIn</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsRankSmallestToLargest</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsRankLargestToSmallest</c></description></item>
+    /// </list>
+    /// The supported calculation types requires base item settings are:
+    /// <list type="bullet">
+    /// <item><description><c>PivotTableShowValuesAsPercentOf</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsDifferenceFrom</c></description></item>
+    /// <item><description><c>PivotTableShowValuesAsPercentDifferenceFrom</c></description></item>
+    /// </list>
+    /// </para>
     /// </remarks>
     public struct SlicerOptions
     {