Activate-Methode

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

Beschreibung

Legt den aktiven Client oder das aktive Zeichen fest.

Syntax

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

Teil	Beschreibung
State	Wahlfrei. 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. Wenn mehrere Clientanwendungen dasselbe Zeichen gemeinsam nutzen, empfängt nur einer der Clients Mauseingaben (z. B. Klick- oder Ziehereignisse des Microsoft Agent-Steuerelements). 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 im 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 ganz oben).)

Sie können diese Methode auch verwenden, um explizit zu verwalten, wenn Ihr Client Eingaben empfängt, die an das Zeichen weitergeleitet werden, z. B. wenn die Anwendung selbst aktiv wird. Wenn Sie z. B. Status auf 2 festlegen, wird das Zeichen ganz oben angezeigt, und Ihr Client empfängt alle Maus- und Spracheingabeereignisse, die von der Benutzerinteraktion mit dem Zeichen generiert werden. Daher wird ihr Client auch zum eingabeaktiven Client des Zeichens.

Sie können sich jedoch auch selbst als aktiver Client für ein Zeichen festlegen, ohne das Zeichen ganz oben zu machen, indem Sie Status auf 1 festlegen. Auf diese Weise kann Ihr Client Eingaben empfangen, die an dieses Zeichen weitergeleitet werden, wenn das Zeichen ganz oben wird. Ebenso können Sie festlegen, dass Ihr Client nicht der aktive Client (nicht zum Empfangen von Eingaben) ist, wenn das Zeichen ganz oben angezeigt wird, indem Sie Status auf 0 festlegen.

Vermeiden Sie das direkte Aufrufen dieser Methode nach einer Show-Methode. " anzeigen" legt den eingabeaktiven Client automatisch fest. Wenn das Zeichen ausgeblendet ist, schlägt der Aufruf Activate 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. Wenn Sie versuchen, diese Methode mit dem Parameter State auf 2 auf 2 festzulegen, wenn das angegebene Zeichen ausgeblendet ist, tritt ein Fehler auf. Wenn Sie State auf 0 festlegen und die Anwendung der einzige Client ist, schlägt dieser Aufruf fehl, da ein Zeichen immer über einen clientseitigen Oberen 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

Siehe auch

ActivateInput-Ereignis, DeactivateInput-Ereignis