====== Elementtext ======
Mit **Elementtext** ist es möglich Beschriftungen in der [[GUI|Primusoberfläche]] [[Spracheinstellung|sprachabhängig]] und damit variabel zu halten. Dazu wird anstelle der direkten (hardcoded) Eingabe eines Textes, ein Platzhalter angegeben. Dieser wird beim Start von Primus, abhängig von der eingestellten Sprache, durch einen Text aus der, in einer [[Sprachdatei]] hinterlegten, Tabelle ersetzt.

===== Sprachdefinition =====
Die Definition der zu verwendenden Sprache erfolgt in der [[Primus.xml]] im [[Primus.xml#Stammelement]] mit dem Attribut **stringspath**.

===== Aufbau eines Elementtextes =====
Der Aufbau eines Elementtextes sieht folgendermaßen aus:
''**$**//<SPRACHDATEI>//**.**//SAMPLE_ELEMENTTEXT//''.
Er beginnt immer mit einem Dollarzeichen (''$''), gefolgt vom Namen der Sprachdatei ohne Dateiendung, dann ein Punkt (''.'') und anschließend der eigentliche Platzhaltertext. Der Übersichtlichkeit wegen wird der Platzhaltertext immer in Großbuchstaben geschrieben, Leerzeichen sind __nicht__ erlaubt. Bei der Verwendung von Platzhaltertexten ist die Groß- / Kleinschreibung __unbedingt__ zu beachten.

==== Mehrere Elementtexte kombinieren ====
Es ist möglich mehrere Elementtexte zu kombinieren. Allerdings muß zwischen den beiden Elementtexten ein Leerzeichen als Trennung verwendet werden.
''**$**//<SPRACHDATEI>//**.**//SAMPLE_ELEMENTTEXT// **$**//<SPRACHDATEI>//**.**//SAMPLE_ELEMENTTEXT_2//''.

==== Elementtext mit Hardcoded Text ergänzen ====
Es ist möglich einen Elementtext mit einem festen Text zu ergänzen. Auch hier muß zwischen dem Elementtext und dem festen Text ein Leerzeichen zur Trennung sein.
''**$**//<SPRACHDATEI>//**.**//SAMPLE_ELEMENTTEXT// (Nur als Beispiel)''

===== Beispiel =====
<code xml><Title label="$Primus.SHEET_TITLE" /></code>

Wie man Platzhaltertexte definiert wird unter [[Spracheinstellung]] näher erklärt.

===== Systemdefinierte Platzhalter =====
Für einige Funktionen und Meldungen in Primus gibt es vordefinierte Platzhalter. Welche dies sind, steht in der [[Liste der Systemdefinierten Platzhalter]].

===== Suche nach Hardcoded Texten in der CFG.xml =====
Mit der [[Regular Expression]] <code>(label=")(?![\$,\"])</code> kann in [[Notepad++]] nach Texten in der [[CFG.XML]], die nicht durch einen Eintrag in einer Sprachdatei definiert sind, gesucht werden. Wobei statt ''text'' auch
  * ''label''
  * ''tooltip''
  * ''title''
verwendet werden kann.

{{tag>GUI Sprachabhängig Textersetzung Case_sensitiv Regular_Expression}}