writeEx

[ Funktion ]

Version 1.8

public static writeEx(
    expression: string, 
    value: any, 
    callback: (data: TcHmi.IResultObject | TcHmi.Server.IResultObject) => void
): void;

Version 1.12

public static writeEx<T = any>(
    expression: string, 
    value: T, 
    callback: (data: TcHmi.IResultObject<T> | TcHmi.Server.IResultObject<T>) => void
): DestroyFunction;

Schreibt den Wert eines Symbols adressiert über den Symbolausdruck.

writeEx 1:

Ab Version 1.0 erfolgt der Aufruf der Callback Funktion in Abhängigkeit des verwendeten Symbol Typs entweder synchron oder asynchron.

Server

asynchron

Internal

synchron

LocalizedText

synchron

PartialParam

synchron

TemplateParam

synchron

Function

synchron

Control

synchron

writeEx 2:

Version 1.12: Wird die API in TypeScript-Code benutzt, so kann dem TypeScript-Compiler mitgeteilt werden, welchen Typ der Symbolwert hat.

writeEx 3:

Dies ist eine reine Hilfe für die Programmierung. Der Browser kennt diese „Typeannotation“ nicht. Es findet keine Prüfung oder Konvertierung zur Laufzeit statt.

Die Typprüfung ist in dieser Funktion nur von begrenztem Nutzen. Siehe Beispiele.

Parameter

Name

Typ

Beschreibung

expression

string

Symbolausdruck

value

Version 1.8

any

Version 1.12

T

Neuer Wert des Symbols. Kann beliebigen Typ haben.

callback [ Optional ]

Version 1.8

(data: TcHmi.IResultObject | TcHmi.Server.IResultObject) => void

Version 1.12

(data: TcHmi.IResultObject<T> | TcHmi.Server.IResultObject<T>) => void

Wird ausgelöst wenn die Aktion erfolgreich abgeschlossen oder ein Fehler aufgetreten ist. Details sind dem Parameter data zu entnehmen.

Rückgabewert

Typ

Beschreibung

void

Ab Version 1.12:
DestroyFunction

Kein Rückgabewert

Ab Version 1.12:
Funktion zum Abbruch des Schreibvorgangs von asynchronen Werten.

writeEx 4:

Verfügbar ab Version 1.8

Beispiel - JavaScript

TcHmi.Symbol.writeEx('%s%PLC1.MAIN.sTest%/s%', 'Test', function (data) {
    if (data.error === TcHmi.Errors.NONE) {
        // Handle success... 
    } else {
        // Handle error... 
    }
});

Beispiel 1 - TypeScript

// TS does not know the variable type
TcHmi.Symbol.writeEx('%s%PLC1.MAIN.sTest%/s%', 'Test', function (data) {
    if (data.error === TcHmi.Errors.NONE) {
        // Handle success... 
    } else {
        // Handle error... 
    }
});

Beispiel 2 - TypeScript

TcHmi.Symbol.writeEx<string>('%s%PLC1.MAIN.sTest%/s%', 'Test', function (data) {
    if (data.error === TcHmi.Errors.NONE) {
        // Handle success... 
    } else {
        // Handle error... 
    }
});

Beispiel 3 - TypeScript

// TS prevents compile!
TcHmi.Symbol.writeEx<string>('%s%PLC1.MAIN.sTest%/s%', 42, function (data) {
    if (data.error === TcHmi.Errors.NONE) {
        // Handle success... 
    } else {
        // Handle error... 
    }
});