Methode activeren

[Microsoft Agent is afgeschaft vanaf Windows 7 en is mogelijk niet beschikbaar in volgende versies van Windows.]

beschrijving

Hiermee stelt u de actieve client of het actieve teken in.

syntaxis

agent**. Tekens ("CharacterID"). Activeren** [status]

Deel	Beschrijving
	Facultatief. U kunt de volgende waarden opgeven voor deze parameter: 0 Niet de actieve client. 1 De actieve client. 2 (standaard) Het bovenste teken.

Opmerkingen

Wanneer meerdere tekens zichtbaar zijn, ontvangt slechts één van de tekens tegelijk spraakinvoer. Als meerdere clienttoepassingen hetzelfde teken delen, ontvangt slechts één van de clients muisinvoer (bijvoorbeeld klikken of slepen van gebeurtenissen in Microsoft Agent). De tekenset voor het ontvangen van muis- en spraakinvoer is het bovenste teken en de client die de invoer ontvangt, is de actieve client van dat teken. (Het bovenste tekenvenster wordt ook boven aan de z-volgorde van het tekenvenster weergegeven.) Normaal gesproken bepaalt de gebruiker het bovenste teken door het teken expliciet te selecteren. De bovenste activering wordt echter ook gewijzigd wanneer een teken wordt weergegeven of verborgen (het teken wordt respectievelijk niet meer het hoogste.)

U kunt deze methode ook gebruiken om expliciet te beheren wanneer uw client invoer ontvangt die wordt omgeleid naar het teken, zoals wanneer uw toepassing zelf actief wordt. Als u bijvoorbeeld State instelt op 2, wordt het teken het meest bovenliggend en ontvangt uw client alle gebeurtenissen voor muis- en spraakinvoer die zijn gegenereerd op basis van gebruikersinteractie met het teken. Daarom wordt uw client ook de invoer-actieve client van het teken.

U kunt uzelf echter ook instellen als de actieve client voor een teken zonder het teken het meest bovenaan te maken door State in te stellen op 1. Hierdoor kan uw client invoer ontvangen die naar dat teken wordt omgeleid wanneer het teken het meest bovenliggend wordt. Op dezelfde manier kunt u instellen dat uw client niet de actieve client is (niet om invoer te ontvangen) wanneer het teken het hoogst wordt, door State in te stellen op 0.

Vermijd het aanroepen van deze methode direct na een methode weergeven. automatisch de invoer-actieve client instelt. Wanneer het teken is verborgen, kan de aanroep Activeren mislukken als het wordt verwerkt voordat de methode weergeven is voltooid.

Als u deze methode aanroept aan een functie, retourneert deze een Booleaanse waarde die aangeeft of de methode is geslaagd. Als u deze methode probeert aan te roepen met de parameter State ingesteld op 2 wanneer het opgegeven teken verborgen is, mislukt. Als u State instelt op 0 en uw toepassing de enige client is, mislukt deze aanroep omdat een teken altijd een bovenste client moet hebben.

   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

Notitie

Als u deze methode aanroept met Status ingesteld op 1, wordt doorgaans geen ActivateInput-gebeurtenis gegenereerd, tenzij er geen andere tekens zijn geladen of uw toepassing al invoer actief is.

Zie ook

ActivateInput-gebeurtenisDeactivateInput-gebeurtenis