IAgentBalloonEx::SetStyle
[O Microsoft Agent foi preterido do Windows 7 em diante e pode não estar disponível em versões subsequentes do Windows.]
HRESULT SetStyle(
long lStyle, // style settings
);
Recupera as configurações de estilo de balão de palavras do caractere.
- Retorna S_OK para indicar que a operação foi bem-sucedida.
-
lStyle
-
Configurações de estilo para o balão de palavra, que pode ser uma combinação de qualquer um dos seguintes valores:
Valor Descrição const unsigned shortBALLOON_STYLE_BALLOONON = 0x00000001; O balão funciona para saída. const unsigned shortBALLOON_STYLE _SIZETOTEXT = 0x0000002; A altura do balão é dimensionada para acomodar a saída de texto. const unsigned shortBALLOON_STYLE _AUTOHIDE = 0x00000004; O balão é ocultado automaticamente. const unsigned shortBALLOON_STYLE _AUTOPACE = 0x00000008; A saída de texto é ritmada com base na taxa de saída.
Quando o bit de estilo BalloonOn é definido, a palavra balão aparece quando o método Speak ou Think é usado, a menos que o usuário substitua a exibição na folha de propriedades do Microsoft Agent. Quando não definido, nenhum balão é exibido.
Quando o bit de estilo SizeToText é definido, o balão de palavras dimensiona automaticamente a altura do balão para o tamanho atual do texto especificado no método Speak ou Think. Quando não definido, a altura do balão é baseada na configuração da propriedade de número de linhas do balão. Esse bit de estilo é definido como 1, e uma tentativa de usar IAgentBalloonEx::SetNumLines resultará em um erro.
Quando o bit de estilo AutoHide é definido, o balão de palavra é ocultado automaticamente após um curto tempo limite. Quando não definido, o balão é exibido até uma nova chamada Speak ou Think, até que o caractere fique oculto ou até que o usuário clique ou arraste o caractere.
Quando o bit de estilo AutoPace é definido, o balão de palavra acelera a saída com base na taxa de saída atual, por exemplo, uma palavra por vez. Quando a saída excede o tamanho do balão, o texto anterior é rolado automaticamente. Quando não definido, todo o texto incluído em uma instrução Speak ou Think é exibido de uma só vez.
A propriedade de estilo do balão poderá ser definida mesmo que o usuário tenha desabilitado a exibição do balão usando a folha de propriedades do Microsoft Agent.
Essa propriedade aplica-se apenas ao uso do caractere pelo aplicativo cliente; a configuração não afeta outros clientes do caractere ou outros caracteres do aplicativo cliente.
Os padrões desses bits de estilo são baseados em suas configurações quando o personagem é compilado com o editor de caracteres do Microsoft Agent.