Insérer une image dans la feuille de calcul

Propriétés et configuration de l’activité Insérer un classeur d’image, qui insère une image dans un classeur Excel au niveau d’une cellule spécifiée avec un décalage et une mise à l’échelle facultatifs.

UiPath.Excel.Activities.InsertImage

Description

Insère une image dans une feuille de classeur, ancrée dans une cellule. Le coin supérieur gauche de l'image est placé dans la cellule d'ancrage, décalé par les valeurs que vous avez définies dans Image gauche et Image supérieure.

Remarque :

Le seul format de classeur pris en charge est .xlsx.

Les formats d'images suivants sont pris en charge:

• PNG
• JPEG
• Gif
• BMP
• TIFF
• WebP
• PCX

Compatibilité du projet

Windows | Multiplate-forme

Configuration

• Fichier - Chemin complet du classeur de ressources. Pour passer à un chemin local, sélectionnez l’icône plus, puis Utiliser le fichier local. Le champ actuel est remplacé par Fichier (chemin local), où vous pouvez fournir le chemin complet du classeur.
• Fichier d'image : le fichier de ressource de l'image à insérer. Pour basculer vers un chemin local, sélectionnez l’icône Plus, puis Utiliser le fichier local. Le champ actuel devient Image (chemin local), où vous pouvez indiquer le chemin complet de l’image.
• NomFeuille : la feuille dans laquelle insérer l'image. Si la feuille n’existe pas, elle sera créée automatiquement. La valeur par défaut est Sheet1.
• Cellule - Cellule d'ancrage pour le coin supérieur gauche de l'image. La valeur par défaut est A1.

Utiliser le classeur

• Classeur : le classeur existant à utiliser.

Entrée

• Image gauche : décalage horizontal par rapport à la cellule d'ancrage, en pixels. La valeur doit être égale ou supérieure à 0. La valeur par défaut est 0.
• Haut de l'image : le décalage vertical par rapport à la cellule d'ancrage, en pixels. La valeur doit être égale ou supérieure à 0. La valeur par défaut est 0.
• Largeur de l'image : La largeur de l'image, en pixels. La valeur doit être égale ou supérieure à 0.
• Hauteur de l'image : Hauteur de l'image, en pixels. La valeur doit être égale ou supérieure à 0.

Les valeurs Largeur d'image et Hauteur d'image déterminent la façon dont l'image est mise à l'échelle:

Largeur de l'image	Hauteur de l'image	Résultat
Non défini	Non défini	L'image conserve ses dimensions d'origine.
Ensemble	Non défini	La hauteur s'adapte localement, préservant ainsi le même aspect.
Non défini	Ensemble	La largeur s'adapte localement, préservant ainsi le même aspect.
Ensemble	Ensemble	L'image utilise les dimensions exactes que vous avez définies. Le rapport hauteur/largeur n’est pas conservé.

Remarque :

L'image est ancrée à la cellule que vous spécifiez dans Cellule, ce qui limite la façon dont vous pouvez la positionner:

• L’image à gauche et l’image en haut sont encapsulées dans la largeur et la hauteur de la cellule d’ancrage, de sorte qu’un décalage supérieur à la cellule place l’image au bord de la cellule à la place.
• Si vous redimensionnez la cellule d’ancrage, l’image se déplace avec elle, mais conserve ses propres dimensions.

L’activité ne prend pas en charge l’ancrage d’une image entre deux cellules, ni le placement d’une image à une position fixe indépendante de toute cellule.

Options

• Mot de passe : le mot de passe du classeur, si nécessaire.