Screenshot anfertigen (Take Screenshot)

Erstellt einen Screenshot eines angegebenen UI-Elements oder einer angegebenen Anwendung und speichert ihn als Datei.

Diese API muss nach „ Öffnen “ oder „ Anhängen“ hinzugefügt werden.

Definition

Namespace: UiPath.UIAutomationNext.API.Models

Assembly: UiPath.UIAutomationNext.API.Models (in der UiPath.UIAutomationNext.API.Models-DLL)

Überladungen

Überladen	Beschreibung
TakeScreenshot(IElementDescriptor, TakeScreenshotOptions)	Erstellt einen Screenshot eines bestimmten UI-Elements oder einer bestimmten Anwendung und speichert ihn in einer Datei, die durch einen Deskriptor eines Elements in Object Repository identifiziert wird
TakeScreenshot(IElementDescriptor, String)	Erstellt einen Screenshot eines bestimmten UI-Elements oder einer bestimmten Anwendung und speichert ihn in einer Datei, die durch einen Deskriptor eines Elements in Object Repository identifiziert wird, während der Dateiname angegeben wird.
TakeScreenshot(String, TakeScreenshotOptions)	Erstellt einen Screenshot eines bestimmten UI-Elements oder einer bestimmten Anwendung und speichert ihn in einer Datei, die durch einen String aus dem Objekt-Repository identifiziert wird, zusammen mit anderen Konfigurationen.
TakeScreenshot(String, String)	Erstellt einen Screenshot eines bestimmten UI-Elements oder einer bestimmten Anwendung und speichert ihn in einer Datei, die durch einen String aus dem Objekt-Repository identifiziert wird, zusammen mit anderen Konfigurationen.
TakeScreenshot(RuntimeTarget, TakeScreenshotOptions)	Erstellt einen Screenshot eines bestimmten UI-Elements oder einer bestimmten Anwendung und speichert ihn in einer Datei, die von einer Laufzeitinstanz eines Object Repository-Elements zusammen mit anderen Konfigurationen identifiziert wird.
TakeScreenshot(TargetAnchorableModel, TakeScreenshotOptions)	Erstellt einen Screenshot eines bestimmten UI-Elements oder einer bestimmten Anwendung und speichert ihn in einer Datei, die durch das TargetAnchorableModel -Objekt zusammen mit anderen Konfigurationen identifiziert wird.
TakeScreenshot(TargetAnchorableModel, String)	Erstellt einen Screenshot eines bestimmten UI-Elements oder einer bestimmten Anwendung und speichert ihn in einer Datei, die durch das TargetAnchorableModel -Objekt identifiziert wird, während der Dateiname angegeben wird.

TakeScreenshot(IElementDescriptor, TakeScreenshotOptions)

Erstellt einen Screenshot eines bestimmten UI-Elements oder einer bestimmten Anwendung und speichert ihn in einer Datei, die durch einen Deskriptor eines Elements in Object Repository identifiziert wird

TakeScreenhot(
    IElementDescriptor elementDescriptor,
    TakeScreenshotOptions takeScreenshotOptions)

elementDescriptor IElementDescriptor

Der Elementdeskriptor, aus dem der Screenshot erstellt werden soll. Verlassen Sie null , um einen Screenshot des gesamten Desktops zu erstellen.

takeScreenshotOptions TakeScreenshotOptions

Zusätzliche Optionen zum Anpassen des Screenshots. Sie können Folgendes anpassen:

• TargetOptions:
  • Timeout – Gibt (in Sekunden) an, wie lange die API ausgeführt werden muss, bevor der Fehler SelectorNotFoundException ausgegeben wird. Der Standardwert beträgt 30 Sekunden.
  • VerzögernNach – Verzögerungszeit (in Sekunden) nach dem Ausführen der API. Die Standardzeit beträgt 0,3 Sekunden (300 Millisekunden).
  • VerzögernVor – Verzögerungszeit (in Sekunden), bevor die API mit der Ausführung von Vorgängen beginnt. Die Standardzeitspanne ist 0,2 Sekunden (200 Millisekunden).
• FileName – Der Name der Datei, die Sie speichern möchten.

TakeScreenshot(IElementDescriptor, String)

Erstellt einen Screenshot eines bestimmten UI-Elements oder einer bestimmten Anwendung und speichert ihn in einer Datei, die durch einen Deskriptor eines Elements in Object Repository identifiziert wird, während der Dateiname angegeben wird.

TakeScreenhot(
    IElementDescriptor elementDescriptor,
    string fileName)

elementDescriptor IElementDescriptor

Der Elementdeskriptor, aus dem der Screenshot erstellt werden soll. Verlassen Sie null , um einen Screenshot des gesamten Desktops zu erstellen.

FileName String

Der Name der Datei, die Sie speichern möchten.

TakeScreenshot(String, TakeScreenshotOptions)

Erstellt einen Screenshot eines bestimmten UI-Elements oder einer bestimmten Anwendung und speichert ihn in einer Datei, die durch einen String aus dem Objekt-Repository identifiziert wird, zusammen mit anderen Konfigurationen.

TakeScreenhot(
    string target,
    TakeScreenshotOptions takeScreenshotOptions)

target String

Das Ziel, von dem ein Screenshot erstellt werden soll, wird durch eine Zeichenfolge in Object Repository identifiziert. Verlassen Sie null , um einen Screenshot des gesamten Desktops zu erstellen.

takeScreenshotOptions TakeScreenshotOptions

Zusätzliche Optionen zum Anpassen des Screenshots. Sie können Folgendes anpassen:

• TargetOptions:
  • Timeout – Gibt (in Sekunden) an, wie lange die API ausgeführt werden muss, bevor der Fehler SelectorNotFoundException ausgegeben wird. Der Standardwert beträgt 30 Sekunden.
  • VerzögernNach – Verzögerungszeit (in Sekunden) nach dem Ausführen der API. Die Standardzeit beträgt 0,3 Sekunden (300 Millisekunden).
  • VerzögernVor – Verzögerungszeit (in Sekunden), bevor die API mit der Ausführung von Vorgängen beginnt. Die Standardzeitspanne ist 0,2 Sekunden (200 Millisekunden).
• FileName – Der Name der Datei, die Sie speichern möchten.

TakeScreenshot(String, String)

Erstellt einen Screenshot eines bestimmten UI-Elements oder einer bestimmten Anwendung und speichert ihn in einer Datei, die durch einen String aus dem Objekt-Repository identifiziert wird, zusammen mit anderen Konfigurationen.

TakeScreenhot(
    string target,
    string fileName)

target String

Das Ziel, von dem ein Screenshot erstellt werden soll, wird durch eine Zeichenfolge in Object Repository identifiziert. Verlassen Sie null , um einen Screenshot des gesamten Desktops zu erstellen.

FileName String

Der Name der Datei, die Sie speichern möchten.

TakeScreenshot(RuntimeTarget, TakeScreenshotOptions)

Erstellt einen Screenshot eines bestimmten UI-Elements oder einer bestimmten Anwendung und speichert ihn in einer Datei, die von einer Laufzeitinstanz eines Object Repository-Elements zusammen mit anderen Konfigurationen identifiziert wird.

TakeScreenhot(
    RuntimeTarget target,
    TakeScreenshotOptions takeScreenshotOptions)

target RuntimeTarget

Das Ziel, von dem ein Screenshot erstellt werden soll, wird durch eine Laufzeitinstanz eines Object-Repository-Elements identifiziert. Verlassen Sie null , um einen Screenshot des gesamten Desktops zu erstellen.

takeScreenshotOptions TakeScreenshotOptions

Zusätzliche Optionen zum Anpassen des Screenshots. Sie können Folgendes anpassen:

• TargetOptions:
  • Timeout – Gibt (in Sekunden) an, wie lange die API ausgeführt werden muss, bevor der Fehler SelectorNotFoundException ausgegeben wird. Der Standardwert beträgt 30 Sekunden.
  • VerzögernNach – Verzögerungszeit (in Sekunden) nach dem Ausführen der API. Die Standardzeit beträgt 0,3 Sekunden (300 Millisekunden).
  • VerzögernVor – Verzögerungszeit (in Sekunden), bevor die API mit der Ausführung von Vorgängen beginnt. Die Standardzeitspanne ist 0,2 Sekunden (200 Millisekunden).
• FileName – Der Name der Datei, die Sie speichern möchten.

TakeScreenshot(TargetAnchorableModel, TakeScreenshotOptions)

Erstellt einen Screenshot eines bestimmten UI-Elements oder einer bestimmten Anwendung und speichert ihn in einer Datei, die durch das TargetAnchorableModel -Objekt zusammen mit anderen Konfigurationen identifiziert wird.

TakeScreenhot(
    TargetAnchorableModel target,
    TakeScreenshotOptions takeScreenshotOptions)

target TargetAnchorableModel

Das Ziel, von dem ein Screenshot erstellt werden soll, wird durch das TargetAnchorableModel -Objekt identifiziert. Verlassen Sie null , um einen Screenshot des gesamten Desktops zu erstellen.

takeScreenshotOptions TakeScreenshotOptions

Zusätzliche Optionen zum Anpassen des Screenshots. Sie können Folgendes anpassen:

• TargetOptions:
  • Timeout – Gibt (in Sekunden) an, wie lange die API ausgeführt werden muss, bevor der Fehler SelectorNotFoundException ausgegeben wird. Der Standardwert beträgt 30 Sekunden.
  • VerzögernNach – Verzögerungszeit (in Sekunden) nach dem Ausführen der API. Die Standardzeit beträgt 0,3 Sekunden (300 Millisekunden).
  • VerzögernVor – Verzögerungszeit (in Sekunden), bevor die API mit der Ausführung von Vorgängen beginnt. Die Standardzeitspanne ist 0,2 Sekunden (200 Millisekunden).
• FileName – Der Name der Datei, die Sie speichern möchten.

TakeScreenshot(TargetAnchorableModel, String)

Erstellt einen Screenshot eines bestimmten UI-Elements oder einer bestimmten Anwendung und speichert ihn in einer Datei, die durch das TargetAnchorableModel -Objekt identifiziert wird, während der Dateiname angegeben wird.

TakeScreenhot(
    TargetAnchorableModel target, 
    string fileName)

target TargetAnchorableModel

Das Ziel, von dem ein Screenshot erstellt werden soll, wird durch das TargetAnchorableModel -Objekt identifiziert. Verlassen Sie null , um einen Screenshot des gesamten Desktops zu erstellen.

FileName String

Der Name der Datei, die Sie speichern möchten.

Codebeispiel

Hier finden Sie eine kurze exemplarische Vorgehensweise zur Codeimplementierung.

Diese Codezeile legt den Dateipfad fest, in dem der Screenshot gespeichert wird.

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

Dieser Befehl wird aus einer bereits geöffneten Anwendung an einen Bildschirm angefügt.

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

Die API TakeScreenshot wird hier aufgerufen, erfasst den Screenshot des neu angegebenen Elements auf Ihrem Bildschirm und speichert ihn anschließend im definierten Dateipfad.

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

Prüft, ob die Screenshotdatei unter dem angegebenen filePath vorhanden ist.

var fileExists = system.FileExists(filePath);

Schließlich überprüft die Anweisung, ob die Screenshotdatei erfolgreich im Ziel filePath gespeichert wurde.

testing.VerifyAreEqual(fileExists, true);

Hinzufügen von Optionen

Sie können auf zwei Arten Optionen in Ihrem Code hinzufügen.

Eine Möglichkeit, Optionen hinzuzufügen, besteht darin, die richtige Überladung zu verwenden. Drücken Sie dazu Ctrl + Space und IntelliSense wird angezeigt, sodass Sie Ihre bevorzugte Überladung durchsuchen und auswählen können. Sie können sich entscheiden, die Überladung auszuwählen, bei der Sie die Parameter im Voraus eingerichtet haben. Optionale Parameter sind in Klammern angegeben.

Wenn Sie eine einzelne Einstellung wie windowResize initialisieren möchten, können Sie diese Syntax verwenden:

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

Eine andere Möglichkeit zum Hinzufügen von Optionen besteht darin, eine allgemeine Optionsüberladung zu verwenden, z. B. Attach, und sie mit der Klasse Options zu koppeln. Das bietet etwas mehr Flexibilität beim Anpassen Ihrer Parameter.