IAgentBalloonEx::GetStyle
[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]
HRESULT GetStyle(
long * plStyle, // address of style settings
);
Recupera as configurações de estilo de balão de palavra do caractere.
- Retorna S_OK para indicar que a operação foi bem-sucedida.
-
plStyle
-
Configurações de estilo para a palavra balão, que pode ser uma combinação de qualquer um dos seguintes valores:
Valor Descrição const unsigned shortBALLOON_STYLE_BALLOONON = 0x00000001; O balão tem suporte 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 é acelerada com base na taxa de saída.
Quando o bit de estilo BalloonOn é definido, o balão de palavras é exibido quando o método Speak ou Think é usado, a menos que o usuário substitua sua exibição por meio da 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 palavra 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 no número de configurações de propriedade 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 período de tempo limite. Quando não definido, o balão é exibido até que uma nova chamada Fale ou Pense , o caractere esteja oculto ou o usuário clique ou arraste o caractere.
Quando o bit de estilo do AutoPace é definido, a palavra balão 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 ao mesmo tempo.
Essa propriedade se aplica somente 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 para esses bits de estilo baseiam-se nas configurações quando o caractere é compilado por meio do Editor de Caracteres do Microsoft Agent.