IAgentBalloonEx::SetStyle
[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows].
HRESULT SetStyle(
long lStyle, // style settings
);
Recupera la configuración de estilo del bocadillo de palabras del personaje.
- Devuelve S_OK para indicar que la operación se ha realizado correctamente.
-
lStyle
-
Configuración de estilo del bocadillo de palabras, que puede ser una combinación de cualquiera de los siguientes valores:
Valor Descripción const unsigned short BALLOON_STYLE_BALLOONON = 0x00000001; El bocadillo se admite para la salida. const unsigned short BALLOON_STYLE _SIZETOTEXT = 0x0000002; La altura del bocadillo tiene el tamaño para acomodar el texto final. const unsigned short BALLOON_STYLE _AUTOHIDE = 0x00000004; El bocadillo se oculta automáticamente. const unsigned short BALLOON_STYLE _AUTOPACE = 0x00000008; El ritmo de escritura del texto final se basa en la velocidad de salida.
Cuando se crea el bit de estilo BalloonOn, el bocadillo de palabras aparecerá cuando se use el método Speak o Think, a menos que el usuario invalide que se muestre en la hoja de propiedades de Microsoft Agent. Si no se crea, no aparece ningún bocadillo.
Cuando se crea el bit de estilo SizeToText, el bocadillo de palabras ajusta automáticamente su altura actual al tamaño del texto correspondiente en el método Speak o Think. Si no se crea, la altura del bocadillo se basará en el ajuste de propiedad del número de líneas en el bocadillo. Este bit de estilo cambia a 1 y si se intenta usar IAgentBalloonEx::SetNumLines, se generará un error.
Cuando se crea el bit de estilo AutoHide, el bocadillo de palabras se oculta automáticamente después de un breve tiempo de espera. Si no se crea, el bocadillo aparece hasta una nueva llamada a Speak o Think, el personaje quede oculto o el usuario haga clic o arrastre el personaje.
Cuando se crea el bit de estilo AutoPace, el bocadillo de palabras se rellenará con texto al mismo ritmo que la velocidad de salida actual, por ejemplo, una palabra a la vez. Si la salida supera el tamaño del globo, el texto anterior se desplazará automáticamente. Si no se crea, todo el texto incluido en una instrucción Speak o Think aparecerá a la vez.
La propiedad de estilo del bocadillo se puede crear aunque el usuario haya anulado que aparezca el bocadillo a través de la hoja de propiedades de Microsoft Agent.
Esta propiedad solo se aplica al uso del personaje de la aplicación cliente; el ajuste no afecta a otros clientes del personaje u otros personajes de la aplicación cliente.
Los valores predeterminados de estos bits de estilo se basan en la configuración cuando el personaje se compila mediante el Editor de personajes de Microsoft Agent.