Nouveautés d’Excel API JavaScript 1.19

L’API Excel 1.19 ajoute des fonctionnalités pour les graphiques et les formes, afin de vous aider à mieux visualiser vos données dans Excel. Il inclut également des mises à jour de la fonctionnalité des types de données, telles que la prise en charge des types de données liées, la notation par points et les options développées pour les valeurs de cellule de base.

Le tableau suivant fournit un résumé concis des API, tandis que le tableau de liste des API suivant donne une liste détaillée.

Fonctionnalité Description Objets pertinents
Étiquettes de graphiques Contrôler l’apparence des étiquettes de graphiques. ChartDataLabel, ChartDataLabelAnchor, ChartLeaderLines, ChartLeaderLinesFormat
Entités liées Ajoute la prise en charge des types de données connectés à Excel à partir de sources externes. Pour plus d’informations, consultez Créer des valeurs de cellule d’entité liées LinkedEntityDataDomain, LinkedEntityDataDomainCollection, LinkedEntityDataDomainCreateOptions, LinkedEntityIdCulture, LinkedEntityLoadServiceRequest

Liste des API

Le tableau suivant répertorie les API dans Excel : Ensemble de conditions requises pour l’API JavaScript 1.19. Pour consulter la documentation de référence sur toutes les API prises en charge par l’API Excel défini sur les exigences de l’API JavaScript 1.19 ou version antérieure, consultez API Excel correspondant au jeu de conditions requises 1.19 ou version antérieure.

Classe Champs Description
BasicCardLayout mise en page Représente le type de cette disposition.
BasicCompactLayout icon Spécifie le nom de l’icône utilisée pour ouvrir la carte.
BasicViewLayouts carte Représente la disposition de cette valeur et ses propriétés en mode Carte.
compacts Représente la disposition utilisée lorsque l’espace est limité pour représenter la valeur.
BooleanCellValue mises en page Représente les informations de mise en page pour les vues de cette valeur booléenne.
properties Représente des propriétés supplémentaires de cette valeur booléenne.
fournisseur d’aide Représente les informations qui décrivent le service qui a fourni les données dans ce BooleanCellValue.
referencedValues Représente les valeurs de cellule référencées dans BooleanCellValue.properties.
CardLayoutTwoColumnSection mise en page Représente le type de mise en page de cette section.
ChartDataLabel geometricShapeType Spécifie le type de forme géométrique de l’étiquette de données.
getSubstring(start: number, length?: number) Renvoie une sous-chaîne de l’étiquette de données.
getTailAnchor() Renvoie l’ancre de queue de l’étiquette de données qui s’affiche sous la forme d’une légende rémanente.
setHeight(height : number) Définit la hauteur de l’étiquette de données en points.
setWidth(width : number) Définit la largeur de l’étiquette de données en points.
showAsStickyCallout Indique si l’étiquette de données s’affiche sous forme de légende avec l’ancre de queue attachée au point de données.
ChartDataLabelAnchor left Indique la distance, en points, entre l’ancrage et le bord gauche de l’étiquette de données du graphique.
top Indique la distance, en points, entre l’ancrage et le bord supérieur de l’étiquette de données du graphique.
ChartDataLabels geometricShapeType Spécifie le type de forme géométrique des étiquettes de données.
Lignes de suite Obtient un objet qui représente les lignes de repère des étiquettes de données.
showAsStickyCallout Indique si les étiquettes de données sont affichées sous forme de légende avec l’ancre de queue attachée au point de données.
showLeaderLines Indique si des lignes de repère sont affichées pour les étiquettes de données.
ChartLeaderLines format Représente la mise en forme des lignes de repère des étiquettes de données dans une série.
ChartLeaderLinesFormat line Obtient un objet qui représente la mise en forme linéaire des traits d’orientation du graphique.
DoubleCellValue mises en page Représente les informations de mise en page pour les vues de cette valeur double.
numberFormat Renvoie la chaîne de format numérique utilisée pour afficher cette valeur.
properties Représente des propriétés supplémentaires de cette valeur double.
fournisseur d’aide Représente les informations qui décrivent le service qui a fourni les données dans ce DoubleCellValue.
referencedValues Représente les valeurs de cellule référencées dans DoubleCellValue.properties.
JavaScriptCustomFunctionReferenceCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
functionType Représente le type de FunctionCellValue.
id Représente l’ID de la fonction personnalisée.
espace de noms Représente l’espace de noms utilisé par la fonction personnalisée.
type Représente le type de cette valeur de cellule.
LinkedEntityDataDomain dataProvider Obtient le nom du fournisseur de données pour le domaine de données de l’entité liée.
delete() Supprime cet objet du LinkedEntityDataDomainCollection.
id Obtient l’ID du domaine de données d’entité liée défini par les compléments Office.
lastRefreshed Obtient la date et l’heure (dans le fuseau horaire local) depuis l’ouverture du classeur et LinkedEntityCellValue la dernière actualisation des objets de ce domaine de données d’entité liée.
loadFunctionId Obtient l’ID de la fonction personnalisée qui est appelée à la demande pour résoudre ou actualiser les LinkedEntityCellValue objets du domaine de données d’entité lié défini par les compléments Office.
name Obtient le nom du domaine de données de l’entité liée.
periodicRefreshInterval Obtient la fréquence, en secondes, à laquelle LinkedEntityCellValue les objets de ce domaine de données d’entité lié sont actualisés automatiquement.
refresh() Actualise tous les LinkedEntityCellValue objets de ce domaine de données d’entité lié.
refreshMode Spécifie le mode d’actualisation qui définit comment et quand les LinkedEntityCellValue objets de ce domaine de données d’entité liée sont actualisés.
serviceId Obtient l’ID de service du domaine de données de l’entité liée.
supportedRefreshModes Obtient tous les modes d’actualisation pris en charge par le domaine de données de l’entité liée.
LinkedEntityDataDomainAddedEventArgs id Obtient l’ID du domaine de données d’entité lié qui vient d’être ajouté au classeur.
serviceId Obtient l’ID de service du domaine de données d’entité lié qui vient d’être ajouté au classeur.
source Obtient la source de l’événement.
type Obtient le type de l’événement.
LinkedEntityDataDomainCollection add(options : Excel.LinkedEntityDataDomainCreateOptions) Ajoute à la collection un objet de domaine de données d’entité lié défini par le complément Office.
getCount() Obtient le nombre de domaines de données d’entité liés dans la collection.
getItem(id: string) Obtient une entité liée domaine de données par son id.
getItemAt(index: number) Obtient un domaine de données d’entité lié par son index dans la collection.
getItemByName(name : string) Obtient une entité liée domaine de données par son name.
getItemByNameOrNullObject(name : string) Obtient une entité liée domaine de données par son name.
getItemOrNullObject(id: string) Obtient une entité liée domaine de données par son id.
items Obtient l’élément enfant chargé dans cette collection de sites.
onLinkedEntityDataDomainAdded Se produit lorsqu’un nouveau domaine de données d’entité liée est ajouté au classeur.
onRefreshCompleted Se produit lorsque la demande d’actualisation LinkedEntityCellValue des objets d’un domaine de données d’entité lié est terminée.
onRefreshModeChanged Se produit lorsque le refreshMode d’un domaine de données d’entité liée est modifié.
refreshAll() Actualise tous les LinkedEntityCellValue objets de tous les domaines de données d’entité liés dans cette collection.
LinkedEntityDataDomainCreateOptions dataProvider Spécifie le nom du fournisseur de données pour le domaine de données de l’entité liée.
id Spécifie l’ID du domaine de données de l’entité liée.
loadFunctionId Spécifie l’ID de la fonction personnalisée qui sera appelée à la demande pour résoudre ou actualiser les LinkedEntityCellValue objets de ce domaine de données d’entité liée.
name Spécifie le nom du domaine de données de l’entité liée.
periodicRefreshInterval Spécifie la fréquence, en secondes, à laquelle LinkedEntityCellValue les objets de ce domaine de données d’entité liée sont actualisés automatiquement.
supportedRefreshModes Spécifie tous les modes d’actualisation pris en charge par le domaine de données de l’entité liée.
LinkedEntityDataDomainRefreshCompletedEventArgs errors Obtient toutes les erreurs rencontrées lors de la demande d’actualisation LinkedEntityCellValue des objets du domaine de données de l’entité liée.
id Obtient l’ID du domaine de données d’entité lié dont LinkedEntityCellValue les objets ont été actualisés.
Actualisé Renvoie true si les LinkedEntityCellValue objets du domaine de données d’entité lié ont été actualisés correctement. Sinon, retourne false.
serviceId Obtient l’ID de service du domaine de données d’entité lié dont LinkedEntityCellValue les objets ont été actualisés.
source Obtient la source de l’événement.
type Obtient le type de l’événement.
LinkedEntityDataDomainRefreshModeChangedEventArgs id Obtient l’ID du domaine de données d’entité lié dont le mode d’actualisation a été modifié.
refreshMode Obtient le nouveau mode d’actualisation du domaine de données de l’entité liée.
serviceId Obtient l’ID de service du domaine de données d’entité lié dont le mode d’actualisation a été modifié.
source Obtient la source de l’événement.
type Obtient le type de l’événement.
LinkedEntityIdCulture La culture Représente la culture linguistique utilisée pour créer l’objet LinkedEntityCellValue .
ID d’entité Représente l’identificateur spécifique à un service utilisé pour créer l’objet LinkedEntityCellValue .
LinkedEntityLoadServiceRequest domainId Représente le domaine spécifique au service utilisé pour créer les LinkedEntityCellValue objets.
entités Représente les ID d’entité et les cultures des LinkedEntityCellValue objets à charger.
LinkedEntityLoadServiceResult entités Représente les objets chargés LinkedEntityCellValue .
Range getDisplayedCellProperties(cellPropertiesLoadOptions : CellPropertiesLoadOptions) Renvoie un tableau 2D encapsulant les données d’affichage pour la police, le remplissage, les bordures, l’alignement et d’autres propriétés de chaque cellule.
StringCellValue mises en page Représente les informations de mise en page pour les affichages de cette valeur de chaîne.
properties Représente des propriétés supplémentaires de cette valeur de chaîne.
fournisseur d’aide Représente les informations qui décrivent le service qui a fourni les données dans ce StringCellValue.
referencedValues Représente les valeurs de cellule référencées dans StringCellValue.properties.
Classeur getActiveShape() Obtient la forme active dans le classeur.
getActiveShapeOrNullObject() Obtient la forme active dans le classeur.
linkedEntityDataDomains Renvoie une collection de domaines de données d’entité liés qui sont disponibles dans le classeur.
Feuille de calcul showDataTypeIcons Indique si les icônes des types de données sont visibles dans la feuille de calcul.

Voir aussi