Prendre une capture d'écran (Take Screenshot)

Prend une capture d'écran d'un élément d'IU ou d'une application spécifié et l'enregistre dans un fichier.

Cette API doit être ajoutée après Open ou Attach.

Définition

Espace de noms: UiPath.UIAutomationNext.API.Models

Assembly: UiPath.UIAutomationNext.API.Models (dans UiPath.UIAutomationNext.API.Models dll)

Surcharges

Surcharge	Description
TakeScreenshot(IElementDescriptor, TakeScreenshotOptions)	Prend une capture d'écran d'un élément d'IU ou d'une application spécifié et l'enregistre dans un fichier, identifié par un descripteur d'un élément du Référentiel d'objets.
TakeScreenshot(IElementDescriptor, String)	Prend une capture d'écran d'un élément ou d'une application d'IU spécifié et l'enregistre dans un fichier, identifié par un descripteur d'un élément du Référentiel d'objets (Object Repository), tout en spécifiant le nom du fichier.
TakeScreenshot(String, TakeScreenshotOptions)	Prend une capture d'écran d'un élément ou d'une application d'IU spécifié et l'enregistre dans un fichier, identifié par une chaîne du Référentiel d'objets (Object Repository), ainsi que d'autres configurations.
TakeScreenshot(String, String)	Prend une capture d'écran d'un élément ou d'une application d'IU spécifié et l'enregistre dans un fichier, identifié par une chaîne du Référentiel d'objets (Object Repository), ainsi que d'autres configurations.
TakeScreenshot(RuntimeTarget, TakeScreenshotOptions)	Prend une capture d'écran d'un élément ou d'une application d'IU spécifié et l'enregistre dans un fichier, identifié par une instance de runtime d'un élément du Référentiel d'objets, ainsi que d'autres configurations.
TakeScreenshot(TargetAnchorableModel, TakeScreenshotOptions)	Prend une capture d'écran d'un élément ou d'une application d'IU spécifié et l'enregistre dans un fichier, identifié par l'objet TargetAnchorableModel , avec d'autres configurations.
TakeScreenshot(TargetAnchorableModel, String)	Prend une capture d'écran d'un élément d'IU ou d'une application spécifiés et l'enregistre dans un fichier, identifié par l'objet TargetAnchorableModel , tout en spécifiant le nom du fichier.

TakeScreenshot(IElementDescriptor, TakeScreenshotOptions)

Prend une capture d'écran d'un élément d'IU ou d'une application spécifié et l'enregistre dans un fichier, identifié par un descripteur d'un élément du Référentiel d'objets.

TakeScreenhot(
    IElementDescriptor elementDescriptor,
    TakeScreenshotOptions takeScreenshotOptions)

elementDescriptor IElementDescriptor

Descripteur d'élément à partir duquel prendre la capture d'écran. Laissez null pour prendre une capture d'écran de tout le bureau.

takeScreenshotOptions TakeScreenshotOptions

Options supplémentaires pour personnaliser la capture d'écran. Vous pouvez choisir de personnaliser :

• TargetOptions :
  • Délai d'attente - indique le délai d'attente (en secondes) d'attente de l'exécution de l'API avant qu'une erreur SelectorNotFoundException soit générée. La valeur par défaut est 30 secondes.
  • DélaiAprès : délai (en secondes) après l’exécution de l’API. La durée par défaut est de 0,3 seconde (300 millisecondes).
  • DélaiAvant : délai (en secondes) avant que l’API commence à effectuer des opérations. La durée par défaut est de 0,2 seconde (200 millisecondes).
• FileName : le nom du fichier à enregistrer.

TakeScreenshot(IElementDescriptor, String)

Prend une capture d'écran d'un élément ou d'une application d'IU spécifié et l'enregistre dans un fichier, identifié par un descripteur d'un élément du Référentiel d'objets (Object Repository), tout en spécifiant le nom du fichier.

TakeScreenhot(
    IElementDescriptor elementDescriptor,
    string fileName)

elementDescriptor IElementDescriptor

Descripteur d'élément à partir duquel prendre la capture d'écran. Laissez null pour prendre une capture d'écran de tout le bureau.

FileName Chaîne de caractères (string)

Le nom de fichier que vous souhaitez enregistrer.

TakeScreenshot(String, TakeScreenshotOptions)

Prend une capture d'écran d'un élément ou d'une application d'IU spécifié et l'enregistre dans un fichier, identifié par une chaîne du Référentiel d'objets (Object Repository), ainsi que d'autres configurations.

TakeScreenhot(
    string target,
    TakeScreenshotOptions takeScreenshotOptions)

target Chaîne de caractères (string)

La cible à partir de laquelle prendre une capture d'écran, identifiée par une chaîne du référentiel d'objets. Laissez null pour prendre une capture d'écran de tout le bureau.

takeScreenshotOptions TakeScreenshotOptions

Options supplémentaires pour personnaliser la capture d'écran. Vous pouvez choisir de personnaliser :

• TargetOptions :
  • Délai d'attente - indique le délai d'attente (en secondes) d'attente de l'exécution de l'API avant qu'une erreur SelectorNotFoundException soit générée. La valeur par défaut est 30 secondes.
  • DélaiAprès : délai (en secondes) après l’exécution de l’API. La durée par défaut est de 0,3 seconde (300 millisecondes).
  • DélaiAvant : délai (en secondes) avant que l’API commence à effectuer des opérations. La durée par défaut est de 0,2 seconde (200 millisecondes).
• FileName : le nom du fichier à enregistrer.

TakeScreenshot(String, String)

Prend une capture d'écran d'un élément ou d'une application d'IU spécifié et l'enregistre dans un fichier, identifié par une chaîne du Référentiel d'objets (Object Repository), ainsi que d'autres configurations.

TakeScreenhot(
    string target,
    string fileName)

target Chaîne de caractères (string)

La cible à partir de laquelle prendre une capture d'écran, identifiée par une chaîne du référentiel d'objets. Laissez null pour prendre une capture d'écran de tout le bureau.

FileName Chaîne de caractères (string)

Le nom de fichier que vous souhaitez enregistrer.

TakeScreenshot(RuntimeTarget, TakeScreenshotOptions)

Prend une capture d'écran d'un élément ou d'une application d'IU spécifié et l'enregistre dans un fichier, identifié par une instance de runtime d'un élément du Référentiel d'objets, ainsi que d'autres configurations.

TakeScreenhot(
    RuntimeTarget target,
    TakeScreenshotOptions takeScreenshotOptions)

target RuntimeTarget

La cible à partir de laquelle prendre une capture d'écran, identifiée par une instance de runtime d'un élément du référentiel d'objets. Laissez null pour prendre une capture d'écran de tout le bureau.

takeScreenshotOptions TakeScreenshotOptions

Options supplémentaires pour personnaliser la capture d'écran. Vous pouvez choisir de personnaliser :

• TargetOptions :
  • Délai d'attente - indique le délai d'attente (en secondes) d'attente de l'exécution de l'API avant qu'une erreur SelectorNotFoundException soit générée. La valeur par défaut est 30 secondes.
  • DélaiAprès : délai (en secondes) après l’exécution de l’API. La durée par défaut est de 0,3 seconde (300 millisecondes).
  • DélaiAvant : délai (en secondes) avant que l’API commence à effectuer des opérations. La durée par défaut est de 0,2 seconde (200 millisecondes).
• FileName : le nom du fichier à enregistrer.

TakeScreenshot(TargetAnchorableModel, TakeScreenshotOptions)

Prend une capture d'écran d'un élément ou d'une application d'IU spécifié et l'enregistre dans un fichier, identifié par l'objet TargetAnchorableModel , avec d'autres configurations.

TakeScreenhot(
    TargetAnchorableModel target,
    TakeScreenshotOptions takeScreenshotOptions)

target TargetAnchorableModel

La cible à partir de laquelle prendre une capture d'écran, identifiée par l'objet TargetAnchorableModel . Laissez null pour prendre une capture d'écran de tout le bureau.

takeScreenshotOptions TakeScreenshotOptions

Options supplémentaires pour personnaliser la capture d'écran. Vous pouvez choisir de personnaliser :

• TargetOptions :
  • Délai d'attente - indique le délai d'attente (en secondes) d'attente de l'exécution de l'API avant qu'une erreur SelectorNotFoundException soit générée. La valeur par défaut est 30 secondes.
  • DélaiAprès : délai (en secondes) après l’exécution de l’API. La durée par défaut est de 0,3 seconde (300 millisecondes).
  • DélaiAvant : délai (en secondes) avant que l’API commence à effectuer des opérations. La durée par défaut est de 0,2 seconde (200 millisecondes).
• FileName : le nom du fichier à enregistrer.

TakeScreenshot(TargetAnchorableModel, String)

Prend une capture d'écran d'un élément d'IU ou d'une application spécifiés et l'enregistre dans un fichier, identifié par l'objet TargetAnchorableModel , tout en spécifiant le nom du fichier.

TakeScreenhot(
    TargetAnchorableModel target, 
    string fileName)

target TargetAnchorableModel

La cible à partir de laquelle prendre une capture d'écran, identifiée par l'objet TargetAnchorableModel . Laissez null pour prendre une capture d'écran de tout le bureau.

FileName Chaîne de caractères (string)

Le nom de fichier que vous souhaitez enregistrer.

Exemple de code

Voici un bref aperçu d’un exemple d’implémentation de code.

Cette ligne de code définit le chemin d’accès au fichier dans lequel la capture d’écran est enregistrée.

var filePath = "C:\\samplefile.jpg";

Cette commande se connecte à un écran à partir d’une application déjà ouverte.

var sampleApp = uiAutomation.Attach(Descriptors.NewApplication.NewScreen);

L’API TakeScreenshot est invoquée à cet endroit, capturant la capture d’écran du nouvel élément spécifié sur votre écran et l’enregistrant par la suite dans le chemin d’accès défini.

sampleApp.TakeScreenshot(Descriptors.NewApplication.NewScreen.NewElement, filePath);

Vérifie si le fichier de capture d’écran existe au niveau du filePath donné.

var fileExists = system.FileExists(filePath);

Enfin, l’instruction vérifie que le fichier de capture d’écran est enregistré dans le filePath cible.

testing.VerifyAreEqual(fileExists, true);

Ajout d’options

Vous pouvez ajouter des options à votre code de deux manières.

Vous pouvez notamment utiliser la surcharge appropriée. Pour ce faire, appuyez sur Ctrl + Space pour faire apparaître IntelliSense, vous permettant de parcourir et de sélectionner votre surcharge préférée. Vous pouvez décider de sélectionner la surcharge dans laquelle les paramètres sont déjà configurés. Les paramètres facultatifs sont indiqués entre parenthèses.

Si vous souhaitez initialiser un seul paramètre comme windowResize, vous pouvez utiliser la syntaxe suivante :

var sampleApp = uiAutomation.Attach(Descriptors.NewApplication.NewScreen, windowResize: NWindowResize.Restore);

Pour ajouter des options, vous pouvez également utiliser une surcharge d’options courantes, telle que Joindre (Attach), et l’associer à la classe Options. Cette action vous offre un peu plus de flexibilité dans la personnalisation de vos paramètres.