Приложения

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

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

А.5.8. Работа с окнами подсистем

А.5.8.18. rdsSetEditorWindowFlags – задать флаги панелей окна подсистемы

Функция rdsSetEditorWindowFlags устанавливает флаги, описывающие видимость панелей окна подсистемы.

  void RDSCALL rdsSetEditorWindowFlags(
    RDS_BHANDLE System,    // Подсистема
    DWORD Flags,           // Флаги
    DWORD Mask             // Маска установки
  );

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

RDS_VBhDwDw

Параметры

System (RDS_BHANDLE)

Идентификатор подсистемы, состояние панелей окна которой нужно установить (окно подсистемы не обязательно должно быть открыто).

Flags (DWORD)

Набор битовых флагов, описывающих состояние панелей (эти же флаги возвращаются функцией rdsGetEditorWindowFlags). Взведенный флаг указывает на то, что соответствующая панель должна быть видима, сброшенный – скрыта:

RDS_EWF_CALCTOOLBAR	Панель расчета (с кнопками переключения режимов).
RDS_EWF_DISPLAYTOOLBAR	Панель элементов (с кнопками управления сеткой и отображением имен блоков и переменных).
RDS_EWF_LAYERSTOOLBAR	Панель слоев (со списками слоев и их конфигураций).
RDS_EWF_PRINTTOOLBAR	Панель печати (с кнопками вызова окна печати и управления зоной печати.
RDS_EWF_STATUSBAR	Строка состояния.
RDS_EWF_ZOOMTOOLBAR	Панель масштаба (со списком масштабов и кнопками увеличения и перетаскивания).

Mask (DWORD)

Маска панелей, видимость которых должна быть изменена. Это набор тех же флагов, что используются в параметре Flags, но, в данном случае, взведенный флаг указывает на то, что видимость соответствующей панели должна быть изменена, сброшенный – видимость не меняется. Можно также использовать дополнительно описанную константу RDS_EWF_ALLBARS, являющуюся объединением всех флагов (ее передача в параметре Mask указывает на то, что видимость всех панелей должна быть изменена).

Примечания

Эта функция устанавливает видимость панелей, указанных в параметре Mask, согласно флагам в параметре Flags. Единица в каком-либо разряде Mask указывает на то, что видимость соответствующей панели меняется в соответствии со значением того же самого бита в параметре Flags:

Пример

Показать панель расчета в подсистеме с идентификатором Sys:

  rdsSetEditorWindowFlags(
      Sys,
      RDS_EWF_CALCTOOLBAR,
      RDS_EWF_CALCTOOLBAR);

или

  rdsSetEditorWindowFlags(
      Sys,
      RDS_EWF_ALLBARS,       // Все флаги установлены
      RDS_EWF_CALCTOOLBAR);

Скрыть строку состояния:

  rdsSetEditorWindowFlags(Sys,0,RDS_EWF_STATUSBAR);

Скрыть все панели:

  rdsSetEditorWindowFlags(Sys,0,RDS_EWF_ALLBARS);

См. также

rdsGetEditorWindowFlags.