IAgentBalloonEx::SetStyle

[Der Microsoft Agent ist seit Windows 7 veraltet und kann in späteren Versionen von Windows nicht mehr verfügbar sein.]

HRESULT SetStyle(
   long lStyle,  // style settings
);

Ruft die Einstellungen der Sprechblasenformatvorlage des Charakters ab.

• Gibt S_OK zurück, um anzugeben, dass der Vorgang erfolgreich war.

lStyle

Formatvorlageneinstellungen für die Sprechblase, die eine Kombination aus einem der folgenden Werte sein kann:

Wert	Beschreibung
const unsigned shortBALLOON_STYLE_BALLOONON = 0x00000001;	Die Sprechblase wird für die Ausgabe unterstützt.
const unsigned shortBALLOON_STYLE _SIZETOTEXT = 0x0000002;	Die Höhe der Sprechblase entspricht der Größe der Textausgabe.
const unsigned shortBALLOON_STYLE _AUTOHIDE = 0x00000004;	Die Sprechblase wird automatisch ausgeblendet.
const unsigned shortBALLOON_STYLE _AUTOPACE = 0x00000008;	Die Textausgabe wird basierend auf der Ausgaberate beschleunigt.

Wenn das BalloonOn-Formatvorlagenbit festgelegt ist, wird die Sprechblase bei der Methode Speak oder Think verwendet, es sei denn, der Benutzer überschreibt die Anzeige in das Eigenschaftenblatt des Microsoft Agent. Wenn sie nicht festgelegt ist, wird keine Sprechblase angezeigt.

Wenn das SizeToText-Formatvorlagenbit festgelegt ist, passt die Sprechblase die Größen für die Sprechblasenhöhe an die aktuelle Größe des Texts an, der in der Methode Speak oder Think angegeben ist. Wenn sie nicht festgelegt ist, basiert die Höhe der Sprechblase auf der Einstellung der Eigenschaft „Number of lines“ der Sprechblase. Dieses Formatvorlagenbit ist auf 1 festgelegt, und ein Versuch zur Verwendung von IAgentBalloonEx::SetNumLines führt zu einem Fehler.

Wenn das AutoHide-Formatvorlagenbit festgelegt ist, wird die Sprechblase nach einem kurzen Timeout automatisch ausgeblendet. Wenn es nicht festgelegt ist, wird die Sprechblase angezeigt, bis ein neuer Speak- oder Think-Aufruf angezeigt wird, der Charakter ausgeblendet wird oder der Benutzer auf den Charakter klickt bzw. den Charakter zieht.

Wenn das AutoPace-Formatvorlagenbit festgelegt ist, passt die Sprechblase die Ausgabe basierend auf der aktuellen Ausgaberate an, z. B. jeweils ein Wort. Wenn die Ausgabe die Größe der Sprechblase überschreitet, wird der vorherige Text automatisch gescrollt. Wenn es nicht festgelegt ist, wird der gesamte in einer Speak- oder Think-Anweisung enthaltene Text gleichzeitig angezeigt.

Die Formateigenschaft der Sprechblase kann auch dann festgelegt werden, wenn der Benutzer die Anzeige der Sprechblase über das Eigenschaftenblatt des Microsoft Agent deaktiviert hat.

Diese Eigenschaft gilt nur für die Verwendung des Charakters durch Ihre Clientanwendung. Die Einstellung wirkt sich nicht auf andere Clients des Charakters oder andere Charaktere Ihrer Clientanwendung aus.

Die Standardwerte für diese Formatvorlagenbits basieren auf ihren Einstellungen beim Kompilieren des Charakters mit dem Microsoft Agent Character Editor.

Weitere Informationen

IAgentBalloonEx::GetStyle