Описание команды

comns

Добавление/удаление/замена комментария файлов и каталогов.

comns=%L,%WL||LISTF<>||PS<>||FOLDC<>||FOLDM<>||LISTC<>||FLST<>||cliplist||$var_aa||$GLOBALNAME||Number||String, ||SeriesParam, ||Dialogs, ||<info>, ||<ifile>, ||upd<>, ||[tc], ||listcms<>, ||clip

Параметры:

1-й обязательный параметр. Может иметь несколько вариантов:
%L,
%WL		Список выделенных объектов.
Также может использоваться путь к файлу списка полных путей объектов %P%N. см. Дополнение №7 или с:\List.txt
LISTF<>Список заданных объектов. см. Дополнение №22.
PS<>Список объектов каталога. см. Дополнение №22.
FOLDC<>Список объектов содержимого каталогов. см. Дополнение №22.
FOLDM<>Список выделенных объектов и всех объектов в подпапках. см. Дополнение №22.
LISTC<>Список объектов из выделенных без дубликатов. см. Дополнение №22.
FLST<>Смешанные списки объектов по заданному списку. см. Дополнение №22.
cliplistСписок полных путей объектов из буфера обмена.
$var_aaМассив. Переменная $var_a... - массив путей, созданный в команде exect.
$GLOBALNAMEМассив. Список путей глобальной переменной см. Дополнение №23.
2-й обязательный параметр.
NumberУсловие. Где Number:
  0 - добавление строки (замена комментария, если существует).
  1 - добавление в начало комментария.
  2 - добавление в конец комментария.
  3 - удаление комментария.
  4 - удаление строки с начала комментария (если таковая существует).
  5 - удаление строки с конца комментария (если таковая существует).
  6 - удаление строки во всём комментарии.
  7 - замена строки на строку в комментарии.
  8 - добавление в начало комментария, если в начале его нет.
  9 - добавление в конец комментария, если в конце его нет.
  10 - добавление в начало комментария, если в начале его нет; удаление, если он есть.
  11 - добавление в конец комментария, если в конце его нет; удаление, если он есть.
3-й обязательный параметр.
StringСтрока комментария.
При Number=7 строки "что искать" и "чем заменять", разделяются !!
При Number=3 параметр не используется.
Дополнительные параметры:
SeriesParamПреобразование комментария. Серия параметров, изменяющих комментарий см. Дополнение №24.
DialogsДиалоги. см. Дополнение №18
  Описание
Различные параметры диалогов.
  [input] - диалог ввода информации в InputBox.
  [richinput] - диалог ввода информации в RichInputBox.
  [combo] - диалог выбора информации в ComboBox.
  [group] - диалог выбора информации в GroupBox.
  [check] - диалог выбора информации в CheckBox.
  [edits] - диалог выбора информации в EditBox.
  [sfold] - выбор каталога.
  [zfold] - выбор каталогов.
  [sopen] - выбор файла для открытия.
  [ssave] - выбор файла для сохранения.
  [sicon] - диалог просмотра и выбора значка.
  [msgbx] - окно сообщения MsgBox.
  [updwn] - диалог выбора числовой информации UpDown.
  [image] - диалог выбора изображения.
  [elect] - диалог выбора файлов и папок.
...и другие диалоги.
<info>Получение различной информации. см. Дополнение №10.
<ifile>Вставка из файла. Параметр <ifile=PathFile(|1)>, где PathFile - путь к файлу, содержимое которого будет добавлено в команду. (если в параметрах необходимо использовать путь соответствующего файла, то используйте два двоеточия ::). При 2-м параметре содержимое будет прочитано в виде бинарных данных.
upd<>Обновление панели.
  Описание
Параметр upd<Number>, где Number - значение обновления панели(ей) Total Commander:
  1 - обновить активную панель.
  2 - обновить обе панели, вернуться в активную.
  3 - обновить другую панель, вернуться в активную.
  4 - обновить активную панель, перейти в другую.
  5 - обновить другую панель, остаться в другой.
  6 - обновить обе панели, остаться в другой.
  7 - не обновлять (по умолчанию, т.е. если параметр не прописан, то панели не обновляются).
[tc]Расширенный аналог параметров Total Commander. см. Дополнение №12.
listcms<>Список комментариев. Параметр listcms<String>, где String может иметь несколько вариантов:
  • cliplist - строки-комментарии берутся из буфера обмена.
  • ListFile - путь к файлу со списком комментариев.
Если необходимо вставить информацию с переносами строк, то в вместо них прописывается \n или @CRLF.
clipБуфер.
  clpget - будет заменён содержимым буфера обмена (до обработки командной строки).
  cliptext - будет заменён содержимым буфера обмена (после обработки командной строки).

Примечания:

Дополнительные символы, которые можно использовать в строке: "@CR" - Символ возврата каретки, Chr(13), "@LF" - Символ перевода строки, Chr(10), "@CRLF" = @CR & @LF, "@TAB" - Символ Tab, Chr(9).

Если в команде(ах) необходимы кавычки, то используются две одинарных кавычки (апострофа) '' , если в команде необходим пробел - используются два символа тильды ~~.Аналог команды для одного объекта comnt

См. также:

comnt, descl, descf

Примеры:
 Как создать кнопку?

comns=%WL||[input=BOX50]||[input=BOX51] ;; групповая обработка комментариев выделенных объектов

comns=%WL||0||[<info=f13:://>] ;; выделенных файлов добавить в комментарий соответствующее имя с расширением, заключенные в квадратные скобки

comns=%WL||0||<ifile=::#Info.txt> ;; для выделенных папок создать комментарий из соответствующих файлов #Info.txt находящихся в каждой папке

comns=%WL||0||<info=f13:://> ;; для выделенных файлов добавить в комментарий соответствующее имя с расширением

comns=%WL||0||<info=o72:://>||&&^.*(\(.+\))$!!$1 renms=%WL||&&^(.*)~~?\(.+\)$!!$1 ;; для выделенных объектов добавить в комментарий соответствующую фразу в скобках, находящуюся в конце имени объектов + переименовать, удалив соответствующие фразы в скобках, находящиеся в конце имени объектов

comns=%WL||0||<info=o72:://>||&&^.*(\(.+\))$!!$1 ;; для выделенных объектов добавить в комментарий соответствующую фразу в скобках, находящуюся в конце имени объектов

comns=%WL||0||clpget||upd<1> ;; добавить комментарий из буфера обмена выделенным объектам и обновить панель (если комментарий уже был, то он будет заменён)

comns=%WL||0||listcms<cliplist> ;; добавить комментарии выделенным объектам по списку из буфера обмена

comns=%WL||1||★☆ ;; добавить в начало комментария выделенных объектов заданную фразу (значение CommentPreferredFormat от 1 и выше в Wincmd.ini)

comns=%WL||1||<info=i3:://> ;; добавить в начало комментария выделенных изображений ширину и высоту

comns=%WL||1||<info=o72:://>||&&^.*(\(.+\))$!!$1~~ renms=%WL||&&^(.*)~~?\(.+\)$!!$1||#G3 ;; для выделенных объектов добавить в комментарий соответствующую фразу в скобках, находящуюся в конце имени объектов с последующим удалением из имени

comns=%WL||1||<info=t52::|?Frgx_link0//>@CRLF ;; выделенным файлам добавить в комментарий первый URL адрес встретившейся в содержимом выделенных файлов

comns=%WL||1||123@CRLF456@CRLF789 ;; добавить в начало комментария выделенных объектов слово "привет"

comns=%WL||1||clpget ;; добавить в начало комментария выделенных объектов содержимое буфера обмена

comns=%WL||1||привет ;; добавить в начало комментария выделенных объектов слово "привет"

comns=%WL||10||#### ;; добавить в начало комментария выделенных объектов "####", если его нет, и удалить если он есть в начале

comns=%WL||10||####@CRLF ;; добавить в начало комментария выделенных объектов "####" + перенос строки, если его нет, и удалить если он есть в начале

comns=%WL||11||#### ;; добавить в конец комментария выделенных объектов "####", если его нет, и удалить если он есть в конце

comns=%WL||11||@CRLF#### ;; добавить в конец комментария выделенных объектов перенос строки + "####", если его нет, и удалить если он есть в конце

comns=%WL||2||[<info=f13:://>] ;; для выделенных файлов добавить в конец комментария соответствующее имя с расширением, заключенные в квадратные скобки

comns=%WL||2||clpget ;; добавить в конец комментария выделенных объектов содержимое буфера обмена

comns=%WL||2||пока ;; добавить в конец комментария выделенных объектов слово "пока"

comns=%WL||3 ;; удалить комментарии выделенных объектов

comns=%WL||4||clpget ;; удалить с начала комментария выделенных объектов слово из буфера обмена, если таковое есть в начале

comns=%WL||4||пока ;; удалить с начала комментария выделенных объектов слово "пока", если таковое есть в начале

comns=%WL||5||clpget ;; удалить с конца комментария выделенных объектов слово из буфера обмена, если таковое есть в конце

comns=%WL||5||привет ;; удалить с конца комментария выделенных объектов слово "привет", если таковое есть в конце

comns=%WL||6||ноль ;; удалить из комментария выделенных объектов "ноль"

comns=%WL||7||е!!ё ;; заменить в комментариях выделенных объектов "е" на "ё"

comns=%WL||8||cliptext ;; добавить комментарий из буфера обмена

comns=%WL||8||привет ;; добавить в начало комментариев выделенных объектов слово "привет", если такового нет в начале комментария

comns=%WL||9||привет ;; добавить в конец комментариев выделенных объектов слово "привет", если такового нет в конце комментария

comns=PS<%P%N//2>||0||<ifile=::#Info.txt> ;; в папке под курсором создать комментарий для корневых подпапок из соответствующих файлов #Info.txt находящихся в каждой корневой подпапке

comns=PS<%P%N//-2>||0||<ifile=::#Info.txt> ;; в папке под курсором создать комментарий для корневых подпапок, включая папку под курсором из соответствующих файлов #Info.txt находящихся в каждой корневой подпапке

global copys=cliplist||"%p"//0 comns=$GLOBALCOPYS||0||listcms<cliplist>||upd<1> ;; копировать в активную панель файлы по списку путей из буфера обмена и каждому файлу в комментарии прописать путь откуда он копировался

imgpr=1 slist=%WL||##path<0> copys=$GLOBALSLIST||"%t"//0 comns=$GLOBALCOPYS||0||listcms<$GLOBALSLIST>||upd<1> ;; копировать выделенные объекты в другую панель с добавлением в комментарий путь откуда был скопирован тот или иной файл

sends=-1??-1 copys=$GLOBALSENDS||"%p"//0 comns=$GLOBALCOPYS||0||listcms<$GLOBALSENDS>||upd<1> ;; копировать в активную панель файлы по списку путей из буфера обмена и каждому файлу в комментарии прописать путь откуда он копировался

shape=5 comns=%WL||[group=BOX4]||[edits=BOX1] ;; групповая обработка комментариев выделенных объектов (выбор режима в общем диалоге)

slist=%WL copys=$GLOBALSLIST||"%t"//0 comns=$GLOBALCOPYS||0||listcms<$GLOBALSLIST>||upd<1> ;; копировать в другую панель выделенные объекты и каждому объекту в комментарии прописать путь откуда он копировался

swcmd=comns=%WL||2||@CRLF#metka#¦¦comns=%WL||6||@CRLF#metka#??tcimg=$cm524¦¦CMarks ;; добавить в конец комментариев выделенных объектов слово #metka# (с новой строки), второе нажатие удалит строку со словом #metka# и снимет выделение

© Аверин Андрей для Total Commander Image  Averin-And@yandex.ru