IAgentCharacterEx::SetAutoPopupMenu

[Microsoft Agent is deprecated as of Windows 7, and may be unavailable in subsequent versions of Windows.]

HRESULT SetAutoPopupMenu(
   long bAutoPopupMenu,  // auto pop-up menu display setting
);

Sets whether the server automatically displays the character's pop-up menu.

  • Returns S_OK to indicate the operation was successful.

bAutoPopupMenu

The automatic pop-up menu display flag. If this parameter is True, Microsoft Agent automatically displays the character's pop-up menu when the user right-clicks the character or character's taskbar icon.

This property applies only to your client application's use of the character; the setting does not affect other clients of the character or other characters of your client application.

By setting this property to False, you can create your own menu-handling behavior. To display the menu after setting this property to False, use the IAgentCharacterEx::ShowPopupMenu method.

See Also

IAgentCharacterEx::GetAutoPopupMenu, IAgentCharacterEx::ShowPopupMenu