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.
![]() | 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