IAgentCharacter ::Hide

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]

HRESULT Hide(
   long bFast,      // play Hiding state animation flag
   long * pdwReqID  // address of request ID
);

Masque le caractère.

• Retourne S_OK pour indiquer que l’opération a réussi. Lorsque la fonction est retournée, pdwReqID contient l’ID de la requête.

bFast

indicateur d’animation d’état de masquage. Si ce paramètre est True, l’animation de masquage n’est pas lue avant que le cadre de caractère ne soit masqué ; si False, l’animation est lue.

pdwReqID

Adresse d’une variable qui reçoit le Masquer l’ID de requête de.

Le serveur met en file d’attente l’animation associée à la méthode Masquer dans la file d’attente du caractère. Cela vous permet de l’utiliser pour masquer le caractère après une séquence d’autres animations. Vous pouvez lire l’action immédiatement à l’aide de la méthode Arrêter avant d’appeler la méthode Masquer.

Lorsque vous utilisez le protocole HTTP pour accéder aux données de caractère et d’animation, utilisez la méthode Prepare pour garantir la disponibilité de l’animation d’état hiding avant d’appeler cette méthode.

Le masquage d’un caractère peut également entraîner le déclenchement de l’événement IAgentNotifySink ::ActivateInputState d’un autre caractère visible.

Les caractères masqués ne peuvent pas accéder au canal audio. Le serveur transmet un état d’échec dans l’événement RequestComplete si vous générez une demande d’animation et que le caractère est masqué.

Voir aussi

IAgentCharacter ::Show