Método Activate

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]

descrição

Define o cliente ou caractere ativo.

de sintaxe

agente**. Caracteres ("CharacterID "). Activate** [State]

Parte	Descrição
State	Opcional. Você pode especificar os seguintes valores para este parâmetro: 0 Não o cliente ativo. 1 O cliente ativo. 2 (Padrão) O caractere mais alto.

Observações

Quando vários caracteres estão visíveis, apenas um dos caracteres recebe a entrada de fala por vez. Da mesma forma, quando vários aplicativos cliente compartilham o mesmo caractere, apenas um dos clientes recebe a entrada do mouse (por exemplo, o controle do Microsoft Agent clica ou arrasta eventos). O conjunto de caracteres para receber o mouse e a entrada de fala é o caractere mais alto e o cliente que recebe a entrada é o cliente ativo desse caractere. (A janela do caractere mais alto também aparece na parte superior da ordem z da janela do caractere.) Normalmente, o usuário determina o caractere mais alto selecionando explicitamente o caractere. No entanto, a ativação superior também é alterada quando um caractere é mostrado ou oculto (o caractere se torna ou não é mais superior, respectivamente).)

Você também pode usar esse método para gerenciar explicitamente quando o cliente recebe a entrada direcionada para o caractere, como quando o próprio aplicativo se torna ativo. Por exemplo, definir State como 2 torna o caractere mais alto e seu cliente recebe todos os eventos de entrada de mouse e fala gerados da interação do usuário com o caractere. Portanto, ele também torna seu cliente o cliente ativo de entrada do caractere.

No entanto, você também pode definir-se como o cliente ativo para um caractere sem tornar o caractere mais alto, definindo State como 1. Isso permite que o cliente receba a entrada direcionada para esse caractere quando o caractere se tornar mais alto. Da mesma forma, você pode definir seu cliente para não ser o cliente ativo (para não receber entrada) quando o caractere se tornar mais alto, definindo State como 0.

Evite chamar esse método diretamente após um método Show. Mostrar define automaticamente o cliente ativo de entrada. Quando o caractere estiver oculto, a chamada Ativar poderá falhar se for processada antes que o método Show seja concluído.

Se você chamar esse método para uma função, ele retornará um valor booliano que indica se o método foi bem-sucedido. A tentativa de chamar esse método com o parâmetro State definido como 2 quando o caractere especificado estiver oculto falhará. Da mesma forma, se você definir State como 0 e seu aplicativo for o único cliente, essa chamada falhará porque um caractere deve sempre ter um cliente superior.

   Dim Genie as Object

   Sub FormLoad()

   Agent1.Characters.Load "Genie", "Genie.acs"

   Set Genie = Agent1.Characters ("Genie")

   If (Genie. Activate = True) Then
      'I'm active

   Else
      'I must be hidden or something

   End If 
   
   End Sub

Consulte Também

de eventos ActivateInput, evento DeactivateInput