4D v14.3

Get indexed string

Home

 
4D v14.3
Get indexed string

Get indexed string 


 

Get indexed string ( ResID ; StrID {; ResDatei} ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
ResID  Lange Ganzzahl in Kennummer der Ressource oder 'id' Attribut des 'group' Elements (XLIFF)
StrID  Lange Ganzzahl in Stringnummer oder 'id' Attribut des 'trans-unit' Elements (XLIFF)
ResDatei  DokRef in Referenznummer der Ressourcendatei
Ohne Angabe: alle XLIFF Dateien oder offene Ressourcendateien.
Funktionsergebnis  String in Wert des indizierten String

Der Befehl Get indexed string gibt folgendes zurück:

  • Einen String aus der Stringlisten-Ressource (“STR#”) mit der Kennummer ResID.
    ODER
  • Einen String aus einer offenen XLIFF Datei mit dem 'id' Attribut des 'group' Elements, übergeben in ResID (siehe unten).

Sie übergeben die Stringnummer in StrID. Die Strings in der Stringlisten-Ressource sind numeriert von 1 bis N. Wollen Sie alle Strings (und ihre Nummern) aus der String-Listen Ressource erhalten, verwenden Sie den Befehl STRING LIST TO ARRAY.
Wird die Ressource oder der String innerhalb einer Ressource nicht gefunden, wird ein leerer String zurückgegeben, die OK Variable wird auf 0 (Null) gesetzt.

Übergeben Sie in ResDatei eine gültige Referenznummer für die Ressourcendatei, wird die Ressource nur in dieser Datei gesucht. Übergeben Sie ResDatei nicht, wird das erste Vorkommen der Ressource in der Ressourcendatei-Kette zurückgegeben.

Hinweis: Jeder String einer Stringlisten-Ressource kann bis zu 255 Zeichen enthalten.

Die Funktion Get indexed string ist ab 4D Version 11 mit der XLIFF Architektur kompatibel: Die Funktion sucht zuerst in allen offenen XLIFF Dateien nach Werten, die ResID und StrID entsprechen (wenn der Parameter ResDatei nicht übergeben ist). ResID bestimmt dann das id-Attribut des group-Elements und StrID das id-Attribut des trans-unit-Elements.

Wird der Wert nicht gefunden, setzt die Funktion die Suche in den offenen Ressource-Dateien fort. Weitere Informationen dazu finden Sie im Anhang C: XLIFF Architektur des Handbuchs 4D Designmodus.

Siehe letztes Beispiel zur Funktion SET MENU BAR.

Wird die Ressource gefunden, wird OK auf 1 gesetzt, sonst auf Null (0).

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Ressourcen
Nummer: 510

Dieser Befehl ändert die Systemvariable OK

 
GESCHICHTE 

Geändert: 4D v11 SQL

 
SIEHE AUCH 

Get string resource
Get text resource
STRING LIST TO ARRAY

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v11 SQL Release 6)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)