Partilhar via


IAgentCharacter::GestureAt

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

HRESULT GestureAt(
   short x,         // x-coordinate of specified location
   short y,         // y-coordinate of specified location
   long * pdwReqID  // address of a request ID
);

Reproduz a animação de estado Gesturing associada com base no local especificado.

  • Retorna S_OK para indicar que a operação foi bem-sucedida. Quando a função retorna, pdwReqID contém a ID da solicitação.

x

A coordenada x do local especificado em pixels, em relação à origem da tela (canto superior esquerdo).

y

A coordenada y do local especificado em pixels, em relação à origem da tela (canto superior esquerdo).

pdwReqID

Endereço de uma variável que recebe o GestureAt ID de solicitação.

O servidor determina e reproduz automaticamente a animação gestual apropriada com base na posição atual do personagem e no local especificado. Ao usar o protocolo HTTP para acessar dados de caracteres e animações, use o método Prepare para garantir que as animações estejam disponíveis antes de chamar esse método.