Дополнение к командам/параметрам, связанным с диалогами ввода и просмотра

Дополнение №18

Дополнение к командам/параметрам, связанным с диалогами ввода и просмотра.

1. [input] , <input>	Диалог ввода информации в Input
2. [combo] , <combo>	Диалог выбора информации в ComboBox
3. [group] , <group>	Диалог выбора информации в GroupBox
4. [edits] , <edits>	Диалог выбора информации в EditBox
5. shape	Объединение в один диалог
6. [ssave] , <ssave>	Диалог выбора файла для сохранения
7. [sopen] , <sopen>	Диалог выбора файла для открытия
8. [sicon] , <sicon>	Диалог просмотра и выбора значка
9. [sfold] , <sfold>	Диалог выбора каталога
10. [richinput] , <richinput>	Диалог ввода информации в RichInput
11. [check] , <check>	Диалог выбора информации в CheckBox
12. [zfold] , <zfold>	Диалог выбора каталогов
13. [fontz] , <fontz>	Диалог выбора шрифта
14. [iconz] , <iconz>	Диалог выбора значка
15. style	Установка стиля для диалогов
16. [lista] , <lista>	Диалог редактирования и выбора из списка ListBox
17. stylp	Установка стиля для прогресс бара
18. [timen]	Установка времени ожидания для диалогов
19. [msgbx] , <msgbx>	Окно сообщения MsgBox
20. [updwn] , <updwn>	Диалог выбора числовой информации UpDown
21. [image] , <image>	Диалог выбора изображения
22. <TRAY>	Подсказка в трее
23. [elect] , <elect>	Диалог выбора файлов и папок
24. [dates] , <dates>	Диалог выбора даты и времени

Примечание	№1 - Передача переменных диалогам
Примечание	№2 - Применение тегов ширины и высоты
Примечание	№3 - Установка значка окну диалога
Примечание	№4 - Подсказки в диалогах GroupBox и CheckBox
Примечание	№5 - Сохранение позиций диалогов
Примечание	№6 - Установка фона диалогов
Примечание	№7 - Установка значения по умолчанию
Примечание	№8 - Маска шаблонов. Параметр [extnd=Name]
Примечание	№9 - Окно подсказки в диалогах.

Диалоги можно использовать в командах (в тех местах где нужно получить данные) или воспользоваться командой dilog и далее использовать глобальные переменные для вставки данных в нужные места командной строки.

В версии 9.0 добавлена поддержка в TCIMG_.lng пользовательских окончаний ключей (кроме цифр):
InfoBox, InputBox, FolderBox, OpenBox, GroupBox, ComboBox, EditsBox, Shape, TrayIconHint, Title
К примеру, использоваться ключи с любым окончанием после основы InputBox,
в котором есть цифры, латинские символы и знак подчёркивания _ (InputBox_V01=...)

1. Диалог ввода информации: Подпараметр [input] или <input>

Ввод информации. Подпараметр [input] или <input>.
В любом месте строки параметров, где встретится [input], будет вызвано диалоговое окно, в котором можно ввести данные.

Расширенный вид: [input=Title*|Info|Line(|Width|Height|TextSize|Mode)] позволяет самому настроить окно ввода, где:
Title* - заголовок окна.
Info - информация в окне (если необходим символ |, используйте && ; если необходим перенос, используйте @CRLF).
Line - начальная строка в окне ввода.
Width - ширина диалога (минимальный размер 240 px).
Height - высота диалога (минимальный размер 96 px).
TextSize - размер шрифта.
Mode - любое значение отображает "звёздочки" (•) вместо символов при вводе текста

Также поддерживается формат [input=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng в секции языка ([Russian]) в соответствующих ключах InputBox1, InputBox2 ... InputBoxN, в том же формате Title|Info|Line(|Width|Height|TextSize|Mode).
Также могут использоваться ключи с любым окончанием после основы InputBox, в котором есть цифры, латинские символы и знак подчёркивания _

Пример записи:

InputBox1=Ввод расширения|Введите необходимое расширение|txt

В версии 4.4. появилась возможность настраивать размер, толщину, имя шрифта, фон, цвет в диалоге в TCIMG.ini в секции [Box]

Установка значка окну *

Установка подсказки окну **

Команда имеет возможность передавать другим командам информацию через именные глобальные переменные. см. Дополнение №23

Имя переменной Описание

GLOBALINPUT массив входных данных (в первой ячейке введённые данные)
если используются несколько диалогов [input] или [richinput] то:
  данные 2-го диалога записываются во 2-ю ячейку
  данные 3-го диалога записываются в 3-ю ячейку
  ...
  данные N-го диалога записываются в N-ю ячейку

GLOBALINPUT1
...
GLOBALINPUTN массив входных построчных данных. Разделитель данных @RN
  построчные данные 1-го диалога записываются в переменную GLOBALINPUT1
  построчные данные 2-го диалога записываются в переменную GLOBALINPUT2
  ...
  построчные данные N-го диалога записываются в переменную GLOBALINPUTN

Может выглядеть следующим образом:

2. Диалог выбора информации в ComboBox: Подпараметр [combo] или <combo>

Выбор информации в ComboBox. Подпараметр [combo] или <combo>.
В любом месте строки параметров, где встретится [combo=BOXN], будет вызвано диалоговое окно, в котором можно выбрать данные.

[combo=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng в секции языка ([Russian]) в соответствующих ключах ComboBox1, ComboBox2 ... ComboBoxN и позволяет самому настроить окно вывода.
Также могут использоваться ключи с любым окончанием после основы ComboBox, в котором есть цифры, латинские символы и знак подчёркивания _

Синтаксис шаблона:

ComboBoxN=Title*||Info||List||Width||Height||Number||Edit

где:
Title* - заголовок окна.
Info - информация в окне (@CRLF для переноса строк).
List - строка-список фраз, выводимых в ComboBox, прописываемых через разделитель |
Width - ширина диалога.
Height - высота диалога.
Number - номер фразы из списка List, выводимой первой в ComboBox.
Edit - 1 - редактируемый ComboBox, 0 - не редактируемый.

Пример записи:

ComboBox1=Выбор имени||Выберите или введите своё имя файла:||Name|File|ReadMe|Test|Безымянный||343||117||1||1

Можно настраивать размер, толщину, имя шрифта, фон, цвет в диалоге в TCIMG.ini в секции [Box]

Добавлено в версии 13.6
Можно в пунктах List прописывать комментарии пробел<<текст>>, которые выводятся в пунктах, но не передаются при выборе.

Пример записи комментариев:

ComboBox_X00=Копирование||Выберите папку||$f06 <<рабочий стол>>|$f300 <<папка Total Commander>>||400||120||1

Чтобы передать символ | используется Chr(124).

Добавлено в версии 13.7
List - может быть следующего формата ¤¤Data¤¤Section¤¤Delimeter¤¤
  Data - данные, которые используются в пунктах, возможны варианты:
    File - путь к файлу, в котором находится информация.
    GLOBALNAME<xN> - информация из глобальных переменных (см. Дополнение №23)
    $var_... - значения переменных, созданные командой exect
  Section - имя секции, если секция не используется, то прописывается символ #
  Delimeter - разделитель данных для пунктов. Можно использовать в строке: "@CR" - Символ возврата каретки, Chr(13), "@LF" - Символ перевода строки, Chr(10), "@CRLF" = @CR & @LF, "@TAB" - Символ Tab, Chr(9)

Пример записи:

ComboBox_X000=Выбор шаблона||Выберите шаблон:||¤¤C:\List.txt¤¤#¤¤@CRLF¤¤||383||117||1||1

Добавлено в версии 33.2
List - может быть следующего формата ®Data1®Name1...®DataN®NameN
  Data - данные, которые будут переданы при выборе.
  Name - имя данных, которое будет отображаться в диалоге.
  ®Data®Name - могут использоваться сколько угодно раз, пары прописываются последовательно друг за другом.

Пример записи:

ComboBox_Mask11=Выбор маски||Выберите маску для поиска:||®*.ani|*.bmp|*.cdr|*.clp|*.cgm|*.cur|*.dib|*.djvu|*.drw®Файлы изображений®*.txt|*.lst|*.tcg®Текстовые файлы||260||117||1||1

В данном шаблоне в диалоге будут отображаться имена данных "Файлы изображений" и "Текстовые файлы"
При выборе будут передаваться данные "*.ani|*.bmp|*.cdr|*.clp|*.cgm|*.cur|*.dib|*.djvu|*.drw" или "*.txt|*.lst|*.tcg"
Актуально при длинных строках данных, которые необходимо выбрать и передать...

Установка значка окну *

Установка подсказки окну **

Имя переменной Описание

GLOBALCOMBO массив входных данных (в первой ячейке данные выбранного пункта)
если используются несколько диалогов [combo] то:
  данные 2-го диалога записываются во 2-ю ячейку
  данные 3-го диалога записываются в 3-ю ячейку
  ...
  данные N-го диалога записываются в N-ю ячейку

GLOBALCOMBO1
...
GLOBALCOMBON массив входных построчных данных. Разделитель данных @RN
  построчные данные 1-го диалога записываются в переменную GLOBALCOMBO1
  построчные данные 2-го диалога записываются в переменную GLOBALCOMBO2
  ...
  построчные данные N-го диалога записываются в переменную GLOBALCOMBON

GLOBALCOMBN1
...
GLOBALCOMBNN массив выходных данных.
в 1-й ячейке номер выбранного пункта.
  номер 1-го диалога записываются в переменную GLOBALCOMBN1
  номер 2-го диалога записываются в переменную GLOBALCOMBN2
  ...
  номер N-го диалога записываются в переменную GLOBALCOMBNN

Может выглядеть следующим образом:

3. Диалог выбора информации в GroupBox: Подпараметр [group] или <group>

Выбор информации в GroupBox. Подпараметр [group] или <group>.
В любом месте строки параметров, где встретится [group=BOXN], будет вызвано диалоговое окно, в котором можно выбрать данные.

[group=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng в секции языка ([Russian]) в соответствующих ключах GroupBox1, GroupBox2 ... GroupBoxN и позволяет самому настроить окно вывода.
Также могут использоваться ключи с любым окончанием после основы ComboBox, в котором есть цифры, латинские символы и знак подчёркивания _

Синтаксис шаблона:

GroupBoxN=Title*<#>Info<#>Group<#>LineRadioButtons<#>Width<#>Height<#>TextSize<#>TextWeight

где:
Title* - заголовок окна.
Info - информация в окне (@CRLF для переноса строк).
Group - название группы.
LineRadioButtons - строка-список радиокнопок, состоящих из пар: название радиокнопки и параметр командной строки, передаваемый при выборе - разделитель внутри и между парами <+>
Width - ширина диалога.
Height - высота диалога.
TextSize - размер шрифта.
TextWeight - толщина шрифта.

Пример записи:

GroupBox1=Выбор режима конвертирования<#>Конвертировать изображения.<#>Выберите режим<#>Все с расширением под курсором<+>%p*.%E<+>Все выделенные<+>/filelist=%L<#>290<#>160

Если в LineRadioButtons в параметрах командной строки участвуют параметры Total Commander (см. Дополнение №7),
то через разделитель !! в [group=BOXN] необходимо добавить соответствующие параметры TC.

К примеру, если в LineRadioButtons есть параметры %L, %p, %E ..., то синтаксис записи:

[group=BOXN!!%%L=%L!!%%p=%p!!%%E=%E]

В версии 14.6 добавлен в LineRadioButtons тег :LABEL:Text<+>TextWeight,Color позволяющий создавать однострочную надпись в GroupBox, где:
  :LABEL: - тег, означающий, что будет создаваться надпись.
  Text - текст надписи.
  <+> - разделитель.
  TextWeight [необязательный] - толщина шрифта: 400 - нормальный, 700 - жирный.
  Color [необязательный] - RGB цвет шрифта.

Пример записи:

GroupBox_YY=Заголовок<#>Описание<#>Режим<#>:LABEL:Надпись 1<+>700,000080<+>1. Первое<+>N_1<+>2. Второе<+>N_2<+>:LABEL:Надпись 2<+>700,DC143C<+>3. Третье<+>N_3<+>4. Четвёртое<+>N_4<#>230<#>240

В версии 14.7 добавлен в LineRadioButtons тег :BREAK:<+>Indent
:BREAK: - тег, означающий перенос последующих пунктов в новый столбец.
Indent - число, означающее отступ от предыдущего столбца в пикселях.

Пример записи:

GroupBox_BR1=Заголовок<#>Описание<#>Режим<#>:LABEL:Надпись 1<+>700,000080<+>1. Первое<+>N_1<+>2. Второе<+>N_2<+>:BREAK:<+>100<+>:LABEL:Надпись 2<+>700,DC143C<+>3. Третье<+>N_3<+>4. Четвёртое<+>N_4<#>230<#>180

В LineRadioButtons тег Текст:V:<+>Cmd
  :V: - тег указывает, что пункт будет активен.
  Cmd - параметры командной строки.
  Активность устанавливается для последнего пункта, в котором найден тег :V: (по умолчанию активный 1-й пункт)

Совместно с другими тегами можно использовать подсказку к пунктам или к названиям в GroupBox.
В LineRadioButtons тег Текст©Hint©<+>Cmd
  ©Hint© - подсказка к пункту (прописывается в конце после всех тегов и текста между символами ©)
  Cmd - параметры командной строки.
   Дополнительные настройки подсказки в Примечании №4

В любом месте строки можно использовать метки §string§ для внутреннего пользования, которые не влияют и не отображаются в диалоге.
§string§ - string - строка или набор символов.

Можно настраивать размер, толщину, имя шрифта, фон, цвет в диалоге в TCIMG.ini в секции [Box]

Установка значка окну *

Установка подсказки окну **

Имя переменной Описание

GLOBALGROUP массив входных данных (в первой ячейке данные выбранного пункта)
если используются несколько диалогов [group] то:
  данные 2-го диалога записываются во 2-ю ячейку
  данные 3-го диалога записываются в 3-ю ячейку
  ...
  данные N-го диалога записываются в N-ю ячейку

GLOBALGROUP1
...
GLOBALGROUPN массив входных построчных данных. Разделитель данных @RN
  построчные данные 1-го диалога записываются в переменную GLOBALGROUP1
  построчные данные 2-го диалога записываются в переменную GLOBALGROUP2
  ...
  построчные данные N-го диалога записываются в переменную GLOBALGROUPN

GLOBALGROUN1
...
GLOBALGROUNN массив выходных данных.
в 1-й ячейке номер выбранного пункта.
  номер 1-го диалога записываются в переменную GLOBALGROUN1
  номер 2-го диалога записываются в переменную GLOBALGROUN2
  ...
  номер N-го диалога записываются в переменную GLOBALGROUNN

Может выглядеть следующим образом:

4. Диалог выбора информации в EditsBox: Подпараметр [edits] или <edits>

Выбор информации в EditsBox. Подпараметр [edits] или <edits>.
В любом месте строки параметров, где встретится [edits=BOXN], будет вызвано диалоговое окно, в котором можно ввести данные.

[edits=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng в секции языка ([Russian]) в соответствующих ключах EditsBox1, EditsBox2 ... EditsBoxN и позволяет самому настроить окно вывода.
Также могут использоваться ключи с любым окончанием после основы EditsBox, в котором есть цифры, латинские символы и знак подчёркивания _

Синтаксис шаблона:

EditsBoxN=Title*<#>Info<#>Edit<#>Width<#>Height<#>TextSize<#>TextWeight<#>TextName<#>Color

где:
Title* - заголовок окна.
Info - информация в окне.
Edit - строка-список окон edit, состоящих из трио:
Название окна<+>Высота окна<+>параметр командной строки, передаваемый при выборе
Разделитель внутри и между трио <+>
Width - ширина диалога.
Height - высота диалога.
TextSize - размер шрифта.
TextWeight - толщина шрифта.
TextName - имя шрифта.
Color - RGB цвет диалога (по умолчанию системный).

TextSize, TextWeight, TextName, Color являются не обязательными, по умолчанию значения берутся в TCIMG.ini в секции [Box]

Пример записи:

EditsBox1=Поиск и замена<#>Введите фразы для поиска и замены в содержимом выделенных файлах.<#>ввод строки поиска<+>100<+>!!<+>ввод строки замены<+>100<+><#>340<#>305

Для установки заданных строк в элемент(ы) Edit при вызове диалога,
во 2-м соответствующем ключе EditsTextBoxN прописывается строка
или строки, разделённые <#> (количество строк должно совпадать количеству элементов Edit)

Пример записи:

EditsTextBox1=Строка №1 по умолчанию@CRLFпри вызове диалога<#>Строка №2

Установка значка окну *

Установка подсказки окну **

Имя переменной Описание

GLOBALEDITS массив входных данных (в первой ячейке введённые данные)
если используются несколько диалогов или полей ввода [edits] то:
  данные 2-го диалога (или поля ввода) записываются во 2-ю ячейку
  данные 3-го диалога (или поля ввода) записываются в 3-ю ячейку
  ...
  данные N-го диалога (или поля ввода) записываются в N-ю ячейку

GLOBALEDITS1
...
GLOBALEDITSN массив входных построчных данных. Разделитель данных @RN
  построчные данные 1-го диалога записываются в переменную GLOBALEDITS1
  построчные данные 2-го диалога записываются в переменную GLOBALEDITS2
  ...
  построчные данные N-го диалога записываются в переменную GLOBALEDITSN

Может выглядеть следующим образом:

5. Объединение в один диалог : Команда shape

Команда shape создана для объединения отдельных диалогов [input], [richinput], [combo], [group], [edits], [check], [iconz], [lista], [updwn], [image], [dates] в один.

Может выглядеть следующим образом:

В версии 20.4 появилась возможность горизонтального объединения диалогов.
• Тег [break] в командной строке между диалогами означает перенос последующих за ним диалогов в новую колонку.
• Тег [break] может использоваться несколько раз.
Пример записи:

shape=1 creat="%p"||[combo=BOX2].[break][combo=BOX3]

Может выглядеть следующим образом:

Установка значка окну *

Установка подсказки окну **
Пример записи:

shape=1??BOX_Ex1 creat="%p"||[combo=BOX2].[break][combo=BOX3]

6. Диалог выбора файла для сохранения: Подпараметр [ssave] или <ssave>

Выбор файла для сохранения. Подпараметр [ssave]. В любом месте строки параметров, где встретится [ssave], будет вызвано диалоговое окно выбора файла для записи.

Расширенный вид:[ssave=Info!!Path!!Filter!!Name!!Ext!!N] позволяет самому настроить окно ввода, где:
  Info - информация в диалоге.
  Path - корневой каталог дерева выбора в диалоге.
  Filter - файловый фильтр (текст_1|фильтр_1|текст_2|фильтр_2|текст_N|фильтр_N).
  Name - начальное имя.
  Ext - начальное расширение.
  N - номер начального выводимого фильтра.

Также поддерживается формат [ssave=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng, в секции языка ([Russian]), в соответствующих ключах SaveBox1, SaveBox2 ... SaveBoxN, в том же формате Info!!Path!!Filter!!Name!!Ext!!N
Также могут использоваться ключи с любым окончанием после основы SaveBox, в котором есть цифры, латинские символы и знак подчёркивания _

Пример записи:

SaveBox1=Выберите имя файла для сохранения.!!C:\!!Текст (*TXT)|*.txt|Все (*.*)|*.*!!newname!!txt!!2

Имя переменной Описание

GLOBALSSAVE1
GLOBALSSAVE2
...
GLOBALSSAVEN массив: в первой ячейке путь выбранного файла
  данные 1-го диалога записываются в переменную GLOBALSSAVE1
  данные 2-го диалога записываются в переменную GLOBALSSAVE2
  ...
  данные N-го диалога записываются в переменную GLOBALSSAVEN

Может выглядеть следующим образом:

7. Диалог выбора файла для открытия: Подпараметр [sopen] или <sopen>

Выбор файла для открытия. Подпараметр [sopen]. В любом месте строки параметров, где встретится [sopen], будет вызвано диалоговое окно выбора файла.

Расширенный вид: [sopen=Info!!Path!!Filter!!Name!!Ext!!Number!!Options] позволяет самому настроить окно ввода, где:
Info - информация в диалоге.
Path - корневой каталог дерева выбора в диалоге.
Filter - файловый фильтр (текст_1|фильтр_1|текст_2|фильтр_2|текст_N|фильтр_N).
Name - начальное имя.
Ext - начальное расширение.
Number - номер начального выводимого фильтра.
Options - выбор нескольких файлов при Options=4 (по умолчанию Options=0 - выбор одного файла).

Также поддерживается формат [sopen=BOX1..N], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng, в секции языка ([Russian]) , в соответствующих ключах OpenBox1, OpenBox2 ... OpenBoxN, в том же формате Info!!Path!!Filter!!Name!!Ext!!Number.
Также могут использоваться ключи с любым окончанием после основы OpenBox, в котором есть цифры, латинские символы и знак подчёркивания _

Пример записи:

OpenBox1=Выберите имя файла.!!C:\!!Текст (*TXT)|*.txt|Все (*.*)|*.*!!openfile!!txt!!2

Возвращает:
Полный путь к выбранному файлу.
При Options=4 временный файл со списком полных путей выбранных файлов (даже если выбран один файл)

Имя переменной Описание

GLOBALSOPEN1
GLOBALSOPEN2
...
GLOBALSOPENN массив, в котором находятся пути выбранных файлов
  данные 1-го диалога записываются в переменную GLOBALSOPEN1
  данные 2-го диалога записываются в переменную GLOBALSOPEN2
  ...
  данные N-го диалога записываются в переменную GLOBALSOPENN

Может выглядеть следующим образом:

8. Диалог просмотра и выбора значка: Подпараметр <sicon> или [sicon]

Выбор значка. Подпараметр <sicon> или <sicon=FileIcon(|Size|Focus|Flag|Mode|Delimeter)>, где:
FileIcon - путь к библиотеке с иконками.
Size - отображаемый размер значков при просмотре.
          Этот параметр может быть в диапазоне от 8 до 256.
          При -1 размер берётся из TCIMG.ini из секции [IconDialog] из ключа SizeIcon
Focus - номер (начальная позиция) значка просмотра.
Flag
  0 - не создавать кнопку "Свернуть", иконка не отображается на панели задач (по умолчанию).
  1 - создавать кнопку "Свернуть", иконка отображается на панели задач.
Mode - режим вывода:
  0 - возвращается абсолютный путь и через разделитель номер иконки (по умолчанию)
  1 - возвращается относительный путь и через разделитель номер иконки
  2 - возвращается относительный путь (относительно утилиты TCIMG) и через разделитель номер иконки
  3 - возвращается номер иконки
Delimeter - разделитель между путём и номером иконки (по умолчанию запятая ",")
   Дополнительные возможности, которые можно использовать в разделителе:
  • "@CR" - Символ возврата каретки, Chr(13), "@LF" - Символ перевода строки, Chr(10), "@CRLF" = @CR & @LF, "@TAB" - Символ Tab, Chr(9).
  • Если необходимы кавычки, то используются две одинарных кавычки (апострофа) '' , если в команде необходим пробел - используются два символа тильды ~~
  • Так же можно вставлять символы с помощью функций Autoit Chr() и ChrW(), которые заменяются соответствующими символами, а так же ClipGet(), которая заменяется содержимым буфера обмена и Number(), позволяющая производить математические действия.

Если путь не найден, то открывается диалог ввода файла со значками.
Основные типы файлов, содержащие иконки: EXE, DLL, ICL, SCR, OCX, CPL, WCX, WDX, WLX, WFX, SFX, TSP, IME, AX, DRV....

Имя переменной Описание

GLOBALSICON1
GLOBALSICON2
...
GLOBALSICONN массив, в котором находятся данные выбранного значка:
- в 1-й ячейке путь файла и через запятую номер значка.
- во 2-й ячейке путь файла.
- в 3-й ячейке номер значка.
- в 4-й ячейке путь файла с удваиванием слешей и через запятую номер значка.

  данные 1-го диалога записываются в переменную GLOBALSICON1
  данные 2-го диалога записываются в переменную GLOBALSICON2
  ...
  данные N-го диалога записываются в переменную GLOBALSICONN

Может выглядеть следующим образом:

9. Диалог выбора каталога: Подпараметр [sfold] или <sfold>

Выбор каталога. Подпараметр [sfold]. В любом месте строки параметров, где встретится [sfold], будет вызвано диалоговое окно выбора каталога, в котором можно выбрать каталог.

Расширенный вид: [sfold=Info|Path] позволяет самому настроить окно ввода, где:
Info - информация в диалоге.
Path - корневой каталог дерева выбора в диалоге.
Чтобы установить Рабочий Стол в качестве корневого каталога (по умолчанию) 2-й параметр не указывается.

Также поддерживается формат [sfold=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng, в секции языка ([Russian]) , в соответствующих ключах FolderBox1, FolderBox2 ... FolderBoxN, в том же формате Info|Path.
Также могут использоваться ключи с любым окончанием после основы FolderBox, в котором есть цифры, латинские символы и знак подчёркивания _

Пример записи:

FolderBox1=Выберите папку для создания списка|

Имя переменной Описание

GLOBALSFOLD1
GLOBALSFOLD2
...
GLOBALSFOLDN массив: в первой ячейке путь выбранной папки.
  данные 1-го диалога записываются в переменную GLOBALSFOLD1
  данные 2-го диалога записываются в переменную GLOBALSFOLD2
  ...
  данные N-го диалога записываются в переменную GLOBALSFOLDN

Может выглядеть следующим образом:

10. Диалог ввода информации: Подпараметр [richinput] или <richinput>

Параметр richinput является аналогом параметра input, в котором используется класс поля ввода "RichEdit"

Ввод информации. Подпараметр [richinput] или <richinput>.
В любом месте строки параметров, где встретится [richinput], будет вызвано диалоговое окно, в котором можно ввести данные.

Расширенный вид: [richinput=Title|Info|Line(|Width|Height|TextSize|Mode)] позволяет самому настроить окно ввода, где:
Title - заголовок окна.
Info - информация в окне (если необходим символ |, используйте &&; если необходим перенос, используйте @CRLF).
Line - начальная строка в окне ввода.
Width - ширина диалога (минимальный размер 240 px).
Height - высота диалога (минимальный размер 96 px).
TextSize - размер шрифта.
Mode - любое значение отображает "звёздочки" (•) вместо символов при вводе текста

Также поддерживается формат [input=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng в секции языка ([Russian]) в соответствующих ключах RichInputBox1, RichInputBox2 ... RichInputBoxN, в том же формате Title|Info|Line(|Width|Height|TextSize|Mode).
Также могут использоваться ключи с любым окончанием после основы RichInputBox, в котором есть цифры, латинские символы и знак подчёркивания _

Пример записи:

RichInputBox1=Ввод расширения|Введите необходимое расширение|txt

Есть возможность настраивать размер, толщину, имя шрифта в диалоге в TCIMG.ini в секции [Box]

Установка значка окну *

Установка подсказки окну **

11. Диалог выбора информации в CheckBox: Подпараметр [check] или <check>

Выбор информации в CheckBox. Подпараметр [check] или <check>.
В любом месте строки параметров, где встретится [check=BOXN], будет вызвано диалоговое окно, в котором можно выбрать данные.

[check=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng в секции языка ([Russian]) в соответствующих ключах CheckBox1, CheckBox2 ... CheckBoxN и позволяет самому настроить окно вывода.
Также могут использоваться ключи с любым окончанием после основы CheckBox, в котором есть цифры, латинские символы и знак подчёркивания _

Синтаксис шаблона:

CheckBoxN=Title*<#>Info<#>Check<#>LineRadioButtons<#>Width<#>Height<#>TextSize<#>TextWeight

где:
Title* - заголовок окна.
Info - информация в окне.
Check - название группы.
LineRadioButtons - строка-список радиокнопок, состоящих из пар: название радиокнопки и параметр командной строки, передаваемый при выборе - разделитель внутри и между парами <+>
Width - ширина диалога.
Height - высота диалога.
TextSize - размер шрифта.
TextWeight - толщина шрифта.

Пример записи:

CheckBox1=Выбор режима конвертирования<#>Конвертировать изображения.<#>Выберите режим<#>Все с расширением под курсором<+>%p*.%E<+>Все выделенные<+>/filelist=%L<#>290<#>160

Если в LineRadioButtons в параметрах командной строки участвуют параметры Total Commander (см. Дополнение №7),
то через разделитель !! в [check=BOXN] необходимо добавить соответствующие параметры TC.

К примеру, если в LineRadioButtons есть параметры %L, %p, %E ..., то синтаксис записи:

[check=BOXN!!%%L=%L!!%%p=%p!!%%E=%E]

В LineRadioButtons тег :LABEL:Text<+>TextWeight,Color позволяющий создавать однострочную надпись в CheckBox, где:
  :LABEL: - тег, означающий, что будет создаваться надпись.
  Text - текст надписи.
  <+> - разделитель.
  TextWeight [необязательный] - толщина шрифта: 400 - нормальный, 700 - жирный.
  Color [необязательный] - RGB цвет шрифта.

Пример записи:

CheckBox_YY=Заголовок<#>Описание<#>Режим<#>:LABEL:Надпись 1<+>700,000080<+>1. Первое<+>N_1<+>2. Второе<+>N_2<+>:LABEL:Надпись 2<+>700,DC143C<+>3. Третье<+>N_3<+>4. Четвёртое<+>N_4<#>230<#>240

В LineRadioButtons тег :BREAK:<+>Indent
:BREAK: - тег, означающий перенос последующих пунктов в новый столбец.
Indent - число, означающее отступ от предыдущего столбца в пикселях.

Пример записи:

CheckBox_BR1=Заголовок<#>Описание<#>Режим<#>:LABEL:Надпись 1<+>700,000080<+>1. Первое<+>N_1<+>2. Второе<+>N_2<+>:BREAK:<+>100<+>:LABEL:Надпись 2<+>700,DC143C<+>3. Третье<+>N_3<+>4. Четвёртое<+>N_4<#>230<#>180

В LineRadioButtons тег Текст:V:<+>Cmd
:V: - тег указывает, что пункту будет установлена галочка.
Cmd - параметры командной строки.

Тег :NO: - прописывается в любом месте, означает, что галочка не будет установлена 1-му пункту.
Тег игнорируется, если используется тег :V:

Совместно с другими тегами можно использовать подсказку к пунктам или к названиям в CheckBox.
В LineRadioButtons тег Текст©Hint©<+>Cmd
  ©Hint© - подсказка к пункту (прописывается в конце после всех тегов и текста между символами ©)
  Cmd - параметры командной строки.
   Дополнительные настройки подсказки в Примечании №4

Можно настраивать размер, толщину, имя шрифта, фон, цвет в диалоге в TCIMG.ini в секции [Box]

Установка значка окну *

Установка подсказки окну **

1. Диалог отличается от остальных тем что не передаёт в команду данных, т.к. можно выбрать несколько вариантов
2. Запуск производится через команды cmdcm или dilog (на странице команд есть примеры)

Имя переменной Описание

GLOBALCHECK1
GLOBALCHECK2
GLOBALCHECK3
GLOBALCHECK4
GLOBALCHECK5
GLOBALCHECK6
GLOBALCHECK7
GLOBALCHECK8
GLOBALCHECK9 массив входных данных:
  в   1-й ячейке данные 1-го отмеченного пункта
  во 2-й ячейке данные 2-го отмеченного пункта
  в   3-й ячейке данные 3-го отмеченного пункта
  ...
  в   N-й ячейке данные N-го отмеченного пункта

если используются несколько диалогов [check] то:
  данные 1-го диалога записываются в переменную GLOBALCHECK1
  данные 2-го диалога записываются в переменную GLOBALCHECK2
  ...
  данные 9-го диалога записываются в переменную GLOBALCHECK9

GLOBALCHECM1
GLOBALCHECM2
GLOBALCHECM3
GLOBALCHECM4
GLOBALCHECM5
GLOBALCHECM6
GLOBALCHECM7
GLOBALCHECM8
GLOBALCHECM9 массив входных данных:
  все выбранные данные записываются в первую ячейку без разделителя
если используются несколько диалогов [check] то:
  данные 1-го диалога записываются в переменную GLOBALCHECM1
  данные 2-го диалога записываются в переменную GLOBALCHECM2
  ...
  данные 9-го диалога записываются в переменную GLOBALCHECM9

GLOBALCHECR1
GLOBALCHECR2
GLOBALCHECR3
GLOBALCHECR4
GLOBALCHECR5
GLOBALCHECR6
GLOBALCHECR7
GLOBALCHECR8
GLOBALCHECR9 массив входных построчных данных. Разделитель данных @RN
  в   1-й ячейке построчные данные 1-го отмеченного пункта
  во 2-й ячейке построчные данные 2-го отмеченного пункта
  в   3-й ячейке построчные данные 3-го отмеченного пункта
  ...
  в   N-й ячейке построчные данные N-го отмеченного пункта

если используются несколько диалогов [check] то:
  данные 1-го диалога записываются в переменную GLOBALCHECR1
  данные 2-го диалога записываются в переменную GLOBALCHECR2
  ...
  данные 9-го диалога записываются в переменную GLOBALCHECR9

GLOBALCHECN1
GLOBALCHECN2
GLOBALCHECN3
GLOBALCHECN4
GLOBALCHECN5
GLOBALCHECN6
GLOBALCHECN7
GLOBALCHECN8
GLOBALCHECN9 массив выходных данных. Массив равен количеству пунктов.
  0 - если пункт не выбран.
  1 - если пункт выбран.

если используются несколько диалогов [check] то:
  выбор 1-го диалога записываются в переменную GLOBALCHECN1
  выбор 2-го диалога записываются в переменную GLOBALCHECN2
  ...
  выбор 9-го диалога записываются в переменную GLOBALCHECN9

GLOBALCHECO1
GLOBALCHECO2
GLOBALCHECO3
GLOBALCHECO4
GLOBALCHECO5
GLOBALCHECO6
GLOBALCHECO7
GLOBALCHECO8
GLOBALCHECO9 массив выходных данных. Массив равен количеству пунктов.
  "пустая строка" - если пункт не выбран.
  указанные данные - если пункт выбран.

если используются несколько диалогов [check] то:
  выбор 1-го диалога записываются в переменную GLOBALCHECO1
  выбор 2-го диалога записываются в переменную GLOBALCHECO2
  ...
  выбор 9-го диалога записываются в переменную GLOBALCHECO9

Может выглядеть следующим образом:

12. Диалог выбора каталогов: Подпараметр [zfold] или <zfold>

Выбор каталогов. Подпараметр [zfold]. В любом месте строки параметров, где встретится [zfold], будет вызвано диалоговое окно выбора каталога, в котором можно выбрать один или несколько каталогов.

Расширенный вид: [zfold=Info|Path] позволяет самому настроить окно ввода, где:
Info - информация в диалоге.
Path - корневой каталог дерева выбора в диалоге.
Чтобы установить Рабочий Стол в качестве корневого каталога (по умолчанию) 2-й параметр не указывается.

Также поддерживается формат [zfold=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng, в секции языка ([Russian]) , в соответствующих ключах FolderzBox1, FolderzBox2 ... FolderzBoxN, в том же формате Info|Path.
Также могут использоваться ключи с любым окончанием после основы FolderzBox, в котором есть цифры, латинские символы и знак подчёркивания _

Пример записи:

FolderzBox1=Выберите папки для создания списка|C:\

Имя переменной Описание

GLOBALZFOLD1
GLOBALZFOLD2
...
GLOBALZFOLDN массив, в котором находятся пути выбранных каталогов.
  данные 1-го диалога записываются в переменную GLOBALZFOLD1
  данные 2-го диалога записываются в переменную GLOBALZFOLD2
  ...
  данные N-го диалога записываются в переменную GLOBALZFOLDN

Может выглядеть следующим образом:

13. Диалог выбора шрифта: Подпараметр [fontz] или <fontz>

Выбор каталогов. Подпараметр [fontz]. В любом месте строки параметров, где встретится [fontz], будет вызвано диалоговое окно выбора шрифта, в котором можно выбрать размер, имя, цвет... шрифта.

Расширенный вид: [fontz=Name|Size|Weight|Italic|Underline|Strikethru|Color|Flag|CharSet] позволяет самому настроить начальные данные окна шрифта, где:
  Name - имя шрифта (по умолчанию системный).
  Size - размер шрифта (по умолчанию системный).
  Weight - толщина шрифта (от 100 до 1000, число кратное 100, 400 - нормальный, 700 - жирный) (по умолчанию 400).
  Italic - 1 - курсив, 0 - не курсив (по умолчанию 0).
  Underline - 1 - подчеркнутый, 0 - не подчеркнутый (по умолчанию 0).
  Strikethru - 1 - зачёркнутый, 0 - не зачёркнутый (по умолчанию 0).
  Color - RGB цвет шрифта (по умолчанию 0 или 000000 - чёрный).
  Flag - может быть суммой флагов, определяющих вывод заданных шрифтов:

Имя Константы	Значение	Описание
CF_SCREENFONTS	0x1 (1)	Список экранных шрифтов
CF_PRINTERFONTS	0x2 (2)	Список шрифтов для печати
CF_BOTH	0x3 (3)	Список всех экранных и принтерных шрифтов (по умолчанию)
CF_FIXEDPITCHONLY	0x4000 (16384)	Список только моноширинных шрифтов
CF_SCALABLEONLY	0x20000 (131072)	Список масштабированных шрифтов
CF_TTONLY	0x40000 (262144)	Список TrueType-шрифтов

CharSet - определяет используемый набор символов. Может иметь следующие значения:

Имя Константы	Значение	Описание (code)
CHARSET_ARABIC	176	арабский язык (1256)
CHARSET_BALTIC	186	прибалтийские языки (1257)
CHARSET_CHINESEBIG5	136	китайский язык (традиционное письмо) (950)
CHARSET_CHINESEGB2312	134	китайский язык (упрощенное письмо) (936)
CHARSET_EASTEUROPE	238	Windows Latin 2 (1250)
CHARSET_GREEK	161	греческий язык (1253)
CHARSET_HEBREW	177	иврит (1255)
CHARSET_JAPANESESHIFTJIS	128	японский язык (932)
CHARSET_KOREANHANGEUL	129	корейский язык (949)
CHARSET_KOREANJOHAB	130	корейский язык (1361)
CHARSET_RUSSIAN	204	кириллица (1251)
CHARSET_THAI	222	тайский язык (874)
CHARSET_TURKISH	162	турецкий язык (1254)
CHARSET_VIETNAMESE	163	вьетнамский язык (1258)
CHARSET_SYMBOL	2	Symbol (42)
CHARSET_ANSI	0	Зависит от локализации Windows (для русской - 1251)
CHARSET_MAC	77	Зависит от локализации Windows (для русской - 10007)
CHARSET_OEM	255	Зависит от локализации Windows (для русской - 866)

Все параметры являются необязательными.

Также поддерживается формат [fontz=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng, в секции языка ([Russian]) , в соответствующих ключах FontBox1, FontBox2 ... FontBoxN, в том же формате Name|Size|Weight|Italic|Underline|Strikethru|Color.
Также могут использоваться ключи с любым окончанием после основы FontBox, в котором есть цифры, латинские символы и знак подчёркивания _

Пример записи:

FontBox1=Segoe UI|12|400|0|0|0|0000FF|0x4000

Имя переменной Описание

GLOBALFONTZ1
GLOBALFONTZ2
...
GLOBALFONTZN массив, в котором находятся данные, выбранные в диалоге.
  данные 1-го диалога записываются в переменную GLOBALFONTZ1
  данные 2-го диалога записываются в переменную GLOBALFONTZ2
  ...
  данные N-го диалога записываются в переменную GLOBALFONTZN

в 1-й ячейке - имя шрифта.
в 2-й ячейке - размер шрифта.
в 3-й ячейке - ширина шрифта (от 100 до 1000).
в 4-й ячейке - курсив шрифта (0 или 1).
в 5-й ячейке - подчеркнутость шрифта (0 или 1).
в 6-й ячейке - зачёркнутость шрифта (0 или 1).
в 7-й ячейке - RGB цвет шрифта.
в 8-й ячейке - значение (используемый набор символов).

Может выглядеть следующим образом:

14. Диалог выбора значка: Подпараметр [iconz] или <iconz>

Выбор значка. Подпараметр [iconz] или <iconz>.
В любом месте строки параметров, где встретится [iconz=BOXN], будет вызвано диалоговое окно, в котором можно выбрать значок.

[iconz=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng в секции языка ([Russian]) в соответствующих ключах IconzBox1, IconzBox2 ... IconzBoxN и позволяет самому настроить окно вывода.
Также могут использоваться ключи с любым окончанием после основы IconzBox, в котором есть цифры, латинские символы и знак подчёркивания _

Синтаксис шаблона:

где:
Title* - заголовок окна.
Info - информация в окне.
Path - путь к библиотеке значков.
Width - ширина диалога.
Height - высота диалога.
Number - нумерация значков: 0 - с нуля, 1 - с единицы.

Пример записи:

IconzBox1=Выбор значка¤TCIMG.dll,92|Выберите значок:|%TCIMG_PATH%\TCIMG.dll|343|165|0

Можно настраивать размер, толщину, имя шрифта, фон, цвет в диалоге в TCIMG.ini в секции [Box]

Установка значка окну *

Установка подсказки окну **

Имя переменной Описание

GLOBALICONZ1
...
GLOBALICONZN   данные 1-го диалога записываются в переменную GLOBALICONZ1
  данные 2-го диалога записываются в переменную GLOBALICONZ2
  ...
  данные N-го диалога записываются в переменную GLOBALICONZN

  1 ячейка содержит путь библиотеки и через запятую номер значка.
  2 ячейка содержит путь библиотеки.
  3 ячейка содержит номер значка.
  4 ячейка содержит путь с удвоенным слешем.

Может выглядеть следующим образом:

15. Установка стиля для диалогов : Команда style

Может выглядеть следующим образом:

16. Диалог редактирования и выбора из списка ListBox: Подпараметр [lista] или <lista>

Выбор из списка. Подпараметр [lista] или <lista>.
В любом месте строки параметров, где встретится [lista=BOXN], будет вызвано диалоговое окно, в котором можно выбрать значение из списка.

[lista=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng в секции языка ([Russian]) в соответствующих ключах ListaBox1, ListaBox2 ... ListaBoxN и позволяет самому настроить окно вывода.
Также могут использоваться ключи с любым окончанием после основы ListaBox, в котором есть цифры, латинские символы и знак подчёркивания _

Синтаксис шаблона:

где:
Title* - заголовок окна.
Info - информация в окне.
List - список пунктов, может иметь несколько вариантов:
  Path - путь к файлу списка.
  cliplist - список из буфера обмена.
  $GLOBALNAME - список путей глобальной переменной.

Width - ширина диалога.
Height - высота диалога.
ListBox - высота элемента ListBox (минимум 146).

Пример записи:

ListaBox1=Список¤TCIMG.dll,92|Редактировать список|$GLOBALSLIST|443|240|146

Можно настраивать размер, толщину, имя шрифта, фон, цвет в диалоге в TCIMG.ini в секции [Box]

Установка значка окну *

Установка подсказки окну **

Имя переменной Описание

GLOBALLISTA1
...
GLOBALLISTAN
GLOBALLISTB1
...
GLOBALLISTBN   данные 1-го диалога записываются в переменные GLOBALLISTA1 и GLOBALLISTB1
  данные 2-го диалога записываются в переменные GLOBALLISTA2 и GLOBALLISTB2
  ...
  данные N-го диалога записываются в переменные GLOBALLISTAN и GLOBALLISTBN

  GLOBALLISTAN - содержит список всех пунктов.
  GLOBALLISTBN - содержит в 1-й ячейке данные выбранного пункта.

Может выглядеть следующим образом:

17. Установка стиля для прогресс бара : Команда stylp

Может выглядеть следующим образом:

18. Установка времени ожидания для диалогов: Подпараметр [timen]

Установка времени ожидания. Подпараметр [timen].
В любом месте строки параметров, где встретится [timen=Seconds|Exit], будут установлены следующие параметры для диалогов:
  Seconds - время ожидания (в секундах), по истечении которого диалог будет автоматически закрыт.
    При 0 время ожидания устанавливаться не будет.
  Exit - [необязательный]
    0 - продолжаются выполнятся последующие команды, прописанные после диалога (по умолчанию).
    1 - происходит выход из утилиты.

Установки параметра [timen] действуют для всех диалогов, следующих после подпараметра.
Для переопределения установок можно использовать подпараметр несколько раз.

Для установки времени ожидания по умолчанию можно воспользоваться ключами DialogsTimeOut и DialogsTimeOutExit в TCIMG.ini в секции [Setting]

Пример записи:

[Setting]
; DialogsTimeOut - устанавливать время ожидания (в секундах), по истечении которого диалог будет автоматически закрыт.
;   0 - не устанавливать ожидание.
;   N - число в секундах.
DialogsTimeOut=15
; DialogsTimeOutExit - режим действия после автоматического закрытия диалога:
;   0 - продолжаются выполнятся команды, прописанные после диалога.
;   1 - происходит выход из утилиты.
DialogsTimeOutExit=0

Может выглядеть следующим образом:

19. Окно сообщения MsgBox: Подпараметр [msgbx] или <msgbx>

Выбор информации в MsgBox. Подпараметр [msgbx] или <msgbx>.
В любом месте строки параметров, где встретится [msgbx=BOXN], будет вызвано окно сообщения.

[msgbx=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng в секции языка ([Russian]) в соответствующих ключах MsgbxBox1, MsgbxBox2 ... MsgbxBoxN и позволяет самому настроить окно сообщения.
Также могут использоваться ключи с любым окончанием после основы MsgbxBox, в котором есть цифры, латинские символы и знак подчёркивания _

Синтаксис шаблона:

MsgbxBoxN=Title*<#>Info<#>PathIcon,Number,Size<#>LineButtons<#>Width<#>Height<#>TimeOut<#>ButtonWidth

где:
Title* - заголовок окна.
Info - информационная строка сообщения.
PathIcon - путь к библиотеке значков.
  Number - номер значка.
  Size - [необязательный] размер значка (по умолчанию 32).
    Если значок или библиотека находится в папке системы или в той же папке, что и TCIMG.exe , то достаточно указать имя.
    Некоторые DLL могут иметь значок извлекаемый только отрицательным числом.
    Вместо иконки может использоваться рисунок BMP или файл курсора ANI.
    Если PathIcon,Number,Size не прописаны, то диалог без значка.
LineButtons - строка-список кнопок.
  Состоит из пар: название кнопки и возвращаемого значения, передаваемого при выборе.
  Разделитель внутри и между парами <+>
  Если в возвращаемом значении прописан тег :EXIT:, то при нажатии на кнопку произойдёт завершение работы утилиты.
Width - ширина диалога (вычисляется автоматически, если ширина меньше заданного количества кнопок).
Height - высота диалога.
TimeOut - [необязательный] установка времени ожидания состоит из Button|Seconds|Exit , где:
  Button - номер кнопки, на которой будет отображаться обратный отсчёт.
    при 0 время ожидания устанавливаться не будет (по умолчанию).
  Seconds - время ожидания (в секундах), по истечении которого диалог будет автоматически закрыт.
  Exit - режим:
    0 - продолжаются выполнятся последующие команды, прописанные после диалога (по умолчанию).
    1 - происходит выход из утилиты.
ButtonWidth - [необязательный] ширина кнопки (по умолчанию 80).

Пример записи:

MsgbxBox2=Сообщение¤TCIMG.dll,26<#>Продолжить работу?<#>user32.dll,102<#>Да<+>1<+>Нет<+>:EXIT:<#>280<#>110<#>1|15|0

Имя переменной Описание

GLOBALMSGBX возвращаются заданные данные нажатой кнопки диалога:
  данные 1-го диалога записываются в 1-ю ячейку переменной GLOBALMSGBX
  данные 2-го диалога записываются в 2-ю ячейку переменной GLOBALMSGBX
  ...
  данные N-го диалога записываются в N-ю ячейку переменной GLOBALMSGBX

Может выглядеть следующим образом:

20. Диалог выбора числовой информации UpDown: Подпараметр [updwn] или <updwn>

Выбор информации в UpDown. Подпараметр [updwn] или <updwn>.
В любом месте строки параметров, где встретится [updwn=BOXN], будет вызвано диалоговое окно, в котором можно выбрать данные.

[updwn=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng в секции языка ([Russian]) в соответствующих ключах UpDown1, UpDown2 ... UpDownN и позволяет самому настроить окно вывода.
Также могут использоваться ключи с любым окончанием после основы UpDown, в котором есть цифры, латинские символы и знак подчёркивания _

Синтаксис шаблона:

UpDownN=Title*<#>Info<#>LineUpDown<#>Width<#>Height<#>TextSize<#>TextWeight

где:
Title* - заголовок окна.
Info - информация в окне.
LineUpDown - строка-список элементов UpDown
Width - ширина диалога.
Height - высота диалога.
TextSize - [необязательный] размер шрифта окна.
TextWeight - [необязательный] толщина шрифта окна.

LineUpDown - строка-список элементов UpDown
  Все параметры являются необязательными.
  Недостающие значения берутся из ключей UpDown... в секции [Box] или из установленного стиля style.
  Состоит из пар: Label<+>UpDown
    Label - параметры названия элемента: Title|Mode|Width|Height|Style|Size|Weight|Color
      Title - название (@CRLF используется для переноса строки).
      Mode - режим положения названия.
        0 - сверху элемента.
        1 - снизу элемента.
        2 - слева элемента.
        3 - справа элемента.
      Width - ширина названия.
      Height - высота названия.
      Style - стиль названия.
        0 - выравнивание названия по левому краю (по умолчанию).
        1 - выравнивание названия по центру по горизонтали.
        2 - выравнивание названия по правому краю.
        512 - выравнивание названия по центру по вертикали.
      Size - размер шрифта названия.
      Weight - толщина шрифта названия: 400 - нормальный, 700 - жирный.
      Color - RGB цвета названия.
    UpDown - параметры элемента: Width|Height|Min|Max|Begin|Style|Size|Weight|Color
      Width - ширина элемента.
      Height - высота элемента.
      Min - минимальное значение элемента.
      Max - максимальное значение элемента.
      Begin - начальное значение элемента.
      Style - стиль элемента. может быть суммой из значений:
        1 - счёт "по кругу" (из начала в конец или из конца в начало).
        4 - элемент с правого края от поля ввода.
        8 - элемент с левого края от поля ввода.
        32 - вызов элемента происходит клавишами UP (стрелка вверх) и DOWN (стрелка вниз) на клавиатуре.
        64 - элемент отображает указывающие стрелки влево/вправо, а не вверх/вниз.
        128 - предотвращает в четырёхзначных и более числах, использовать разделительный пробел после каждой тройки цифр.
      Size - размер шрифта элемента.
      Weight - толщина шрифта элемента: 400 - нормальный, 700 - жирный.
      Color - RGB цвета элемента.

  Может быть использовано несколько пар Label1<+>UpDown1<+>Label2<+>UpDown2<+>LabelN<+>UpDownN
  Может быть использован тег :BREAK:<+>Indent
    :BREAK: - тег, означающий перенос следующего элемента на новый столбец.
    Indent - число, означающее отступ от предыдущего элемента в пикселях.

Пример записи:

UpDownBox1=Выбор счётчика¤TCIMG.dll,107<#>Выберите число<#>|2|80<+>50|25|1|100|50|1<#>220<#>110

Установка значка окну *

Установка подсказки окну **

Имя переменной Описание

GLOBALUPDWN массив входных данных. Данные передаются через разделитель |
  данные 1-го диалога записываются в 1-ю ячейку
  данные 2-го диалога записываются в 2-ю ячейку
  ...
  данные N-го диалога записываются в N-ю ячейку

GLOBALUPDWN1
GLOBALUPDWN2
...
GLOBALUPDWNN
массив входных данных.
  данные 1-го диалога записываются в переменную GLOBALUPDWN1
  данные 2-го диалога записываются в переменную GLOBALUPDWN2
  ...
  данные N-го диалога записываются в переменную GLOBALUPDWNN

Может выглядеть следующим образом:

21. Диалог выбора изображения: Подпараметр [image] или <image>

Выбор изображения или нескольких изображений. Подпараметр [image] или <image>.
В любом месте строки параметров, где встретится [image=BOXN], будет вызвано диалоговое окно, в котором можно выбрать изображения.

Диалог рассчитан для отображения небольшого количества изображений:
2BP, AI, AMC, BMP, DIB, EMF, GIF, JBF, JFIF, JPE, JPEG, JPG, LPM, MPO, PDN, PLB, PNG, PXS, PXT, RLE, SSL, TIF, TIFF, WMF
Для других форматов необходимы дополнительные библиотеки (см. примечание команды imgth)

[image=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng в секции языка ([Russian]) в соответствующих ключах ImageBox1, ImageBox2 ... ImageBoxN и позволяет самому настроить окно вывода.
Также могут использоваться ключи с любым окончанием после основы ImageBox, в котором есть цифры, латинские символы и знак подчёркивания _

Синтаксис шаблона:

где:
Title* - заголовок окна.
Info - информация в окне.
List - список изображений для выбора, возможны варианты:
  - List - файл списка полных путей изображений.
  - Folder - полный путь папки с изображениями.
  - Path1/Path2/...PathN - пути изображений, прописанные через разделитель /
  - $GLOBALNAME - массив с полными путями изображений (см. Дополнение №23).
Width - ширина диалога.
Height - высота диалога.
SizeLV - размер квадрата элемента изображения, поддерживаются размеры: 32, 48, 64, 96, 128, 160, 192, 224, 256, 300, 400, 500.
HeightLV - высота ListView, в котором отображаются изображения (размер должен быть меньше Height (высоты диалога)).
BackgroundLV - фон ListView, возможны варианты:
  - RGB цвет.
  - путь к фоновому изображению.
FrameColorLV - RGB цвет рамки элементов изображения.
  - если прописан '#', то без рамки.
TextColorLV - RGB цвет текста, надписи под элементами изображения.
  - если прописан '#', то без надписи.
StyleLV [необязательный] - стиль ListView:
  0 - вертикальное расположение (по умолчанию).
  1 - горизонтальное расположение.
HintLV [необязательный] - подсказка при наведении на элемент изображения:
  0 - с подсказками (по умолчанию).
  1 - без подсказок.

Пример записи:

ImageBox1=Выбор изображений¤TCIMG.dll,55|Выберите изображения:|$GLOBALSENDS|362|215|96|127|FFFFFF|FF0000|008080

Можно настраивать размер, толщину, имя шрифта, фон, цвет в диалоге в TCIMG.ini в секции [Box]

Установка значка окну *

Установка подсказки окну **

Имя переменной Описание

GLOBALIMAGE1
...
GLOBALIMAGEN массив входных данных. Список путей выбранных изображений.
  данные 1-го диалога записываются в переменную GLOBALIMAGE1
  данные 2-го диалога записываются в переменную GLOBALIMAGE2
  ...
  данные N-го диалога записываются в переменную GLOBALIMAGEN

GLOBALIMAGE0 массив входных данных. Номера выбранных изображений передаются через разделитель |
  номера 1-го диалога записываются в 1-ю ячейку.
  номера 2-го диалога записываются в 2-ю ячейку.
  ...
  номера N-го диалога записываются в N-ю ячейку.
Отсчёт нумерации с 0

Может выглядеть следующим образом:

22. Подсказка в трее: Команда <TRAY>

Подсказка при наведении курсора на иконку в трее. Команда <TRAY>.
Если в начале строки параметров прописано <TRAY=HINTN>, будет установлен значок в трее и подсказка, отображающаяся при наведении на значок.

Команда <TRAY=String||Mode||Icon>, где:
    String - строка-подсказка при наведении курсора на иконку в трее.
      Так же подсказка может быть настроена в TCIMG.lng в секциях TrayIconHint1, TrayIconHint2, ... , TrayIconHintN,
      при этом в тег прописываются соответствующие <TRAY=HINT1>, <TRAY=HINT2>, ... , <TRAY=HINTN>
    Mode - режим отображения значка:
      1 - отображает иконку в трее
      2 - скрывает иконку в трее
      3 - мигает иконка в трее
      4 - мигание иконки остановлено
    Icon - включает в себя путь и номер значка, прописанных через запятую.
      (так же может быть использован номер ключа в TCIMG.ini из секции [ProcessIcon])

Пример записи:

TrayIconHint1=Описание подсказки:@CRLF• Первая строка@CRLF• Вторая строка@CRLF• Третья строка

@CRLF заменяется переносом строки.

При <TRAY=...> при нажатии на иконку в трее правой кнопкой мыши можно приостановить действие или завершить работу команд

23. Диалог выбора файлов и папок: Подпараметр [elect] или <elect>

Диалог выбора файлов и папок. Подпараметр [elect] или <elect>.
В любом месте строки параметров, где встретится [elect], будет вызвано диалоговое окно, в котором можно выбрать файлы и папки.

Расширенный вид: [elect=Title*|Path(|Width|Height|ViewMode|Option|Flags|Filter|Style)] позволяет самому настроить окно ввода, где:
Title* - заголовок окна.
Path - корневой каталог дерева выбора в диалоге, возможны варианты:
    • Абсолютный или относительный путь к каталогу: C:\Users\, $f
    • Сетевые пути: \\User-PC\
    • Путь каталога, передаваемый параметрами %P%N, %P, %T, %T%M
    • Путь zip архива любой вложенности: D:\Util\TCIMG.zip\Files\Scripts\ (другие типы архивов не поддерживаются)
    • Путь каталога, передаваемый параметрами <info>, [tc], и др.
    • Путь каталога, передаваемый глобальными переменными GLOBALNAME
    • Номер или идентификатор GUID папки, см. таблицу Дополнения №35
        По умолчанию идентификатор возвращает пользовательский путь, для возврата пути по умолчанию системы прописывается *
        Пример: {B4BFCC3A-DB2C-424C-B029-7FE99A87C641}* или 39*
Width - ширина диалога (размер по умолчанию 625).
Height - высота диалога (размер по умолчанию 435).
ViewMode - режим представления:
  Прописывается номер режима.

Номер	Размер	Название
1	32x32	"Содержимое"
2	48x48	"Плитка"
3	16x16	"Таблица" (по умолчанию)
4	16x16	"Список"
5	16x16	"Мелкие значки"
6	24x24
7	32x32
8	48x48	"Обычные значки"
9	64x64
10	96x96	"Крупные значки"
11	128x128
12	160x160
13	192x192
14	256x256	"Огромные значки"

Option
    0 - без отображения стандартных панелей слева и сверху
    1 - отображение стандартных панелей (по умолчанию)
Flags - может быть суммой значений:
  По умолчанию Flags=0
  Можно прописывать как сумму 0x00000040+0x00000080, так и десятичную сумму 64+128 или 192
  В таблице наиболее полезные флаги, информацию о других можно найти здесь FOLDERFLAGS

Имя Константы	Значение	Описание
FWF_SINGLESEL	0x00000040 (64)	Только один пункт может быть выделен
FWF_NOSUBFOLDERS	0x00000080 (128)	Не показывать папки
FWF_ALIGNLEFT	0x00000800 (2048)	Пункты выравниваются по левому краю
FWF_SINGLECLICKACTIVATE	0x00008000 (32768)	Элемент выделяется при наведении на него курсора
FWF_HIDEFILENAMES	0x00020000 (131072)	При ViewMode=7 и выше не отображаются имена файлов
FWF_NOFILTERS	0x00400000 (4194304)	Не отображать фильтры в заголовках таблицы
FWF_NOCOLUMNHEADER	0x01000000 (16777216)	Не показывать заголовки столбцов (кроме ViewMode=3)
FWF_EXTENDEDDILES	0x02000000 (33554432)	При ViewMode=2 элемент размещается по ширине окна

Filter - фильтр для файлов (по умолчанию отображаются все объекты).
  • Необходимые типы файлов прописываются через разделитель ;
    Пример: txt
    Пример: txt;ini;log
  • Если нужно получить кроме заданных, то перед фильтром прописывается знак ^
    Пример: ^txt;ini;log
  • Если фильтр не нужен, то прописывается "*" (отображать все объекты).
Style - стиль диалога, может быть суммой значений:
    0 - по умолчанию (диалог с изменениями размеров, диалог блокирует активное окно)
    1 - без изменения размеров диалога
    2 - диалог не блокирует активное окно
    4 - диалог не блокирует активное окно и отображается на панели задач

Также поддерживается формат [elect=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng в секции языка ([Russian]) в соответствующих ключах ElectBox1, ElectBox2 ... ElectBoxN, в том же формате.
Также могут использоваться ключи с любым окончанием после основы ElectBox, в котором есть цифры, латинские символы и знак подчёркивания _

Пример записи:

ElectBox1=Выберите объекты|%COMMANDER_PATH%|600|400|7|1|0|0|2

Установка значка окну *

Имя переменной Описание

GLOBALELECT1
GLOBALELECT2
...
GLOBALELECTN массив, в котором находятся пути выбранных каталогов.
  данные 1-го диалога записываются в переменную GLOBALELECT1
  данные 2-го диалога записываются в переменную GLOBALELECT2
  ...
  данные N-го диалога записываются в переменную GLOBALELECTN

Может выглядеть следующим образом:

24. Диалог выбора даты и времени: Подпараметр [dates] или <dates>

Диалог выбора даты и времени. Подпараметр [dates] или <dates>.
В любом месте строки параметров, где встретится [dates], будет вызвано диалоговое окно, в котором можно выбрать дату и время.

Расширенный вид: [dates=Title*|Info|DateLine|Width|Height] позволяет самому настроить окно выбора, где:
Title* - заголовок окна.
Info - информация в окне.
DateLine - состоит из Date^Format^Mode, где:
  Date - начальная дата в элементе выбора, может быть прописана в форматах:
    ⏩ 2022/04/20 17:24:47
    ⏩ 2022/04/20
    ⏩ 17:24:47
    ⏩ если прописан тег #SISDATE, то будет вставлена системная дата.
  Format - формат вывода даты, см. таблицу.
    К примеру: yyyy/MM/dd HH:mm:ss
  Mode [необязательный] - режим выбора даты:
    0 - выбор из выпадающего календаря (по умолчанию).
    1 - устанавливает элемент up-down (стрелочки вверх-вниз) справа от элемента даты для изменения значения времени.
Width - ширина диалога.
Height - высота диалога.

Также поддерживается формат [dates=BOXN], где BOX1, BOX2 ... BOXN - являются шаблонами, которые прописываются в TCIMG_.lng в секции языка ([Russian]) в соответствующих ключах DatesBox1, DatesBox2 ... DatesBoxN, в том же формате Title|Info|DateLine|Width|Height.
Также могут использоваться ключи с любым окончанием после основы DatesBox, в котором есть цифры, латинские символы и знак подчёркивания _

Пример записи:

DatesBox1=Выбор даты¤TCIMG.dll,131|Выберите дату.|#SISDATE^yyyy/MM/dd HH:mm:ss|245|110

Можно настраивать размер, толщину, имя шрифта, фон, цвет в диалоге в TCIMG.ini в секции [Box] в ключах Dates...

Установка значка окну *

Установка подсказки окну **

Имя переменной Описание

GLOBALDATES массив входных данных (в первой ячейке введённые данные)
если используются несколько диалогов [dates], то:
  данные 2-го диалога записываются во 2-ю ячейку
  данные 3-го диалога записываются в 3-ю ячейку
  ...
  данные N-го диалога записываются в N-ю ячейку

В формате вывода даты могут использоваться следующие сокращения (символы или сочетания символов):
h.hh.H.HH.m.mm.s.ss.t.tt.d.dd.ddd.dddd.M.MM.MMM.MMMM.y.yy.yyyy
Они могут располагаться в любом порядке и использоваться несколько раз.
Вместо точек могут прописываться любые другие символы.

Сокращение	Описание
Время:
h	часы, цифры без ведущего нуля; 12-часовой формат
hh	часы, цифры с ведущим нулём; 12-часовой формат
H	часы, цифры без ведущего нуля; 24-часовой формат
HH	часы, цифры с ведущим нулём; 24-часовой формат
m	минуты, цифры без ведущего нуля
mm	минуты, цифры с ведущим нулём
s	секунды, цифры без ведущего нуля
ss	секунды, цифры с ведущим нулём
t	один символ времени маркер, А или P (если установлен вывод в системе)
tt	символы времени маркеров, AM или PM (если установлен вывод в системе)
Дата:
d	день месяца, цифры без ведущего нуля
dd	день месяца, цифры с ведущим нулём
ddd	день недели, буквенное сокращение (Чт)
dddd	день недели, полное имя (четверг)
M	месяц, цифры без ведущего нуля
MM	месяц, цифры с ведущим нулём
MMM	месяц, трехбуквенное сокращение (авг)
MMMM	месяц, полное имя (Август)
y	год, две последние цифры без ведущего нуля
yy	год, две последние цифры с ведущим нулем
yyyy	год, четыре цифры

Может выглядеть следующим образом:

Примечания:

Примечание №1. Передача переменных диалогам.

Диалоги подключены в большинстве команд утилиты. Если в какой-либо команде этого нет, а очень нужно, сообщите, вставлю.
Так же это можно сделать самостоятельно без изменения кода утилиты, а именно с помощью команды exect
т.е переменной передаётся значение вызванного диалога, а далее переменная прописывается в любое необходимое место командной строки.
Пример записи:

exect=$var_i=##[input=BOX77] exicn=%P%N||"%t"||$var_i||nodelim<>

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Примечание №2. Применение тегов ширины и высоты.

В [input], [richinput], [combo], [group], [check], [edits] и других для определения размера диалогового окна (Width и Height), могут использоваться:
  • Тег @W, который будет заменён значением ширины экрана.
  • Тег @H, который будет заменён значением высоты экрана.
  • При использовании тегов @W и @H :
    - в Width и Height возможно указывать математические действия, определяющие размеры диалогового окна.
    - диалоговое окно отображается относительно центра экрана.

Пример записи в ключах TCIMG_.lng:

ComboBox_X01=Создание файла||Создать текстовый файл:||Name.txt|Name.ini|Name.vbs|Name.au3|Name.ahk|Name.js|Name.html|Name.xml|Name.bat|Name.cmd|Name.doc|Name.xls|Name.lst|Name.m3u||@W-16||117||1||1
RichInputBox_X01=Ввод пароля|Введите пароль для расшифрования.||@W-12|@H/2|10|1
EditsBox_X01=Ввод текста<#>Введите текст<#>ввод текста<+>@H/2.6<+><#>@W-12<#>@H/2<#>10<#>700<#>Arial<#>5C6FCA

Пример записи в командах:

renmm=%P%N||##<richinput=Редактировать~~имя|Изменение~~базового~~имени|"%O"|@W-12|117>||upd<1>

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Примечание №3. Установка значка окну диалога.

В версии 14.3 появилась возможность устанавливать значок диалогу:
Для установки значка в конце заголовка Title после разделителя ¤ прописывается путь к библиотеке значков и через запятую номер значка.
Если значок или библиотека находится в той же папке, что и TCIMG.exe , то достаточно указать имя.
Некоторые DLL могут иметь значок извлекаемый только отрицательным числом.
Вместо иконки может использоваться рисунок BMP или файл курсора ANI.

Примеры записи в ключах TCIMG_.lng:

InputBox1=Ввод расширения¤TCIMG.dll,33|Введите необходимое расширение для замены в выделенных файлах.|txt|270|140
InputBox1=Ввод расширения¤%WINDIR%\System32\shell32.dll,-134|Введите необходимое расширение для замены в выделенных файлах.|txt|270|140
InputBox1=Ввод расширения¤c:\testicon.ico,0|Введите необходимое расширение для замены в выделенных файлах.|txt|270|140
InputBox1=Ввод расширения¤%COMMANDER_PATH%\Wcmicons.dll,2|Введите необходимое расширение для замены в выделенных файлах.|txt|270|140
InputBox1=Ввод расширения¤%TCIMG_PATH%\Files\Img\Puzzle.bmp,0|Введите необходимое расширение для замены в выделенных файлах.|txt|270|140
InputBox1=Ввод расширения¤User.dll,58|Введите необходимое расширение для замены в выделенных файлах.|txt|270|140

ComboBox12=Выбор глубины¤TCIMG.dll,33||Введите ГЛУБИНУ создания каталогов:||1|2|3|4|5|6|7|8|9|10||343||117||1||1
ComboBox12=Выбор глубины¤%WINDIR%\System32\shell32.dll,-134||Введите ГЛУБИНУ создания каталогов:||1|2|3|4|5|6|7|8|9|10||343||117||1||1
ComboBox12=Выбор глубины¤c:\testicon.ico,0||Введите ГЛУБИНУ создания каталогов:||1|2|3|4|5|6|7|8|9|10||343||117||1||1
ComboBox12=Выбор глубины¤%COMMANDER_PATH%\Wcmicons.dll,2||Введите ГЛУБИНУ создания каталогов:||1|2|3|4|5|6|7|8|9|10||343||117||1||1
ComboBox12=Выбор глубины¤%TCIMG_PATH%\Files\Img\Puzzle.bmp,0||Введите ГЛУБИНУ создания каталогов:||1|2|3|4|5|6|7|8|9|10||343||117||1||1
ComboBox12=Выбор глубины¤User.dll,58||Введите ГЛУБИНУ создания каталогов:||1|2|3|4|5|6|7|8|9|10||343||117||1||1

GroupBox9=Выбор стиля кнопки¤TCIMG.dll,33<#>Выберите стиль кнопки.<#><#>Обычный<+>0<+>В виде меню<+>1<#>280<#>155
GroupBox9=Выбор стиля кнопки¤%WINDIR%\System32\shell32.dll,-134<#>Выберите стиль кнопки.<#><#>Обычный<+>0<+>В виде меню<+>1<#>280<#>155
GroupBox9=Выбор стиля кнопки¤c:\testicon.ico,0<#>Выберите стиль кнопки.<#><#>Обычный<+>0<+>В виде меню<+>1<#>280<#>155
GroupBox9=Выбор стиля кнопки¤%COMMANDER_PATH%\Wcmicons.dll,2<#>Выберите стиль кнопки.<#><#>Обычный<+>0<+>В виде меню<+>1<#>280<#>155
GroupBox9=Выбор стиля кнопки¤%TCIMG_PATH%\Files\Img\Puzzle.bmp,0<#>Выберите стиль кнопки.<#><#>Обычный<+>0<+>В виде меню<+>1<#>280<#>155
GroupBox9=Выбор стиля кнопки¤User.dll,58<#>Выберите стиль кнопки.<#><#>Обычный<+>0<+>В виде меню<+>1<#>280<#>155

EditsBox4=Поиск фразы¤TCIMG.dll,33<#>Введите фразу для поиска.<#>ввод строки<+>100<+><#>340<#>185
EditsBox4=Поиск фразы¤%WINDIR%\System32\shell32.dll,-134<#>Введите фразу для поиска.<#>ввод строки<+>100<+><#>340<#>185
EditsBox4=Поиск фразы¤c:\testicon.ico,0<#>Введите фразу для поиска.<#>ввод строки<+>100<+><#>340<#>185
EditsBox4=Поиск фразы¤%COMMANDER_PATH%\Wcmicons.dll,2<#>Введите фразу для поиска.<#>ввод строки<+>100<+><#>340<#>185
EditsBox4=Поиск фразы¤%TCIMG_PATH%\Files\Img\Puzzle.bmp,0<#>Введите фразу для поиска.<#>ввод строки<+>100<+><#>340<#>185
EditsBox4=Поиск фразы¤User.dll,58<#>Введите фразу для поиска.<#>ввод строки<+>100<+><#>340<#>185

Для команды shape
Для установки значка через разделитель || прописывается путь к библиотеке значков и через запятую номер значка.
Если значок или библиотека находится в той же папке, что и TCIMG.exe , то достаточно указать имя.
Некоторые DLL могут иметь значок извлекаемый только отрицательным числом.
Вместо иконки может использоваться рисунок BMP.

Примеры записи в ключах TCIMG_.lng:

Shape1=Создание файлов||TCIMG.dll,33
Shape1=Создание файлов||%WINDIR%\System32\shell32.dll,-134
Shape1=Создание файлов||c:\testicon.ico,0
Shape1=Создание файлов||%COMMANDER_PATH%\Wcmicons.dll,2
Shape1=Создание файлов||%TCIMG_PATH%\Files\Img\Puzzle.bmp,0
Shape1=Создание файлов||User.dll,58

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Примечание №4. Подсказки в диалогах GroupBox и CheckBox.

В версии 15.5 появилась возможность устанавливать и настраивать подсказки к пунктам диалогов GroupBox и CheckBox:

В конце названия пункта прописывается подсказка, несколько вариантов синтаксиса:
Знак тильды "~" означает перенос строки (для многострочных подсказок)
1.
Текст Пункта©TipText©
TipText - Текст всплывающей подсказки, который отображается при наведении мыши на элемент интерфейса.

2.
  Текст Пункта©TipText©Title©Icon©Options©
    TipText - текст всплывающей подсказки, который отображается при наведении мыши на элемент интерфейса.
    Title     - [необязательный] заголовок подсказки.
    Icon     - иконка, которая будет отображаться рядом с заголовком: Требуется заголовок.
       0 - без иконки.
       1 - информационная иконка.
       2 - иконка предупреждения.
       3 - иконка ошибки.
    Options - [необязательный] Установка различных параметров способа отображения подсказки (Может быть сложено - 1+2)
       1 - овальная подсказка.
       2 - подсказка центрированная по горизонтали вдоль элемента.

3.
  Текст Пункта©TipText©Title|Path|Icon|Size©:STYLEN:©
    TipText - текст всплывающей подсказки, который отображается при наведении мыши на элемент интерфейса.
    Title     - заголовок подсказки.
    Path     - путь к значку (если файл находится в папке с утилитой достаточно прописывать имя файла).
    Icon     - номер иконки.
    Size     - размер.
       0 - устанавливается маленькая иконка 16x16
       1 - устанавливается большая иконка 32x32
    :STYLEN: - стиль подсказки.
       Стиль для подсказки берётся из TCIMG.ini (TCIMGU.ini) из секции [Box] в ключах StyleToolTipN , где:
       N - это приставка к ключам:
       если ключ StyleToolTip_Y1=... , то прописывается :STYLE_Y1:
       если ключ StyleToolTipXXX=... , то прописывается :STYLEXXX:

  Описание настроек стиля в TCIMG.ini в секции [Box]:
    StyleToolTipN=StyleW|DelayTime|Balloon|Flags|FontName|FontSize|FontWidth|FontStyle|FontColor|BkColor|Left|Top|Right|Bottom

       (1) StyleW - стиль подсказки.
          0 - стиль системы, игнорируются параметры Font..., BkColor, Left, Top, Right, Bottom.
          1 - свой стиль.
          2 - стиль системы №2, игнорируются ряд параметров.
          3 - стиль системы №3, игнорируются ряд параметров.
       (2) DelayTime - время в миллисекундах, в течение которого отображается подсказка.
            если курсор находится в пределах прямоугольника объекта (максимальное значение 32767 - ~32 секунды).
       (3) Balloon - внешний вид.
           - для StyleW=0 (Может быть суммой флагов (3, 6, 7 ...))
              0 - прямоугольная.
              1 - с закруглёнными углами.
              2 - центрировать подсказку.
              4 - принудительно отображать подсказку полностью, независимо от указанных координат.
                (если используется несколько мониторов, подсказка будет "прилипать" к ближайшему монитору).
           - для StyleW больше нуля
              0 - прямоугольная.
              64 - с закруглёнными углами.
       (4) Flags - отображение подсказки.
            0 - обычное.
            2 - центрирует окно подсказки.
            4 - сдвигает подсказку влево.
       (5) FontName - имя шрифта.
       (6) FontSize - размер шрифта.
       (7) FontWidth - толщина шрифта: 400 - нормальный, 700 - жирный.
       (8) FontStyle - стиль шрифта.
            0 - обычный.
            1 - курсив.
       (9) FontColor - RGB цвет шрифта.
      (10) BkColor - RGB цвет фона подсказки.
      (11) Left - интервал между левой границей и левой части текста, в пикселях.
      (12) Top - интервал между верхней границей и верхней части текста, в пикселях.
      (13) Right - интервал между правой границей и правой части текста, в пикселях.
      (14) Bottom - интервал между нижней границей и нижней части текста, в пикселях.

Пример записи:

StyleToolTip1=1|32767|64|0|Tahoma|14|400|1|00008B|DCF8F8|0|0|0|0
StyleToolTip2=1|5000|0|2|Segoe UI|14|400|1|FFFFFF|395A00|0|0|0|0
StyleToolTip3=0|5000|0|4|Segoe UI|15|400|2|---|---|-|-|-|-
StyleToolTip4=1|5000|64|2|Segoe Script|24|900|0|FF0000|FFFF00|30|20|10|15
StyleToolTip5=0|5000|64|0|Segoe UI|15|700|0|---|---|-|-|-|-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Примечание №5. Сохранение позиций диалогов.

В версии 16.1 появилась возможность сохранять позиции диалогов:

В TCIMG.ini в секции [Setting] ключ PositionDialogs позволяет:
0 - не сохранять позиции диалогов.
1 - сохранять позиции диалогов.
При PositionDialogs=1 создаётся файл Dialog.ini в папке TCIMG, в который записываются позиции окон.
При PositionDialogs=1 все диалоги имеют атрибут "Поверх всех окон".

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Примечание №6. Установка фона диалогов.

Возможны варианты:
1. (возможность появилась в версии 15.3)
RGB цвет фона диалога (0000FF).

2. (возможность появилась в версии 22.6)
  Фоновое изображение. PathImage*Flag*Brightness, где:
    PathImage - путь к изображению JPG, GIF, PNG, BMP, ICO
    Flag - [необязательный] стиль установки изображения:
      0 - обычный (как есть по умолчанию).
      1 - замостить плиткой (небольшое изображение размножается по всей области окна).
    Brightness - [необязательный] яркость:
      Целое число в диапазоне от -255 до 255, которое определяет уровень яркости.
      (0 - по умолчанию)

3. (возможность появилась в версии 22.7)
  Градиентный фон. Gradient*Offset*Mixing*Frame, где:
    Gradient - градиент, состоит из: Color1,Color2,Flag,Correction :
      Color1 - RGB цвет №1 (0000FF), # - случайный цвет, @ - прозрачный цвет.
      Color2 - RGB цвет №2 (FF0000), # - случайный цвет, @ - прозрачный цвет.
      Flag - [необязательный] режим градиента:
        0 - горизонтальный градиент (по умолчанию).
        1 - вертикальный градиент.
        2 - диагональный прямой градиент.
        3 - диагональный обратный градиент.
      Correction - [необязательный] гамма коррекция:
        0 - отключена (по умолчанию).
        1 - включена.
    Offset - [необязательный] смещение градиента, состоит из: Factor1,Factor2,Factor3,Factor4
      FactorN - числа, указывающие процент от конечного цвета и должны быть в диапазоне от 0.0 до 1.0
      -1 - по умолчанию параметры: 0.0,0.4,0.6,1.0
    Mixing - [необязательный] смешивание цветов градиента, состоит из: Pos1,Pos2,Pos3,Pos4
      PosN - числа, указывающие процент смешивания и должны быть в диапазоне от 0.0 до 1.0
      -1 - по умолчанию параметры: 0.0,0.3,0.7,1.0
    Frame - [необязательный] рамка вокруг градиента, состоит из: Color,Frame
       Color - RGB цвет (0000FF), # - случайный цвет, @ - прозрачный цвет
       Frame - ширина рамки в пикселях.

4. (возможность появилась в версии 25.4)
  После параметров фона диалога может быть прописано число через разделитель ?Number, позволяющее установить прозрачность диалога.
    Number - число в диапазоне 0 - 255. Чем меньше число, тем более прозрачность окна.
    255 - непрозрачно
    0 - невидимое

Пример записи:

; Примеры вариантов для ключей секции [Box] файла TCIMG.ini
; InputBkColor, RichInputBkColor, ComboBkColor, GroupBkColor, CheckBkColor, EditsBkColor, IconzBkColor, ListaBkColor, MsgbxBkColor
[Box]
InputBkColor=0000FF
InputBkColor=0000FF?200
InputBkColor=%TCIMG_PATH%\Files\Img\Puzzle.bmp*1
InputBkColor=%TCIMG_PATH%\Files\Img\Puzzle.bmp*1?200
InputBkColor=$f202\Puzzle.bmp*1*-150
InputBkColor=FF033E,0000FF
InputBkColor=FF033E,0000FF?200
InputBkColor=FF033E,0000FF*0.5,0.2,0.0,0.0*0.0,1.0,0.7,1.0*#,1
-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-
; Примеры вариантов для ключей ShapeXXX файла TCIMG_.lng

; Пример установки цвета фона для диалогов
ShapeXX=Сообщение:NOEXIT:||TCIMG.dll,55||CF1534||FFF8DC|Comic Sans MS|12|400
ShapeYY=Сообщение||TCIMG.dll,55||707070||@T1||@D1||@P1||@G1
ShapeZZ=Сообщение||TCIMG.dll,55||707070?200||@T1||@D1||@P1||@G1

; Пример установки фонового изображения для диалогов
ShapeIMG1=Сообщение||TCIMG.dll,55||%TCIMG_PATH%\Files\Img\Puzzle.bmp*1
ShapeIMG2=Сообщение||TCIMG.dll,55||$f202\DarkBlue.gif*1||@T3||@G3||@P3||@D3

; Пример установки фонового изображения для диалогов с заданной яркостью
ShapeIMG1_1=Сообщение||TCIMG.dll,55||$f202\DarkBlue.gif*1*180
ShapeIMG2_1=Сообщение||TCIMG.dll,55||$f202\Puzzle.bmp*1*-150||@D3||@T3||@P3||@G7

; Пример установки градиентного изображения
ShapeGRAD1=Сообщение||TCIMG.dll,55||FF033E,FDEE00,0||@D3||@T4||@P4||@G4
ShapeGRAD2=Сообщение||TCIMG.dll,55||FF033E,FDEE00*0.5,0.0,0.0,1.0*0.0,1.0,0.7,1.0*#,3||@D3||@T4||@P4||@G6
ShapeGRAD3=Сообщение||TCIMG.dll,55||FF0000,0000DF*0.5,0.2,0.0,0.0*0.0,1.0,0.7,1.0*#,1||@D3||@T4||@P4||@G5

Может выглядеть следующим образом:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Примечание №7. Установка значения по умолчанию.

В версии 24.1 появилась возможность устанавливать значение по умолчанию для диалогов [combo], [group], [input], [richinput] при использовании таймера [timen].

В любом месте шаблона строка между символами ¶ (символ параграфа) будет являться значением по умолчанию, если во время ожидания не нажата ни одна кнопка диалога.

Пример записи:

ComboBox_DEF1=Выбор режима¤TCIMG.dll,85¶100¶||Выберите||1|2|3|4||241||134||1||2
ComboBox_DEF2=Выбор режима2¤TCIMG.dll,85¶$var_s¶||Выберите||111|222|333|444||241||134||1||2

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Примечание №8. Маска шаблонов. Параметр [extnd=Name].

В версии 27.7 параметр обрабатывается совместно с обработкой диалогов.

Параметр [extnd=Name]
В любом месте строки параметров, где встретится [extnd=Name], будет вставлена строка-шаблон значений, прописанных TCIMG.ini, в секции [Extensions], где Name - имя ключа.

Пример записи:

[Extensions]
Arhives=*.7z|*.7zip|*.rar
Musics=*.mp3|*.wav|*.wma
Scripts=*.bat|*.cmd|*.vbs|*.js

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Примечание №9. Окно подсказки в диалогах.

В версии 28.2 появилась возможность устанавливать подсказку для диалогов [input], [richinput], [combo], [group], [edits], [check], [iconz], [lista], [updwn], [image], а так же для команды shape.

После имени шаблона через разделитель ?? прописывается имя шаблона подсказки.

Пример записи команд:

;; пример вывода окна подсказки в диалоге по нажатию кнопки [i]

dilog=[check=BOX_BR1??BOX_Ex1] ;; шаблон подсказки настраивается в TCIMG_...lng в ключе HelpBox_Ex1

dilog=[combo=BOX1??BOX_Ex3] ;; шаблон подсказки настраивается в TCIMG_...lng в ключе HelpBox_Ex3

dilog=[edits=BOX2??BOX_Ex5] ;; шаблон подсказки настраивается в TCIMG_...lng в ключе HelpBox_Ex5

dilog=[group=BOX1??BOX_Ex4] ;; шаблон подсказки настраивается в TCIMG_...lng в ключе HelpBox_Ex4

dilog=[iconz=BOX1??BOX_Ex2] ;; шаблон подсказки настраивается в TCIMG_...lng в ключе HelpBox_Ex2

dilog=[input=BOX9??BOX_Ex1] ;; шаблон подсказки настраивается в TCIMG_...lng в ключе HelpBox_Ex1

dilog=[richinput=BOX1??BOX_Ex2] ;; шаблон подсказки настраивается в TCIMG_...lng в ключе HelpBox_Ex2

dilog=[updwn=BOX_EX1??BOX_Ex4] ;; шаблон подсказки настраивается в TCIMG_...lng в ключе HelpBox_Ex4

sends=%WL dilog=[image=BOX1??BOX_Ex5] ;; шаблон подсказки настраивается в TCIMG_...lng в ключе HelpBox_Ex5

slist=%WL dilog=[lista=BOX1??BOX_Ex3] ;; шаблон подсказки настраивается в TCIMG_...lng в ключе HelpBox_Ex3

shape=GRAD3??BOX_Ex1 dilog=[timen=15][group=BOX1][combo=BOX_U3][iconz=BOX1][input=BOX6] ;; шаблон подсказки настраивается в TCIMG_...lng в ключе HelpBox_Ex1

Шаблоны подсказки настраиваются в ключах HelpBox1, HelpBox2, ... HelpBox_Ex1 в языковом файле TCIMG_.lng
Также могут использоваться ключи с любым окончанием после основы ImageBox, в котором есть цифры, латинские символы и знак подчёркивания _

Синтаксис шаблона:

HelpBoxN=Title||Content||Width||Height||X||Y||OnTop||Transparency||Icon||style<Number|Flag>||set<,,,,,,,>

где:
  Title - Заголовок всплывающего окна.
  Content - содержимое окна, варианты:
    • Текст
    • Код html
    • @PathFile.html - путь к файлу с кодом html
  Width - ширина окна в пикселях.
    при -1 ширина окна равна ширине диалога.
  Height - высота окна в пикселях.
    при -1 высота окна равна высота диалога.
  X - отступ слева в пикселях.
    при -1 окно располагается относительно окна диалога (справа или слева, в зависимости от расстояния ширины экрана).
  Y - отступ сверху в пикселях.
    при -1 окно располагается относительно окна диалога.
  OnTop - [необязательный]
    0 - отключить "Поверх всех окон".
    1 - включить "Поверх всех окон" (по умолчанию).
  Transparency - [необязательный] прозрачность окна .
    Число в диапазоне 0-255. Чем меньше число, тем более прозрачность окна.
    255 - непрозрачно (по умолчанию).
    0 - невидимое.
  Icon - значок диалога, возможны варианты:
    PathIcon,Number - прописывается путь к библиотеке значка и через запятую номер значка.
    Number - номер ключа в TCIMG.ini в секции [ProcessIcon] в котором прописан путь и номер значка.

Дополнительные параметры:

  Стиль окна. Параметр style<Number|Flag> , где:
  Number:
    0 - окно не меняет размеры (по умолчанию).
    1 - окно меняет размеры и имеет горизонтальную и вертикальную прокрутку.
    2 - окно без заголовка и границ.
  Flag [необязательный]
    0 - окно с границами и заголовком (по умолчанию).
    1 - окно без границ и заголовка.

  Установка внешнего вида сообщения. Параметр set<BgColor,FontColor,FontName,FontSize,FontStyle,FontWidth,Center>, где:   BgColor - RGB цвет фона окна.
    можно установить градиент Color1|Color2|Type (работает не на всех системах и версиях IE)
        Color1 - начальный RGB цвет градиента.
        Color2 - конечный RGB цвет градиента.
        Type - тип градиента: 1 - горизонтальный градиент, 0 - вертикальный.
  FontColor - RGB цвет шрифта.
  FontName - имя шрифта.
  FontSize - размер шрифта.
  FontStyle - стиль шрифта, 0 - нормальный (по умолчанию), 1 - курсивный, 2 - наклонный.
  FontWidth - толщина шрифта: 400 - нормальный (по умолчанию), 700 - жирный.
  Center - 0 - не по центру (по умолчанию), 1 - текст по центру.
--------------------------------------------------------------------------------
Ни один из параметров не является обязательным, если какой либо из параметров не прописан, он не будет установлен.
Пример: set<,,,30,,,1>
--------------------------------------------------------------------------------
Параметр рассчитан для обычного текста, если в команде прописан шаблон html, в котором уже указаны цвет фона, текста, и другие теги, то параметр set<> использовать не имеет смысла - все стили будут взяты из шаблона...

Может выглядеть следующим образом:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -