LangId

ITcEventView

Diese Eigenschaft setzt und gibt die Sprache zurück, in welcher der TcEventViewer, Meldungstexte und Quellen angezeigt werden.
Es kann entweder nur die primäre Sprach Id (z.B. ENG = 9; GER = 7) oder eine komplette LCID (z.B. ENG = 1033; GER = 1031) angegeben werden. Der TcEventViewer wird die Parameter entsprechend interpretieren. Das Setzen der Sprache hat zwei Effekte: zum einen werden die intern benutzten String Tables geändert, zum anderen wird der übergebene Parameter an den TcEventFormatter weitergeleitet. Es ist wichtig, dass der Parameter nur weitergeleitet wird. Das heißt, wenn 7 für Deutsch als Sprache übergeben wird, sucht der Formatter in seinen Ressourcen nach dem String '7'. Ist die deutsche Meldung in der Ressource als '1031' definiert, wird sie nicht gefunden.

Property get

HRESULT get_LangId([out, retval] long *pVal);

Parameter

pVal

[out, retval] Pointer auf eine long Variable, die die aktuell angewählte Sprach-Id erhält.

Rückgabe Werte

S_OK

Funktion wurde erfolgreich aufgerufen.

E_POINTER

pVal war kein gültiger Pointer.

Property let

HRESULT put_LangId([in] long newVal);

Parameter

newVal

[in] Die Sprach-Id der angefragten Sprache. Die gewünschte Sprache sollte mit *LCIDs markiert werden. Die nächste Tabelle zeigt ein Beispiel für einige Sprach-Ids. In der Konfiguration des Event Formatters werden die Sprachen mit der gleichen Sprach-Id gekennzeichnet.

LCID	Beschreibung
1031	Deutsch
1033	US Englisch
1034	Spanisch
1036	Französisch

Rückgabe Werte

S_OK

Funktion wurde erfolgreich aufgerufen.

Visual Basic Beispielcode

Option Explicit
' add the Beckhoff TcEvent View Library to the components
' place a TcEventView on the form, and assign the name TcEventView1

Private Sub Form_Load()
  ' prints the old language id
  Debug.Print TcEventView1.LangId
 ' sets the language id to English
 TcEventView1.LangId = 1033
End Sub

Anmerkungen

Wenn eine neue Sprache zugeordnet wird, werden alle angezeigten Events erneut in der neu ausgewählten Sprache aufgerufen.