Nouveautés de l’API JavaScript Excel 1.13
ExcelApi 1.13 a ajouté une méthode permettant d’insérer des feuilles de calcul dans un classeur à partir d’une chaîne encodée en Base64 et d’un événement pour détecter l’activation du classeur. Il a également augmenté la prise en charge des formules dans les plages en ajoutant des API pour suivre les modifications apportées aux formules et localiser les cellules dépendantes directes d’une formule. En outre, il a étendu la prise en charge des tableaux croisés dynamiques en ajoutant des API PivotLayout pour la gestion du texte de remplacement, du style et des cellules vides.
Fonctionnalité | Description | Objets pertinents |
---|---|---|
Événements de modification de formule | Suivez les modifications apportées aux formules, y compris la source et le type d’événement qui a provoqué une modification. | Worksheet.onFormulaChanged |
Dépendants de la formule | Recherchez les cellules dépendantes directes d’une formule. | Range.getDirectDependents |
Insérer des feuilles de calcul | Insérez des feuilles de calcul d’un autre classeur dans le classeur actif sous la forme d’une chaîne encodée en Base64. | Workbook.insertWorksheetsFromBase64 |
Tableau croisé dynamiqueLayout | Extension de la classe PivotLayout, avec une nouvelle prise en charge du texte de remplacement et de la gestion des cellules vides. | PivotLayout |
Liste des API
Le tableau suivant répertorie les API dans l’ensemble de conditions requises de l’API JavaScript Excel 1.13. Pour afficher la documentation de référence des API pour toutes les API prises en charge par l’ensemble de conditions requises de l’API JavaScript Excel 1.13 ou version antérieure, consultez API Excel dans l’ensemble de conditions requises 1.13 ou antérieur.
Classe | Champs | Description |
---|---|---|
FormulaChangedEventDetail | cellAddress | Adresse de la cellule qui contient la formule modifiée. |
previousFormula | Représente la formule précédente, avant sa modification. | |
InsertWorksheetOptions | positionType | Position d’insertion, dans le classeur actif, des nouvelles feuilles de calcul. |
Relativeto | Feuille de calcul dans le classeur actif référencé pour le WorksheetPositionType paramètre . |
|
sheetNamesToInsert | Noms des feuilles de calcul individuelles à insérer. | |
PivotLayout | altTextDescription | Description du texte de remplacement du tableau croisé dynamique. |
altTextTitle | Titre du texte de remplacement du tableau croisé dynamique. | |
displayBlankLineAfterEachItem(display: boolean) | Définit si une ligne vide doit être affichée ou non après chaque élément. | |
emptyCellText | Texte qui est automatiquement rempli dans une cellule vide du tableau croisé dynamique si fillEmptyCells == true . |
|
fillEmptyCells | Spécifie si les cellules vides du tableau croisé dynamique doivent être remplies avec le emptyCellText . |
|
repeatAllItemLabels(repeatLabels: boolean) | Définit le paramètre « répéter toutes les étiquettes d’élément » sur tous les champs du tableau croisé dynamique. | |
showFieldHeaders | Spécifie si le tableau croisé dynamique affiche les en-têtes de champ (légendes de champ et listes déroulantes de filtre). | |
PivotTable | refreshOnOpen | Spécifie si le tableau croisé dynamique s’actualise lorsque le classeur s’ouvre. |
Range | getDirectDependents() | Renvoie un WorkbookRangeAreas objet qui représente la plage contenant toutes les cellules dépendantes directes d’une plage spécifiée dans la même feuille de calcul ou dans plusieurs feuilles de calcul. |
getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string) | Retourne un objet de plage qui inclut la plage actuelle et jusqu’au bord de la plage, en fonction de la direction fournie. | |
getMergedAreasOrNullObject() | Renvoie un RangeAreas objet qui représente les zones fusionnées dans cette plage. |
|
getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string) | Retourne un objet de plage qui est la cellule de bord de la région de données qui correspond à la direction fournie. | |
Tableau | resize(newRange: Range | string) | Redimensionnez la table en fonction de la nouvelle plage. |
Classeur | insertWorksheetsFromBase64(base64File: string, options?: Excel.InsertWorksheetOptions) | Insère les feuilles de calcul spécifiées à partir d’un classeur source dans le classeur actif. |
onActivated | Se produit lorsque le classeur est activé. | |
WorkbookActivatedEventArgs | type | Obtient le type de l’événement. |
Feuille de calcul | onFormulaChanged | Se produit lorsqu’une ou plusieurs formules sont modifiées dans cette feuille de calcul. |
WorksheetCollection | onFormulaChanged | Se produit lorsqu’une ou plusieurs formules sont modifiées dans une feuille de calcul de cette collection. |
WorksheetFormulaChangedEventArgs | formulaDetails | Obtient un tableau d’objets FormulaChangedEventDetail , qui contient les détails sur toutes les formules modifiées. |
source | Source de l'événement. | |
type | Obtient le type de l’événement. | |
worksheetId | Obtient l’ID de la feuille de calcul dans laquelle la formule a été modifiée. |