TakeAllScreenShots


function TakeAllScreenShots(outputType: 'pdf' | 'png', RegionControl: TcHmi.Controls.System.TcHmiRegion | null, Contents: string[]):void

Die Funktion TakeAllScreenShots erstellt Screenshots von allen Inhalten, die in einem Projekt konfiguriert sind, basierend auf dem Attribut NavigationConfig des Controls Configurator. Die Inhalte werden nacheinander in einem durch den Parameter RegionControl festgelegten Bereich angezeigt, und von jedem Inhalt werden Screenshots erstellt. Die Ergebnis-Screenshots werden entweder im pdf- oder png-Format auf den Client heruntergeladen.

Bei speziellen Controls, die eine Paginierung unterstützen, wie z. B. Table und ZoneConfiguration, löst die Funktion Änderungen der Unterseiten aus und erstellt Screenshots für jede Unterseite.

Im Falle des Controls Table wird die Funktion bei jedem Inhalt, der während der Iteration durch alle Inhalte erscheint, zu jeder Unterseite jeder Untertabelle navigieren und Screenshots erstellen.

Für das Control ZoneConfiguration durchläuft die Funktion jede Zonengruppe, die auf dem Control verfügbar ist, und erstellt für jede Screenshots.

TakeAllScreenShots 1:

Beschränkungen und Genehmigungen

Mit dieser Funktion werden nur Screenshots der sichtbaren Bereiche der gemeinsamen Registerkarte, des Fensters oder des gesamten Bildschirms erstellt. Es kann keine Scroll-Aktion auslösen oder einen nicht sichtbaren Bereich in den Ergebnis-Screenshots erfassen.

Damit diese Funktion Screenshots aufnehmen kann, muss der Benutzer die Bildschirmfreigabe genehmigen, die der Browser vor der Aufnahme eines Screenshots anfordert. Der Benutzer muss eine geeignete Registerkarte, ein Fenster oder den gesamten Bildschirm auswählen und dem Browser den Zugriff auf die ausgewählte Ansicht gewähren, damit ein Screenshot erstellt werden kann.

Parameter

Name

Typ

Beschreibung

OutputType

ScreenShotFormat

Das Ausgabedateiformat ist .png oder .pdf (Standard ist .png).

Region

TcHmi.Controls.System.TcHmiRegion

Bereich, in dem vor dem Erstellen des Screenshots die Funktion jedes Inhalts angezeigt wird.

ContentList [ optional ]

ContentList

In diesem Parameter ist eine Liste der ausgewählten Inhalte zu finden, die für den Screenshot verwendet werden.

Wenn der Benutzer einen Screenshot von allen Inhalten des Projekts erstellen möchte, lassen Sie diesen Parameter leer.

Rückgabewert

Typ

Beschreibung

void

Kein Rückgabewert.

NuGet Paket: Beckhoff.TwinCAT.HMI.Plastic.Functions

Verfügbar: seit Version 12.18.0

Verwendung: TC3 Plastic Application HMI Projekte