Difference between revisions of "IDE Window: Make ResourceString/de"

From Lazarus wiki
Jump to navigationJump to search
m (Reverted edits by Chronos (Talk); changed back to last version by Swen)
m (Fixed syntax highlighting; deleted category included in page template)
 
(9 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
{{IDE Window: Make ResourceString}}
 
{{IDE Window: Make ResourceString}}
  
This wizard helps to convert a string constant into a resourcestring.
+
Dieser Assistent hilft Ihnen, eine Zeichenkettenkonstante in einen Ressourcenstring umzuwandeln.
  
Place the cursor on a string constant or select the part of the constant that should be converted. Dann rufen sie Werkzeuge -> Make Resource String auf.
+
Stellen Sie den Cursor auf eine Stringkonstante oder wählen Sie denjenigen Teil der Konstante aus, der konvertiert werden soll. Dann rufen Sie ''Quelltext -> Refactoring -> Ressourcenstring erzeugen ...'' auf.
  
Eine Stringkonstante ist zum Beispiel 'Some text'.
+
Eine Stringkonstante ist zum Beispiel 'Irgendein Text'.
  
 
== Konvertierungseinstellungen ==
 
== Konvertierungseinstellungen ==
Line 12: Line 12:
  
 
Sie können einen neuen Bezeichner automatisch erzeugen. Der neue Bezeichner beginnt mit dem Präfix, gefolgt von den Zeichen der Stringkonstante. Wenn es bereits einen Ressourcestring mit diesem Wert gibt, dann wird der alte Bezeichner vorgeschlagen.
 
Sie können einen neuen Bezeichner automatisch erzeugen. Der neue Bezeichner beginnt mit dem Präfix, gefolgt von den Zeichen der Stringkonstante. Wenn es bereits einen Ressourcestring mit diesem Wert gibt, dann wird der alte Bezeichner vorgeschlagen.
The IDE remembers the prefixes for each unit, so the last used prefix for the current unit is preselected first.
+
Die IDE merkt sich die Präfixe für jede Unit; somit wird das zuletzt benutzte Präfix für die aktuelle Unit zuerst vorgeschlagen.
  
 
=== Bezeichnerlänge ===
 
=== Bezeichnerlänge ===
Line 20: Line 20:
 
=== Benutzerdefinierter Bezeichner ===
 
=== Benutzerdefinierter Bezeichner ===
  
Instead of using an automatically created identifier, you can specify the identifier on your own here.
+
Anstatt einen automatisch erstellen Bezeichner zu verwenden, können Sie hier einen eigenen Bezeichner angeben.
  
 
=== Ressourcestring-Abschnitt ===
 
=== Ressourcestring-Abschnitt ===
  
This combobox contains all available resourcestring sections of all units in scope. That means all sections of the current unit plus all sections in the interface parts of all used units.
+
Dieses Kombinationsfeld enthält alle verfügbaren Ressourcenstring-Abschnitte aller Units im Gültigkeitsbereich. Damit ist gemeint, alle Abschnitte der aktuellen Unit plus alle Abschnitte in den Schnittstellenteilen aller verwendeten Units.
  
 
=== Strings mit identischen Werten ===
 
=== Strings mit identischen Werten ===
  
This combobox contains all resourcestring identifiers with the same value as the new resourcestring. Sie können hier auswählen, ob sie einen von ihnen nehmen wollen.
+
Dieses Kombinationsfeld enthält alle Ressourcenstring-Bezeichner mit dem gleichen Wert wie der neue Ressourcenstring. Sie können hier auswählen, ob Sie einen von ihnen nehmen wollen.
  
=== Where to put the new identifier in the resourcestring section ===
+
=== Wo soll der neue Bezeichner im Ressourcenstring-Abschnitt stehen ===
  
If a new identifier is created, this defines where it will be added in the resourcestring section.
+
Wenn ein neuer Bezeichner erzeugt wird, legt dies fest, wo er im Ressourcenstring-Abschnitt eingefügt wird.
  
 
* An Ressourcenstring-Abschnitt anhängen - fügt den neuen Bezeichner am Ende des Abschnitts hinzu.
 
* An Ressourcenstring-Abschnitt anhängen - fügt den neuen Bezeichner am Ende des Abschnitts hinzu.
 
* Alphabetisch einfügen - ordnet den Bezeichner alphabetisch ein.
 
* Alphabetisch einfügen - ordnet den Bezeichner alphabetisch ein.
* Kontextsensitiv einfügen - search the code above and below the current code position and search for resourcestring identifiers. If it finds one, then the new identifier is added there, otherwise it is appended at the end of the section.
+
* Kontextsensitiv einfügen - durchsucht den Code ober- und unterhalb der aktuellen Codeposition und sucht nach Bezeichnern von Ressourcenstrings. Falls einer gefunden wird, wird der neue dort angefügt, andernfalls wird er am Ende des Abschnitts angefügt.
  
== Quelltext-Vorschau ==
+
== Stringkonstanten im Quelltext ==
  
Dies ist eine Vorschau, wie die Stringkonstante ersetzt wird, gefolgt von einer gestrichelten Linie und dann einer Vorschau, wie der Ressourecestring aussehen wird.
+
Dies zeigt den alten bzw. gegenwärtigen Quelltext.
  
== Stringkonstanten im Quelltext ==
+
== Quelltext-Vorschau ==
  
Dies zeigt den alten bzw. gegenwärtigen Quelltext.
+
Dies ist eine Vorschau, wie die Stringkonstante ersetzt wird, gefolgt von einer gestrichelten Linie und dann einer Vorschau, wie der Ressourcenstring aussehen wird.
  
 
== Beispiele ==
 
== Beispiele ==
  
=== Beispiel 1: Setting the caption of a form ===
+
=== Beispiel 1: Den Titel eines Formulars festlegen ===
  
If you do not have already a resource string section, start one in the interface part of the unit. For example right above the 'implementation' keyword:
+
Falls Sie nicht bereits einen Ressourcenstring-Abschnitt haben, beginnen Sie einen im Interface-Bereich der Unit. Zum Beispiel genau oberhalb des Schlüsselworts 'implementation':
  
<pascal>  
+
<syntaxhighlight lang=pascal>  
 
   resourcestring
 
   resourcestring
 
     rsSomeText = 'Some text';
 
     rsSomeText = 'Some text';
</pascal>
+
</syntaxhighlight>
  
Fügen sie im FormCreate Ereignis die folgende Zeile hinzu:
+
Fügen Sie im Ereignis 'FormCreate' die folgende Zeile hinzu:
 
    
 
    
<pascal>  
+
<syntaxhighlight lang=pascal>  
 
   Caption:='An example caption';
 
   Caption:='An example caption';
</pascal>  
+
</syntaxhighlight>  
  
Place the cursor on the string constant, i.e. somewhere between the two '.
+
Stellen Sie den Cursor auf die Stringkonstante, z.B. irgendwo zwischen die beiden '.
Then do Tools -> Make Resource String
+
Dann rufen Sie "Werkzeuge -> Ressourcenstring erzeugen ..." auf.
  
Set in the identifier prefix 'rs' without the '.
+
Geben Sie das Bezeichner-Präfix 'rs' ohne die ' an.
The new automatically suggested identifier will be 'rsAnExampleCaption'.
+
Der neue, automatisch vorgeschlagene Bezeichner ist 'rsAnExampleCaption'.
 
Die Vorschau zeigt
 
Die Vorschau zeigt
  
Line 74: Line 74:
 
   rsAnExampleCaption = 'An example caption'   
 
   rsAnExampleCaption = 'An example caption'   
  
Klicken sie auf OK.  
+
Klicken Sie auf OK.
  
 
=== Beispiel 2 : Komplexe Stringkonstanten ===
 
=== Beispiel 2 : Komplexe Stringkonstanten ===
  
When converting a complex string expression with variables and functions, the tool will use the '''Format''' function. Zum Beispiel wird die Anweisung:
+
Beim Konvertieren eines komplexen Stringausdrucks mit Variablen und Funktionen benutzt das Werkzeug die Funktion '''Format'''. Zum Beispiel wird die Anweisung:
  
<pascal>  
+
<syntaxhighlight lang=pascal>  
 
   Caption:='Left='+IntToStr(Left)+' Top='+IntToStr(Top);
 
   Caption:='Left='+IntToStr(Left)+' Top='+IntToStr(Top);
</pascal>  
+
</syntaxhighlight>  
  
 
ersetzt durch
 
ersetzt durch
  
<pascal>  
+
<syntaxhighlight lang=pascal>  
 
   Caption:=Format(rsLeftTop, [IntToStr(Left), IntToStr(Top)]);
 
   Caption:=Format(rsLeftTop, [IntToStr(Left), IntToStr(Top)]);
</pascal>  
+
</syntaxhighlight>  
  
 
und der neue Ressourcestring wird
 
und der neue Ressourcestring wird
  
<pascal>  
+
<syntaxhighlight lang=pascal>  
 
   rsLeftTop = 'Left=%s Top=%s'       
 
   rsLeftTop = 'Left=%s Top=%s'       
</pascal>  
+
</syntaxhighlight>  
 +
 
 +
Die Funktion 'Format' ist in der SysUtils-Unit definiert. Falls die uses-Klausel Ihrer Unit diese nicht bereits enthält, müssen Sie sie selbst hinzufügen.
 +
 
 +
 
 +
== Siehe auch ==
  
Die Format Funktion ist in der SysUtils Unit definiert. If your unit uses section does not already contain it, you must add it yourself.
+
* [[Getting translation strings right/de|Wie man Übersetzungsstrings richtig hinbekommt]]

Latest revision as of 09:49, 17 February 2020

Deutsch (de) English (en) français (fr) 日本語 (ja)

Dieser Assistent hilft Ihnen, eine Zeichenkettenkonstante in einen Ressourcenstring umzuwandeln.

Stellen Sie den Cursor auf eine Stringkonstante oder wählen Sie denjenigen Teil der Konstante aus, der konvertiert werden soll. Dann rufen Sie Quelltext -> Refactoring -> Ressourcenstring erzeugen ... auf.

Eine Stringkonstante ist zum Beispiel 'Irgendein Text'.

Konvertierungseinstellungen

Bezeichner-Präfix

Sie können einen neuen Bezeichner automatisch erzeugen. Der neue Bezeichner beginnt mit dem Präfix, gefolgt von den Zeichen der Stringkonstante. Wenn es bereits einen Ressourcestring mit diesem Wert gibt, dann wird der alte Bezeichner vorgeschlagen. Die IDE merkt sich die Präfixe für jede Unit; somit wird das zuletzt benutzte Präfix für die aktuelle Unit zuerst vorgeschlagen.

Bezeichnerlänge

Dies ist die maximale Länge des automatisch erzeugten Bezeichners.

Benutzerdefinierter Bezeichner

Anstatt einen automatisch erstellen Bezeichner zu verwenden, können Sie hier einen eigenen Bezeichner angeben.

Ressourcestring-Abschnitt

Dieses Kombinationsfeld enthält alle verfügbaren Ressourcenstring-Abschnitte aller Units im Gültigkeitsbereich. Damit ist gemeint, alle Abschnitte der aktuellen Unit plus alle Abschnitte in den Schnittstellenteilen aller verwendeten Units.

Strings mit identischen Werten

Dieses Kombinationsfeld enthält alle Ressourcenstring-Bezeichner mit dem gleichen Wert wie der neue Ressourcenstring. Sie können hier auswählen, ob Sie einen von ihnen nehmen wollen.

Wo soll der neue Bezeichner im Ressourcenstring-Abschnitt stehen

Wenn ein neuer Bezeichner erzeugt wird, legt dies fest, wo er im Ressourcenstring-Abschnitt eingefügt wird.

  • An Ressourcenstring-Abschnitt anhängen - fügt den neuen Bezeichner am Ende des Abschnitts hinzu.
  • Alphabetisch einfügen - ordnet den Bezeichner alphabetisch ein.
  • Kontextsensitiv einfügen - durchsucht den Code ober- und unterhalb der aktuellen Codeposition und sucht nach Bezeichnern von Ressourcenstrings. Falls einer gefunden wird, wird der neue dort angefügt, andernfalls wird er am Ende des Abschnitts angefügt.

Stringkonstanten im Quelltext

Dies zeigt den alten bzw. gegenwärtigen Quelltext.

Quelltext-Vorschau

Dies ist eine Vorschau, wie die Stringkonstante ersetzt wird, gefolgt von einer gestrichelten Linie und dann einer Vorschau, wie der Ressourcenstring aussehen wird.

Beispiele

Beispiel 1: Den Titel eines Formulars festlegen

Falls Sie nicht bereits einen Ressourcenstring-Abschnitt haben, beginnen Sie einen im Interface-Bereich der Unit. Zum Beispiel genau oberhalb des Schlüsselworts 'implementation':

 
  resourcestring
    rsSomeText = 'Some text';

Fügen Sie im Ereignis 'FormCreate' die folgende Zeile hinzu:

 
  Caption:='An example caption';

Stellen Sie den Cursor auf die Stringkonstante, z.B. irgendwo zwischen die beiden '. Dann rufen Sie "Werkzeuge -> Ressourcenstring erzeugen ..." auf.

Geben Sie das Bezeichner-Präfix 'rs' ohne die ' an. Der neue, automatisch vorgeschlagene Bezeichner ist 'rsAnExampleCaption'. Die Vorschau zeigt

   Caption:=rsAnExampleCaption;
 --------------------------------------------------------------------------------
 rsAnExampleCaption = 'An example caption'   

Klicken Sie auf OK.

Beispiel 2 : Komplexe Stringkonstanten

Beim Konvertieren eines komplexen Stringausdrucks mit Variablen und Funktionen benutzt das Werkzeug die Funktion Format. Zum Beispiel wird die Anweisung:

 
  Caption:='Left='+IntToStr(Left)+' Top='+IntToStr(Top);

ersetzt durch

 
  Caption:=Format(rsLeftTop, [IntToStr(Left), IntToStr(Top)]);

und der neue Ressourcestring wird

 
  rsLeftTop = 'Left=%s Top=%s'

Die Funktion 'Format' ist in der SysUtils-Unit definiert. Falls die uses-Klausel Ihrer Unit diese nicht bereits enthält, müssen Sie sie selbst hinzufügen.


Siehe auch