Método Activate

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows.

Descripción

Establece el cliente o carácter activo.

Syntax

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

Parte	Descripción
Estado	Opcional. Puede especificar los valores siguientes para este parámetro: 0 No el cliente activo. 1 El cliente activo. 2 (valor predeterminado) Carácter superior.

Comentarios

Cuando hay varios caracteres visibles, solo uno de los caracteres recibe la entrada de voz a la vez. Del mismo modo, cuando varias aplicaciones cliente comparten el mismo carácter, solo uno de los clientes recibe la entrada del mouse (por ejemplo, el control de Microsoft Agent hace clic o arrastra eventos). El juego de caracteres para recibir la entrada del mouse y la voz es el carácter más alto y el cliente que recibe la entrada es el cliente activo de ese carácter. (La ventana del carácter superior también aparece en la parte superior del orden z de la ventana de caracteres). Normalmente, el usuario determina el carácter superior seleccionando explícitamente el carácter. Sin embargo, la activación superior también cambia cuando se muestra u oculta un carácter (el carácter se convierte o ya no está más arriba, respectivamente).

También puede usar este método para administrar explícitamente cuando el cliente recibe la entrada dirigida al carácter, como cuando la propia aplicación se activa. Por ejemplo, al establecer Estado en 2, el carácter se coloca más arriba y el cliente recibe todos los eventos de entrada de ratón y voz generados a partir de la interacción del usuario con el carácter. Por lo tanto, también convierte al cliente en el cliente activo de entrada del carácter.

Sin embargo, también puede establecerse como el cliente activo para un carácter sin convertir el carácter en el extremo superior, estableciendo Estado en 1. Esto permite al cliente recibir la entrada dirigida a ese carácter cuando el carácter se vuelve más alto. De forma similar, puede establecer que el cliente no sea el cliente activo (no recibir entrada) cuando el carácter se convierta en el extremo superior, estableciendo Estado en 0.

Evite llamar a este método directamente después de un método Show . Mostrar establece automáticamente el cliente input-active. Cuando el carácter está oculto, se puede producir un error en la llamada Activate si se procesa antes de que se complete el método Show .

Si llama a este método a una función, devuelve un valor booleano que indica si el método se realizó correctamente. Si se intenta llamar a este método con el parámetro State establecido en 2 cuando se oculta el carácter especificado, se producirá un error. Del mismo modo, si establece State en 0 y la aplicación es el único cliente, se produce un error en esta llamada porque un carácter siempre debe tener un 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

Nota

Llamar a este método con State establecido en 1 no suele generar un evento ActivateInput a menos que no haya otros caracteres cargados o la aplicación ya esté activa de entrada.

Consulte también

Evento ActivateInput, evento DeactivateInput