Files
kompas3d-mcp/docs/Kompas3D_SDK/guides/libtoolbarid.md
T
mikhail e1337e4016 feat(sdk-docs): MD-база знаний SDK — в репозиторий; генератор и зеркало убраны
docs/Kompas3D_SDK/ становится каноническим источником справки КОМПАС SDK
и включается в репозиторий (2491 файл, ~14 МБ). HTML-зеркало
docs/KOMPAS_SDK_ru-RU/ (~1.4 ГБ, © АСКОН) и генератор
tools/build_kompas3d_sdk.py больше не нужны — регенерация не предполагается.

- .gitignore: MD-база разблокирована; зеркало остаётся проигнорированным
  (safety-net на случай повторной локальной выгрузки).
- CLAUDE.md / SKILL.md: убраны упоминания регенерации и зеркала.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-26 20:00:05 +03:00

5.4 KiB

title, type, api, tags, sources
title type api tags sources
LibToolBarId - Получить идентификаторы инструментальных и компактных панелей guide
api7
guide
api7
libtoolbarid
libtoolbarid.html

*Создание прикладных библиотек  > Оформление прикладных библиотек типа DLL  > Пример простейшей программы в среде VC++, оформленной в виде библиотеки КОМПАС  > Функции *

LibToolBarId - Получить идентификаторы инструментальных и компактных панелей

Функция не поддерживается Пример... Синтаксис:

extern "C" int WINAPI _export LibToolBarId (int barType, int index);
Входные параметры:
barType    - тип запрашиваемой панели (0 - компактная панель, 1 - простая инструментальная панель, 2 - контекстная всплывающая панель),
index    - индекс панели.
Возвращаемое значение: (для компактной и простой инструментальной панели)
Идентификатор панели
-1    - если для заданного barType нет панели с заданным индексом.
Возвращаемое значение: (для всплывающих панелей)
Идентификатор панели
0    - запрет добавления панели,
-1    - отображать стандартную панель для макроэлемента,
>0    - идентификатор ресурсов для загрузки пользовательской панели.

Примечание:

  1. Панель описывается тремя ресурсами: •RCDATA состава панели; •имя панели; •значок инструментальной панели для возможности включения ее в компактную панель.
  2. При описании панелей в ресурсах блок RCDATA необходимо заканчивать значением 0xffff.
  3. Сначала запрашиваются обычные инструментальные панели, потом компактные панели. Система будет запрашивать функцию пока возвращаемое значение не будет равно -1. Если описанная в ресурсе инструментальная панель входит в компактную, то упоминание инструментальной панели в LibToolBarId не обязательно.
  4. Отображение созданных панелей можно включить, вызвав команду Вид - Панели инструментов после подключения библиотеки.
  5. Кнопки типа Fly-Out.
  6. Пример описания ресурсов панелей и кнопки типа Fly-Out.
  7. Индексы панелей начинаются с 0.
  8. Размер, цвет, тип файла значков на кнопках…
  9. Если в библиотеке нет компактной панели, то при barType = 0 нужно вернуть -1. Если в библиотеке нет инструментальной панели, то при barType = 1 нужно вернуть -1.
  10. При селектировании библиотечного макроэлемента можно заменить или запретить отображение всплывающих панелей. Всплывающая панель может содержать две панели. Для получения списка контекстных панелей функция LibToolBarId вызывается первый раз при подключении библиотеки и требуется вернуть идентификаторы всех всплывающих панелей для всех библиотечных элементов. После подключения библиотеки функция вызывается при селектировании макроэлементов. В зависимости от типа макроэлемента библиотека может вернуть свои или запретить всплывающие панели. Подробнее о создании контекстных панелей...

Пример использования функции LibToolBarId

//----------------------------------------------------------------------------- // Получить идентификаторы панелей // barType == 0 - компактная панель 1 - простая панель // index - индекс панели // --- extern "C" int WINAPI __export LibToolBarId( int barType, int index ){ if ( !barType ) { // Компактная панель "Крепежные элементы" return !index ? COMPACT_BAR_CONSTR : -1; } #ifndef LIGHT_VERSION else { switch( index ) { case 0: return BAR_CONSTRUCT; // Панель "Конструктивные элементы" case 1: return BAR_PROFILE; // Панель "Профили" } } #endif return -1; }