Свойство InvisibleApp.EventInfo (Visio)

  • Статья

Возвращает дополнительные сведения, связанные с событием, если таковые существуют. Только для чтения.

Синтаксис

expression. EventInfo (eventSeqNum)

Выражение Переменная, представляющая объект InvisibleApp .

Параметры

Имя Обязательный или необязательный Тип данных Описание
eventSeqNum Обязательный Long visEvtIDMostRecent (0) для получения сведений о последнем событии или порядковом номере проверяемого события (см. раздел VisEventCodes).

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

Строка

Замечания

Когда Microsoft Visio запускает событие, существует небольшое количество событий, для которых доступны дополнительные сведения. Это события BeforeDocumentSaveAs, DocumentSavedAs, EnterScope, ExitScope, MarkerEvent, ShapesDeleted и ShapeChanged. Используйте свойство EventInfo приложения, чтобы получить эти сведения, если они доступны.

Свойство EventInfo возвращает следующее:

  • Строка, содержимое которой относится к рассматриваемому событию, если событие записывает дополнительные сведения.

  • Пустая строка, если событие не записывает дополнительные сведения.

  • Ошибка, если в Microsoft Visio больше нет сведений о указанном событии.

Дополнительные сведения о содержимом свойства EventInfo для события см. в разделе о конкретном событии.

Если целевой объект события запрашивает свойство EventInfo сразу после активации, последнее событие и событие, порядковый номер которого был передан целевому объекту, совпадают. Однако если целевой объект является надстройкой, реализованной исполняемым (.exe) файлом, это может быть не так, так как исполняемый файл и Visio являются отдельными задачами, которые не являются модальными по отношению друг к другу.

Примечание.

Обработчики событий, использующие ключевое слово Microsoft Visual Basic для приложений (VBA) WithEvents, имеют доступ только к последнему событию и должны использовать visEvtIDMostRecent.

Чтобы гарантировать, что сведения, возвращаемые свойством EventInfo , связаны с тем же событием, которое активировало надстройку, исполняемый файл может передаваться <sequence number> в качестве аргумента в свойство EventInfo . Порядковый номер события можно получить следующими способами:

  • Если свойство Action объекта Event возвращает visActCodeRunAddon, строка командной строки, переданная надстройке, содержит подстроку формы "/eventid=<sequence number>".

    Несмотря на то, что подстрока помечена "/eventid"как , не следует путать <sequence number> переданную в командной строке строку со свойством ID объекта Event , который идентифицирует объект Event в коллекции EventList . Передаваемый номер на самом деле является порядковый номер срабатывания.

  • Если свойство Action объекта Event возвращает visActCodeAdvise, порядковый номер передается в качестве аргумента процедуре VisEventProc , реализованной целевым объектом.

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.