Приложения
Приложение А. Функции, константы и структуры 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 руководства программиста.
См. также