Приложения

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

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

А.5.6. Операции с блоками и связями

А.5.6.35. rdsGetPictureObjectId – элемент векторной картинки блока

Функция rdsGetPictureObjectId возвращает целый идентификатор элемента векторной картинки блока, находящегося по указанным координатам.

  int RDSCALL rdsGetPictureObjectId(
    int x,int y,    // Координаты точки
    BOOL UseVars    // Учитывать значения переменных
  );

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

RDS_IIIB

Параметры

x, y (int): Координаты (в точках экрана) проверяемой точки относительно точки привязки блока (начала координат векторной картинки) в масштабе 100%.
UseVars (BOOL): TRUE – в режимах моделирования и расчета учитывать связи положения, размера, поворота и видимости элементов картинки с переменными блока. FALSE – не учитывать связи с переменными.

Возвращаемое значение

Целый идентификатор элемента, на который в векторной картинке приходятся координаты (x,y), или 0, если по этим координатам нет элементов картинки.

Примечания

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

Чаще всего rdsGetPictureObjectId вызывают из реакций функции модели на нажатие/отпускание кнопок мыши и перемещение ее курсора, хотя для этого есть более удобная функция rdsGetMouseObjectId. Функция возвращает целый идентификатор, присвоенный пользователем одному из элементов картинки в графическом редакторе. По умолчанию всем элементам присваиваются нулевые идентификаторы, с точки зрения rdsGetPictureObjectId попадание курсора в такие элементы не отличается от попадания в свободное место – в обоих случаях функция вернет нулевое значение. Если пользователю нужно сделать какие-то элементы картинки активными и отслеживать попадание в них курсора мыши, ему следует дать им ненулевые идентификаторы.

См. также

RDS_MOUSEDATA, rdsGetMouseObjectId.