Partager via

Ensemble de conditions requises 1.1 pour l’API JavaScript Excel pour le bureau uniquement

L’ensemble ExcelApiDesktop de conditions requises est un ensemble de conditions requises spécial qui inclut des fonctionnalités disponibles uniquement dans Excel pour Windows et Excel pour Mac. Les API de cet ensemble de conditions requises sont considérées comme des API de production pour l’application Excel sur Windows et Mac. Ils suivent les stratégies de support pour les développeurs Microsoft 365. ExcelApiDesktop Les API sont considérées comme des API « en préversion » pour d’autres plateformes (telles que le web et l’iPad) et peuvent ne pas être prises en charge par l’une de ces plateformes.

Lorsque les API de l’ensemble ExcelApiDesktop de conditions requises sont prises en charge sur toutes les plateformes, elles sont ajoutées à l’ensemble de conditions requises suivant (ExcelApi 1.[NEXT]). Une fois que ce nouvel ensemble de conditions requises est public, ces API continueront également d’être étiquetées dans cet ExcelApiDesktop ensemble de conditions requises. Pour en savoir plus sur les exigences spécifiques à la plateforme en général, consultez Présentation des ensembles de conditions requises spécifiques à la plateforme.

Importante

ExcelApiDesktop 1.1 est un ensemble de conditions requises pour le bureau uniquement. Il s’agit d’un sur-ensemble d’ExcelApi 1.20.

Étant donné que les ExcelApiDesktop 1.1 API sont uniquement prises en charge par Excel sur Windows et Mac, votre complément doit case activée si l’ensemble de conditions requises est pris en charge avant d’appeler ces API. Cela évite toute tentative d’utilisation d’API de bureau uniquement sur une plateforme non prise en charge.

if (Office.context.requirements.isSetSupported("ExcelApiDesktop", "1.1")) {
   // Any API exclusive to this ExcelApiDesktop requirement set.
}

Une fois que l’API est dans un ensemble de conditions requises multiplateforme, vous devez supprimer ou modifier le isSetSupported case activée. Cela permet d’activer la fonctionnalité de votre complément sur d’autres plateformes. Veillez à tester la fonctionnalité sur ces plateformes lors de cette modification.

Importante

Votre manifeste ne peut pas spécifier ExcelApiDesktop 1.1 comme condition d’activation. Il ne s’agit pas d’une valeur valide à utiliser dans l’élément Set.

Liste des API

Le tableau suivant répertorie les API JavaScript Excel actuellement incluses dans l’ensemble de conditions ExcelApiDesktop 1.1 requises. Pour obtenir la liste complète de toutes les API JavaScript Excel (y compris ExcelApiDesktop 1.1 les API et les API précédemment publiées), consultez toutes les API JavaScript Excel.

Classe Champs Description
Application activeWindow Renvoie un window objet qui représente la fenêtre active (la fenêtre située en haut).
checkSpelling(word : string, options ?: Excel.CheckSpellingOptions) Cette méthode vérifie l'orthographe d'un seul mot.
enterEditingMode() Passe en mode d’édition pour la plage sélectionnée dans la feuille de calcul active.
union(firstRange : Range | RangeAreas, secondRange : Range | RangeAreas, ... additionalRanges : (Plage | RangeAreas)[]) Renvoie un RangeAreas objet qui représente l’union de deux ou plusieurs Range objets ou RangeAreas .
Windows Retourne toutes les fenêtres Excel ouvertes.
CheckSpellingOptions customDictionary Facultatif.
ignoreUppercase Facultatif.
HeaderFooter centerFooterPicture Obtient un HeaderFooterPicture objet qui représente l’image de la section centrale du pied de page.
centerHeaderPicture Obtient un HeaderFooterPicture objet qui représente l’image de la section centrale de l’en-tête.
leftFooterPicture Obtient un HeaderFooterPicture objet qui représente l’image de la section gauche du pied de page.
leftHeaderPicture Obtient un HeaderFooterPicture objet qui représente l’image de la section gauche de l’en-tête.
rightFooterPicture Obtient un HeaderFooterPicture objet qui représente l’image de la section droite du pied de page.
rightHeaderPicture Obtient un HeaderFooterPicture objet qui représente l’image de la section de droite de l’en-tête.
HeaderFooterPicture luminosité Spécifie la luminosité de l’image.
Colortype Spécifie le type de transformation de couleur de l’image.
contraste Spécifie le contraste de l’image.
cropBottom Spécifie le nombre de points rognées en bas de l’image.
cropLeft Spécifie le nombre de points rognées du côté gauche de l’image.
cropRight Spécifie le nombre de points rognées du côté droit de l’image.
cropTop Spécifie le nombre de points rognées en haut de l’image.
Fichier Spécifie l’URL (sur l’intranet ou le web) ou le chemin d’accès (local ou réseau) à l’emplacement où l’objet source est enregistré.
height Spécifie la hauteur de l’image en points.
lockAspectRatio Spécifie une valeur qui indique si l’image conserve ses proportions d’origine lorsqu’elle est redimensionnée.
width Spécifie la largeur de l’image en points.
Image luminosité Spécifie la luminosité de l’image.
Colortype Spécifie le type de transformation de couleur appliquée à l’image.
contraste Spécifie le contraste de l’image.
cropBottom Spécifie le nombre de points rogné en bas de l’image.
cropLeft Spécifie le nombre de points rogné du côté gauche de l’image.
cropRight Spécifie le nombre de points rognées du côté droit de l’image.
cropTop Spécifie le nombre de points rogné en haut de l’image.
incrementBrightness(increment : number) Incrémente la luminosité de l’image d’une quantité spécifiée.
incrementContrast(increment : number) Incrémente le contraste de l’image d’un montant spécifié.
PageLayout alignMarginsHeaderFooter Spécifie si Excel aligne l’en-tête et le pied de page sur les marges définies dans les options de mise en page.
printQuality Spécifie un tableau à deux éléments qui contient des valeurs de qualité d’impression horizontales et verticales.
Pane index Retourne l’index du volet.
PaneCollection getCount() Retourne le nombre de volets dans la collection.
getItemAt(index: number) Obtient le volet de la collection par index.
items Obtient l’élément enfant chargé dans cette collection de sites.
Range checkSpelling(options ?: Excel.CheckSpellingOptions) Vérifie l’orthographe des mots de cette plage.
formulaArray Spécifie la formule matricielle d’une plage.
showDependents(remove ?: boolean) Cette méthode affiche les flèches d'audit signalant les dépendants directs de la plage.
showPrecedents(remove ?: boolean) Cette méthode affiche les flèches d'audit signalant les antécédents directs de la plage.
Window activate() Active la fenêtre.
activateNext() Active la fenêtre suivante.
activatePrevious() Active la fenêtre précédente.
activeCell Obtient la cellule active dans la fenêtre.
activePane Obtient le volet actif dans la fenêtre.
activeWorksheet Obtient la feuille de calcul active dans la fenêtre.
autoFilterDateGroupingEnabled Spécifie si le regroupement de dates de filtre automatique est activé dans la fenêtre.
close() Ferme la fenêtre.
enableResize Spécifie si le redimensionnement est activé pour la fenêtre.
freezePanes Spécifie si les volets sont figés dans la fenêtre.
height Spécifie la hauteur de la fenêtre.
index Obtient l’index de la fenêtre.
isVisible Spécifie si la fenêtre est visible.
largeScroll(Down : number, Up : number, ToRight : number, ToLeft : number) Fait défiler la fenêtre de plusieurs pages.
left Spécifie la distance, en points, entre le bord gauche de l’écran de l’ordinateur et le bord gauche de la fenêtre.
name Spécifie le nom de la fenêtre.
newWindow() Ouvre une nouvelle fenêtre Excel.
Vitres Obtient une collection de volets associés à la fenêtre.
pointsToScreenPixelsX(Points : number) Convertit les points horizontaux en pixels d’écran.
pointsToScreenPixelsY(Points : number) Convertit les points verticaux en pixels d’écran.
scrollColumn Spécifie la colonne de défilement de la fenêtre.
scrollIntoView(Left : number, Top : number, Width : number, Height : number, Start ?: boolean) Fait défiler la fenêtre pour afficher la plage spécifiée.
scrollRow Spécifie la ligne de défilement de la fenêtre.
scrollWorkbookTabs(Sheets ?: number, Position ?: Excel.ScrollWorkbookTabPosition) Fait défiler les onglets du classeur.
showFormulas Spécifie si les formules sont affichées dans la fenêtre.
showGridlines Spécifie si le quadrillage est affiché dans la fenêtre.
showHeadings Spécifie si les titres sont affichés dans la fenêtre.
showHorizontalScrollBar Spécifie si la barre de défilement horizontale s’affiche dans la fenêtre.
showOutline Spécifie si le plan est affiché dans la fenêtre.
showRightToLeft Obtient la valeur de disposition de droite à gauche de la fenêtre.
showRuler Spécifie si la règle est affichée dans la fenêtre.
showVerticalScrollBar Spécifie si la barre de défilement verticale s’affiche dans la fenêtre.
showWhitespace Spécifie si l’espace blanc est affiché dans la fenêtre.
showWorkbookTabs Spécifie si les onglets du classeur sont affichés dans la fenêtre.
showZeros Spécifie si les zéros sont affichés dans la fenêtre.
smallScroll(Down : number, Up : number, ToRight : number, ToLeft : number) Fait défiler la fenêtre d’un certain nombre de lignes ou de colonnes.
fendre Spécifie l’état de fractionnement de la fenêtre.
splitColumn Spécifie la colonne fractionnée de la fenêtre.
splitHorizontal Spécifie le fractionnement horizontal de la fenêtre.
splitRow Spécifie la ligne fractionnée de la fenêtre.
splitVertical Spécifie le fractionnement vertical de la fenêtre.
tabRatio Spécifie le rapport de tabulation de la fenêtre.
top Spécifie la distance, en points, entre le bord supérieur de la fenêtre et le bord supérieur de la zone utilisable (sous les menus, les barres d’outils ancrées en haut et la barre de formule).
type Spécifie le type de la fenêtre.
usableHeight Obtient la hauteur utilisable de la fenêtre.
utilisableWidth Obtient la largeur utilisable de la fenêtre.
view Spécifie la vue de la fenêtre.
visibleRange Obtient la plage visible de la fenêtre.
width Spécifie la largeur d’affichage de la fenêtre.
windowNumber Obtient le numéro de la fenêtre.
windowState Spécifie l’état de la fenêtre.
zoom Spécifie une valeur entière qui représente la taille d’affichage de la fenêtre.
WindowCollection breakSideBySide() Interrompt la vue côte à côte des fenêtres.
compareCurrentSideBySideWith(windowName : string) Compare la fenêtre active côte à côte avec la fenêtre spécifiée.
getCount() Obtient le nombre de fenêtres dans la collection.
getItemAt(index: number) Obtient la fenêtre dans la collection par index.
items Obtient l’élément enfant chargé dans cette collection de sites.
resetPositionsSideBySide() Réinitialise les positions des fenêtres en mode côte à côte.
Classeur focus() Définit le focus sur le classeur.
Feuille de calcul checkSpelling(options ?: Excel.CheckSpellingOptions) Vérifie l’orthographe des mots dans cette feuille de calcul.
clearArrows() Cette méthode efface les flèches d'audit de la feuille de calcul.
evaluate(name : string) Retourne le résultat d’évaluation d’une chaîne de formule.

Voir aussi

  • Last updated on