Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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. |