Приложения

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

А.2. События блока и связанные с ними описания

А.2.6. События пользовательского интерфейса и рисования внешнего вида блоков

А.2.6.10. RDS_BFM_MOUSEDBLCLICK – двойной щелчок мыши

Поток, в котором вызывается функция модели

Главный поток RDS.

Первый параметр функции модели (int CallMode)

Константа RDS_BFM_MOUSEDBLCLICK.

Третий параметр функции модели (void *ExtParam)

Указатель на структуру описания события RDS_MOUSEDATA.

Возвращаемое функцией модели значение

RDS_BFR_DONE	Двойной щелчок обработан блоком.
RDS_BFR_NOTPROCESSED	Двойной щелчок не обработан блоком, он будет передан в родительскую подсистему, а затем, если и она его не обработает, в RDS.

Примечания

Реакция на событие RDS_BFM_MOUSEDBLCLICK вызывается при двойном щелчке на изображении блока в окне подсистемы, если одновременно выполняются следующие условия:

RDS находится в режиме моделирования или расчета;
изображение блока находится на видимом слое окна подсистемы, для которого разрешено редактирование;
в параметрах блока разрешена реакция на мышь.

Блоки могут обрабатывать щелчки кнопок мыши только в режимах моделирования и расчета: в режиме редактирования мышь используется для редактирования схемы. Если изображения блоков перекрываются, двойной щелчок мыши сначала будет передан в блок, изображение которого находится ближе всего к переднему плану. Если его модель не обработает двойной щелчок, будет вызвана модель блока, находящегося дальше, и т.д. Если ни один блок не обработает двойной щелчок, будет вызвана модель подсистемы для реакции на событие RDS_BFM_WINDOWMOUSEDBLCLICK. Если же и подсистема не среагирует на двойной щелчок, он будет обработан RDS (будет включен режим редактирования и, если щелчок пришелся на блок, будет открыто окно его параметров или вызвана функция настройки). Реакция блоков на мышь подробно рассматривается в §2.12 руководства программиста. Следует помнить, что, в отличие от большинства других событий, при реакции на мышь возврат стандартной константы RDS_BFR_DONE сообщает RDS о том, что блок обработал действие пользователя. Таким образом, если разрешить в параметрах блока реакцию на мышь, блок начнет перехватывать все щелчки, пришедшиеся на его изображение, даже если не включать в модель реакции на события RDS_BFM_MOUSE*. Чтобы блок, которому разрешена реакция на мышь, был «прозрачным» для щелчков, его модель должна вернуть константу RDS_BFR_NOTPROCESSED (пример использования этой константы приведен в §2.12.3 руководства программиста).

Для описания произошедшего события служит структура RDS_MOUSEDATA (она используется и в других событиях реакции на мышь):

  typedef struct {
    RDSINT32 x,y;           // Координаты курсора мыши
    RDSINT32 BlockX,BlockY; // Координаты точки привязки блока
    RDSINT32 Left,Top;      // Верхний левый угол изображения блока
    RDSINT32 Width,Height;  // Размеры изображения блока
    RDSINT32 IntZoom;       // Масштаб окна подсистемы в %
    DWORD Button;           // Кнопка мыши (RDS_M*)
    DWORD Shift;            // Флаги мыши и клавиатуры (RDS_M*, RDS_K*)
    BOOL BlockName;         // Действие на имени блока
    double DoubleZoom;      // Масштабный к-т окна (в долях единицы)
    RDSINT32 MouseEvent;    // Событие
    RDSINT32 Viewport;      // Устаревшее, больше не используется
  } RDS_MOUSEDATA;
  typedef RDS_MOUSEDATA *RDS_PMOUSEDATA;

Поля структуры

x, y (RDSINT32)

Координаты курсора мыши в окне подсистемы на момент возникновения события.

BlockX, BlockY (RDSINT32)

Координаты точки привязки изображения блока в текущем масштабе. Для блоков с векторной картинкой это положение начала координат этой картинки, для программно рисуемых блоков и блоков, изображаемых прямоугольником с текстом, это координаты левого верхнего угла изображения (горизонтальная ось координат направлена вправо, вертикальная – вниз, начало координат – левый верхний угол рабочего поля). Если положение блока связано с его переменными, значения BlockX и BlockY в этой структуре указываются уже с учетом значений этих переменных. При реакции на события RDS_BFM_WINDOWMOUSE* эти поля не используются.

Left, Top (RDSINT32)

Горизонтальная (Left) и вертикальная (Top) фактические координаты верхнего левого угла изображения блока в текущем масштабе на момент последней перерисовки окна подсистемы. При реакции на события RDS_BFM_WINDOWMOUSE* эти поля не используются.

Width, Height (RDSINT32)

Фактические ширина (Width) и высота (Height) изображения блока в текущем масштабе на момент последней перерисовки окна подсистемы. При реакции на события RDS_BFM_WINDOWMOUSE* эти поля не используются.

IntZoom (RDSINT32)

Текущий масштаб окна подсистемы в процентах.

Button (DWORD)

Кнопка мыши, нажатие или отпускание которой вызвало событие:

RDS_MLEFTBUTTON	Левая кнопка мыши.
RDS_MRIGHTBUTTON	Правая кнопка мыши.
RDS_MMIDDLEBUTTON	Средняя кнопка мыши.

Shift (DWORD)

Битовые флаги, описывающие состояние специальных клавиш клавиатуры и кнопок мыши в момент возникновения события.

BlockName (BOOL)

Событие произошло из-за действий с отображаемым именем блока, а не с его изобрадением. Это возможно только в том случае, если модель блока взвела флаг RDS_NAMEMOUSEREACTION.

DoubleZoom (double)

Текущий масштаб окна подсистемы в долях единицы: 1 для 100%, 2 для 200%, 0.5 для 50% и т.п.

MouseEvent (RDSINT32)

Действие пользователя, которое привело к возникновению события. В реакциях на события RDS_BFM_MOUSE* дублирует параметр CallMode функции модели. В реакциях подсистем RDS_BFM_WINDOWMOUSE* в это поле записывается идентификатор события, близкого по смыслу к произошедшему событию:

Событие	CallMode	Поле KeyEvent
Нажатие кнопки мыши на изображении блока	RDS_BFM_MOUSEDOWN	RDS_BFM_MOUSEDOWN
Отпускание кнопки мыши на изображении блока	RDS_BFM_MOUSEUP	RDS_BFM_MOUSEUP
Перемещение курсора мыши над изображением блока	RDS_BFM_MOUSEMOVE	RDS_BFM_MOUSEMOVE
Двойной щелчок на изображении блока	RDS_BFM_MOUSEDBLCLICK	RDS_BFM_MOUSEDBLCLICK
Нажатие кнопки мыши на свободном месте окна подсистемы	RDS_BFM_WINDOWMOUSEDOWN	RDS_BFM_MOUSEDOWN
Отпускание кнопки мыши на свободном месте окна подсистемы	RDS_BFM_WINDOWMOUSEUP	RDS_BFM_MOUSEUP
Перемещение курсора мыши в окне подсистемы	RDS_BFM_WINDOWMOUSEMOVE	RDS_BFM_MOUSEMOVE
Двойной щелчок на свободном месте окна подсистемы	RDS_BFM_WINDOWMOUSEDBLCLICK	RDS_BFM_MOUSEDBLCLICK
Проверка возможности выбора блока щелчком мыши	RDS_BFM_MOUSESELECT	RDS_BFM_MOUSESELECT

См. также

RDS_BFM_MOUSEDOWN, RDS_BFM_MOUSEUP, RDS_BFM_MOUSEMOVE, RDS_BFM_WINDOWMOUSEDOWN, RDS_BFM_WINDOWMOUSEUP, RDS_BFM_WINDOWMOUSEMOVE, RDS_BFM_WINDOWMOUSEDBLCLICK.