Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.24. Вспомогательный объект для работы со списком блоков и связей

А.5.24.4. rdsBCLExecuteGroupSetDialog – вызов окна групповой установки

Функция rdsBCLExecuteGroupSetDialog открывает окно для групповой установки параметров блоков и связей в указанном списке и, если пользователь нажмет в нем кнопку «OK», устанавливает заданные в окне параметры для всех блоков и связей из списка.

  void RDSCALL rdsBCLExecuteGroupSetDialogA(
    RDS_HOBJECT List, // Список
    DWORD Flags,      // Флаги (RDS_GS_*)
    RDSCSTR Title,    // Заголовок окна (UTF8)
    BOOL Undo         // Разрешить отмену
  );
  void RDSCALL rdsBCLExecuteGroupSetDialogW(
    RDS_HOBJECT List, // Список
    DWORD Flags,      // Флаги (RDS_GS_*)
    RDSWCSTR Title,   // Заголовок окна (UTF16)
    BOOL Undo         // Разрешить отмену
  );
  // Функция-псевдоним
  void RDSCALL rdsBCLExecuteGroupSetDialog(
    RDS_HOBJECT List, // Список
    DWORD Flags,      // Флаги (RDS_GS_*)
    RDSXCSTR Title,   // Заголовок окна (кодировка по умолчанию)
    BOOL Undo         // Разрешить отмену
  );

Тип указателя на эту функцию

RDS_VHoDwSB (для UTF8) или RDS_VHoDwWsB (для UTF16)

Параметры

List (RDS_HOBJECT)

Идентификатор вспомогательного объекта-списка, ранее созданного функцией rdsBCLCreateList.

Flags (DWORD)

Объединенные битовым ИЛИ флаги запрета отдельных операций в окне групповой установки:

RDS_GS_DISABLEAUTOCOMP	Запрет изменения параметров автоматической компиляции модели блока
RDS_GS_DISABLEBLOCKAPPEARANCE	Запрет изменения параметров внешнего вида блока (изображение имени, точки привязки и т.п.)
RDS_GS_DISABLEBUSPACK	Запрет удаления пустых каналов шин
RDS_GS_DISABLECONNAPPEARANCE	Запрет изменения внешнего вида связи и шины
RDS_GS_DISABLECONNSTATE	Запрет включения/выключения связи
RDS_GS_DISABLEDBLCLICK	Запрет изменения реакции блока на двойной щелчок
RDS_GS_DISABLEDLLFUN	Запрет изменения функции модели блока
RDS_GS_DISABLEDLLOPTIONS	Запрет изменения флагов реакции функции модели блока
RDS_GS_DISABLEDRAWTYPE	Запрет изменения способа отображения внешнего вида блока (картинка, прямоугольник, программное рисование)
RDS_GS_DISABLEEDITORPARAMS	Запрет изменения параметров окна подсистемы
RDS_GS_DISABLELAYERCHANGE	Запрет изменения слоя блоков, связей и шин
RDS_GS_DISABLEPICTURE	Запрет изменения векторной картинки блока и ее параметров
RDS_GS_DISABLEREMARKS	Запрет изменения комментариев блоков
RDS_GS_DISABLESIZING	Запрет изменения параметров масштаба и размера блока
RDS_GS_DISABLEVARCHANGE	Запрет изменения переменных блока
RDS_GS_DISABLEVARVALUES	Запрет присвоения значений переменным блока

Если в параметре Flags будет передано нулевое значение (не установлен ни один флаг), будут разрешены все операции.

Title (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку с заголовком, который должно иметь окно групповой установки. Если в этом параметре передать NULL, окно будет иметь стандартный заголовок «Параметры выделенных объектов».

Undo (BOOL)

TRUE, если нужно разрешить пользователю в будущем отменить выполненную операцию групповой установки (он сможет сделать это, как обычно, выбрав пункт меню «Система | Отмена»). FALSE, если отмену нужно запретить.

Примечания

Эта функция открывает стандартное окно групповой установки параметров RDS для блоков и связей, находящихся в списке List. В этом окне пользователь может одновременно изменить параметры всех этих блоков и связей.

См. также

rdsBCLCreateList.