Mise à jour de la trancheuse

Scénarios d’utilisation possibles

Mettre à jour une trancheuse signifie filtrer les données du tableau croisé dynamique ou du tableau auquel la trancheuse est connectée. Lorsque vous sélectionnez ou désélectionnez des éléments de la trancheuse dans Microsoft Excel, le tableau croisé dynamique ou le tableau lié est recalculé en conséquence. Avec Aspose.Cells for Java, vous n’avez pas besoin de parcourir les éléments du cache de la trancheuse ni d’actualiser la trancheuse manuellement — la méthode Slicer.selectItems(String[], boolean) met à jour la trancheuse et recalcule le tableau croisé dynamique ou le tableau lié directement à partir des éléments de filtrage :

  • Slicer.selectItems(labels, append) — sélectionne les étiquettes spécifiées et recalcule le tableau croisé dynamique ou le tableau lié. Lorsque append vaut true, les étiquettes initialement sélectionnées sont conservées et les étiquettes spécifiées sont ajoutées à la sélection ; lorsque append vaut false, toutes les sélections d’origine sont effacées et seules les étiquettes spécifiées restent sélectionnées.
  • Slicer.unselectItems(labels) — désélectionne une partie des éléments actuellement sélectionnés.
  • Slicer.clearFilter() — supprime le filtre et sélectionne tous les éléments.

Mise à jour de la trancheuse

Le code d’exemple suivant charge le fichier Excel d’exemple qui contient une trancheuse existante connectée à un tableau croisé dynamique. Il sélectionne uniquement les éléments “Blue” et “Pink” de la trancheuse avec Slicer.selectItems(labels, false) — le tableau croisé dynamique est recalculé directement à partir des éléments de filtrage, sans appel manuel à Slicer.refresh(). Il enregistre ensuite le classeur sous la forme de fichier Excel de sortie. La capture d’écran suivante montre l’effet du code d’exemple sur le fichier Excel d’exemple. Comme vous pouvez le voir sur la capture d’écran, le tableau croisé dynamique n’affiche que les éléments filtrés. todo:image_alt_text

Code d’exemple

Remplacez la sélection actuelle (seules les étiquettes spécifiées restent sélectionnées) et recalculez le tableau croisé dynamique ou le tableau lié :

import com.aspose.cells.Workbook;
import com.aspose.cells.Worksheet;
import com.aspose.cells.Slicer;
// Load sample Excel file containing slicer.
Workbook workbook = new Workbook("sampleUpdatingSlicer.xlsx");
// Access first worksheet.
Worksheet worksheet = workbook.getWorksheets().get(0);
// Access the first slicer inside the slicer collection.
Slicer slicer = worksheet.getSlicers().get(0);
// Select only "Blue" and "Pink"; the linked pivot table or table
// is recalculated directly from the filter items.
slicer.selectItems(new String[] { "Blue", "Pink" }, false);
// Save the modified workbook.
workbook.save("out.xlsx");

Conservez les étiquettes actuellement sélectionnées et sélectionnez des éléments supplémentaires :

// Keep the current selection and add "Red" to it.
slicer.selectItems(new String[] { "Red" }, true);

Désélectionnez une partie des éléments sélectionnés :

// Remove "Pink" from the current selection.
slicer.unselectItems(new String[] { "Pink" });

Supprimez le filtre (sélectionnez tous les éléments) :

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