Метод активации
[Microsoft Agent не рекомендуется использовать в Windows 7 и может быть недоступно в последующих версиях Windows.]
-
Задает активный клиент или символ.
-
синтаксис
-
агент**. Символы ("CharacterID"). Активация** [состояние]
Часть Описание состояния Необязательный. Для этого параметра можно указать следующие значения: 0 Не активный клиент.
1 Активный клиент.
2 (по умолчанию) Самый верхний символ.
Замечания
При отображении нескольких символов только один из символов получает входные данные речи одновременно. Аналогичным образом, если несколько клиентских приложений используют один и тот же символ, один из клиентов получает входные данные мыши (например, элемент управления Microsoft Agent или перетаскивание событий). Набор символов для получения ввода мыши и речи является самым верхним символом, а клиент, получающий входные данные, является активным клиентом этого символа. (Окно верхнего символа также отображается в верхней части z-порядка окна символа.) Как правило, пользователь определяет самый верхний символ путем явного выбора символа. Тем не менее, самая верхняя активация также изменяется при отображении или скрытии символа (символ становится или больше не является самым верхним, соответственно).)
Этот метод также можно использовать для явного управления, когда клиент получает входные данные, направленные на символ, например, когда приложение становится активным. Например, установка состояния значение 2 делает символ самым верхним, а клиент получает все события ввода мыши и речи, созданные из взаимодействия пользователя с символом. Таким образом, он также делает клиент входным активным клиентом символа.
Однако вы также можете настроить себя активным клиентом для символа, не делая символ самым верхним, задав state значение 1. Это позволяет клиенту получать входные данные, направленные на этот символ, когда символ становится самым верхним. Аналогичным образом можно задать, чтобы клиент не был активным клиентом (не получать входные данные), когда символ становится самым верхним, задав состояние значение 0.
Избегайте вызова этого метода непосредственно после метода Show. показывать автоматически задает клиент input-active. Если символ скрыт, вызов активации может завершиться ошибкой, если он обрабатывается до завершения метода .
При вызове этого метода функции возвращает логическое значение, указывающее, успешно ли выполнен метод. Попытка вызвать этот метод с параметром состояния значение 2, если указанный символ скрыт, завершится ошибкой. Аналогичным образом, если для state значение 0, а приложение является единственным клиентом, этот вызов завершается ошибкой, так как символ всегда должен иметь самый верхний клиент.
Dim Genie as Object
Sub FormLoad()
Agent1.Characters.Load "Genie", "Genie.acs"
Set Genie = Agent1.Characters ("Genie")
If (Genie. Activate = True) Then
'I'm active
Else
'I must be hidden or something
End If
End Sub
Заметка
Вызов этого метода с состояния для 1 обычно не создает событие ActivateInput, если нет других символов, загруженных или приложение уже активно.