Delphi Source | Project

Use this sheet configure how forms are localized.

Resource string tags

Check Scan source code to find resource string comments check box to make Sisulizer to scan the source code. Checking this will slow down the scanning speed so check it only if your source code contains resource string tags. You need to have source code available and you have to specify project file name in order to enable resource string tags.

Resource string tag is used to pass resource string comments and properties to the project. The syntax is

//<tag>[comment_string|attribute]...
attribute=MaxChars=mc|MaxPixels=mp|Expression="expression"

where tag is a tag string (e.g. slz), mc is the maximum length of the translation in characters, mp is the maximum length of the translation is pixels, and expression is the combined string expression.

The following line has an resource string tag that contains a comment ("A message that is shown when the application starts"):

resourcestring

  SMsg = 'Hello world'; //slz A message that is shown when the application starts

The following line has an resource string tag that contains a comment ("Clicking this button opens on-line help") and sets the maximum length to 300 pixels:

resourcestring
  SMsg = 'Click Help to get more information'; //slz MaxPixels=300 Clicking this button opens on-line help

Project file name

Specifies a Delphi project file (.dpr). Use this if you have unit names having _ in their file names and those units use resource strings having also _ in their names. Otherwise Sisulizer can not determine the exact resource string context. For example if My_File.pas has the following resource string

resourcestring
  SMy_Sample_String = 'This is a sample';

It is highly recommend to specify project file. However Sisulizer can localize VCL applications without project files.

DRC file name

Specifies a DRC file that contains tables of all string constants declared by the resourcestring keywords. If you do no specify a DRC file then you have to select what context method is used with resource strings. Possible values are:

Because both alternative context methods have their limitation and dangers it is very much recommended to specify a DRC file. To create a .drc file choose Project | Options | Linking from Delphi and select Detailed in the Map file selection. In Delphi XE2 or later you can also turn DRC files on by checking Output resource string .drc file check box.