Текущий раздел:

Описания RDS

Приложения

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

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

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

А.5.8.14. rdsRefreshBlockWindows – обновить немодальные окна

# Приложения

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

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

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

##### А.5.8.14. rdsRefreshBlockWindows – обновить немодальные окна

Функция rdsRefreshBlockWindows обновляет все немодальные окна, принадлежащие указанному блоку (включая окна подсистем).

      void RDSCALL rdsRefreshBlockWindows(
        RDS_BHANDLE Block,    // Блок
        BOOL Recurse          // Включая вложенные блоки
      );

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

RDS_VBhB

Параметры

Block(RDS_BHANDLE)
  Идентификатор блока, немодальные окна которого нужно обновить. Если Block – подсистема, обновляется также окно этой подсистемы.
Recurse(BOOL)
  TRUE: если Block – подсистема, обновить также и все окна ее внутренних блоков и подсистем. FALSE: обновить только окна, принадлежащие Block.

Примечания

Чаще всего эта функция вызывается для обновления окна подсистемы (и, возможно, окон всех вложенных в нее подсистем) в тех случаях, когда оно не обновляется автоматически. При вызове любой модели блока RDS взводит флаг обновления его родительской подсистемы, что приведет к обновлению окна этой подсистемы при первой возможности, поэтому здесь функцию rdsRefreshBlockWindows вызывать не нужно. Если же изменения во внешний вид одного из блоков внесены в результате каких-либо других действий – например, из функции какого-либо окна, открытого моделью средствами Windows API, или изменением динамической переменной без вызова специальной функции rdsNotifyDynVarSubscribers – обновить окно подсистемы нужно вручную.

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

Пример

Пример использования функции rdsRefreshBlockWindows описан в §2.7.6 руководства программиста.

См. также

RDS_BFM_WINREFRESH, rdsEnableWindowRefresh.