Свойство Application.EventInfo (Visio)
Возвращает дополнительные сведения, связанные с событием, если таковые существуют. Только для чтения.
Синтаксис
expression. EventInfo (eventSeqNum)
выражение: переменная, представляющая объект Application.
Параметры
Имя | Обязательный или необязательный | Тип данных | Описание |
---|---|---|---|
eventSeqNum | Обязательный | Long | visEvtIDMostRecent (0) для получения сведений о последнем событии или порядковом номере проверяемого события (см. раздел VisEventCodes). |
Возвращаемое значение
Строка
Замечания
Когда Microsoft Visio запускает событие, существует небольшое количество событий, для которых доступны дополнительные сведения. Это события BeforeDocumentSaveAs, DocumentSavedAs, EnterScope, ExitScope, MarkerEvent, ShapesDeleted и ShapeChanged. Используйте свойство EventInfo приложения, чтобы получить эти сведения, если они доступны.
Свойство EventInfo возвращает следующее:
Строка, содержимое которой относится к рассматриваемому событию, если событие записывает дополнительные сведения.
Пустая строка, если событие не записывает дополнительные сведения.
Ошибка, если в 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 и обратная связь.