Compartilhar via

IAgentNotifySink::Move

  • Artigo

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

HRESULT Move(
   long dwCharID,  // character ID
   long x,         // x-coordinate of new location
   long y,         // y-coordinate of new location
   long dwCause    // cause of move state
);

Notifica um aplicativo cliente quando o caractere é movido.

  • Nenhum valor retornado.

dwCharID

Identificador do caractere que foi movido.

x

A coordenada x da nova posição em pixels, em relação à origem da tela (canto superior esquerdo). A localização de um caractere é baseada no canto superior esquerdo do quadro de animação.

y

A coordenada y da nova posição em pixels, em relação à origem da tela (canto superior esquerdo). A localização de um caractere é baseada no canto superior esquerdo do quadro de animação.

dwCause

A causa do movimento do caractere. O tipo de parâmetro pode ser um dos seguintes:

Valor Descrição
const unsigned short NeverMoved = 0;
 O caractere não foi movido.
const unsigned short UserMoved = 1;
 O usuário arrastou o caractere.
const unsigned short ProgramMoved = 2;
 O aplicativo moveu o caractere.
const unsigned short OtherProgramMoved = 3;
 Outro aplicativo moveu o caractere.
const unsigned short SystemMoved = 4
 O servidor moveu o caractere para mantê-lo na tela após uma alteração na resolução da tela.

O evento é enviado a todos os clientes do caractere.

Confira também

IAgentCharacter::GetMoveCause, IAgentCharacter::MoveTo