Compartilhar via


IAgentNotifySink::VisibleState

[O Microsoft Agent foi preterido do Windows 7 em diante e pode não estar disponível em versões subsequentes do Windows.]

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

Notifica um aplicativo cliente quando o estado de visibilidade do caractere é alterado.

  • Nenhum valor retornado.

dwCharID

Identificador do caractere cujo estado de visibilidade é alterado.

bVisible

Sinalizador de visibilidade. Esse valor booliano é True quando o caractere se torna visível e False quando o caractere fica oculto.

dwCause

Causa da última alteração no estado de visibilidade do caractere. O tipo de parâmetro pode ser um dos seguintes:

Valor Descrição
const unsigned short NeverShown = 0;
O caractere não foi mostrado.
const unsigned short UserHid = 1;
O usuário ocultou o caractere com o menu pop-up do ícone da barra de tarefas do caractere ou com a entrada de fala.
const unsigned short UserShowed = 2;
O usuário mostrou o caractere.
const unsigned short ProgramHid = 3;
O aplicativo ocultou o caractere.
const unsigned short ProgramShowed = 4;
O aplicativo mostrou o caractere.
const unsigned short OtherProgramHid = 5;
Outro aplicativo escondeu o caractere.
const unsigned short OtherProgramShowed = 6;
Outro aplicativo mostrou o caractere.
const unsigned short UserHidViaCharacterMenu = 7
O usuário ocultou o caractere com o menu pop-up do caractere.
const unsigned short UserHidViaTaskbarIcon = UserHid
O usuário ocultou o caractere com o menu pop-up do ícone da barra de tarefas do caractere ou usando a entrada de fala.

Confira também

IAgentCharacter::GetVisible, IAgentCharacter::GetVisibilityCause