IAgentBalloonEx::SetStyle
[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]
HRESULT SetStyle(
long lStyle, // 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.
-
lStyle
-
Paramètres de style pour la bulle de texte, qui peuvent être une combinaison des valeurs suivantes :
Valeur Description const unsigned short BALLOON_STYLE_BALLOONON = 0x00000001; La bulle est prise en charge pour l'édition. const unsigned short BALLOON_STYLE _SIZETOTEXT = 0x0000002; La hauteur de la bulle est adaptée à la sortie du texte. const unsigned short BALLOON_STYLE _AUTOHIDE = 0x00000004; La bulle est automatiquement masquée. const unsigned short BALLOON_STYLE _AUTOPACE = 0x00000008; La sortie du texte est rythmée en fonction de la vitesse de sortie.
Lorsque le bit de style BalloonOn est activé, 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 de mots se cache automatiquement après un court délai. Si elle n'est pas définie, la bulle s'affiche jusqu'à ce qu'un nouvel appel Speak ou Think soit lancé, 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.
La propriété de style de la bulle peut être définie même si l'utilisateur a désactivé l'affichage de la bulle à l'aide de la feuille de propriétés de Microsoft Agent.
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 bits de style sont basées sur leurs paramètres lorsque le personnage est compilé avec l'éditeur de caractères de Microsoft Agent.