IDE Window: Make ResourceString/de

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

This wizard helps to convert a string constant into a resourcestring.

Place the cursor on a string constant or select the part of the constant that should be converted. Then invoke Tools -> Make Resource String.

A string constant is for example 'Some text'.

Konvertierungseinstellungen

Bezeichner-Präfix

You can create automatically a new identifier. The new identifier will start with the prefix, followed by the words of the string constant. If there is already a resourcestring with this value, the old identifier will be suggested. The IDE remembers the prefixes for each unit, so the last used prefix for the current unit is preselected first.

Bezeichnerlänge

This is the maximum length of the automatically created identifier.

Benutzerdefinierter Bezeichner

Instead of using an automatically created identifier, you can specify the identifier on your own here.

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.

Strings mit identischen Werten

This combobox contains all resourcestring identifiers with the same value as the new resourcestring. You can choose here, if you want to take one of them.

Where to put the new identifier in the resourcestring section

If a new identifier is created, this defines where it will be added in the resourcestring section.

• An Ressourcenstring-Abschnitt anhängen - add the new identifier at the end of the section.
• Alphabetisch einfügen - insert the identifier alphabetically.
• 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.

Stringkonstanten im Quelltext

This shows the old or current source code.

Quelltext-Vorschau

This is a preview, how the string constant is replaced, followed by a line of dashes and then a preview of how the resourcestring will look like.

Beispiele

Beispiel 1: Setting the caption of a form

If you do not have already a resource strin section, start one in the interface part of the unit. For example right above the 'implementation' keyword:

<pascal>

 resourcestring
   rsSomeText = 'Some text';

</pascal>

Add in the FormCreate event the following line:

<pascal>

 Caption:='An example caption';

</pascal>

Place the cursor on the string constant, i.e. somewhere between the two '. Then do Tools -> Make Resource String

Set in the identifier prefix 'rs' without the '. The new automatically suggested identifier will be 'rsAnExampleCaption'. The preview shows

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

Click ok.

Beispiel 2 : Complex string constants

When converting a complex string expression with variables and functions, the tool will use the Format function. For instance the statement:

<pascal>

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

</pascal>

will be replaced with

<pascal>

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

</pascal>

and the new resourcestring will be

<pascal>

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

</pascal>

The Format function is defined in the SysUtils unit. If your unit uses section does not already contain it, you must add it yourself.