{"draftJsState":{"blocks":[{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Разработчики программных решений для nanoCAD, имея потребность создать для своего плагина меню (здесь и далее под словом «меню» будем понимать вкладки и кнопки в ленточном и/или классическом интерфейсе программы), сталкиваются со следующими проблемами:","type":"unstyled","key":"ba7ov"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Не понятно, какие файлы создавать и что в них прописывать. Существующие примеры .cfg/.cuix файлов (которые можно найти в папках nanoCAD или попробовать сделать вручную через создание «кнопок» в настройках nanoCAD) содержат в себе очень много не очень понятного текста. Консолидированной информации по этому поводу ни для nanoCAD, ни для других CAD-платформ нами найдено не было.","type":"ordered-list-item","key":"ce3b8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для создания каждой отдельной «кнопки» в меню необходимо прописать достаточно большое количество текста. Хочется иметь какое-то средство автоматизированной генерации обозначенных файлов.","type":"ordered-list-item","key":"2ckq7"},{"data":{},"depth":0,"entityRanges":[{"key":0,"length":11,"offset":58}],"inlineStyleRanges":[],"text":"Актуальность этих проблем поднялась в нашем Telegram-чате nanoCAD API.","type":"unstyled","key":"b7p9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Обе проблемы постараемся решить в этой статье.","type":"unstyled","key":"aobjf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Важно отметить, что в статье будет рассмотрен минимальный рабочий вариант разработки меню с нашей точки зрения. Представленное решение не позиционируется, как идеальное, и мы готовы выслушать комментарии с дополнением. Также обратим внимание, что описываемый подход используется во всех плагинах для nanoCAD, разрабатываемых командой TBS. В качестве «боевого» примера будет использоваться плагин TBS Plus, функционал которого на момент написания статьи содержит больше 70 команд (и соответствующее количество «кнопок» в меню).","type":"unstyled","key":"1pi99"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В первой части статьи рассмотрим, какие файлы отвечают за формирования меню надстройки, а также принципиальное содержание этих файлов. Во второй части мы расскажем о решении по автоматизации сборки файлов меню, которое применяется в нашей команде, а также поделимся ссылкой на репозиторий с этим решением.","type":"unstyled","key":"eda0d"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":64,"offset":0,"style":"BOLD"}],"text":"Часть 1. Ручное формирование файлов меню надстройки для nanoCAD\n","type":"header-two","key":"5r3d1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Итак, первое, с чего мы должны начать – создание конфиг файла: создаём обычный текстовый файл с любым именем и расширением “.cfg”. У нас это будет “Test.cfg”.","type":"unstyled","key":"1bima"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":94,"offset":0,"style":"ITALIC"}],"text":"ВАЖНО – кодировка файла – «UTF-8 with BOM». Замечено, что «UTF-8» в данном случае не подходит.","type":"unstyled","key":"38vsn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В этом файле мы пропишем все команды нашего плагина, создадим меню и панель инструментов (toolbar) для классического интерфейса.","type":"unstyled","key":"59ie2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для того, чтобы отслеживать каждый шаг, сразу «подключим» наш файл к программе nanoCAD. Для этого открываем файл «%AppData%\\Nanosoft\\nanoCAD x64 23.0\\Config\\nanoCAD.cfg» (с поправкой на версию nanoCAD) и в самый конец добавляем строку, содержащую путь к нашему .cfg файлу, в нашем случай: \n#include \"C:\\Test\\Test.cfg\"","type":"unstyled","key":"a77oi"},{"data":{"image":{"id":"656039278bd00b589b962f41"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"being"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":111,"offset":0,"style":"ITALIC"}],"text":"ВАЖНО – созданный нами .cfg файл должен «лежать» на диске C. Иначе есть шанс, что он не загрузится в программу.","type":"unstyled","key":"cqrg1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Далее сохраняем файл «nanoCAD.cfg» без изменения кодировки и закрываем его, он нам больше не понадобится.","type":"unstyled","key":"468fs"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Открываем созданный ранее файл («Test.cfg») с помощью любого текстового редактора.","type":"unstyled","key":"asl65"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":18,"offset":21,"style":"BOLD"}],"text":"Для начала нам нужно «зарегистрировать» все нужные нам команды. Для этого пишем следующее (переносы строк добавлены исключительно для удобства восприятия):","type":"unstyled","key":"5a2os"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":0,"style":"ITALIC"}],"text":"[\\configman]","type":"unstyled","key":"8alo7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":21,"offset":0,"style":"ITALIC"}],"text":"[\\configman\\commands]","type":"unstyled","key":"cfutl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":44,"offset":0,"style":"ITALIC"}],"text":"[\\configman\\commands\\TBSPlus_TextCalculator]","type":"unstyled","key":"4gch2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":0,"style":"ITALIC"}],"text":"weight=i10","type":"unstyled","key":"c02ka"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":0,"style":"ITALIC"}],"text":"cmdtype=i1","type":"unstyled","key":"6afi4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":33,"offset":0,"style":"ITALIC"}],"text":"intername=sTBSPlus_TextCalculator","type":"unstyled","key":"kej6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":28,"offset":0,"style":"ITALIC"}],"text":"DispName=sКалькулятор текста","type":"unstyled","key":"cp341"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":102,"offset":0,"style":"ITALIC"}],"text":"StatusText=sПалитра, содержащая инструменты для арифметических операций с числами в текстовых объектах","type":"unstyled","key":"bvbu2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":43,"offset":0,"style":"ITALIC"}],"text":"BitmapDll=sicons\\TBSPlus_TextCalculator.ico","type":"unstyled","key":"29h4c"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":48,"offset":0,"style":"ITALIC"}],"text":"[\\configman\\commands\\TBSPlus_LevelingInstrument]","type":"unstyled","key":"dv0c0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":0,"style":"ITALIC"}],"text":"weight=i10","type":"unstyled","key":"7el37"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":10,"offset":0,"style":"ITALIC"}],"text":"cmdtype=i1","type":"unstyled","key":"amee8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":37,"offset":0,"style":"ITALIC"}],"text":"intername=sTBSPlus_LevelingInstrument","type":"unstyled","key":"edu5d"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":0,"style":"ITALIC"}],"text":"DispName=sНивелир","type":"unstyled","key":"fkmc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":71,"offset":0,"style":"ITALIC"}],"text":"StatusText=sПалитра для измерения превышения и проложения между точками","type":"unstyled","key":"461nn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":47,"offset":0,"style":"ITALIC"}],"text":"BitmapDll=sicons\\TBSPlus_LevelingInstrument.ico","type":"unstyled","key":"8p6th"},{"data":{"image":{"id":"65603ab8153f1d1e81c81970"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"lqun"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"На скрине даны пояснения за что отвечает каждая строка, более подробно о каждом из параметров можно изучить в настройках nanoCAD на примере любой (в том числе базовой) команды:","type":"unstyled","key":"a4ipg"},{"data":{"image":{"id":"65603acbbcb92670e328c8ef"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"c80jk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Отметим лишь несколько моментов.","type":"unstyled","key":"3qm3g"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Перед значением параметров указывается префикс, соответствующий типу данных: \n“s” для всех строковых значений (имен, описаний, путей и т.д.);\n“i” для целочисленных значений;\n“f” для булевых значений (“f0” – false, “f1” - true);","type":"ordered-list-item","key":"2e7ia"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Внутреннее имя – то имя, которое объявлено в нашем приложении (в случае .NET это значение атрибута «CommandMethod») и используется при вызове команды с командной строки. Это же имя будем использовать в нашем файле в дальнейшем, для создания «кнопки» для нашей команды.","type":"ordered-list-item","key":"857l3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В более сложных случаях для команды можно добавить ключевое слово: Keyword=s^C^C(setq a 1)(load\"arh_atr\")(arh_atr)\nЭто значение будет «отправлено на консоль» в момент обращения к команде.","type":"ordered-list-item","key":"8oco2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":63,"offset":416,"style":"ITALIC"}],"text":"Путь к иконке. Здесь задан относительный путь (помним про указанный префикс). В папку icons, «лежащую» рядом с нашим «Test.cfg» файлом, сохраним две иконки с соответствующими именами. Естественно, имя иконки может отличаться от внутреннего имени команды, оно должно лишь совпадать с именем, указанным в «Test.cfg» файле. Из нашего опыта разрешение 32х32 хорошо подходит, как для больших, так и для маленьких кнопок. Используемые иконки расположены в архиве, приложенном к статье.","type":"ordered-list-item","key":"102kh"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Сохраняем файл (всегда помня о кодировке) и открываем nanoCAD (необязательный шаг). Здесь и далее важно понимать, что наш файл «считывается» программой во время загрузки, поэтому после внесения любого изменения в .cfg файл для того, чтобы увидеть эти изменения в nanoCAD, мы должны перезагрузить программу.","type":"unstyled","key":"e69g9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"На текущем этапе наши команды были зарегистрированы (можно увидеть в настройках nanoCAD, скрин выше). Теперь при консольном обращении в списке команд мы видим наши команды, во-первых, с иконками, а во-вторых, с полным (в нашем случае - русскоязычным) названием.","type":"unstyled","key":"m71c"},{"data":{"image":{"id":"65603b0bf2e0f641cb180ae9"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"dhu30"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":19,"offset":44,"style":"BOLD"}],"text":"Теперь, добавим вкладку с нашими кнопками в классическое меню. Для этого в конец нашего «Test.cfg» добавляем следующее:","type":"unstyled","key":"99v1n"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":7,"offset":0,"style":"ITALIC"}],"text":"[\\menu]","type":"unstyled","key":"7n4iq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":0,"style":"ITALIC"}],"text":"[\\menu\\Test_Menu]","type":"unstyled","key":"250ic"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":14,"offset":0,"style":"ITALIC"}],"text":"Name=sTBS Plus","type":"unstyled","key":"btj6n"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":29,"offset":0,"style":"ITALIC"}],"text":"[\\menu\\Test_Menu\\Инструменты]","type":"unstyled","key":"djp5m"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":0,"style":"ITALIC"}],"text":"name=sИнструменты","type":"unstyled","key":"9b3cg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":53,"offset":0,"style":"ITALIC"}],"text":"[\\menu\\Test_Menu\\Инструменты\\sTBSPlus_TextCalculator]","type":"unstyled","key":"5bbce"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":24,"offset":0,"style":"ITALIC"}],"text":"name=sКалькулятор текста","type":"unstyled","key":"20vot"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":33,"offset":0,"style":"ITALIC"}],"text":"Intername=sTBSPlus_TextCalculator","type":"unstyled","key":"beqct"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":57,"offset":0,"style":"ITALIC"}],"text":"[\\menu\\Test_Menu\\Инструменты\\sTBSPlus_LevelingInstrument]","type":"unstyled","key":"23nrl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":0,"style":"ITALIC"}],"text":"name=sНивелир","type":"unstyled","key":"e7g6g"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":37,"offset":0,"style":"ITALIC"}],"text":"Intername=sTBSPlus_LevelingInstrument","type":"unstyled","key":"54a00"},{"data":{"image":{"id":"65603b4f368ff54436e61108"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"d2fh"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Таким образом, мы создали вкладку “Тест”, в нее добавили подпункт “Инструменты”, а в него уже “вложили” две “кнопки”. Вложенность может быть произвольной и многоуровневой. Важно отметить, что внутреннее имя команды должно совпадать с внутренним именем одной из зарегистрированных в программе команд. Очевидно, команда с таким внутренним именем будет выполнена при нажатии на данную “кнопку”.","type":"unstyled","key":"5rbdk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Сохраняем файл и открываем nanoCAD (для самопроверки, шаг опять же необязательный).","type":"unstyled","key":"e8op9"},{"data":{"image":{"id":"65603b678a8c3e662b136f39"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Переключить интерфейс с ленточного на классический можно с помощью кнопки в правом верхнем углу (выделена на скрине).","type":"atomic:image","key":"4btbi"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Как видим, в классическом меню появилась наша вкладка с вложенным подпунктом, в который в свою очередь вложены две “кнопки”.","type":"unstyled","key":"fhbif"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Последнее, что мы сделаем в нашем «Test.cfg» - создадим панель инструментов (toolbar) с нашими кнопками.","type":"unstyled","key":"52ggq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В конец файла «Test.cfg» пишем:","type":"unstyled","key":"1tk83"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":0,"style":"ITALIC"}],"text":"[\\toolbars]","type":"unstyled","key":"4p6mg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":28,"offset":0,"style":"ITALIC"}],"text":"[\\toolbars\\Test_Инструменты]","type":"unstyled","key":"cvc8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":22,"offset":0,"style":"ITALIC"}],"text":"name=sTest_Инструменты","type":"unstyled","key":"douu1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":27,"offset":0,"style":"ITALIC"}],"text":"Intername=sTest_Инструменты","type":"unstyled","key":"54o63"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":51,"offset":0,"style":"ITALIC"}],"text":"[\\toolbars\\Test_Инструменты\\TBSPlus_TextCalculator]","type":"unstyled","key":"8o86o"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":33,"offset":0,"style":"ITALIC"}],"text":"Intername=sTBSPlus_TextCalculator","type":"unstyled","key":"f6cbu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":55,"offset":0,"style":"ITALIC"}],"text":"[\\toolbars\\Test_Инструменты\\TBSPlus_LevelingInstrument]","type":"unstyled","key":"bdoeg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":37,"offset":0,"style":"ITALIC"}],"text":"Intername=sTBSPlus_LevelingInstrument","type":"unstyled","key":"3r29l"},{"data":{"image":{"id":"65603b9357c2956cdc9b0653"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"b6h6a"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Мы создали панель инструментов Test_Инструменты и добавили на нее две кнопки.","type":"unstyled","key":"24l1v"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":157,"offset":53,"style":"ITALIC"}],"text":"Сохраняем файл, открываем nanoCAD и видим результат (для отображения панели инструментов нужно переключить интерфейс на классический вид и в меню «Панели инструментов» установить видимость созданной нами панели).","type":"unstyled","key":"1pc03"},{"data":{"image":{"id":"65603ba9037207634cf53dc9"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"ch0ad"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":96,"offset":424,"style":"ITALIC"}],"text":"UPD:\nКак видим, с созданной нами панелью инструментов есть две сложности: во-первых, она не отображается по умолчанию, во-вторых, она не закреплена и после включения видимости отображается в случайном (с той точки зрения, что мы его не определяли) месте на экране. Эти особенности, а также способ их регулирования осветил участник чата nanoCAD API, рассмотрим это решение.\nВ конец нашего файла «Test.cfg» добавим следующее:\n[\\toolbarspos]\n[\\toolbarspos\\Test_Инструменты]\nDockPosition=sTop\nrow=i0\npos=i1\nInitialVisible=f1\n\nТеперь наша панель инструментов будет отображаться по умолчанию и будет размещена в указанном нами месте (сверху, в первом ряду; на второй позиции). Возможные значения параметров можно посмотреть в настройках интерфейса nanoCAD (русскоязычные названия приведены на скрине):","type":"unstyled","key":"bkbtu"},{"data":{"image":{"id":"65795b870971875120deef57"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"b7spl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":16,"offset":25,"style":"BOLD"}],"text":"Переходим к формированию ленточного меню.","type":"unstyled","key":"7v2p7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Основные элементы, о которых пойдёт речь дальше, подписаны на скрине:","type":"unstyled","key":"3cpsn"},{"data":{"image":{"id":"65603bc352110a2d68cd32e6"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"6gq1c"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":31,"offset":172,"style":"ITALIC"}],"text":"Создаём текстовый файл с любым названием и расширением «.cui» (например, «RibbonRoot.cui»). Внутреннее содержание файла будет соответствовать xml разметке; кодировка файла – «UTF-8» или «UTF-8 with BOM».","type":"unstyled","key":"8lsg5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Открываем созданный файл любым текстовым редактором и пишем в него:","type":"unstyled","key":"4ibsf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":38,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"25gbe"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"79jo9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":29,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"4k8hh"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":56,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"fudhp"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":114,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"1gr0v"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":107,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"20v7f"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":20,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"358je"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":30,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"fjn5e"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":27,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"ahdoo"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":44,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"2kh6r"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":52,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"39acl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":18,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"uorr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":28,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"f25qr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"6govh"},{"data":{"image":{"id":"65603be32a1b3c7e443f4c20"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"e7k5d"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Разберем состав документа поэлементно.","type":"unstyled","key":"ajqea"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"RibbonRoot – корневой элемент документа.","type":"unstyled","key":"6c6sf"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В него будут вложены два элемента: RibbonPanelSourceCollection и RibbonTabSourceCollection.","type":"unstyled","key":"dfkan"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Первый из них – это, как можно догадаться из названия, коллекция панелей. В RibbonPanelSourceCollectionбудем вкладывать элементы типа RibbonPanelSource (описание отдельной панели).","type":"unstyled","key":"1srig"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Атрибуты RibbonPanelSource:","type":"unstyled","key":"9h5ar"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"UID – идентификатор, который мы будем использовать в дальнейшем (для простоты примем такое же значение, как для атрибута Text, хотя, естественно, ничего не мешает нам написать здесь любое значение).","type":"ordered-list-item","key":"bc406"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Text – отображаемое название панели.","type":"ordered-list-item","key":"g866"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В элемент RibbonPanelSource у нас вложены элементы типа RibbonCommandButton, описывающие непосредственно кнопки.","type":"unstyled","key":"4s3a4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Атрибуты RibbonCommandButton:","type":"unstyled","key":"5vb1t"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Text – отображаемое название","type":"ordered-list-item","key":"ecjur"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"ButtonStyle – размер кнопки и наличие текста. Варианты \"LargeWithText\", \"LargeWithoutText\", “LargeWithHorizontalText”, \"SmallWithText\", \"SmallWithoutText\". В нашем примере мы использовали \"LargeWithText\" – большая с текстом. Значение остальных вариантов можно так же понять из перевода","type":"ordered-list-item","key":"c463e"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"MenuMacroID – внутреннее имя выполняемой команды.","type":"ordered-list-item","key":"ffgjl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Второй элемент, входящий в корень документа – RibbonTabSourceCollection. Опять же из названия можно понять, что это коллекция вкладок. В этот элемент будем вкладывать элементы типа RibbonTabSource, каждый из которых соответствует отдельной вкладке.","type":"unstyled","key":"9s4sc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Атрибуты RibbonTabSource:","type":"unstyled","key":"9pkmm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Text – отображаемое название вкладки","type":"ordered-list-item","key":"o124"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"UID – уникальный идентификатор вкладки. Мы нигде не будем использовать его, но этот атрибут должен быть, поэтому запишем туда какое-либо уникальное значение.","type":"ordered-list-item","key":"8olv5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В элемент, соответствующий создаваемой нами вкладке, мы должны вложить необходимые панели, создаваемые выше. Для этого нам потребуется элемент RibbonPanelSourceReference с единственным атрибутом PanelId, ссылающимся на идентификатор (UID) панели.","type":"unstyled","key":"1u15"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Итак, сохраняем этот файл.","type":"unstyled","key":"5kanc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Далее создаём архив типа «zip» (этот тип проверен на практике, при этом, к примеру «7z», по невыясненной причине не подходит), называем его любым именем с расширением «.cuix» (в нашем примере - «Test.cuix»), в этот архив помещаем созданный ранее файл «RibbonRoot.cui». Таким образом, «.cuix» представляет собой обычный архив, содержащий в себе xml файл, описывающий ленточное меню нашей надстройки.","type":"unstyled","key":"654ua"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"«Подключим» сформированный файл в nanoCAD. Для этого в файл «Test.cfg» (например, в самое начало файла) добавим две строки:\n[\\ribbon\\Test]","type":"unstyled","key":"cj55n"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"CUIX=s%CFG_PATH%\\Test.cuix","type":"unstyled","key":"3kfii"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":78,"style":"ITALIC"}],"text":"Здесь «%CFG_PATH%\\Test.cuix» – путь к созданному файлу «Test.cuix». При этом «%CFG_PATH%» — это путь к папке с текущим «.cfg» файлом, т.е. «Test.cfg». Такую запись удобно использовать, если файлы «Test.cfg» и «Test.cuix» расположены в одной папке.","type":"unstyled","key":"ccrj9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":286,"offset":0,"style":"ITALIC"}],"text":"Примечание: указанные строки можно было так же добавить и в ранее упоминаемый файл «nanoCAD.cfg» (при этом вместо %CFG_PATH% в общем случае нужно будет указывать абсолютный путь), но в целях минимизации записей в «nanoCAD.cfg» в нашей команде используется именно описанный выше вариант.","type":"unstyled","key":"fpcu0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Запускаем nanoCAD:","type":"unstyled","key":"6j1iu"},{"data":{"image":{"id":"65603c3bdf645248a6cc8170"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"1h08v"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Итак, цель достигнута – создана новая вкладка на ленте, в ней создана одна панель, в которую добавлено две кнопки.","type":"unstyled","key":"3tont"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"ck5tg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Рассмотрим еще пару полезных примеров.","type":"unstyled","key":"80b09"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":2,"offset":0,"style":"BOLD"},{"length":47,"offset":4,"style":"BOLD"}],"text":"1. Кнопка с выпадающим списком (RibbonSplitButton)","type":"header-three","key":"5aqek"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\nRibbonSplitButton задается элементом одноименного типа.","type":"unstyled","key":"8setn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Атрибуты RibbonSplitButton:","type":"unstyled","key":"b7or1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Text – отображаемое название кнопки","type":"ordered-list-item","key":"2e8ml"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Behavior – поведение. В нашем примере будем использовать значение \"SplitFollowStaticText\" – выпадающая с запоминанием","type":"ordered-list-item","key":"2rl4i"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"ButtonStyle – размер кнопки и наличие текста аналогично атрибуту элемента RibbonCommandButton.","type":"ordered-list-item","key":"2cbkh"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для того чтобы не регистрировать новых команд и не добавлять новые иконки, будем использовать уже знакомые нам две команды, меняя только их отображаемые имена (атрибут Text).","type":"unstyled","key":"6r2dl"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В элемент RibbonPanelSource вкладываем RibbonSplitButton, в который добавляем кнопки (аналогично предыдущему пункту), которые должны войти в выпадающий список.","type":"unstyled","key":"ahkis"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"fvakb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"524lu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"a6acr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"6fnbh"},{"data":{"image":{"id":"65603c7b153f1d1e81cafb76"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"548fe"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Сохраняем файл. Для того, чтобы увидеть результат в случае работы с ленточным интерфейсом не обязательно перезагружать nanoCAD, можно использовать команду «ЛЕНТАОБН».","type":"unstyled","key":"4vmr9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Результат:","type":"unstyled","key":"5k3dp"},{"data":{"image":{"id":"65604874015b20609285ce25"},"images":[{"id":"65604874015b20609285ce25"}],"contents":{}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"ddlfd"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":2,"offset":0,"style":"BOLD"},{"length":16,"offset":4,"style":"BOLD"}],"text":"2. Маленькая кнопка","type":"header-three","key":"7h3sn"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"\nКомпоновка маленьких кнопок (кнопок со значением атрибута ButtonStyle - \"SmallWithText\" или \"SmallWithoutText\") производится немного сложнее.","type":"unstyled","key":"esff3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Если мы попробуем использовать ту же логику и напишем так:","type":"unstyled","key":"8uu54"},{"data":{"image":{"id":"65603ccd7b3142535609d816"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"50m3m"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"То получим не тот результат, который ожидается:","type":"unstyled","key":"apdtg"},{"data":{"image":{"id":"65603cecbcb92670e32c5077"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"5u4pg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Внешне кнопки выглядят так, как нужно, но они расположены в один ряд. Чаще всего мы используем маленькие кнопки для экономии места, и хотелось бы, чтобы они скомпоновались в одну колонку.","type":"unstyled","key":"be3at"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для этого используем еще два элемента – RibbonRowPanel и RibbonRow. RibbonRowPanel мы вложим в нужное место RibbonPanelSource, а внутрь RibbonRowPanel вложим от одной до трёх маленьких кнопок, которые мы хотим скомпоновать в колонку. При этом каждый вкладываем элемент RibbonCommandButton «обернём» в RibbonRow.","type":"unstyled","key":"42md"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":16,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"nomv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"14nm3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":124,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"5iggb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"g51b"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"7420o"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":124,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"8i6l8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"6okgi"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"5hj8c"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":124,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"4858s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"bblfq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"4mtoj"},{"data":{"image":{"id":"65603d27368ff54436e91c6a"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"6lnjh"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Сохраняем файл, обновляем ленту:","type":"unstyled","key":"po67"},{"data":{"image":{"id":"65603d39df645248a6cdf8be"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"bvc2a"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Вынесем часть элементов на отдельную панель:","type":"unstyled","key":"5mlai"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":38,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"keo0"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"8tl6a"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":29,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"8hsli"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":56,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"53mgq"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":114,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"612a2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":107,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"99ou3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":20,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"2lasm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":48,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"dcehk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":106,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"65ubb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":103,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"6aicb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":107,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"2eb1t"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":20,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"945ta"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":16,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"3be9m"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"a7o3b"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":124,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"2j22v"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"ese5p"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"4j9p2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":124,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"cf6hd"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"4stu6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":11,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"15sfu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":124,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"efvt1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":12,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"f18ul"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":17,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"ahbh4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":20,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"b22cb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":30,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"395mh"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":27,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"8l7k1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":44,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"ej8ig"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":52,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"1f7o"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":48,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"f0o1d"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":18,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"11ter"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":28,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"9scdj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":0,"style":"ITALIC"}],"text":"","type":"unstyled","key":"eso10"},{"data":{"image":{"id":"65603da7df645248a6ce9b74"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"c52a4"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Результат:","type":"unstyled","key":"4vnqi"},{"data":{"image":{"id":"65603db910b109449fd06f90"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"4dbdk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Мы рассмотрели основные приёмы формирования ленточного интерфейса, переходим к автоматизации данного процесса.","type":"unstyled","key":"1l9j6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Часть 2. Автоматизированная сборка файлов меню\n","type":"header-two","key":"6jkhn"},{"data":{},"depth":0,"entityRanges":[{"key":1,"length":9,"offset":0}],"inlineStyleRanges":[],"text":"По ссылке можно найти репозиторий с нашим решением MenuFilesGen.","type":"unstyled","key":"1gt1d"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Концепция программы заключается в генерации .cfg и .cuix файлов по описанной выше структуре на основании .tsv таблицы строго определенной структуры.","type":"unstyled","key":"fth26"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":240,"offset":0,"style":"ITALIC"}],"text":"Примечание: формат .tsv был выбран как простой для чтения формат, не имеющий недостатка .csv, накладывающего ограничение на использование запятой (или точки с запятой), которая может использоваться в таблице (к примеру, в описании команды).","type":"unstyled","key":"f4g9j"},{"data":{},"depth":0,"entityRanges":[{"key":2,"length":17,"offset":0}],"inlineStyleRanges":[],"text":"Структуру таблицы можно изучить на примере уже упомянутого TBS Plus.","type":"unstyled","key":"8d4s7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Фрагмент таблицы:","type":"unstyled","key":"4kvmj"},{"data":{"image":{"id":"65603ddbcc3c5426d8b9d45e"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"e21kv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Из неочевидного, считаем нужным прокомментировать:","type":"unstyled","key":"8qh9e"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"1. «RibbonSplitButton» - используется для объединения нескольких кнопок в RibbonSplitButton. Для этого нужно прописать в столбец одинаковое название для нужных строк. К примеру, для строк 40-42 со скрины имеем:","type":"unstyled","key":"1hm4q"},{"data":{"image":{"id":"65603f759e88d95fa26f3bdb"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"47kui"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"2. «Не отображать в меню» - если True, команда не будет учтена в меню (используется, к примеру, для тестовых команд на время разработки).","type":"unstyled","key":"eq4j"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Таким образом, достаточно сформировать таблицу с описанием команд вашего решения, сохранить ее в формате .tsv, запустить MenuFilesGen и указать путь к созданному .tsv файлу. Программа создаст .cfg и .cuix файлы в той же папке. Заметим, что сгенерированные файлы будут иметь название файла с таблицей. Это же название будет и у созданной вкладки. Тут же важно обратить внимание, что одна таблица подразумевает описание одной вкладки.","type":"unstyled","key":"85l73"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Дальше остаётся добавить сгенерированные файлы в инсталлятор вашего плагина и «научить» его прописывать путь к вашему .cfg файлу в файл «nanoCAD.cfg». Готово, ваша надстройка теперь обладает интерфейсом, перекомпоновка которого стала очень простой.","type":"unstyled","key":"2d5qv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Примечание: важно, что .cfg и .cuix файлы у пользователя должны быть расположены в одной папке, в этой же папке должна быть папка “icons”, содержащая набор всех необходимых иконок, при этом имена иконок должны совпадать с внутренними именами команд.","type":"unstyled","key":"cs04g"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Мы намеренно принимаем такие допущения как использование конкретного формата (.tsv), использование имени этого файла, сохранение новых файлов рядом с исходным и тд, потому что понимаем, что каждый разработчик, кто возьмет MenuFilesGen на вооружение, сможет абсолютно без труда настроить его под себя и сократить количество кликов до минимума.","type":"unstyled","key":"8iu8c"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Расскажем, к примеру, как это работает у нас. В проекте MenuFilesGen мы создали несколько конфигураций (по одной на каждый разрабатываемый нами плагин для nanoCAD). Для каждого плагина прописали нужные пути и ссылки:","type":"unstyled","key":"f7e5d"},{"data":{"image":{"id":"65603e429e88d95fa26d2b24"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"nu3k"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Теперь для сборки файлов меню выбираем нужную конфигурацию и запускаем проект. Программа сама скачает таблицу в нужном формате и сохранит сгенерированные файлы в нужную папку, откуда их в дальнейшем «заберёт» инсталлятор.","type":"unstyled","key":"2vbj7"},{"data":{},"depth":0,"entityRanges":[{"key":3,"length":9,"offset":236},{"key":4,"length":9,"offset":681}],"inlineStyleRanges":[{"length":53,"offset":195,"style":"ITALIC"},{"length":1,"offset":691,"style":"ITALIC"},{"length":40,"offset":651,"style":"BOLD"}],"text":"Таким образом, предложенное в этой статье решение является, как нам кажется, хорошей основой для инструмента, который вы можете довести до идеала с учётом специфики разработки в вашей компании.\n\nМатериалы статьи можно изучить подробнее по ссылке.\n\n⚫️ Мы, как поставщик ПО Нанософт и CSoft, помогаем нашим клиентам переносить привычные скрипты, плагины и другие средства автоматизации из среды AutoCAD в nanoCAD. Если перенос в исходном виде по каким-то причинам не возможен, то мы можем рассмотреть возможность добавления в инструменты наших плагинов нужного функционала, либо создать необходимый плагин с нуля в том виде в котором он вам необходим.\nПодробнее о наших разработках по ссылке.\n","type":"unstyled","key":"11k11"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"⬇️ Приглашаем вас вступать в наши сообщества посвященные разработкам TBS и обсуждению продуктов CSoft Development и Nanosoft:","type":"unstyled","key":"92lte"},{"data":{},"depth":0,"entityRanges":[{"key":5,"length":25,"offset":0},{"key":6,"length":22,"offset":26},{"key":7,"length":16,"offset":123},{"key":8,"length":13,"offset":140}],"inlineStyleRanges":[],"text":"Telegram-канал nanoCADAPI\nTelegram-канал TBSapps\n\n⬇️ А также, подписывайтесь на наши социальные сети, там много полезного:\nГруппа Вконтакте\nYoutube-канал","type":"unstyled","key":"3qnun"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"marker","key":"P6LPC3e8tViHqJs7rMKo"}],"entityMap":{"0":{"data":{"url":"https://t.me/nanoCADAPI"},"mutability":"MUTABLE","type":"LINK"},"1":{"data":{"url":"https://github.com/TBS-Software/MenuFilesGen"},"mutability":"MUTABLE","type":"LINK"},"2":{"data":{"url":"https://docs.google.com/spreadsheets/d/17c7IhodIssifwAcz5XvV8-ZGdPzh-evJbF8ZK5u9BIc/edit?usp=sharing"},"mutability":"MUTABLE","type":"LINK"},"3":{"data":{"url":"https://disk.yandex.ru/d/Ey1OEsmNh2i3Xg"},"mutability":"MUTABLE","type":"LINK"},"4":{"data":{"url":"https://tbs-soft.ru/development"},"mutability":"MUTABLE","type":"LINK"},"5":{"data":{"url":"https://t.me/nanoCADAPI"},"mutability":"MUTABLE","type":"LINK"},"6":{"data":{"url":"https://t.me/TBSapps"},"mutability":"MUTABLE","type":"LINK"},"7":{"data":{"url":"https://vk.com/tbssoft"},"mutability":"MUTABLE","type":"LINK"},"8":{"data":{"url":"https://www.youtube.com/@TBSsoft"},"mutability":"MUTABLE","type":"LINK"}}},"mentions":[]}