Partager via

IAgentBalloonEx::GetStyle

  • Article

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

HRESULT GetStyle(
   long * plStyle,  // address of style settings
);

Récupère les paramètres de style de la bulle de texte du personnage

  • Renvoie S_OK pour indiquer que l'opération a réussi.

plStyle

Paramètres de style pour la bulle de texte, qui peuvent être une combinaison des valeurs suivantes :

Valeur Description
const unsigned shortBALLOON_STYLE_BALLOONON = 0x00000001;
 La bulle est prise en charge pour l'édition.
const unsigned shortBALLOON_STYLE _SIZETOTEXT = 0x0000002; La hauteur de la bulle est adaptée à la sortie du texte.
const unsigned shortBALLOON_STYLE _AUTOHIDE = 0x00000004; La bulle est automatiquement masquée.
const unsigned shortBALLOON_STYLE _AUTOPACE = 0x00000008; La sortie du texte est rythmée en fonction de la vitesse de sortie.

Lorsque le bit de style BalloonOn est défini, la bulle de mots apparaît lorsque la méthode Speak ou Think est utilisée, à moins que l'utilisateur ne remplace son affichage dans la feuille de propriétés de Microsoft Agent. S'il n'est pas activé, aucune bulle n'apparaît.

Lorsque le bit de style SizeToText est défini, la hauteur de la bulle de mots est automatiquement adaptée à la taille actuelle du texte spécifié dans la méthode Speak ou Think. S'il n'est pas défini, la hauteur de la bulle est basée sur le paramètre de propriété Nombre de lignes de la bulle. Ce bit de style est défini à 1 et toute tentative d'utilisation de IAgentBalloonEx::SetNumLines entraînera une erreur.

Lorsque le bit de style AutoHide est activé, la bulle se cache automatiquement après un court délai. S'il n'est pas activé, le ballon s'affiche jusqu'à ce qu'un nouvel appel Speak ou Think soit effectué, que le personnage soit masqué ou que l'utilisateur clique sur le personnage ou le fasse glisser

Lorsque le bit de style AutoPace est activé, la bulle de mots s'affiche en fonction du taux de sortie actuel, par exemple, un mot à la fois Lorsque l'édition dépasse la taille de la bulle, le texte précédent défile automatiquement. Si cette option n'est pas activée, tout le texte inclus dans une instruction Speak ou Think s'affiche en une seule fois.

Cette propriété s'applique uniquement à l'utilisation du personnage par votre application cliente ; le paramètre n'affecte pas les autres clients du personnage ou les autres caractères de votre application cliente.

Les valeurs par défaut de ces éléments de style sont basées sur les paramètres définis lors de la compilation du personnage dans l'éditeur de caractères de Microsoft Agent.

Voir aussi

IAgentBalloonEx::SetStyle