Activate-Methode

[Der Microsoft-Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht verfügbar.]

Beschreibung

Legt den aktiven Client oder das aktive Zeichen fest.

Syntax

Agent**. Zeichen ("CharacterID"). Activate** [State]

Teil	Beschreibung
Zustand	Optional. Sie können die folgenden Werte für diesen Parameter angeben: 0 Nicht der aktive Client. 1 Der aktive Client. 2 (Standard) Das oberste Zeichen.

Bemerkungen

Wenn mehrere Zeichen sichtbar sind, empfängt jeweils nur eines der Zeichen spracheingaben. Ebenso empfängt, wenn mehrere Clientanwendungen dasselbe Zeichen gemeinsam haben, nur einer der Clients Mauseingaben (z. B. Klick- oder Ziehereignisse der Microsoft Agent-Steuerung). Der Zeichensatz zum Empfangen von Maus- und Spracheingaben ist das oberste Zeichen, und der Client, der die Eingabe empfängt, ist der aktive Client dieses Zeichens. (Das Fenster des obersten Zeichens wird auch oben in der Z-Reihenfolge des Zeichenfensters angezeigt.) In der Regel bestimmt der Benutzer das oberste Zeichen, indem er das Zeichen explizit auswählt. Die oberste Aktivierung ändert sich jedoch auch, wenn ein Zeichen angezeigt oder ausgeblendet wird (das Zeichen wird bzw. ist nicht mehr oberstes Zeichen).)

Sie können diese Methode auch verwenden, um explizit zu verwalten, wann Ihr Client Eingaben empfängt, die an das Zeichen weitergeleitet werden, z. B. wenn Ihre Anwendung selbst aktiv wird. Wenn Sie z. B . State auf 2 festlegen, wird das Zeichen am höchsten festgelegt, und Ihr Client empfängt alle Maus- und Spracheingabeereignisse, die aus der Benutzerinteraktion mit dem Zeichen generiert werden. Daher wird Ihr Client auch zum eingabeaktiven Client des Zeichens.

Sie können sich jedoch auch als aktiver Client für ein Zeichen festlegen, ohne das Zeichen am obersten Rand zu setzen, indem Sie State auf 1 festlegen. Dadurch kann Ihr Client Eingaben empfangen, die an dieses Zeichen weitergeleitet werden, wenn das Zeichen am höchsten ist. Ebenso können Sie festlegen, dass Ihr Client nicht der aktive Client ist (keine Eingabe empfangen), wenn das Zeichen am obersten Rand wird, indem Sie State auf 0 festlegen.

Vermeiden Sie es, diese Methode direkt nach einer Show-Methode aufzurufen. Anzeigen legt automatisch den eingabeaktiven Client fest. Wenn das Zeichen ausgeblendet ist, schlägt der Activate-Aufruf möglicherweise fehl, wenn es verarbeitet wird, bevor die Show-Methode abgeschlossen ist.

Wenn Sie diese Methode für eine Funktion aufrufen, wird ein boolescher Wert zurückgegeben, der angibt, ob die Methode erfolgreich war. Der Versuch, diese Methode aufzurufen, wobei der State-Parameter auf 2 festgelegt ist, wenn das angegebene Zeichen ausgeblendet ist, schlägt fehl. Wenn Sie State auf 0 festlegen und Ihre Anwendung der einzige Client ist, schlägt dieser Aufruf fehl, da ein Zeichen immer über einen obersten Client verfügen muss.

   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

Hinweis

Wenn Sie diese Methode mit State 1 aufrufen, wird in der Regel kein ActivateInput-Ereignis generiert, es sei denn, es sind keine anderen Zeichen geladen oder Ihre Anwendung ist bereits eingabeaktiv.

Weitere Informationen

ActivateInput-Ereignis, DeactivateInput-Ereignis