IAgentNotifySink::VisibleState

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

HRESULT VisibleState(
   long dwCharID,  // character ID
   long bVisible,  // visibility flag
   long dwCause,   // cause of visible state
);

Notifies a client application when the visibility state of the character changes.

dwCharID

Identifier of the character whose visibility state is changed.

bVisible

Visibility flag. This Boolean value is True when character becomes visible and False when the character becomes hidden.

dwCause

Cause of last change to the character's visibility state. The parameter may be one of the following:

Value	Description
const unsigned short NeverShown = 0;	Character has not been shown.
const unsigned short UserHid = 1;	User hid the character with the character's taskbar icon pop-up menu or with speech input..
const unsigned short UserShowed = 2;	User showed the character.
const unsigned short ProgramHid = 3;	Your application hid the character.
const unsigned short ProgramShowed = 4;	Your application showed the character.
const unsigned short OtherProgramHid = 5;	Another application hid the character.
const unsigned short OtherProgramShowed = 6;	Another application showed the character.
const unsigned short UserHidViaCharacterMenu = 7	User hid the character with the character's pop-up menu.
const unsigned short UserHidViaTaskbarIcon = UserHid	User hid the character with the character's taskbar icon pop-up menu or using speech input.

See Also