Partager via


Office.SetSelectedDataOptions interface

Fournit des options permettant d’insérer des données dans la sélection.

Propriétés

asyncContext

Élément défini par l’utilisateur de tout type retourné, inchangé, dans la propriété asyncContext de l’objet AsyncResult passé à un rappel.

cellFormat

Utilisez uniquement avec la table de type de liaison et lorsqu’un objet TableData est passé pour le paramètre de données. Tableau d’objets qui spécifient une plage de colonnes, de lignes ou de cellules et spécifient, en tant que paires clé-valeur, la mise en forme de cellule à appliquer à cette plage.

Exemple : [{cells: Office.Table.Data, format: {fontColor: "yellow"}}, {cells: {row: 3, column: 4}, format: {borderColor: "white", fontStyle: "bold"}}]

coercionType

Définit explicitement la forme de l’objet de données. S’il n’est pas fourni, est déduit du type de données.

imageHeight

Cette option s’applique à l’insertion des images. Indique la hauteur de l’image. Si cette option est indiquée sans imageWidth, l’image sera dimensionnée pour correspondre à la valeur de la hauteur de l’image. Si la largeur de l’image et la hauteur de l’image sont indiquées, l’image sera redimensionnée selon ces proportions. Si ni la hauteur ni la largeur de l’image n’est fournie, la taille de l’image par défaut et les proportions seront utilisées. Cette valeur est exprimée en points.

imageLeft

Cette option s’applique à l’insertion des images. Indique l’emplacement d’insertion par rapport au côté gauche de la diapositive pour PowerPoint et sa relation avec la cellule actuellement sélectionnée dans Excel. Cette valeur est ignorée pour Word. Cette valeur est exprimée en points.

imageTop

Cette option s’applique à l’insertion des images. Indique l’emplacement d’insertion par rapport au haut de la diapositive pour PowerPoint et à la cellule actuellement sélectionnée dans Excel. Cette valeur est ignorée pour Word. Cette valeur est exprimée en points.

imageWidth

Cette option s’applique à l’insertion des images. Indique la largeur de l’image. Si cette option est indiquée sans imageHeight, l’image sera dimensionnée pour correspondre à la valeur de la largeur de l’image. Si la largeur de l’image et la hauteur de l’image sont indiquées, l’image sera redimensionnée selon ces proportions. Si ni la hauteur ni la largeur de l’image n’est fournie, la taille de l’image par défaut et les proportions seront utilisées. Cette valeur est exprimée en points.

tableOptions

Pour un tableau inséré, liste de paires clé-valeur qui spécifient les options de mise en forme du tableau, telles que la ligne d’en-tête, la ligne totale et les lignes à bandes. Exemple : {bandedRows: true, filterButton: false}

Détails de la propriété

asyncContext

Élément défini par l’utilisateur de tout type retourné, inchangé, dans la propriété asyncContext de l’objet AsyncResult passé à un rappel.

asyncContext?: any

Valeur de propriété

any

cellFormat

Utilisez uniquement avec la table de type de liaison et lorsqu’un objet TableData est passé pour le paramètre de données. Tableau d’objets qui spécifient une plage de colonnes, de lignes ou de cellules et spécifient, en tant que paires clé-valeur, la mise en forme de cellule à appliquer à cette plage.

Exemple : [{cells: Office.Table.Data, format: {fontColor: "yellow"}}, {cells: {row: 3, column: 4}, format: {borderColor: "white", fontStyle: "bold"}}]

cellFormat?: RangeFormatConfiguration[]

Valeur de propriété

coercionType

Définit explicitement la forme de l’objet de données. S’il n’est pas fourni, est déduit du type de données.

coercionType?: Office.CoercionType | string

Valeur de propriété

imageHeight

Cette option s’applique à l’insertion des images. Indique la hauteur de l’image. Si cette option est indiquée sans imageWidth, l’image sera dimensionnée pour correspondre à la valeur de la hauteur de l’image. Si la largeur de l’image et la hauteur de l’image sont indiquées, l’image sera redimensionnée selon ces proportions. Si ni la hauteur ni la largeur de l’image n’est fournie, la taille de l’image par défaut et les proportions seront utilisées. Cette valeur est exprimée en points.

imageHeight?: number

Valeur de propriété

number

imageLeft

Cette option s’applique à l’insertion des images. Indique l’emplacement d’insertion par rapport au côté gauche de la diapositive pour PowerPoint et sa relation avec la cellule actuellement sélectionnée dans Excel. Cette valeur est ignorée pour Word. Cette valeur est exprimée en points.

imageLeft?: number

Valeur de propriété

number

imageTop

Cette option s’applique à l’insertion des images. Indique l’emplacement d’insertion par rapport au haut de la diapositive pour PowerPoint et à la cellule actuellement sélectionnée dans Excel. Cette valeur est ignorée pour Word. Cette valeur est exprimée en points.

imageTop?: number

Valeur de propriété

number

imageWidth

Cette option s’applique à l’insertion des images. Indique la largeur de l’image. Si cette option est indiquée sans imageHeight, l’image sera dimensionnée pour correspondre à la valeur de la largeur de l’image. Si la largeur de l’image et la hauteur de l’image sont indiquées, l’image sera redimensionnée selon ces proportions. Si ni la hauteur ni la largeur de l’image n’est fournie, la taille de l’image par défaut et les proportions seront utilisées. Cette valeur est exprimée en points.

imageWidth?: number

Valeur de propriété

number

tableOptions

Pour un tableau inséré, liste de paires clé-valeur qui spécifient les options de mise en forme du tableau, telles que la ligne d’en-tête, la ligne totale et les lignes à bandes. Exemple : {bandedRows: true, filterButton: false}

tableOptions?: object

Valeur de propriété

object