Plastic.Localize
async function Localize(ctx: Context, key: TcHmi.Symbol): voidDie Funktion Plastic.Localize kann zur flexiblen Verwendung der im Beckhoff.TwinCAT.HMI.Plastic.Localization Pakets zur Verfügung gestellten Lokalisierungen verwendet werden. Die Funktion implementiert hierbei folgende Verhaltensweisen:
- Alle übergebenen LocalizationKeys (im folgenden Schlüssel) die im Package existieren werden in der ausgewählten Sprache angezeigt.
- Sollte ein identischer Schlüssel im Projekt angelegt werden, so wird die durch das Paket bereitgestellte Übersetzung überschrieben.
- Schlüssel können dadurch in einer einzelnen Sprache schnell angepasst werden.
- Benutzerspezifische Sprachen können direkt im Projekt gepflegt werden.
- Im Gegensatz zum Import aller Schlüssel aus dem Tc3_PlasticLocalization-Control können neue Lokalisierungen nach einem Paket-Update ohne Neuimport genutzt werden.
- Jeder Schlüssel, der in der ausgewählten Sprache weder im Projekt noch im Paket gefunden werden kann, wird mit einem
<N/A>markiert. - Ermöglicht das einfachere Identifizieren von nicht übersetzten Schlüsseln im Engineering. Diese Markierung ist daher exklusiv im Engineering sichtbar.
- Auf einem veröffentlichten Server sind diese Markierungen deaktiviert.
Beispielaufruf:

Beispielresultate:
- Schlüssel existiert:

- Schlüssel existiert nicht:

![]() | Schnelle Änderung eines Schlüssels ab TwinCAT HMI 14.x nicht möglich. Die schnelle Änderung eines Schlüssels im Eingabefeld (durch langsames doppelt Klicken) ist ab der TwinCAT HMI 14.x nicht mehr möglich. Um das Symbol dennoch zu ändern, empfehlen wir folgende Herangehensweise:
|
Parameter
Name | Typ | Beschreibung |
|---|---|---|
ctx <hidden> | Kontextobjekt mit Rückmeldung zum Fehler/Erfolg der Ausführung. | |
key | Der LocalizationKey, der durch die Funktion übersetzt werden soll. |
Rückgabewert
Typ | Beschreibung |
|---|---|
void | Kein Rückgabewert. |
NuGet Paket: Beckhoff.TwinCAT.HMI.Plastic.Localization
Verfügbar: seit Version 12.22.0
Verwendung: TC3 Plastic Application HMI Projekte
