Поделиться через


IAgentNotifySinkEx::ActiveClientChange

[Microsoft Agent не рекомендуется использовать в Windows 7 и может быть недоступно в последующих версиях Windows.]

HRESULT ActiveClientChange(
...long dwCharID,  // character ID
   long lStatus    // active state flag
);

Уведомляет клиентское приложение, если его активный клиент больше не является активным клиентом символа.

  • Нет возвращаемого значения.

dwCharID

Идентификатор символа, для которого изменилось активное состояние клиента.

lStatus

Активное изменение состояния клиента, которое может быть сочетанием любого из следующих значений:

значение Описание
const unsigned shortACTIVATE_NOTACTIVE = 0;
Клиент не является активным клиентом символа.
const unsigned shortACTIVATE_ACTIVE = 1;
Ваш клиент является активным клиентом символа.
const unsigned shortACTIVATE_INPUTACTIVE = 2;
Клиент имеет значение input-active (активный клиент самого верхнего символа).

Если несколько клиентских приложений используют один и тот же символ, активный клиент символа получает входные данные мыши (например, элемент управления Microsoft Agent щелчок или перетаскивание событий). Аналогично при отображении нескольких символов активный клиент самого верхнего символа (также известный как клиент ввода-активный) получает события IAgentNotifySink::Command .

Если активный клиент символа изменяется, это событие передает идентификатор этого символа и true , если приложение стало активным клиентом символа или False , если он больше не является активным клиентом символа.

Клиентское приложение может получить это событие, когда пользователь выбирает запись другого клиентского приложения в всплывающем меню символа или голосовой командой, клиентское приложение изменяет его активное состояние или другое клиентское приложение завершает подключение к Microsoft Agent. Агент отправляет это событие только клиентским приложениям, непосредственно затронутым тем, которые становятся активным клиентом или перестают быть активным клиентом.

Метод Activate можно использовать для задания того, является ли приложение активным клиентом символа или сделать приложение клиентом input-active (который также делает символ самым верхним).

См. также

IAgentCharacter::Activate, IAgentCharacterEx::GetActive, IAgentNotifySink::ActivateInputState