Propriedade Style

[O Microsoft Agent foi preterido a partir do Windows 7 e pode não estar disponível em versões subsequentes do Windows.]

Descrição

Retorna ou define o estilo de saída do balão de palavras do personagem.

Sintaxe

*agent.*Caracteres("CharacterID"). Balloon.Style [ = Estilo]

Peça	Descrição
Estilo	Um inteiro que representa o estilo de saída do balão. A configuração de estilo é um campo de bits com bits correspondentes a: balloon-on (bit 0), size-to-text (bit 1), auto-hide (bit 2), auto-pace (bit 3), número de caracteres por linhas (bits 16-23) e número de linhas (bits 24-31).

 

Comentários

Quando o bit de estilo balloon-on é definido como 1, a palavra balão aparece quando um método Speak ou Think é usado, a menos que o usuário substitua essa configuração na folha de propriedades do Microsoft Agent. Quando definido como 0, um balão não aparece.

Quando o bit de estilo de tamanho para texto é definido como 1, o balão de palavras dimensiona automaticamente a altura do balão para o tamanho atual do texto para a instrução Speak ou Think. Quando definido como 0, a altura do balão é baseada na configuração da propriedade NumberOfLines. Se esse bit de estilo estiver definido como 1 e você tentar definir a propriedade NumberOfLines, o Agent gerará um erro.

Quando o bit de estilo de ocultação automática é definido como 1, a palavra balão é ocultada automaticamente quando a saída falada é concluída. Quando definido como 0, o balão permanece exibido até a próxima chamada Speak ou Think, o caractere está oculto ou o usuário clica ou arrasta o caractere.

Quando o bit de estilo de ritmo automático é definido como 1, a palavra balão acelera a saída com base na taxa de saída atual, por exemplo, uma palavra de cada vez. Quando a saída excede o tamanho do balão, o texto anterior é rolado automaticamente. Quando definido como 0, todo o texto incluído em uma instrução Speak ou Think é exibido de uma só vez.

Para recuperar apenas o valor dos quatro bits inferiores, E o valor retornado por Style com 255. Para definir um valor de bit, Ou o valor retornado com o valor dos bits que você deseja definir. Para desligar um pouco, E o valor retornado com o complemento do bit:

   Const BalloonOn = 1

   ' Turn the word balloon off
   Genie.Balloon.Style = Genie.Balloon.Style And (Not BalloonOn)
   Genie.Speak "No balloon"

   ' Turn the word balloon on
   Genie.Balloon.Style = Genie.Balloon.Style Or BalloonOn
   Genie.Speak "Balloon"

A propriedade Style também retorna o número de caracteres por linha no byte inferior da palavra superior e o número de linhas no byte alto da palavra superior. Embora isso possa ser lido mais facilmente usando o CharsPerLine e propriedades NumberOfLines, a propriedade Style também permite definir esses valores.

Por exemplo, para alterar o número de linhas, limpe os bits 24 a 31 com uma lógica E operação antes de definir o novo valor como o produto do novo valor vezes 2^24, adicionado ao valor existente da propriedade Style.

   ' Set the number of lines to 4
   Genie.Balloon.Style = (Genie.Balloon.Style <b>AND</b> &amp;H00FFFFFF) + (4*(2^24))

Para definir o número de caracteres por linha, limpe os bits 16 a 23 com uma lógica E operação antes de definir o novo valor como o produto do novo valor vezes 2^16, adicionado ao valor existente da propriedade Style.

   ' Set the number of characters per line to 16
   Genie.Balloon.Style = (Genie.Balloon.Style AND &HFF00FFFF) + (16*(2^16))

A propriedade Style pode ser definida mesmo que o usuário tenha desabilitado a exibição de balão usando a folha de propriedades do Microsoft Agent. No entanto, os valores para o número de linhas devem estar entre 1 e 128 e os caracteres numéricos por linha devem estar entre 8 e 255. Se você fornecer um valor inválido para a propriedade Style, o Agent gerará um erro.

Esta propriedade aplica-se apenas ao uso do caractere pelo seu aplicativo cliente; A configuração não afeta outros clientes do caractere ou outros caracteres do seu aplicativo cliente.

Os padrões para esses bits de estilo são baseados em suas configurações quando o caractere é compilado com o Microsoft Agent Character Editor.