Metodo Activate

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di Windows.]

Descrizione

Imposta il client o il carattere attivo.

Sintassi

agent**. Caratteri ("CharacterID"). Attiva** [Stato]

Parte	Descrizione
State	Facoltativa. È possibile specificare i valori seguenti per questo parametro: 0 Non il client attivo. 1 Il client attivo. 2 (impostazione predefinita) Carattere superiore.

Commenti

Quando più caratteri sono visibili, solo uno dei caratteri riceve l'input vocale alla volta. Analogamente, quando più applicazioni client condividono lo stesso carattere, solo uno dei client riceve l'input del mouse (ad esempio, il controllo Microsoft Agent fa clic o trascina gli eventi). Il carattere impostato per ricevere l'input del mouse e della voce è il carattere superiore e il client che riceve l'input è il client attivo di tale carattere. Nella parte superiore della finestra del carattere viene visualizzata anche nella parte superiore dell'ordine z-order della finestra dei caratteri. In genere, l'utente determina il carattere più alto selezionando in modo esplicito il carattere. Tuttavia, l'attivazione superiore cambia anche quando viene visualizzato o nascosto un carattere (il carattere diventa o non è più superiore, rispettivamente).

È anche possibile usare questo metodo per gestire in modo esplicito quando il client riceve l'input diretto al carattere, ad esempio quando l'applicazione stessa diventa attiva. Ad esempio, l'impostazione di Stato su 2 rende il carattere più in alto e il client riceve tutti gli eventi di input del mouse e voce generati dall'interazione dell'utente con il carattere. Pertanto, rende anche il client il client attivo di input del carattere.

Tuttavia, è anche possibile impostare se stessi per essere il client attivo per un carattere senza rendere il carattere più in alto, impostando Stato su 1. Ciò consente al client di ricevere l'input diretto a tale carattere quando il carattere diventa superiore. Analogamente, è possibile impostare il client su non essere il client attivo (non per ricevere l'input) quando il carattere diventa superiore, impostando Stato su 0.

Evitare di chiamare questo metodo direttamente dopo un metodo Show . Mostra automaticamente imposta il client attivo di input. Quando il carattere è nascosto, la chiamata Attiva potrebbe non riuscire se viene elaborata prima del completamento del metodo Show .

Se si chiama questo metodo a una funzione, restituisce un valore booleano che indica se il metodo ha avuto esito positivo. Il tentativo di chiamare questo metodo con il parametro State impostato su 2 quando il carattere specificato non riesce. Analogamente, se si imposta Stato su 0 e l'applicazione è l'unico client, questa chiamata ha esito negativo perché un carattere deve sempre avere un client superiore.

   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

La chiamata a questo metodo con State impostata su 1 non genera in genere un evento ActivateInput a meno che non siano presenti altri caratteri caricati o che l'applicazione sia già attiva.

Vedere anche

Evento ActivateInput, Evento DeactivateInput