DEPRAG Smart Dokumentation

PrintFile

TwinCAT TIA

Lokal Drucken

ns=2;s=DEPRAG Smart/Local/Print/PrintFile

Erlaubt beliebige Dateien auf dem am System eingestellten Standarddrucker auszudrucken.

Parameter:

FullFileName
Vollständiger Dateiname inkl. Dateipfad zu der Datei, die über den Standarddrucker ausgedruckt werden soll.
Die Datei kann beispielsweise eine PDF-Datei (*.pdf) oder eine Word-Datei (*.doc oder *.docx) sein.

Rückgabewert:

PrintFile
Eine Variable vom Typ OpcMethodReturnValueVoid.

Neben den bereits erläuterten Parametern sind für die Implementierung in TwinCAT 3 nachfolgende Variablen anzulegen / zu übergeben:

Beckhoff Parameter:

bPrintFile
Eine boolesche Variable, über welche die Ausführung des PrintFile-Befehls getriggert werden kann.

OutputDataPrintFile
Eine Instanz der "ST_PrintFileOutputData" Struktur, in welche der Rückgabewert der PrintFile-Methode geschrieben wird.

hrPrintFile
Hiermit kann die Ausführung des Befehls überwacht werden. Fehler-Codes haben den Typ "HRESULT".

fbPrintFile
Eine Instanz des, mit der DEPRAG Smart-Bibliothek gelieferten, "FB_Print" Funktionsbausteins.

FullFileName
Eine Zeichenkette vom Typ "STRING(80)", die den vollständigen Dateinamen inkl. Dateipfad zu der Datei, die über den Standarddrucker ausgedruckt werden soll spezifiziert.

LengthOfFullFileName
Eine UINT-Variable, die die Länge des vollständigen Dateipfades angibt.

ConnectionHandle
Beim Verbindungsaufbau zwischen DEPRAG Smart Server und Ihrem OPC UA Client erhaltenes "ConnectionHandle".



VAR
  bPrintFile    : BOOL;
  OutputDataPrintFile  : ST_PrintFileOutputData;
  hrPrintFile    : HRESULT;
  fbPrintFile : FB_Print;
END_VAR

hrPrintFile := fbPrintFile.PrintFile( 
       bExecute    := bPrintFile, 
       ConnectionHandle  := depragSmartConnection.ConnectionHandle,
       FullFileName   := 'C:\Test\Doc1.docx',
       LengthOfFullFileName  := SIZEOF('D:\Test\Doc1.docx'),
       OutputData    => OutputDataPrintFile);
IF hrPrintFile <> S_FALSE THEN 
    bPrintFile := FALSE;
END_IF

Für Beispiele und Erklärungen bezüglich der Aufrufe von Knoten via Siemens TIA Portal sei an dieser Stelle auf den Unterpunkt "Siemens TIA Portal" in Abschnitt "Erste Schritte" verwiesen.