تحديث العارض باستخدام Golang عبر C++

سيناريوهات الاستخدام المحتملة

يعني تحديث العارض تصفية بيانات الجدول المحوري أو الجدول المرتبط بالعارض. عندما تحدد عناصر العارض أو تلغي تحديدها في Microsoft Excel، يُعاد حساب الجدول المحوري أو الجدول المرتبط وفقًا لذلك. باستخدام Aspose.Cells for Go via C++، لا تحتاج إلى المرور على عناصر ذاكرة التخزين المؤقت للعارض وتحديث العارض يدويًا — تقوم طريقة Slicer.SelectItems(labels, append) بتحديث العارض وإعادة حساب الجدول المحوري أو الجدول المرتبط مباشرةً من عناصر التصفية:

• Slicer.SelectItems(labels, append) — تحدد التسميات المطلوبة وتعيد حساب الجدول المحوري أو الجدول المرتبط. عندما تكون قيمة append هي true، يتم الاحتفاظ بالتسميات المحددة في الأصل وتُضاف التسميات المطلوبة إلى التحديد؛ وعندما تكون قيمة append هي false، يتم مسح جميع التحديدات الأصلية وتبقى التسميات المطلوبة فقط محددة.
• Slicer.UnselectItems(labels) — تلغي تحديد جزء من العناصر المحددة حاليًا.
• Slicer.ClearFilter() — تزيل التصفية وتحدد جميع العناصر.

بدءًا من Aspose.Cells for Go via C++ 26.10، أصبحت خاصية SlicerCacheItem.Selected للقراءة فقط ولم يعد تعيين قيمتها مدعومًا. استخدم الطرق Slicer.SelectItems وSlicer.UnselectItems وSlicer.ClearFilter بدلاً من تعيين SlicerCacheItem.Selected عنصرًا بعنصر.

كيفية تحديث العارض

يقوم الكود النموذجي التالي بتحميل ملف Excel النموذجي الذي يحتوي على عارض موجود مرتبط بجدول محوري. يحدد عناصر “Blue” و"Pink" فقط من العارض باستخدام Slicer.SelectItems(labels, false) — يُعاد حساب الجدول المحوري مباشرةً من عناصر التصفية دون استدعاء Slicer.Refresh() يدويًا. ثم يحفظ المصنف كـ ملف Excel الناتج. تُظهر لقطة الشاشة التالية تأثير الكود النموذجي على ملف Excel النموذجي. كما يمكنك أن ترى في لقطة الشاشة، يعرض الجدول المحوري العناصر المصفّاة فقط.

الكود النموذجي

استبدل التحديد الحالي (تبقى التسميات المطلوبة فقط محددة) وأعد حساب الجدول المحوري أو الجدول المرتبط:

package main

import (
    "fmt"

    . "github.com/aspose-cells/aspose-cells-go-cpp/v26"
)

func main() {
    // Load sample Excel file containing slicer.
    wb, _ := NewWorkbook_String("sampleUpdatingSlicer.xlsx")

    // Access first worksheet.
    wss, _ := wb.GetWorksheets()
    ws, _ := wss.Get_Int(0)

    // Access the first slicer inside the slicer collection.
    slicers, _ := ws.GetSlicers()
    slicer, _ := slicers.Get_Int(0)

    // Select only "Blue" and "Pink"; the linked pivot table or table
    // is recalculated directly from the filter items.
    slicer.SelectItems([]string{ "Blue", "Pink" }, false)

    // Save the modified workbook.
    wb.Save_String("out.xlsx")

    fmt.Println("Slicer updated and workbook saved successfully!")
}

احتفظ بالتسميات المحددة حاليًا وحدد عناصر إضافية:

// Keep the current selection and add "Red" to it.
slicer.SelectItems([]string{ "Red" }, true)

ألغِ تحديد جزء من العناصر المحددة:

// Remove "Pink" from the current selection.
slicer.UnselectItems([]string{ "Pink" })

أزل التصفية (حدد جميع العناصر):

// Clear the filter; all slicer items become selected again.
slicer.ClearFilter()