Приложения

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

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

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

А.5.8.22. rdsSetZoomPercent – задать масштаб окна подсистемы

Функция rdsSetZoomPercent задает масштаб окна подсистемы в процентах и, при необходимости, выводит в центр окна заданную точку рабочего поля.

  void RDSCALL rdsSetZoomPercent(
    RDS_BHANDLE System,        // Подсистема
    int ZoomPercent,           // Масштаб в %
    int CenterX,int CenterY    // Центральная точка или -1
  );

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

RDS_VBhIIIIB

Параметры

System (RDS_BHANDLE)

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

ZoomPercent (int)

Новый масштаб в процентах.

CenterX, CenterY (int)

Координаты точки рабочего поля в масштабе 100% (CenterX – горизонтальная координата, CenterY – вертикальная), которая должна оказаться в центре видимой в окне части рабочего поля после изменения масштаба. В этих параметрах можно передать −1, в этом случае RDS изменит масштаб так, чтобы в центре окна осталась та же точка рабочего поля, что и до изменения масштаба.

Примечания

Эта функция изменяет масштаб подсистемы System, если ее окно открыто. В параметрах (CenterX,CenterY) можно указать координаты точки рабочего поля, которая должна оказаться в центре окна после изменения масштаба, или (–1,–1), чтобы сохранить текущую центральную точку. Если вывести указанную точку в центр окна невозможно (например, если она находится слишком близко к краю рабочего поля), в центр окна будет выставлена ближайшая точка из возможных.

Пример

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

См. также

rdsScrollWindowToRect.