1. Назначение.
2. Особенности.
3. Действия, необходимые для локализации.
4. Описание программы и порядок использования.
5. Описание модуля LcUnit.pas.
6. Демо-проект.
7. Состав комплекта.
8. Лицензионное соглашение.
9. Скачать (версия 2.51 и 3.00 для Delphi XE).
10. Об авторе.

1. Назначение.

Программа ДелЛок (Делфийный локализатор) предназначена для локализации интерфейса Ваших делфийных программ на любое количество языков. Локализируются строки, объявленные в секции resourcestring, а также строковые свойства форм и компонентов.

2. Особенности.

• Программа абсолютно бесплатна для локализации любых программ (включая коммерческие).
• Простой, удобный и понятный интерфейс.
• Минимум добавлений в исходный код Вашей программы.
• Экспорт и импорт сделанных Вами переводов из одних проектов в другие.
• Фильтрация списка локализируемых свойств и строк.
• Перевод всех строковых свойств компонент, включая свойства наследников TStrings и TCollection.
• Переключение языков "на лету".

3. Действия, необходимые для локализации.

Для локализации Вашей делфийной программы с помощью программы ДелЛок (Делфийного локализатора) необходимо:

• Создать с помощью программы ДелЛок файл локализации, в котором будут содержаться локализированные ресурсные строки и свойства форм и компонентов.
• Включить в проект файл LcUnit.pas, поставляемый вместе с "локализатором".
• После загрузки приложения вызвать функцию LoadLcf(), где в качестве параметров указать требуемый язык и имя файла локализации. Вызов функции можно поместить в исходнике проекта сразу после слова begin или в каком-либо модуле проекта в секции initialization.
• При создании локализованной формы вызвать для нее функцию TranslateComponent(). Вызов функции можно поместить в перегруженный конструктор формы (сразу после inherited) или в обработчик события OnCreate. Если Ваши формы наследуются от одной базовой формы, то достаточно поставить вызов функции TranslateComponent() только в базовой форме.

4. Описание программы и порядок использования.

Если Вы в своем проекте используете объявления строк в блоках resourcestring, и Вам необходимо их локализировать, то перед началом локализации Вам необходимо откомпилировать свой делфийный проект с включенной опцией детального документирования линковки (Пункты меню Project->Options, закладка Linker, пункт Map file->Detailed). При этом компилятор Делфи сформирует специальный файл с расширением drc.

Для создания нового файла локализации выберите пункт меню программы ДелЛок Файл->Новый и в открывшемся окне выбора файлов укажите локализируемый exe-файл и соответсвующий ему drc-файл.

После этого в окне Параметров импорта укажите язык, на котором изначально написан интерфейс программы, а также по желанию введите маски отбора названий строковых констант и свойств компонентов, для которых необходимо проводить локализацию. Нажмите кнопку ОК. В окне программы "Содержание" появится иерархическое представление строковых констант и свойств по их названиям и принадлежности к исходным файлам. В таблице в зависимости от выбранного пункта окна "Содержание" будут отображаться строки и свойства с их первоначальными переводом.

Выберите пункт меню Языки->Языки и в открывшемся окне добавьте языки, перевод на которые должен содержать файл локализации. Нажмите кнопку ОК. Вы в любой момент можете добавлять или удалять языки локализации из проекта, используя данное окно.

Непосредственно в таблице или в многострочном редакторе сделайте перевод строк и свойств на добавленные языки локализации.

Откомпилируйте файл локализации выбрав пункт меню Файл-> Сохранить и компилировать. Созданный файл готов к использованию. Если Вы сохраните в файле локализации информацию о проекте, то можете в дальнейшем использовать его для обновления и синхронизации с изменениями, которые Вы вносите в Ваш проект, а также для экспорта сделанных переводов в другие проекты.

Для обновления и синхронизации файла локализации с внесенными в делфийный проект изменениями, а также для импорта переводов из других файлов и проектов, откройте его, выбрав пункт меню Файл->Открыть. Далее выберите пункт меню Перевод->Импорт перевода. В окне Параметров импорта назначте язык импорта и маски фильтрации аналогично тому, как это делалось при создании нового проекта. Нажмите кнопку ОК.

5. Описание модуля LcUnit.pas.

Модуль LcUnit.pas содержит объявления двух функций: LoadLcf() и TranslateComponent(), а также описание одного типа: TLcCallBack.

Функция LoadLcf() производит загрузку указанного файла локализации и активизирует перевод строк и свойств для указанного языка локализации.

function LoadLcf( const sFileName : string; iLCID : LCID; pCallBack : TLcCallBack; pUd : pointer ) : integer;

Описание параметров:

• sFileName - имя файла локализации;
• iLCID - идентификатор языка (локализации), который необходимо использовать. Класс Делфи TLangauges позволяет получить все возможные значения идентификатора локализации и строковые описания соответствующих языков.
• pCallBack - указатель на функцию обратного вызова типа TLcCallBack для получения информации о идентификаторах языков, поддерживаемых файлом локализации. Может быть равен nil;
• pUd - пользовательский указатель, значение которого будет возвращено в качестве параметра в функции pCallBack. Может быть равен nil.

Результат:

• 1 - файл локализации загружен, требуемый язык активирован;
• 0 - файл локализации загружен, но требуемый язык локализации не поддерживается. Перевод осуществлен не будет.
• -1 - ошибка загрузки файла локализации. Перевод осуществлен не будет.

Функция TranslateComponent() локализирует строковые свойства формы и компонентов, расположенных на ней.

function TranslateComponent( oComponent : TComponent ) : boolean;

Описание параметров:

• oComponent - Форма, строковые свойства компонентов которой необходимо перевести.

Результат:

• true - локализация проведена;
• false - ошибка локализации.

Тип TLcCallBack является прототипом функции обратного вызова, указатель на которую в качестве параметра передается в функцию LoadLcf(). Если указатель на функцию не нулевой, то после загрузки файла локализации функция обратного вызова будет вызвана для каждого идентификатора языка, поддерживаемого файлом локализации.

type TLcCallBack = function( iLCID : integer; pUd : pointer ) : integer; stdcall;

Описание параметров:

• iLCID - идентификатор языка, перевод на который присутствует в файле локализации;
• pUd - пользовательский указатель, переданный при вызове функции LoadLcf().

Результат:

• 0 - остановить вызов функции для остальных идентификаторов языков в файле локализации;
• не 0 - продолжить вызовы.

Для переключения языков "на лету" Вы можете в программе использовать следующий код:
   var
     i : integer;
   begin
     for i := 0 to Screen.FormCount - 1 do TranslateComponent( Screen.Forms[ i ] );
   end;

6. Демо-проект.

В поставку программы ДелЛок включен демонстрационный проект, в котором можно посмотреть, как использовать возможности модуля LcUnit.pas, включая:

• получение информации о языках перевода, хранящихся в файле локализации;
• переключение языков "на лету".

7. Состав комплекта.

В комплект поставки входят:

• DelLoc.* - файлы программы ДелЛок;
• LcUnit.pas - исходный файл, включаемый в локализируемые проекты;
• Help\*.* - файлы краткой справки;
• Demo\*.* - файлы демо-проекта;
• readme*.* - файлы описания.

8. Лицензионное соглашение.

1. Программа ДелЛок версии 2.51 (Программное Обеспечение) - свободно распространяемое приложение (freeware). Вы можете использовать ее в любых проектах, включая условно бесплатные (shareware) и коммерческие (commercial).

2. Все авторские права на Программное Обеспечение в целом и на все его составные части принадлежат автору - Гаврилову Сергею Владимировичу.

3. Программное Обеспечение может распространяться свободно в том виде, в котором он поставляется автором. Никакие физические и юридические лица не имеют права брать оплату за распространение и использование Программного Обеспечения без юридически заверенного письменного разрешения автора.

4. Программное Обеспечение распространяется по принципу "как есть". При этом не предусматривается никаких гарантий, явных или подразумеваемых. Вы используете его на свой собственный риск. Автор не несет никакой ответственности и не отвечает за потери данных, повреждения, потери прибыли или любые другие виды потерь, связанные с использованием (правильным или неправильным) этого Программного Обеспечения.

5. Запрещено вносить какие бы то ни было изменения в состав и файлы Программного Обеспечения.

6. Установка и использование Программного Обеспечения свидетельствует о согласии с условиями данного лицензионного соглашения. Если вы не согласны с перечисленными условиями, то должны удалить все файлы Программного Обеспечения со всех своих устройств хранения информации и отказаться от его использования.

9. Скачать.

• dlcinst.exe (~1Мб). Инсталлятор программы ДелЛок.
• dlcxeinst.exe (~1,4Мб). Инсталлятор программы ДелЛокXe для Delphi XE.

10. Об авторе.

Автор программы - Гаврилов Сергей Владимирович, Санкт-Петербург, Россия.

e-mail: sergegavrilov@mail.ru

icq: 777807